smanager 0.2.2__tar.gz → 0.3.0__tar.gz

smanager-0.3.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Pérez Rodríguez
+
+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.

smanager-0.3.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: smanager
+Version: 0.3.0
+Summary: A simple server manager for self-hosted services
+Author: Daniel Pérez Rodríguez
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: InquirerPy>=0.3.4
+Dynamic: license-file
+
+# SManager
+> A simple server manager for self-hosted services, with VPN integration and support for both local and Docker-based services.
+
+When building a self-hosted setup, it’s common to end up with dozens of local services, Docker containers, and maintenance scripts scattered across your system. Tasks as simple as restarting or stopping a service can quickly become frustrating when there’s no clear overview of what is running, how components relate to each other, or how everything is managed.
+
+SManager provides a simple and unified CLI for managing both local and Docker services, with built-in support for VPN integration and interactive metadata management.
+
+Reseting all your music-related services becomes as simple as:
+
+```bash
+smanager group restart music
+```
+
+## Features
+- Unified service management for local/systemd and Docker runtimes.
+- VPN integration (Tailscale provider support).
+- Interactive metadata creation and editing.
+- YAML-based global configuration.
+- Rich service status reporting with optional JSON output.
+
+## CLI Usage
+Use this command pattern:
+
+```bash
+smanager <group> <command> [options]
+```
+
+Discover available commands at any level:
+
+```bash
+smanager --help
+smanager <group> --help
+smanager <group> <command> --help
+```
+
+### Status Commands
+
+Status is now a subcommand under each resource group:
+
+```bash
+smanager service status <service_id>
+smanager group status <group_name>
+smanager dependency status <dependency_name>
+smanager all status
+```
+
+Optional JSON output is available for each status command:
+
+```bash
+smanager service status <service_id> --json
+```
+
+### Info Commands
+
+Info is available under each resource group and shows service name plus WebUI URL:
+
+```bash
+smanager service info <service_id>
+smanager group info <group_name>
+smanager dependency info <dependency_name>
+smanager all info
+```
+
+Use `--details` to include extra operational columns:
+
+```bash
+smanager service info <service_id> --details
+```
+
+## Metadata Commands
+The `metadata` group provides interactive workflows for service metadata files.
+
+### Create Metadata
+```bash
+smanager metadata init
+```
+
+Optional output override:
+
+```bash
+smanager metadata init --output /path/to/sd_info.json
+```
+
+### Edit Existing Metadata
+```bash
+smanager metadata edit
+```
+
+Edit a specific file directly:
+
+```bash
+smanager metadata edit --file /path/to/sd_info.json
+```
+
+Behavior summary:
+- Interactive prompts with inline defaults.
+- Runtime-aware sections (Docker vs Local).
+- Multi-select support for `groups` and `depends_on`.
+- Validation before writing changes.
+
+## Notes
+- `metadata init` creates a new file.
+- `metadata edit` modifies an existing file.
+- Use command-specific `--help` for the latest options and examples.
+

smanager-0.3.0/README.md

@@ -0,0 +1,105 @@
+# SManager
+> A simple server manager for self-hosted services, with VPN integration and support for both local and Docker-based services.
+
+When building a self-hosted setup, it’s common to end up with dozens of local services, Docker containers, and maintenance scripts scattered across your system. Tasks as simple as restarting or stopping a service can quickly become frustrating when there’s no clear overview of what is running, how components relate to each other, or how everything is managed.
+
+SManager provides a simple and unified CLI for managing both local and Docker services, with built-in support for VPN integration and interactive metadata management.
+
+Reseting all your music-related services becomes as simple as:
+
+```bash
+smanager group restart music
+```
+
+## Features
+- Unified service management for local/systemd and Docker runtimes.
+- VPN integration (Tailscale provider support).
+- Interactive metadata creation and editing.
+- YAML-based global configuration.
+- Rich service status reporting with optional JSON output.
+
+## CLI Usage
+Use this command pattern:
+
+```bash
+smanager <group> <command> [options]
+```
+
+Discover available commands at any level:
+
+```bash
+smanager --help
+smanager <group> --help
+smanager <group> <command> --help
+```
+
+### Status Commands
+
+Status is now a subcommand under each resource group:
+
+```bash
+smanager service status <service_id>
+smanager group status <group_name>
+smanager dependency status <dependency_name>
+smanager all status
+```
+
+Optional JSON output is available for each status command:
+
+```bash
+smanager service status <service_id> --json
+```
+
+### Info Commands
+
+Info is available under each resource group and shows service name plus WebUI URL:
+
+```bash
+smanager service info <service_id>
+smanager group info <group_name>
+smanager dependency info <dependency_name>
+smanager all info
+```
+
+Use `--details` to include extra operational columns:
+
+```bash
+smanager service info <service_id> --details
+```
+
+## Metadata Commands
+The `metadata` group provides interactive workflows for service metadata files.
+
+### Create Metadata
+```bash
+smanager metadata init
+```
+
+Optional output override:
+
+```bash
+smanager metadata init --output /path/to/sd_info.json
+```
+
+### Edit Existing Metadata
+```bash
+smanager metadata edit
+```
+
+Edit a specific file directly:
+
+```bash
+smanager metadata edit --file /path/to/sd_info.json
+```
+
+Behavior summary:
+- Interactive prompts with inline defaults.
+- Runtime-aware sections (Docker vs Local).
+- Multi-select support for `groups` and `depends_on`.
+- Validation before writing changes.
+
+## Notes
+- `metadata init` creates a new file.
+- `metadata edit` modifies an existing file.
+- Use command-specific `--help` for the latest options and examples.
+

