CHANGELOG.md

Changelog

1.3.8 (2026-01-12)

1. add AUTO_CAST to morebuiltins.utils.Validator for automatic type conversion
2. add --dry-run/--test to cmd.systemd

1.3.7 (2025-12-05)

1. fix morebuiltins.utils.Validator while type is Union / Optional

1.3.6 (2025-11-26)

1. add morebuiltins.funcs.async_call to automatically call a function asynchronously, whether it's sync or async.
2. add morebuiltins.funcs.countdown to print a countdown timer inline in the console.
3. update morebuiltins.utils.code_inline using zlib instead of gzip.
4. add morebuiltins.utils.Validator string alias for bool type
   1. Validator now supports string values like "true", "false", "1", "0", "yes", "no", "on", "off" for boolean fields.

1.3.5 (2025-10-15)

1. fix writer.wait_closed() ConnectionResetError in ipc.py, proxy_checker.py, log_server.py
2. add morebuiltins.funcs.debounce decorator to debounce function calls.
3. add sep arg to morebuiltins.utils.gen_id to customize the separator between date and time.
4. add LoggerStream to morebuiltins.logs to redirect sys.stdout/sys.stderr with prefix.
   1. Use sys.stdout = LoggerStream() to redirect all stdout to LoggerStream, which sends logs to the logging system / file / custom writer.
   2. LoggerStream.replace_print_ctx: A context manager to temporarily replace the print function within a block of code.
      1. add time prefix to each print line.
5. add nofmt extra field support to morebuiltins.cmd.log_server to skip formatting for high-frequency/thinking logs.
6. add scripts entry to pyproject.toml for morebuiltins command line tool.
   1. now you can run uvx morebuiltins morebuiltins.cmd.log_server to start log server with uvx.

1.3.4 (2025-10-15)

1. fix morebuiltins.utils.gen_id wrong length issue.
2. fix morebuiltins.funcs.LineProfiler to handle nested function calls correctly.
3. update morebuiltins.cmd.log_server to support close idle file handlers after 300 seconds.
4. add get_logger to morebuiltins.cmd.log_server to get a singleton logger with SocketHandler to send logs to LogServer.
5. [Compatibility Warnings] Refactor of morebuiltins.cmd.log_server:
   1. use LogSetting struct instead of untyped dict, client send dict with LogSetting structure.
   2. add level_specs filter to specify log levels of files, like [logging.ERROR, logging.CRITICAL].
   3. add cache file for log settings, readable by both server and human.
   4. THIS IS A BREAKING CHANGE, old clients may not work with new server.

1.3.3 (2025-09-01)

1. add morebuiltins.logs.LogHelper.handle_crash to log uncaught exceptions.
2. fix morebuiltins.logs.LogHelper.bind_handler to avoid adding duplicate queue handlers.
3. update default format of morebuiltins.logs.LogHelper to "%(asctime)s | %(levelname)-5s | %(filename)+8s:%(lineno)+3s - %(message)s".

1.3.2 (2025-08-02)

1. fix typing-hint for morebuiltins.funcs.threads decorator, now it returns Callable[..., Future].
2. add force kill methods to morebuiltins.shared_memory.PLock:
   1. add force_signum to morebuiltins.shared_memory.PLock, to specify the signal number to force kill the process if it exists.
   2. add is_free to morebuiltins.shared_memory.PLock, to check if the lock is free.
   3. add kill_with_name to morebuiltins.shared_memory.PLock, to kill the process with the given name and signal number.
3. add morebuiltins.logs.LogHelper to quickly bind a logging handler to a logger, with a StreamHandler or SizedTimedRotatingFileHandler.
4. Compatibility Warnings:
   1. move async_logger, AsyncQueueListener, LogHelper, RotatingFileWriter, and SizedTimedRotatingFileHandler from morebuiltins.funcs to morebuiltins.logs.
