6. add --StandardOutput and --StandardError to morebuiltins.cmd.systemd.service, and update --Environment to list type.

7. add `is_port_free` to `morebuiltins.ipc`.

Author: ClericPy

CHANGELOG.md

@@ -4,6 +4,8 @@
 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)

README.md

@@ -180,6 +180,8 @@ print(morebuiltins.__file__)
 
 4.7 `find_free_port` - Finds and returns an available port number.
 
+4.8 `is_port_free` - Checks if a port is free.
+
 
 ## 5. morebuiltins.request
 

doc.md

@@ -1994,6 +1994,23 @@ True
 ---
 
 
+
+4.8 `is_port_free` - Checks if a port is free.
+
+
+```python
+
+Demo:
+
+>>> is_port_free(12345)
+True
+
+```
+
+
+---
+
+
 ## 5. morebuiltins.request
 
 

morebuiltins/cmd/systemd/service.py

@@ -72,10 +72,17 @@ def create_service_file(args: Dict[str, Any]) -> str:
         "RestartSec",
         "Environment",
         "EnvironmentFile",
+        "StandardOutput",
+        "StandardError",
     ]
     for param in service_params:
-        if args.get(param):
-            content.append(f"{param}={args[param]}")
+        value = args.get(param)
+        if value:
+            if isinstance(value, list):
+                for v in value:
+                    content.append(f"Environment={v}")
+            else:
+                content.append(f"{param}={args[param]}")
 
     content.append("\n[Install]")
     content.append(f"WantedBy={args.get('WantedBy', 'multi-user.target')}")
@@ -157,10 +164,24 @@ def service_handler():
     parser.add_argument(
         "-RestartSec", "--RestartSec", help="Restart interval (seconds)"
     )
-    parser.add_argument("-Environment", "--Environment", help="Environment variables")
+    parser.add_argument(
+        "-Environment", "--Environment", help="Environment variables", action="append"
+    )
     parser.add_argument(
         "-EnvironmentFile", "--EnvironmentFile", help="Environment file"
     )
+    parser.add_argument(
+        "-StandardOutput",
+        "--StandardOutput",
+        help="Standard output, e.g. syslog, journal, append:/tmp/app.log, file:/tmp/app.log",
+        default="",
+    )
+    parser.add_argument(
+        "-StandardError",
+        "--StandardError",
+        help="Standard error, e.g. syslog, journal, append:/tmp/app.log, file:/tmp/app.log",
+        default="",
+    )
 
     # Install section arguments
     parser.add_argument("-WantedBy", "--WantedBy", default="multi-user.target")

morebuiltins/ipc.py

@@ -16,6 +16,7 @@
     "SocketServer",
     "SocketClient",
     "find_free_port",
+    "is_port_free",
 ]
 
 
@@ -367,6 +368,30 @@ def find_free_port(host="127.0.0.1", port=0):
         pass
 
 
+def is_port_free(
+    port: int,
+    host="127.0.0.1",
+    family=socket.AF_INET,
+    type=socket.SOCK_STREAM,
+    timeout=0.1,
+):
+    """Checks if a port is free.
+
+    Demo:
+
+    >>> is_port_free(12345)
+    True
+    """
+    with socket.socket(family=family, type=type) as s:
+        if timeout:
+            s.settimeout(timeout)
+        connected = s.connect_ex((host, port))
+        if connected == 0:
+            return False
+        else:
+            return True
+
+
 async def test_client(host="127.0.0.1", port=8090, encoder=None, cases=None):
     async with SocketClient(host=host, port=port, encoder=encoder) as c:
         for case in cases:
@@ -427,6 +452,10 @@ async def _test_ipc_logging():
 
 
 def test():
+    import doctest
+
+    doctest.testmod()
+
     globals().setdefault("print_log", True)  # local test show logs
     for function in [_test_ipc, _test_ipc_logging]:
         asyncio.run(function())