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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voodoo-framework
-Version: 2.8.1
+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.1 → 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.1"
+__version__ = "2.8.3"
 
 __all__ = [
     # Core runtime

{voodoo_framework-2.8.1 → 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.1 → voodoo_framework-2.8.3}/src/voodoo/ui/__init__.py

@@ -12,6 +12,7 @@ Voodoo::
     Button("Save", on_click=save)
 """
 
+from voodoo.ui.brand import Brand
 from voodoo.ui.component import Component, Html, escape, tone_to_color_var
 from voodoo.ui.events import UIEvent
 from voodoo.ui.interactive import (
@@ -36,7 +37,6 @@ from voodoo.ui.library import (
     BackLink,
     Badge,
     Box,
-    Brand,
     Card,
     ChatBox,
     ChatMessage,

voodoo_framework-2.8.3/src/voodoo/ui/brand.py

@@ -0,0 +1,137 @@
+"""Branding primitives for logos and wordmarks.
+
+``Brand`` preserves the existing child-based API while adding a first-class
+image mode that can switch logo assets with the active light/dark theme.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from voodoo.ui.component import Component
+
+BRAND_CSS = """
+/* Brand image contract */
+.vd-brand-logo {
+    display: block;
+    max-width: 100%;
+    height: auto;
+    border-radius: 0 !important;
+}
+.vd-brand-logo--light { display: block; }
+.vd-brand-logo--dark { display: none; }
+.dark .vd-brand-logo--light { display: none; }
+.dark .vd-brand-logo--dark { display: block; }
+"""
+
+
+class _BrandLogo(Component):
+    """Internal logo image with no generic ``Img`` presentation styles."""
+
+    tag = "img"
+    auto_id = False
+
+    def __init__(
+        self,
+        *,
+        src: str,
+        alt: str,
+        variant: str | None = None,
+        width: str | int | None = None,
+        height: str | int | None = None,
+    ) -> None:
+        classes = "vd-brand-logo"
+        if variant:
+            classes += f" vd-brand-logo--{variant}"
+        super().__init__(class_=classes)
+        self.attrs["src"] = src
+        self.attrs["alt"] = alt
+        if width is not None:
+            self.attrs["width"] = width
+        if height is not None:
+            self.attrs["height"] = height
+
+
+class Brand(Component):
+    """Brand link supporting either child content or theme-aware logo assets.
+
+    Existing usage remains valid::
+
+        Brand("Acme", href="/")
+        Brand(Img(src="/logo.png", alt="Acme"), href="/")
+
+    Image mode keeps branding free of generic image presentation styles and
+    automatically selects the correct asset for the active theme::
+
+        Brand(
+            light="/logo-black.png",
+            dark="/logo-white.png",
+            alt="Acme",
+            width=160,
+            href="/",
+        )
+
+    When only ``light`` or ``dark`` is supplied, that asset is used for both
+    themes. Image mode and explicit children are intentionally mutually
+    exclusive so the rendered brand stays unambiguous.
+    """
+
+    tag = "a"
+    style = "brand"
+
+    def __init__(
+        self,
+        *children: Any,
+        href: str = "/",
+        light: str | None = None,
+        dark: str | None = None,
+        alt: str = "",
+        width: str | int | None = None,
+        height: str | int | None = None,
+        **kwargs: Any,
+    ) -> None:
+        image_mode = light is not None or dark is not None
+        if image_mode and children:
+            raise ValueError(
+                "Brand image mode cannot be combined with child content. "
+                "Use either Brand(...children) or Brand(light=..., dark=...)."
+            )
+
+        super().__init__(*children, **kwargs)
+        self.attrs["href"] = href
+
+        if not image_mode:
+            return
+
+        light_src = light or dark
+        dark_src = dark or light
+        assert light_src is not None
+        assert dark_src is not None
+
+        if light_src == dark_src:
+            self.children = (
+                _BrandLogo(
+                    src=light_src,
+                    alt=alt,
+                    width=width,
+                    height=height,
+                ),
+            )
+            return
+
+        self.children = (
+            _BrandLogo(
+                src=light_src,
+                alt=alt,
+                variant="light",
+                width=width,
+                height=height,
+            ),
+            _BrandLogo(
+                src=dark_src,
+                alt=alt,
+                variant="dark",
+                width=width,
+                height=height,
+            ),
+        )

{voodoo_framework-2.8.1 → voodoo_framework-2.8.3}/src/voodoo/ui/rendering.py

@@ -40,6 +40,7 @@ def render_page(component: Any, seo: Any = None) -> str:
     """Render a complete HTML document for a Voodoo component tree."""
     from voodoo.config import config
     from voodoo.seo import SEO
+    from voodoo.ui.brand import BRAND_CSS
     from voodoo.ui.component import Component
     from voodoo.ui.styles.theme import default_theme
 
@@ -162,6 +163,9 @@ def render_page(component: Any, seo: Any = None) -> str:
             /* Stable primitive component layer */
             {component_css}
 
+            /* Brand asset switching */
+            {BRAND_CSS}
+
             /* Voodoo Design System 3 */
             {design_system_css}
 

{voodoo_framework-2.8.1 → 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.1
+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.1 → 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
@@ -200,6 +201,7 @@ src/voodoo/telemetry/store.py
 src/voodoo/tools/__init__.py
 src/voodoo/tools/registry.py
 src/voodoo/ui/__init__.py
+src/voodoo/ui/brand.py
 src/voodoo/ui/component.py
 src/voodoo/ui/events.py
 src/voodoo/ui/interactive.py
@@ -238,6 +240,7 @@ tests/test_agent_registry.py
 tests/test_agent_runtime.py
 tests/test_app.py
 tests/test_auth.py
+tests/test_brand.py
 tests/test_capability_security.py
 tests/test_checkpoint_resume.py
 tests/test_chrome.py

voodoo_framework-2.8.3/tests/test_brand.py

@@ -0,0 +1,61 @@
+"""Tests for the theme-aware Brand component."""
+
+import pytest
+
+from voodoo.ui import Brand
+from voodoo.ui.brand import BRAND_CSS
+from voodoo.ui.rendering import render_page
+
+
+def test_brand_preserves_child_based_api():
+    html = Brand("Voodoo", href="/home").render()
+
+    assert 'href="/home"' in html
+    assert ">Voodoo</a>" in html
+    assert "vd-brand-logo" not in html
+
+
+def test_brand_renders_theme_specific_assets_without_generic_img_style():
+    html = Brand(
+        light="/logo-black.png",
+        dark="/logo-white.png",
+        alt="Voodoo",
+        width=160,
+        href="/",
+    ).render()
+
+    assert 'src="/logo-black.png"' in html
+    assert 'src="/logo-white.png"' in html
+    assert 'alt="Voodoo"' in html
+    assert 'width="160"' in html
+    assert "vd-brand-logo--light" in html
+    assert "vd-brand-logo--dark" in html
+    assert "vd-img" not in html
+
+
+def test_brand_single_asset_is_shared_by_both_themes():
+    html = Brand(light="/logo.svg", alt="Acme").render()
+
+    assert html.count("<img") == 1
+    assert 'src="/logo.svg"' in html
+    assert "vd-brand-logo--light" not in html
+    assert "vd-brand-logo--dark" not in html
+
+
+def test_brand_rejects_children_in_image_mode():
+    with pytest.raises(ValueError, match="cannot be combined"):
+        Brand("Voodoo", light="/logo.svg")
+
+
+def test_brand_css_switches_assets_and_removes_radius():
+    assert "border-radius: 0 !important" in BRAND_CSS
+    assert ".dark .vd-brand-logo--light { display: none; }" in BRAND_CSS
+    assert ".dark .vd-brand-logo--dark { display: block; }" in BRAND_CSS
+
+
+def test_render_page_includes_brand_css():
+    html = render_page(Brand(light="/logo-black.png", dark="/logo-white.png"))
+
+    assert "/* Brand asset switching */" in html
+    assert ".vd-brand-logo--light" in html
+    assert ".dark .vd-brand-logo--dark" in html

{voodoo_framework-2.8.1 → 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