octopize.deploy_tool 2.7.0__tar.gz → 2.7.1__tar.gz

{octopize_deploy_tool-2.7.0 → octopize_deploy_tool-2.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: octopize.deploy_tool
-Version: 2.7.0
+Version: 2.7.1
 Summary: Deployment configuration tool for Octopize Avatar platform
 Project-URL: Homepage, https://octopize.io
 Project-URL: Documentation, https://docs.octopize.io/docs/deploying/self-hosted

{octopize_deploy_tool-2.7.0 → octopize_deploy_tool-2.7.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "octopize.deploy_tool"
-version = "2.7.0"
+version = "2.7.1"
 description = "Deployment configuration tool for Octopize Avatar platform"
 readme = "README.md"
 requires-python = ">=3.13"

{octopize_deploy_tool-2.7.0 → octopize_deploy_tool-2.7.1}/src/octopize_avatar_deploy/__init__.py

@@ -10,7 +10,7 @@ from .version_compat import (
     validate_template_version,
 )
 
-__version__ = "2.7.0"
+__version__ = "2.7.1"
 __all__ = [
     "DeploymentRunner",
     "DeploymentConfigurator",

{octopize_deploy_tool-2.7.0 → octopize_deploy_tool-2.7.1}/src/octopize_avatar_deploy/cli.py

@@ -10,6 +10,7 @@ Commands:
     octopize-deploy-tool deploy [options]
     octopize-deploy-tool generate-env [options]
     octopize-deploy-tool configure [options]
+    octopize-deploy-tool start [options]
     octopize-deploy-tool authentik-migrate [options]
 """
 
@@ -71,6 +72,11 @@ from octopize_avatar_deploy.application.render_command import (
     RenderCommandArgs,
     RenderError,
 )
+from octopize_avatar_deploy.application.start_command import (
+    StartCommand,
+    StartCommandArgs,
+    StartError,
+)
 from octopize_avatar_deploy.authentik_migration import (
     AuthentikClient,
     MigrationParser,
@@ -814,6 +820,39 @@ def _run_migrate(
         )
 
 
+# ---------------------------------------------------------------------------
+# start command (Phase 1 — new versioned workflow)
+# ---------------------------------------------------------------------------
+
+
+def _add_start_cli_args(parser: argparse.ArgumentParser) -> None:
+    """Add CLI arguments for the start command."""
+    parser.add_argument(
+        "--app-root",
+        type=Path,
+        default=Path.cwd(),
+        help="Deployment root directory (default: current directory)",
+    )
+
+
+def _run_start(args: argparse.Namespace, printer: Printer | None) -> None:
+    """Run the start command."""
+    from octopize_avatar_deploy.printer import ConsolePrinter  # noqa: PLC0415
+
+    effective_printer: Printer = printer or ConsolePrinter()
+
+    command = StartCommand(
+        current_version_resolver=FilesystemCurrentVersionResolver(),
+        directory_reader=FilesystemDirectoryReader(),
+        docker_client=_make_docker_client(),
+        printer=effective_printer,
+    )
+
+    start_args = StartCommandArgs(app_root=args.app_root)
+    command.run(start_args)
+    print("\n✓ Start complete — deployment stack is running")  # noqa: T201
+
+
 def _make_docker_client() -> "DockerClient":
     """Construct the Docker client appropriate for the current environment.
 
@@ -1166,6 +1205,17 @@ def _build_parser() -> argparse.ArgumentParser:
     )
     _add_update_cli_args(update_parser)
 
+    start_parser = subparsers.add_parser(
+        "start",
+        help="Create Docker volumes and start the deployment stack",
+        description=(
+            "Create all required external Docker volumes (idempotent) and run "
+            "docker compose start to bring the deployment live. "
+            "Typically run after 'install' or 'apply'."
+        ),
+    )
+    _add_start_cli_args(start_parser)
+
     migrate_parser = subparsers.add_parser(
         "migrate",
         help="Bootstrap versioned layout from a legacy deployment",
@@ -1238,6 +1288,8 @@ def main() -> None:
             _run_update(args, test_printer, test_input_gatherer)
         elif args.command == "migrate":
             _run_migrate(args, test_printer, test_input_gatherer)
+        elif args.command == "start":
+            _run_start(args, test_printer)
         elif args.command == "diff":
             _run_diff(args, test_printer, test_input_gatherer)
         elif args.command == "generate-env":
@@ -1267,6 +1319,9 @@ def main() -> None:
     except MigrateError as e:
         print(f"\n✗ Error: {e}")  # noqa: T201
         sys.exit(1)
+    except StartError as e:
+        print(f"\n✗ Error: {e}")  # noqa: T201
+        sys.exit(1)
     except DiffError as e:
         print(f"\n✗ Error: {e}")  # noqa: T201
         sys.exit(1)