6. add scripts entry to pyproject.toml for morebuiltins command line tool.

Author: ClericPy

CHANGELOG.md

@@ -9,6 +9,8 @@
    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.

README.md

@@ -39,6 +39,8 @@ ibution.
 
 - Use `pyz`(downloaded from [releases](https://github.com/ClericPy/morebuiltins/releases))
 
+- Use `uvx morebuiltins morebuiltins.cmd.xxx`
+
 ```python
 import sys
 sys.path.insert(0, 'morebuiltins.pyz')

morebuiltins/cmd/bin/_runner.py

@@ -0,0 +1,58 @@
+import sys
+import runpy
+
+# Usage:
+#   python runner.py <module> [args...]
+# Example:
+#   python runner.py morebuiltins.cmd.log_server
+# uvx:
+#   uvx morebuiltins morebuiltins.cmd.log_server
+
+
+import importlib.util
+
+
+def runner(mod_name: str | None = None, argv: list[str] | None = None) -> None:
+    # Read module name and args from command line if not provided
+    if mod_name is None:
+        if len(sys.argv) < 2:
+            print("Usage: python runner.py <module> [args...]")
+            raise SystemExit(2)
+        mod_name = sys.argv[1]
+        argv = sys.argv[2:]
+    if argv is None:
+        argv = []
+
+    # Mimic `python -m <module>` by setting sys.argv
+    orig_argv = sys.argv[:]
+    sys.argv = [mod_name] + argv
+    try:
+        # Prefer private API to replicate `python -m` semantics (incl. package __main__)
+        run_as_main = getattr(runpy, "_run_module_as_main", None)
+        if run_as_main is not None:
+            # We already set sys.argv above; prevent _run_module_as_main from altering it again
+            run_as_main(mod_name, alter_argv=False)
+            return
+
+        # Fallback: manually handle package __main__
+        spec = importlib.util.find_spec(mod_name)
+        if spec is None:
+            raise ModuleNotFoundError(f"No module named '{mod_name}'")
+
+        target = mod_name
+        if spec.submodule_search_locations is not None:
+            # Package: run <pkg>.__main__
+            main_name = f"{mod_name}.__main__"
+            if importlib.util.find_spec(main_name) is None:
+                raise ModuleNotFoundError(f"No module named '{main_name}'")
+            target = main_name
+
+        # Run target module as __main__
+        runpy.run_module(target, run_name="__main__", alter_sys=True)
+    finally:
+        # Restore original argv to avoid side effects
+        sys.argv = orig_argv
+
+
+if __name__ == "__main__":
+    runner()

pyproject.toml

@@ -11,6 +11,7 @@ classifiers = ["License :: OSI Approved :: MIT License"]
 dynamic = ["version"]
 description = "Expanding Python's built-in functionalities to enable richer and more versatile work scenarios."
 requires-python = ">=3.8"
+scripts = {morebuiltins = "morebuiltins.cmd.bin._runner:runner"}
 
 [project.urls]
 Home = "https://github.com/ClericPy/morebuiltins"