5. add ContextFilter for logging, to add context variables to log records.
6. add queue arg to morebuiltins.logs.LogHelper.bind_handler, to enable async logging with AsyncQueueListener. (like loguru's queue=True)

1.3.1 (2025-06-19)

1. add check_recursion to morebuiltins.funcs, to check if a function is recursive.
2. add SharedBytes to morebuiltins.shared_memory, a shared memory for bytes, similar to multiprocessing.shared_memory.SharedMemory with a header for size.
3. add line_profiler decorator to morebuiltins.funcs, to profile function execution time line by line.

1.3.0 (2025-03-08)

1. Compatibility Warning. rename morebuiltins.functools to morebuiltins.funcs to avoid conflict with functools in python standard library.
2. add key_type arg to sqlite.KV, to support int key.
3. add utils.cut_file to cut file with a+b mode to limit the file size
4. add recheck for utils.set_pid_file
5. add shared_memory.PLock for singleton process with multiprocessing.shared_memory, support linux and windows.
6. add --StandardOutput and --StandardError to morebuiltins.cmd.systemd.service, and update --Environment to list type.
7. add is_port_free to morebuiltins.ipc.

1.2.3 (2025-03-07)

1. add sqlite.KV: A key-value store using sqlite3, lightweight sqlitedict.

1.2.2 (2025-03-04)

1. Change the default alphabet in utils.base_encode to "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz", which follows the order of ASCII characters.
2. add utils.SnowFlake for id generator

1.2.1 (2025-03-03)

1. add utils.get_size to get size of objects recursively.
2. add base_encode, base_decode, gen_id, timeti to utils
3. add alias for AsyncQueueListener: functools.async_logger

1.1.9 (2025-01-16)

1. add snippets.sql.SqliteSQL as Sqlite SQL generator
2. add cmd.parse_deps to parse dependencies of a project directory, and find circular dependencies.
3. add cmd.os.linux.systemd.service and cmd.os.linux.systemd.timer
4. add functools.to_thread, same as asyncio.to_thread in python 3.9+.
5. add functools.AsyncQueueListener for asyncio non-block logging.
6. fix systemd.timer typing hint error

1.1.8 (2024-12-11)

1. add utils.i2b and utils.b2i, integer and fixed-length byte strings conversion.
2. add --compress to cmd.log_server
3. add snippets.event.EventTemplate

1.1.7 (2024-11-19)

1. fix utils.code_inline gzip compress mtime to 1, to ensure the same compressed data
2. fix utils.FileDict.save
3. add ipc.QueueManager based on BaseManager, add JSON listener
4. add compress, ensure_dir arg to funtools.SizedTimedRotatingFileHandler
5. add compress arg to funtools.RotatingFileWriter
6. update utils.format_error default filter skip from "site-packages" to "-packages"

1.1.6 (2024-09-09)

1. add filename_filter to utils.format_error
2. add functools.get_function to find function from entrypoint
   1. set the type default to str while strict=False and no default/annotation
3. add default button_text to TKit.ask_text
4. add morebuiltins.cmd.ui with --cli/--gui, --web
   1. try python -m morebuiltins.cmd.ui -e re:findall --cli
   2. try python -m morebuiltins.cmd.ui -e re:findall --gui1
   3. try python -m morebuiltins.cmd.ui -e re:findall --gui2
   4. try python -m morebuiltins.cmd.ui -e test_func_web --web --web-open --web-timeout=30
5. add default doc for morebuiltins.cmd.ui --gui
6. morebuiltins.functools.FuncSchema changed
   1. parse will see arg type as str while strict=False and no default/annotation
   2. add to_string to FuncSchema

1.1.5 (2024-08-29)

1. add utils.get_hash_int

1.1.4 (2024-08-25)

1. modify default args for cmd.proxy_checker

1.1.3 (2024-08-12)

1. add morebuiltins.cmd.proxy_checker --max-result for quick return
2. fix morebultins.cmd.log_server lost log in high frequency writing

1.1.2 (2024-08-11)

1. add cmd.proxy_checker
   1. python -m morebuiltins.cmd.proxy_checker -c to check proxy, input from clipboard and output to clipboard
2. add utils.Clipboard as same api as pyperclip

1.1.1 (2024-08-10)

1. add cmd.log_server
2. add start_callback end_callback to ipc.SocketServer
   1. ipc: self.handler(self, item) -> self.handler(item)
3. add RotatingFileWriter.flush, and default flush=False
4. fix StreamWriter.__del__ fails if event loop is already closed

1.1.0 (2024-08-04)

1. update 2024.08.07 zipapps https://github.com/ClericPy/zipapps/releases/tag/2024.08.07
2. add functools.RotatingFileWriter
   1. prepare for log_server with asyncio + ipc.SocketLogHandlerEncoder

1.0.9 (2024-08-04)

1. fix default_dict type-hint
2. fix read num zero div
3. add build_opener_handlers+proxy to request.req

1.0.8 (2024-07-16)

1. add utils.PathLock

1.0.7 (2024-07-15)

1. add functools.file_import

1.0.6 (2024-07-10)

1. fix utils.Validator typing-hint class

1.0.5 (2024-07-09)

1. add add py.typed
2. update utils.Validator default to STRICT=True

1.0.4 (2024-07-04)

1. fix functools.func_cmd multi-line docstring
2. add utils.FileDict

1.0.3 (2024-07-03)

1. add functools.get_type_default
2. add functools.func_cmd
3. add emails.SimpleEmail

1.0.2 (2024-07-01)

1. update utils.unix_rlimit default to None
2. add utils.weight_dict
3. add utils.SimpleFilter

1.0.1 (2024-06-30)

1. functools.FuncSchema.parse default strict=True

1.0.0 (2024-06-29)

1. add tk.TextWindow
2. add utils.unix_rlimit
3. release as the first stable version

0.0.9 (2024-06-26)

1. add tk.TKit.ask_text
2. focus_force for tk.TKit

0.0.8 (2024-06-25)

1. update default format of utils.format_error
2. add functools.SizedTimedRotatingFileHandler
3. add utils.switch_flush_print
4. add tk.TKit

0.0.7 (2024-06-19)

1. add utils.is_running_linux, utils.is_running_win32
2. add functools.InlinePB
3. add date.ScheduleTimer, date.Crontab

0.0.6 (2024-06-19)

1. add utils.xor_encode_decode
2. add utils.is_running, utils.lock_pid_file
3. add request.make_response
4. add utils.get_paste(tk), utils.set_clip(win32)
5. add utils.custom_dns
6. update utils.format_error support slice index