{smanager-0.2.2 → smanager-0.3.0}/pyproject.toml

@@ -5,6 +5,12 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "smanager"
 dynamic = ["version"]
+authors = [
+    {name = "Daniel Pérez Rodríguez"}
+]
+description = "A simple server manager for self-hosted services"
+readme = "README.md"
+license = "MIT"
 requires-python = ">=3.9"
 dependencies = [
     "PyYAML>=6.0",

{smanager-0.2.2 → smanager-0.3.0}/smanager/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.2.2"
+__version__ = "0.3.0"
 
 from .global_manager import GlobalManager
 from .datatypes import GlobalConfig, Service, ServiceStatus, MultiStatus

smanager-0.3.0/smanager/cli/commands/__init__.py

@@ -0,0 +1,8 @@
+from .service import service_cmd
+from .group import group_cmd
+from .dependency import dependency_cmd
+from .all import all_cmd
+from .config import config_cmd
+from .metadata import metadata_cmd
+
+__all__ = ["service_cmd", "group_cmd", "dependency_cmd", "all_cmd", "config_cmd", "metadata_cmd"]

smanager-0.3.0/smanager/cli/commands/all.py

@@ -0,0 +1,132 @@
+import click
+
+from ..config import get_manager
+from ..events import attach_cli_event_renderer
+from .info import emit_all_info
+from .status import emit_all_status
+
+
+@click.group(name="all")
+@click.pass_context
+def all_cmd(ctx: click.Context) -> None:
+    """Manage all services.
+
+    \b
+    Actions: start, stop, restart, enable, disable, status, info
+
+    Management actions require --yes to prevent accidental execution.
+    """
+
+
+def _run_all_action(ctx: click.Context, action: str, yes: bool) -> None:
+    if not yes:
+        raise click.UsageError(
+            f"This will run '{action}' on ALL services. Pass --yes to confirm."
+        )
+    manager = get_manager(ctx)
+    detach_renderer = attach_cli_event_renderer(manager, command_scope="all")
+    try:
+        manager.manage_all(action)
+    except ValueError as e:
+        raise click.ClickException(str(e))
+    except RuntimeError as e:
+        raise click.ClickException(str(e))
+    finally:
+        detach_renderer()
+
+
+@all_cmd.command(name="start")
+@click.option(
+    "--yes",
+    is_flag=True,
+    default=False,
+    help="Confirm the operation on all services.",
+)
+@click.pass_context
+def all_start(ctx: click.Context, yes: bool) -> None:
+    """Start all managed services.
+
+    Requires --yes to prevent accidental execution.
+    """
+    _run_all_action(ctx, "start", yes)
+
+
+@all_cmd.command(name="stop")
+@click.option(
+    "--yes",
+    is_flag=True,
+    default=False,
+    help="Confirm the operation on all services.",
+)
+@click.pass_context
+def all_stop(ctx: click.Context, yes: bool) -> None:
+    """Stop all managed services.
+
+    Requires --yes to prevent accidental execution.
+    """
+    _run_all_action(ctx, "stop", yes)
+
+
+@all_cmd.command(name="restart")
+@click.option(
+    "--yes",
+    is_flag=True,
+    default=False,
+    help="Confirm the operation on all services.",
+)
+@click.pass_context
+def all_restart(ctx: click.Context, yes: bool) -> None:
+    """Restart all managed services.
+
+    Requires --yes to prevent accidental execution.
+    """
+    _run_all_action(ctx, "restart", yes)
+
+
+@all_cmd.command(name="enable")
+@click.option(
+    "--yes",
+    is_flag=True,
+    default=False,
+    help="Confirm the operation on all services.",
+)
+@click.pass_context
+def all_enable(ctx: click.Context, yes: bool) -> None:
+    """Enable all managed services.
+
+    Requires --yes to prevent accidental execution.
+    """
+    _run_all_action(ctx, "enable", yes)
+
+
+@all_cmd.command(name="disable")
+@click.option(
+    "--yes",
+    is_flag=True,
+    default=False,
+    help="Confirm the operation on all services.",
+)
+@click.pass_context
+def all_disable(ctx: click.Context, yes: bool) -> None:
+    """Disable all managed services.
+
+    Requires --yes to prevent accidental execution.
+    """
+    _run_all_action(ctx, "disable", yes)
+
+
+@all_cmd.command(name="status")
+@click.option("--json", "as_json", is_flag=True, default=False, help="Output as JSON.")
+@click.pass_context
+def all_status(ctx: click.Context, as_json: bool) -> None:
+    """Show status for all managed services."""
+    emit_all_status(ctx, as_json)
+
+
+@all_cmd.command(name="info")
+@click.option("--details", is_flag=True, default=False, help="Include extra metadata columns.")
+@click.option("--json", "as_json", is_flag=True, default=False, help="Output as JSON.")
+@click.pass_context
+def all_info(ctx: click.Context, details: bool, as_json: bool) -> None:
+    """Show info for all managed services."""
+    emit_all_info(ctx, as_json, details)

{smanager-0.2.2 → smanager-0.3.0}/smanager/cli/commands/config.py

@@ -13,7 +13,7 @@ global:
   vpn_provider: "tailscale"
 
   # Filename for service metadata files. Each service should have a metadata file with this name in its directory.
-  metadata_filename: "sd_info.yaml"
+  metadata_filename: "sd_info.json"
 """
 
 

smanager-0.3.0/smanager/cli/commands/dependency.py

@@ -0,0 +1,93 @@
+import click
+
+from ..config import get_manager
+from ..events import attach_cli_event_renderer
+from .info import emit_dependency_info
+from .status import emit_dependency_status
+
+
+@click.group(name="dependency")
+@click.pass_context
+def dependency_cmd(ctx: click.Context) -> None:
+    """Manage services by dependency.
+
+    \b
+    Actions: start, stop, restart, enable, disable, status, info
+    """
+
+
+def _run_dependency_action(ctx: click.Context, action: str, dependency_name: str) -> None:
+    manager = get_manager(ctx)
+    detach_renderer = attach_cli_event_renderer(manager, command_scope="dependency")
+    try:
+        manager.manage_by_dependency(dependency_name, action)
+    except ValueError as e:
+        raise click.ClickException(str(e))
+    except RuntimeError as e:
+        raise click.ClickException(str(e))
+    finally:
+        detach_renderer()
+
+
+@dependency_cmd.command(name="start")
+@click.argument("dependency_name")
+@click.pass_context
+def dependency_start(ctx: click.Context, dependency_name: str) -> None:
+    """Start services that depend on DEPENDENCY_NAME."""
+    _run_dependency_action(ctx, "start", dependency_name)
+
+
+@dependency_cmd.command(name="stop")
+@click.argument("dependency_name")
+@click.pass_context
+def dependency_stop(ctx: click.Context, dependency_name: str) -> None:
+    """Stop services that depend on DEPENDENCY_NAME."""
+    _run_dependency_action(ctx, "stop", dependency_name)
+
+
+@dependency_cmd.command(name="restart")
+@click.argument("dependency_name")
+@click.pass_context
+def dependency_restart(ctx: click.Context, dependency_name: str) -> None:
+    """Restart services that depend on DEPENDENCY_NAME."""
+    _run_dependency_action(ctx, "restart", dependency_name)
+
+
+@dependency_cmd.command(name="enable")
+@click.argument("dependency_name")
+@click.pass_context
+def dependency_enable(ctx: click.Context, dependency_name: str) -> None:
+    """Enable services that depend on DEPENDENCY_NAME."""
+    _run_dependency_action(ctx, "enable", dependency_name)
+
+
+@dependency_cmd.command(name="disable")
+@click.argument("dependency_name")
+@click.pass_context
+def dependency_disable(ctx: click.Context, dependency_name: str) -> None:
+    """Disable services that depend on DEPENDENCY_NAME."""
+    _run_dependency_action(ctx, "disable", dependency_name)
+
+
+@dependency_cmd.command(name="status")
+@click.argument("dependency_name")
+@click.option("--json", "as_json", is_flag=True, default=False, help="Output as JSON.")
+@click.pass_context
+def dependency_status(ctx: click.Context, dependency_name: str, as_json: bool) -> None:
+    """Show status for services by dependency."""
+    emit_dependency_status(ctx, dependency_name, as_json)
+
+
+@dependency_cmd.command(name="info")
+@click.argument("dependency_name")
+@click.option("--details", is_flag=True, default=False, help="Include extra metadata columns.")
+@click.option("--json", "as_json", is_flag=True, default=False, help="Output as JSON.")
+@click.pass_context
+def dependency_info(
+    ctx: click.Context,
+    dependency_name: str,
+    details: bool,
+    as_json: bool,
+) -> None:
+    """Show info for services by dependency."""
+    emit_dependency_info(ctx, dependency_name, as_json, details)

smanager-0.3.0/smanager/cli/commands/group.py

@@ -0,0 +1,88 @@
+import click
+
+from ..config import get_manager
+from ..events import attach_cli_event_renderer
+from .info import emit_group_info
+from .status import emit_group_status
+
+
+@click.group(name="group")
+@click.pass_context
+def group_cmd(ctx: click.Context) -> None:
+    """Manage all services in a group.
+
+    \b
+    Actions: start, stop, restart, enable, disable, status, info
+    """
+
+
+def _run_group_action(ctx: click.Context, action: str, group_name: str) -> None:
+    manager = get_manager(ctx)
+    detach_renderer = attach_cli_event_renderer(manager, command_scope="group")
+    try:
+        manager.manage_group(group_name, action)
+    except ValueError as e:
+        raise click.ClickException(str(e))
+    except RuntimeError as e:
+        raise click.ClickException(str(e))
+    finally:
+        detach_renderer()
+
+
+@group_cmd.command(name="start")
+@click.argument("group_name")
+@click.pass_context
+def group_start(ctx: click.Context, group_name: str) -> None:
+    """Start all services in GROUP_NAME."""
+    _run_group_action(ctx, "start", group_name)
+
+
+@group_cmd.command(name="stop")
+@click.argument("group_name")
+@click.pass_context
+def group_stop(ctx: click.Context, group_name: str) -> None:
+    """Stop all services in GROUP_NAME."""
+    _run_group_action(ctx, "stop", group_name)
+
+
+@group_cmd.command(name="restart")
+@click.argument("group_name")
+@click.pass_context
+def group_restart(ctx: click.Context, group_name: str) -> None:
+    """Restart all services in GROUP_NAME."""
+    _run_group_action(ctx, "restart", group_name)
+
+
+@group_cmd.command(name="enable")
+@click.argument("group_name")
+@click.pass_context
+def group_enable(ctx: click.Context, group_name: str) -> None:
+    """Enable all services in GROUP_NAME."""
+    _run_group_action(ctx, "enable", group_name)
+
+
+@group_cmd.command(name="disable")
+@click.argument("group_name")
+@click.pass_context
+def group_disable(ctx: click.Context, group_name: str) -> None:
+    """Disable all services in GROUP_NAME."""
+    _run_group_action(ctx, "disable", group_name)
+
+
+@group_cmd.command(name="status")
+@click.argument("group_name")
+@click.option("--json", "as_json", is_flag=True, default=False, help="Output as JSON.")
+@click.pass_context
+def group_status(ctx: click.Context, group_name: str, as_json: bool) -> None:
+    """Show status for all services in GROUP_NAME."""
+    emit_group_status(ctx, group_name, as_json)
+
+
+@group_cmd.command(name="info")
+@click.argument("group_name")
+@click.option("--details", is_flag=True, default=False, help="Include extra metadata columns.")
+@click.option("--json", "as_json", is_flag=True, default=False, help="Output as JSON.")
+@click.pass_context
+def group_info(ctx: click.Context, group_name: str, details: bool, as_json: bool) -> None:
+    """Show info for all services in GROUP_NAME."""
+    emit_group_info(ctx, group_name, as_json, details)