voodoo-framework 2.8.2__tar.gz → 2.8.3__tar.gz

{voodoo_framework-2.8.2 → voodoo_framework-2.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voodoo-framework
-Version: 2.8.2
+Version: 2.8.3
 Summary: The programmable runtime for adaptive applications and operational systems — web, APIs, agents, workers, human workflows, distributed systems, and physical systems in one runtime.
 Author-email: Helder Perez <contact@helderperez.com>
 Maintainer-email: Helder Perez <contact@helderperez.com>

{voodoo_framework-2.8.2 → voodoo_framework-2.8.3}/src/voodoo/__init__.py

@@ -105,7 +105,7 @@ from .ui.styles import (
 from .ui.styles.theme import Theme, ThemeColors, create_theme
 from .workers import task
 
-__version__ = "2.8.2"
+__version__ = "2.8.3"
 
 __all__ = [
     # Core runtime

{voodoo_framework-2.8.2 → voodoo_framework-2.8.3}/src/voodoo/cli/__init__.py

@@ -16,6 +16,7 @@ from voodoo.cli import (
     recover,
     routes,
     schedules,
+    start,
     status,
     tasks,
     theme,
@@ -36,6 +37,7 @@ app = typer.Typer(
 app.command()(new.new)
 app.command()(create.create)
 app.command()(dev.dev)
+app.command()(start.start)
 app.command()(generate.generate)
 app.add_typer(auth_app, name="auth")
 app.add_typer(ai.ai_app, name="ai")

voodoo_framework-2.8.3/src/voodoo/cli/start.py

@@ -0,0 +1,55 @@
+"""Production server command for Voodoo applications."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+import typer
+
+__all__ = ["start"]
+
+
+def start(
+    app_str: str | None = typer.Argument(
+        None,
+        help="App instance to run. Defaults to main:app or voodoo.core:app.",
+    ),
+    host: str | None = typer.Option(
+        None,
+        help="Host to bind to. Defaults to VOODOO_HOST or 0.0.0.0.",
+    ),
+    port: int | None = typer.Option(
+        None,
+        help="Port to bind to. Defaults to PORT, VOODOO_PORT, or 8000.",
+    ),
+) -> None:
+    """Start a Voodoo application in production mode."""
+    if app_str is None:
+        app_str = "main:app" if Path("main.py").exists() else "voodoo.core:app"
+
+    resolved_host = host or os.getenv("VOODOO_HOST") or "0.0.0.0"
+    configured_port = os.getenv("PORT") or os.getenv("VOODOO_PORT") or "8000"
+    resolved_port = port if port is not None else int(configured_port)
+
+    # Production should be the safe default for this command while still
+    # allowing an explicitly configured environment to win.
+    os.environ.setdefault("VOODOO_ENV", "production")
+    os.environ.setdefault("WEBSOCKETS_MAX_LINE_LENGTH", "8388608")
+    os.environ.setdefault("WEBSOCKETS_MAX_NUM_HEADERS", "256")
+
+    import uvicorn
+
+    uvicorn.run(
+        app_str,
+        host=resolved_host,
+        port=resolved_port,
+        # One process owns one live local Store writer. Horizontal scaling uses
+        # separate Voodoo Nodes with node-local Stores.
+        workers=1,
+        proxy_headers=True,
+        forwarded_allow_ips=os.getenv("FORWARDED_ALLOW_IPS", "127.0.0.1"),
+        http="h11",
+        ws="websockets",
+        h11_max_incomplete_event_size=5_242_880,
+    )

{voodoo_framework-2.8.2 → voodoo_framework-2.8.3}/src/voodoo_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voodoo-framework
-Version: 2.8.2
+Version: 2.8.3
 Summary: The programmable runtime for adaptive applications and operational systems — web, APIs, agents, workers, human workflows, distributed systems, and physical systems in one runtime.
 Author-email: Helder Perez <contact@helderperez.com>
 Maintainer-email: Helder Perez <contact@helderperez.com>

{voodoo_framework-2.8.2 → voodoo_framework-2.8.3}/src/voodoo_framework.egg-info/SOURCES.txt

@@ -60,6 +60,7 @@ src/voodoo/cli/recover.py
 src/voodoo/cli/routes.py
 src/voodoo/cli/scaffolding.py
 src/voodoo/cli/schedules.py
+src/voodoo/cli/start.py
 src/voodoo/cli/status.py
 src/voodoo/cli/tasks.py
 src/voodoo/cli/terminal.py

{voodoo_framework-2.8.2 → voodoo_framework-2.8.3}/tests/test_cli.py

@@ -335,3 +335,97 @@ def test_cli_dev_does_not_leak_pythonpath(tmp_path: Path, monkeypatch):
 
     assert result.exit_code == 0
     assert "PYTHONPATH" not in captured
+
+
+def test_cli_start_uses_safe_production_defaults(
+    tmp_path: Path,
+    monkeypatch,
+):
+    """start should discover main.py and preserve Store-safe server defaults."""
+    monkeypatch.chdir(tmp_path)
+    (tmp_path / "main.py").write_text("app = object()\n")
+    for name in (
+        "VOODOO_ENV",
+        "VOODOO_HOST",
+        "VOODOO_PORT",
+        "PORT",
+        "FORWARDED_ALLOW_IPS",
+        "WEBSOCKETS_MAX_LINE_LENGTH",
+        "WEBSOCKETS_MAX_NUM_HEADERS",
+    ):
+        monkeypatch.delenv(name, raising=False)
+
+    with patch("uvicorn.run") as run:
+        result = runner.invoke(app, ["start"])
+
+    assert result.exit_code == 0
+    run.assert_called_once_with(
+        "main:app",
+        host="0.0.0.0",
+        port=8000,
+        workers=1,
+        proxy_headers=True,
+        forwarded_allow_ips="127.0.0.1",
+        http="h11",
+        ws="websockets",
+        h11_max_incomplete_event_size=5_242_880,
+    )
+    assert os.environ["VOODOO_ENV"] == "production"
+    assert os.environ["WEBSOCKETS_MAX_LINE_LENGTH"] == "8388608"
+    assert os.environ["WEBSOCKETS_MAX_NUM_HEADERS"] == "256"
+
+
+def test_cli_start_respects_explicit_configuration(
+    tmp_path: Path,
+    monkeypatch,
+):
+    """CLI arguments and explicit environment settings should remain authoritative."""
+    monkeypatch.chdir(tmp_path)
+    monkeypatch.setenv("VOODOO_ENV", "staging")
+    monkeypatch.setenv("VOODOO_HOST", "127.0.0.2")
+    monkeypatch.setenv("PORT", "9100")
+    monkeypatch.setenv("FORWARDED_ALLOW_IPS", "10.0.0.0/8")
+
+    with patch("uvicorn.run") as run:
+        result = runner.invoke(
+            app,
+            [
+                "start",
+                "custom.application:app",
+                "--host",
+                "127.0.0.3",
+                "--port",
+                "9200",
+            ],
+        )
+
+    assert result.exit_code == 0
+    call = run.call_args
+    assert call.args == ("custom.application:app",)
+    assert call.kwargs["host"] == "127.0.0.3"
+    assert call.kwargs["port"] == 9200
+    assert call.kwargs["forwarded_allow_ips"] == "10.0.0.0/8"
+    assert call.kwargs["workers"] == 1
+    assert os.environ["VOODOO_ENV"] == "staging"
+
+
+def test_cli_start_falls_back_to_folder_routing_app(
+    tmp_path: Path,
+    monkeypatch,
+):
+    """Projects without main.py should use the folder-routing application."""
+    monkeypatch.chdir(tmp_path)
+
+    with patch("uvicorn.run") as run:
+        result = runner.invoke(app, ["start"])
+
+    assert result.exit_code == 0
+    assert run.call_args.args == ("voodoo.core:app",)
+
+
+def test_cli_start_does_not_offer_unsafe_multi_worker_mode():
+    """One local Store writer means the production command has no workers option."""
+    result = runner.invoke(app, ["start", "--workers", "2"])
+
+    assert result.exit_code != 0
+    assert "No such option" in result.output