llama-deploy-appserver 0.3.19__py3-none-any.whl → 0.3.21__py3-none-any.whl

llama_deploy/appserver/app.py

@@ -165,6 +165,7 @@ def prepare_server(
     deployment_file: Path | None = None,
     install: bool = False,
     build: bool = False,
+    install_ui_deps: bool = True,
 ) -> None:
     configure_settings(
         deployment_file_path=deployment_file or Path(DEFAULT_DEPLOYMENT_FILE_PATH)
@@ -175,7 +176,8 @@ def prepare_server(
     if install:
         config = get_deployment_config()
         inject_appserver_into_target(config, settings.resolved_config_parent)
-        install_ui(config, settings.resolved_config_parent)
+        if install_ui_deps:
+            install_ui(config, settings.resolved_config_parent)
     if build:
         build_ui(settings.resolved_config_parent, get_deployment_config(), settings)
 
@@ -289,17 +291,104 @@ def start_server_in_target_venv(
         raise SystemExit(ret)
 
 
+def start_preflight_in_target_venv(
+    cwd: Path | None = None,
+    deployment_file: Path | None = None,
+) -> None:
+    """
+    Run preflight validation inside the target project's virtual environment using uv.
+    Mirrors the venv targetting and invocation strategy used by start_server_in_target_venv.
+    """
+    configure_settings(
+        app_root=cwd,
+        deployment_file_path=deployment_file or Path(DEFAULT_DEPLOYMENT_FILE_PATH),
+    )
+    base_dir = cwd or Path.cwd()
+    path = settings.resolved_config_parent.relative_to(base_dir)
+    args = [
+        "uv",
+        "run",
+        "--no-progress",
+        "python",
+        "-m",
+        "llama_deploy.appserver.app",
+        "--preflight",
+    ]
+    if deployment_file:
+        args.extend(["--deployment-file", str(deployment_file)])
+
+    ret = run_process(
+        args,
+        cwd=path,
+        env=os.environ.copy(),
+        line_transform=_exclude_venv_warning,
+    )
+    if ret is not None and ret != 0:
+        raise SystemExit(ret)
+
+
+class PreflightValidationError(Exception):
+    """Raised when workflow validations fail during preflight.
+
+    Attributes:
+        errors: List of (workflow/service name, error message)
+    """
+
+    def __init__(self, errors: list[tuple[str, str]]):
+        self.errors = errors
+        error_messages = [f"{name}: {msg}" for name, msg in errors]
+        message = "Workflow validation failed:\n" + "\n".join(error_messages)
+        super().__init__(message)
+
+
+def preflight_validate(
+    cwd: Path | None = None,
+    deployment_file: Path | None = None,
+    configure_logging: bool = False,
+) -> None:
+    """
+    Perform the same initialization path as starting the server, without serving.
+    This catches import errors and runs workflow validations.
+    """
+    configure_settings(
+        app_root=cwd,
+        deployment_file_path=deployment_file or Path(DEFAULT_DEPLOYMENT_FILE_PATH),
+    )
+    cfg = get_deployment_config()
+    load_environment_variables(cfg, settings.resolved_config_parent)
+    validate_required_env_vars(cfg)
+
+    workflows = load_workflows(cfg)
+    # Instantiate Deployment to ensure server wiring doesn't raise
+    _ = Deployment(workflows)
+    # Run workflow-level validations if present
+    errors: list[tuple[str, str]] = []
+    for service_name, workflow in workflows.items():
+        method = getattr(workflow, "_validate", None)
+        if callable(method):
+            try:
+                method()
+            except Exception as exc:
+                errors.append((service_name, str(exc)))
+    if errors:
+        raise PreflightValidationError(errors)
+
+
 if __name__ == "__main__":
     parser = argparse.ArgumentParser()
     parser.add_argument("--proxy-ui", action="store_true")
     parser.add_argument("--reload", action="store_true")
     parser.add_argument("--deployment-file", type=Path)
     parser.add_argument("--open-browser", action="store_true")
+    parser.add_argument("--preflight", action="store_true")
 
     args = parser.parse_args()
-    start_server(
-        proxy_ui=args.proxy_ui,
-        reload=args.reload,
-        deployment_file=args.deployment_file,
-        open_browser=args.open_browser,
-    )
+    if args.preflight:
+        preflight_validate(cwd=Path.cwd(), deployment_file=args.deployment_file)
+    else:
+        start_server(
+            proxy_ui=args.proxy_ui,
+            reload=args.reload,
+            deployment_file=args.deployment_file,
+            open_browser=args.open_browser,
+        )

{llama_deploy_appserver-0.3.19.dist-info → llama_deploy_appserver-0.3.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: llama-deploy-appserver
-Version: 0.3.19
+Version: 0.3.21
 Summary: Application server components for LlamaDeploy
 Author: Massimiliano Pippi, Adrian Lyjak
 Author-email: Massimiliano Pippi <mpippi@gmail.com>, Adrian Lyjak <adrianlyjak@gmail.com>
@@ -9,7 +9,7 @@ Requires-Dist: llama-index-workflows[server]>=2.9.1
 Requires-Dist: pydantic-settings>=2.10.1
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: websockets>=12.0
-Requires-Dist: llama-deploy-core>=0.3.19,<0.4.0
+Requires-Dist: llama-deploy-core>=0.3.21,<0.4.0
 Requires-Dist: httpx>=0.24.0,<1.0.0
 Requires-Dist: prometheus-fastapi-instrumentator>=7.1.0
 Requires-Dist: packaging>=25.0

{llama_deploy_appserver-0.3.19.dist-info → llama_deploy_appserver-0.3.21.dist-info}/RECORD

@@ -1,5 +1,5 @@
 llama_deploy/appserver/__init__.py,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
-llama_deploy/appserver/app.py,sha256=8f45734ee7d3748fefb29d9d8bf987de3fda89834876c32609a72e0bfc8e335b,9694
+llama_deploy/appserver/app.py,sha256=64637dec1504d3a05f68ef2e91472754a8089a227f51948897121c5449bad1d4,12562
 llama_deploy/appserver/bootstrap.py,sha256=d0c7b4ad5bd64aa5070d993b1439006694a639010ae757b1d897680318173743,2573
 llama_deploy/appserver/configure_logging.py,sha256=194dd1ebed3c1d9065d9174f7828d557a577eaac8fb0443b3102430b1f578c19,6329
 llama_deploy/appserver/correlation_id.py,sha256=8ac5bc6160c707b93a9fb818b64dd369a4ef7a53f9f91a6b3d90c4cf446f7327,572
@@ -19,6 +19,6 @@ llama_deploy/appserver/workflow_loader.py,sha256=03ef9d2d5eed6b0ec3e3520a6566163
 llama_deploy/appserver/workflow_store/agent_data_store.py,sha256=c58d84ac658679cb9c9e4c7bc2f4096af8bb1aa8f6e3c24ff5a84be1125f4ab3,4221
 llama_deploy/appserver/workflow_store/keyed_lock.py,sha256=bb1504d9de09d51a8f60721cc77b14d4051ac5a897ace6f9d9cba494f068465e,950
 llama_deploy/appserver/workflow_store/lru_cache.py,sha256=bb05c573cf92532a3e673e5b3d5765c4165bf6f8d985744941580c06ceb3eb2d,1386
-llama_deploy_appserver-0.3.19.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
-llama_deploy_appserver-0.3.19.dist-info/METADATA,sha256=d9eaf5a1bffc3fc66b27530c6c04d91920678840c11aa0fb011eed8a2105ae67,1082
-llama_deploy_appserver-0.3.19.dist-info/RECORD,,
+llama_deploy_appserver-0.3.21.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
+llama_deploy_appserver-0.3.21.dist-info/METADATA,sha256=43196c5c20863487af9d638daa6f9465e736fc92da4237804b81006223eef9e4,1082
+llama_deploy_appserver-0.3.21.dist-info/RECORD,,