llama-deploy-appserver 0.4.0__tar.gz → 0.4.1__tar.gz

{llama_deploy_appserver-0.4.0 → llama_deploy_appserver-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: llama-deploy-appserver
-Version: 0.4.0
+Version: 0.4.1
 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.12.0,<2.13.0
 Requires-Dist: pydantic-settings>=2.10.1
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: websockets>=12.0
-Requires-Dist: llama-deploy-core>=0.4.0,<0.5.0
+Requires-Dist: llama-deploy-core>=0.4.1,<0.5.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.4.0 → llama_deploy_appserver-0.4.1}/pyproject.toml

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

{llama_deploy_appserver-0.4.0 → llama_deploy_appserver-0.4.1}/src/llama_deploy/appserver/app.py

@@ -173,13 +173,14 @@ def prepare_server(
     install: bool = False,
     build: bool = False,
     install_ui_deps: bool = True,
+    skip_env_validation: bool = False,
 ) -> None:
     configure_settings(
         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)
+    validate_required_env_vars(cfg, fill_missing=skip_env_validation)
     if install:
         config = get_deployment_config()
         inject_appserver_into_target(config, settings.resolved_config_parent)
@@ -298,10 +299,16 @@ def start_server_in_target_venv(
 def start_preflight_in_target_venv(
     cwd: Path | None = None,
     deployment_file: Path | None = None,
+    skip_env_validation: bool = False,
 ) -> None:
     """
     Run preflight validation inside the target project's virtual environment using uv.
     Mirrors the venv targeting and invocation strategy used by start_server_in_target_venv.
+
+    Args:
+        cwd: Working directory for the validation.
+        deployment_file: Path to the deployment configuration file.
+        skip_env_validation: If True, skip validation of required environment variables.
     """
     configure_settings(
         app_root=cwd,
@@ -320,6 +327,8 @@ def start_preflight_in_target_venv(
     ]
     if deployment_file:
         args.extend(["--deployment-file", str(deployment_file)])
+    if skip_env_validation:
+        args.append("--skip-env-validation")
 
     run_process(
         args,
@@ -386,10 +395,19 @@ def preflight_validate(
     cwd: Path | None = None,
     deployment_file: Path | None = None,
     configure_logging: bool = False,
+    skip_env_validation: bool = False,
 ) -> None:
     """
     Perform the same initialization path as starting the server, without serving.
     This catches import errors and runs workflow validations.
+
+    Args:
+        cwd: Working directory for the validation.
+        deployment_file: Path to the deployment configuration file.
+        configure_logging: Whether to configure logging.
+        skip_env_validation: If True, fill missing required env vars with placeholder
+            values instead of raising an error. Useful when validating workflow structure
+            without actual environment variable values.
     """
     configure_settings(
         app_root=cwd,
@@ -397,7 +415,7 @@ def preflight_validate(
     )
     cfg = get_deployment_config()
     load_environment_variables(cfg, settings.resolved_config_parent)
-    validate_required_env_vars(cfg)
+    validate_required_env_vars(cfg, fill_missing=skip_env_validation)
 
     workflows = load_workflows(cfg)
     # Instantiate Deployment to ensure server wiring doesn't raise
@@ -454,12 +472,17 @@ if __name__ == "__main__":
     parser.add_argument("--deployment-file", type=Path)
     parser.add_argument("--open-browser", action="store_true")
     parser.add_argument("--preflight", action="store_true")
+    parser.add_argument("--skip-env-validation", action="store_true")
     parser.add_argument("--export-json-graph", action="store_true")
     parser.add_argument("--export-output", type=Path)
 
     args = parser.parse_args()
     if args.preflight:
-        preflight_validate(cwd=Path.cwd(), deployment_file=args.deployment_file)
+        preflight_validate(
+            cwd=Path.cwd(),
+            deployment_file=args.deployment_file,
+            skip_env_validation=args.skip_env_validation,
+        )
     elif args.export_json_graph:
         export_json_graph(
             cwd=Path.cwd(),

{llama_deploy_appserver-0.4.0 → llama_deploy_appserver-0.4.1}/src/llama_deploy/appserver/workflow_loader.py

@@ -73,25 +73,37 @@ def load_environment_variables(config: DeploymentConfig, source_root: Path) -> N
             os.environ[key] = value
 
 
-def validate_required_env_vars(config: DeploymentConfig) -> None:
+def validate_required_env_vars(
+    config: DeploymentConfig, *, fill_missing: bool = False
+) -> None:
     """
     Validate that all required environment variables are present and non-empty.
 
+    Args:
+        config: The deployment configuration containing required_env_vars.
+        fill_missing: If True, fill missing env vars with placeholder values instead
+            of raising an error. This is useful for validation where env vars may be
+            read statically during import time.
+
     Raises:
-        RuntimeError: If any required env vars are missing or empty.
+        RuntimeError: If any required env vars are missing or empty and fill_missing is False.
     """
     required = config.required_env_vars
     if not required:
         return
     missing = [name for name in required if not os.environ.get(name)]
     if missing:
-        missing_list = ", ".join(sorted(missing))
-        raise RuntimeError(
-            (
-                "Missing required environment variables defined in required_env_vars: "
-                f"{missing_list}. Provide them via your environment, .env files, or the deployment secrets."
+        if fill_missing:
+            for name in missing:
+                os.environ[name] = f"__PLACEHOLDER_{name}__"
+        else:
+            missing_list = ", ".join(sorted(missing))
+            raise RuntimeError(
+                (
+                    "Missing required environment variables defined in required_env_vars: "
+                    f"{missing_list}. Provide them via your environment, .env files, or the deployment secrets."
+                )
             )
-        )
 
 
 def parse_environment_variables(