llama-deploy-appserver 0.3.20__tar.gz → 0.3.22__tar.gz

{llama_deploy_appserver-0.3.20 → llama_deploy_appserver-0.3.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: llama-deploy-appserver
-Version: 0.3.20
+Version: 0.3.22
 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.20,<0.4.0
+Requires-Dist: llama-deploy-core>=0.3.22,<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.20 → llama_deploy_appserver-0.3.22}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "llama-deploy-appserver"
-version = "0.3.20"
+version = "0.3.22"
 description = "Application server components for LlamaDeploy"
 readme = "README.md"
 license = { text = "MIT" }
@@ -14,7 +14,7 @@ dependencies = [
     "pydantic-settings>=2.10.1",
     "fastapi>=0.100.0",
     "websockets>=12.0",
-    "llama-deploy-core>=0.3.20,<0.4.0",
+    "llama-deploy-core>=0.3.22,<0.4.0",
     "httpx>=0.24.0,<1.0.0",
     "prometheus-fastapi-instrumentator>=7.1.0",
     "packaging>=25.0",

{llama_deploy_appserver-0.3.20 → llama_deploy_appserver-0.3.22}/src/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,
+        )