llama-deploy-appserver 0.4.0__py3-none-any.whl → 0.4.1__py3-none-any.whl

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/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(

{llama_deploy_appserver-0.4.0.dist-info → llama_deploy_appserver-0.4.1.dist-info}/METADATA

@@ -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.dist-info → llama_deploy_appserver-0.4.1.dist-info}/RECORD

@@ -1,5 +1,5 @@
 llama_deploy/appserver/__init__.py,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
-llama_deploy/appserver/app.py,sha256=d1fedfca2b8755f2356d718c5e6cd5be2307954bf967f569a3ab5cd160fdf47d,15246
+llama_deploy/appserver/app.py,sha256=0049778979421d9f35134098122dfb485113342f43e83365d0403b66b4f1c0dc,16305
 llama_deploy/appserver/bootstrap.py,sha256=34724cf3056b653b71d1bedab64dbde221d7c47443a2a41032e767d50168a24b,2581
 llama_deploy/appserver/configure_logging.py,sha256=2431fda77c47d0aef783992b0f01978a3a643768a2e82f10f3c263538f23d800,6361
 llama_deploy/appserver/correlation_id.py,sha256=8ac5bc6160c707b93a9fb818b64dd369a4ef7a53f9f91a6b3d90c4cf446f7327,572
@@ -15,10 +15,10 @@ llama_deploy/appserver/routers/ui_proxy.py,sha256=38f00793a5644c937b1f09af862a63
 llama_deploy/appserver/settings.py,sha256=aa4512d2f1f28b8ee7d3fedc8c61f77bce9f807f85857c0f6282054320c9da23,5124
 llama_deploy/appserver/stats.py,sha256=1f3989f6705a6de3e4d61ee8cdd189fbe04a2c53ec5e720b2e5168acc331427f,691
 llama_deploy/appserver/types.py,sha256=4edc991aafb6b8497f068d12387455df292da3ff8440223637641ab1632553ec,2133
-llama_deploy/appserver/workflow_loader.py,sha256=c1422bda79423528f1f22fe793c9c43cb411dd883a05a80c5a161f04efd9489e,15713
+llama_deploy/appserver/workflow_loader.py,sha256=869c0ed658afc73a3f502ea41154e232ac9ce4482b9899d20ad60df4a79bee3c,16241
 llama_deploy/appserver/workflow_store/agent_data_store.py,sha256=816710c9957c37792ce38e97a2c57cd8079953d55489b445675646ff74b4e13e,7710
 llama_deploy/appserver/workflow_store/keyed_lock.py,sha256=72bcfafbce56d5b36d53aff764b573c2dca2b3f5bc59f2d8baa80be0e4db6e34,1037
 llama_deploy/appserver/workflow_store/lru_cache.py,sha256=10b7d69e4be7d929d9dac009b59635b20fbed4603fb004bc35cbdc3ce538af8b,1454
-llama_deploy_appserver-0.4.0.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
-llama_deploy_appserver-0.4.0.dist-info/METADATA,sha256=41f69121b36ccb0494337a86cf0b83ec247e69ce5c39235cc7c9af0609fff919,1117
-llama_deploy_appserver-0.4.0.dist-info/RECORD,,
+llama_deploy_appserver-0.4.1.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
+llama_deploy_appserver-0.4.1.dist-info/METADATA,sha256=5ac33cfcd59421dc86f5d0ae96feea42a301134c3e7ad677a78b35c820bcc9f4,1117
+llama_deploy_appserver-0.4.1.dist-info/RECORD,,