py-simple-service-manager 0.1.0__tar.gz

py_simple_service_manager-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GGN_2015
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

py_simple_service_manager-0.1.0/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: py-simple-service-manager
+Version: 0.1.0
+Summary: Cross-platform command-as-service manager for Windows, Linux systemd, and macOS launchd.
+Author: GGN_2015
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: System :: Boot
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: admin
+Requires-Dist: py-admin-launch>=0.1.3; extra == "admin"
+Dynamic: license-file
+
+# py-simple-service-manager
+
+`py-simple-service-manager` lets you manage a one-line command as a service on
+Linux, Windows, and macOS.
+
+The same Python runner handles command execution, retry attempts, status files,
+and stdout/stderr logs. Platform backends only register and control the runner:
+
+- Linux: `systemd` units controlled by `systemctl`
+- Windows: Task Scheduler tasks controlled by `schtasks` and PowerShell
+- macOS: `launchd` agents/daemons controlled by `launchctl`
+
+## Install
+
+```bash
+python -m pip install -e .
+```
+
+Optional administrator relaunch support:
+
+```bash
+python -m pip install -e ".[admin]"
+```
+
+The `admin` extra uses
+[`py-admin-launch`](https://pypi.org/project/py-admin-launch/) for Windows UAC,
+Linux `pkexec`/`sudo`, and macOS `osascript`/`sudo`.
+
+## Startup modes
+
+- `manual`: do not start at boot.
+- `auto`: start once at boot after network components are available.
+- `auto-retry`: start at boot and retry after `K` seconds up to `N` times when
+  the command exits with a non-zero code.
+
+The retry count is handled by this package's runner, so it works consistently
+across all supported platforms.
+
+`pssm logs` and the GUI log tabs read the current log files, not only completed
+runs. The runner flushes stdout/stderr to disk as bytes arrive, and Python
+commands are launched with unbuffered output automatically.
+
+## Usage
+
+Register a manual service:
+
+```bash
+pssm add api -- python -m http.server 9000
+```
+
+Register a boot service:
+
+```bash
+pssm --scope system --elevate add api --mode auto -- python -m http.server 9000
+```
+
+Register a boot service with retry:
+
+```bash
+pssm --scope system --elevate add worker --mode auto-retry --retry-delay 10 --retry-limit 5 -- python worker.py
+```
+
+Change startup mode later:
+
+```bash
+pssm mode worker manual
+pssm --scope system --elevate mode worker auto-retry --retry-delay 10 --retry-limit 5
+```
+
+Inspect and control services:
+
+```bash
+pssm list
+pssm status worker
+pssm logs worker
+pssm logs worker --stream stderr --lines 100
+pssm start worker
+pssm stop worker --force
+pssm remove worker
+```
+
+Edit the same fields exposed by the GUI:
+
+```bash
+pssm edit worker --command "python worker.py --queue default" --cwd /path/to/app
+pssm edit worker --mode auto-retry --retry-delay 10 --retry-limit 5
+pssm edit worker --clear-cwd
+```
+
+Open the GUI:
+
+```bash
+pssm gui
+pssm-gui
+```
+
+The GUI supports listing services, creating services, editing command/startup
+mode/retry settings/working directory, deleting services, starting and stopping
+services, and viewing stdout/stderr. Anything the GUI can change is also
+available through the CLI.
+
+Show storage paths and platform details:
+
+```bash
+pssm doctor
+```
+
+`--scope` can be `user`, `system`, or `auto`. `auto` uses `system` when the
+current process is already elevated, otherwise `user`.
+
+## Platform notes
+
+### Linux
+
+Linux requires `systemd` and `systemctl`.
+
+- User scope writes units to `~/.config/systemd/user`.
+- System scope writes units to `/etc/systemd/system`.
+- Boot startup uses `network-online.target` with `Wants=` and `After=`.
+
+For user units that should survive logout, enable lingering outside this tool:
+
+```bash
+loginctl enable-linger "$USER"
+```
+
+### Windows
+
+Windows uses Task Scheduler.
+
+- Manual services can be registered in user scope.
+- Boot startup requires system scope and elevation:
+
+```bash
+pssm --scope system --elevate add name --mode auto -- your-command
+```
+
+System-scope tasks run as `SYSTEM` with highest available privileges. Make sure
+the command and Python environment are available to that account.
+
+### macOS
+
+macOS uses `launchd`.
+
+- User scope writes LaunchAgents to `~/Library/LaunchAgents`.
+- System scope writes LaunchDaemons to `/Library/LaunchDaemons`.
+- Boot startup maps to `RunAtLoad=true`.
+
+## Development
+
+Run tests from source:
+
+```bash
+PYTHONPATH=src python -m unittest discover -s tests -v
+```
+
+On Windows PowerShell:
+
+```powershell
+$env:PYTHONPATH = "src"
+python -m unittest discover -s tests -v
+```

py_simple_service_manager-0.1.0/README.md

@@ -0,0 +1,162 @@
+# py-simple-service-manager
+
+`py-simple-service-manager` lets you manage a one-line command as a service on
+Linux, Windows, and macOS.
+
+The same Python runner handles command execution, retry attempts, status files,
+and stdout/stderr logs. Platform backends only register and control the runner:
+
+- Linux: `systemd` units controlled by `systemctl`
+- Windows: Task Scheduler tasks controlled by `schtasks` and PowerShell
+- macOS: `launchd` agents/daemons controlled by `launchctl`
+
+## Install
+
+```bash
+python -m pip install -e .
+```
+
+Optional administrator relaunch support:
+
+```bash
+python -m pip install -e ".[admin]"
+```
+
+The `admin` extra uses
+[`py-admin-launch`](https://pypi.org/project/py-admin-launch/) for Windows UAC,
+Linux `pkexec`/`sudo`, and macOS `osascript`/`sudo`.
+
+## Startup modes
+
+- `manual`: do not start at boot.
+- `auto`: start once at boot after network components are available.
+- `auto-retry`: start at boot and retry after `K` seconds up to `N` times when
+  the command exits with a non-zero code.
+
+The retry count is handled by this package's runner, so it works consistently
+across all supported platforms.
+
+`pssm logs` and the GUI log tabs read the current log files, not only completed
+runs. The runner flushes stdout/stderr to disk as bytes arrive, and Python
+commands are launched with unbuffered output automatically.
+
+## Usage
+
+Register a manual service:
+
+```bash
+pssm add api -- python -m http.server 9000
+```
+
+Register a boot service:
+
+```bash
+pssm --scope system --elevate add api --mode auto -- python -m http.server 9000
+```
+
+Register a boot service with retry:
+
+```bash
+pssm --scope system --elevate add worker --mode auto-retry --retry-delay 10 --retry-limit 5 -- python worker.py
+```
+
+Change startup mode later:
+
+```bash
+pssm mode worker manual
+pssm --scope system --elevate mode worker auto-retry --retry-delay 10 --retry-limit 5
+```
+
+Inspect and control services:
+
+```bash
+pssm list
+pssm status worker
+pssm logs worker
+pssm logs worker --stream stderr --lines 100
+pssm start worker
+pssm stop worker --force
+pssm remove worker
+```
+
+Edit the same fields exposed by the GUI:
+
+```bash
+pssm edit worker --command "python worker.py --queue default" --cwd /path/to/app
+pssm edit worker --mode auto-retry --retry-delay 10 --retry-limit 5
+pssm edit worker --clear-cwd
+```
+
+Open the GUI:
+
+```bash
+pssm gui
+pssm-gui
+```
+
+The GUI supports listing services, creating services, editing command/startup
+mode/retry settings/working directory, deleting services, starting and stopping
+services, and viewing stdout/stderr. Anything the GUI can change is also
+available through the CLI.
+
+Show storage paths and platform details:
+
+```bash
+pssm doctor
+```
+
+`--scope` can be `user`, `system`, or `auto`. `auto` uses `system` when the
+current process is already elevated, otherwise `user`.
+
+## Platform notes
+
+### Linux
+
+Linux requires `systemd` and `systemctl`.
+
+- User scope writes units to `~/.config/systemd/user`.
+- System scope writes units to `/etc/systemd/system`.
+- Boot startup uses `network-online.target` with `Wants=` and `After=`.
+
+For user units that should survive logout, enable lingering outside this tool:
+
+```bash
+loginctl enable-linger "$USER"
+```
+
+### Windows
+
+Windows uses Task Scheduler.
+
+- Manual services can be registered in user scope.
+- Boot startup requires system scope and elevation:
+
+```bash
+pssm --scope system --elevate add name --mode auto -- your-command
+```
+
+System-scope tasks run as `SYSTEM` with highest available privileges. Make sure
+the command and Python environment are available to that account.
+
+### macOS
+
+macOS uses `launchd`.
+
+- User scope writes LaunchAgents to `~/Library/LaunchAgents`.
+- System scope writes LaunchDaemons to `/Library/LaunchDaemons`.
+- Boot startup maps to `RunAtLoad=true`.
+
+## Development
+
+Run tests from source:
+
+```bash
+PYTHONPATH=src python -m unittest discover -s tests -v
+```
+
+On Windows PowerShell:
+
+```powershell
+$env:PYTHONPATH = "src"
+python -m unittest discover -s tests -v
+```

py_simple_service_manager-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "py-simple-service-manager"
+version = "0.1.0"
+description = "Cross-platform command-as-service manager for Windows, Linux systemd, and macOS launchd."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "GGN_2015" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: System :: Boot",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+]
+dependencies = []
+
+[project.optional-dependencies]
+admin = ["py-admin-launch>=0.1.3"]
+
+[project.scripts]
+pssm = "py_simple_service_manager.cli:main"
+py-simple-service-manager = "py_simple_service_manager.cli:main"
+pssm-gui = "py_simple_service_manager.gui:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

py_simple_service_manager-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

py_simple_service_manager-0.1.0/src/py_simple_service_manager/__init__.py

@@ -0,0 +1,6 @@
+"""Cross-platform command-as-service manager."""
+
+from .models import ServiceConfig, StartupMode
+
+__all__ = ["ServiceConfig", "StartupMode"]
+__version__ = "0.1.0"

py_simple_service_manager-0.1.0/src/py_simple_service_manager/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

py_simple_service_manager-0.1.0/src/py_simple_service_manager/admin.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+import os
+import sys
+from typing import Sequence
+
+from .paths import is_admin
+
+
+def relaunch_with_admin(argv: Sequence[str]) -> int:
+    if is_admin():
+        return -1
+    try:
+        from py_admin_launch import launch
+    except ImportError as exc:
+        raise RuntimeError(
+            "admin relaunch requires py-admin-launch; install with "
+            "'pip install py-simple-service-manager[admin]'"
+        ) from exc
+    result = launch([sys.executable, "-m", "py_simple_service_manager", *argv], cwd=os.getcwd(), wait=True)
+    return int(result.returncode or 0)

py_simple_service_manager-0.1.0/src/py_simple_service_manager/bootstrap.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from .paths import AppLayout
+
+
+def bootstrap_path(layout: AppLayout, name: str) -> Path:
+    return layout.generated_dir / f"{name}-runner.py"
+
+
+def write_runner_bootstrap(layout: AppLayout, name: str) -> Path:
+    path = bootstrap_path(layout, name)
+    package_parent = Path(__file__).resolve().parent.parent
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(
+        "\n".join(
+            [
+                "from __future__ import annotations",
+                "",
+                "import sys",
+                "",
+                f"sys.path.insert(0, {ascii(str(package_parent))})",
+                "from py_simple_service_manager.runner import main",
+                "",
+                "if __name__ == '__main__':",
+                "    raise SystemExit(main())",
+                "",
+            ]
+        ),
+        encoding="utf-8",
+    )
+    return path
+
+
+def delete_runner_bootstrap(layout: AppLayout, name: str) -> None:
+    path = bootstrap_path(layout, name)
+    if path.exists():
+        path.unlink()