llama-deploy-core 0.2.7a1__py3-none-any.whl → 0.3.0__py3-none-any.whl

llama_deploy/core/server/manage_api/_abstract_deployments_service.py

@@ -0,0 +1,165 @@
+from abc import ABC, abstractmethod
+from typing import AsyncGenerator, cast
+
+from llama_deploy.core import schema
+from llama_deploy.core.schema import LogEvent
+from llama_deploy.core.schema.deployments import DeploymentResponse
+
+
+class AbstractPublicDeploymentsService(ABC):
+    @abstractmethod
+    async def get_version(self) -> schema.VersionResponse:
+        """
+        Get the version of the server
+        """
+        ...
+
+
+class AbstractDeploymentsService(ABC):
+    @abstractmethod
+    async def get_projects(self) -> schema.ProjectsListResponse:
+        """
+        Get a list of projects
+        """
+        ...
+
+    @abstractmethod
+    async def validate_repository(
+        self,
+        project_id: str,
+        request: schema.RepositoryValidationRequest,
+    ) -> schema.RepositoryValidationResponse:
+        """
+        Validate repository access and return unified response.
+        """
+        ...
+
+    @abstractmethod
+    async def create_deployment(
+        self,
+        project_id: str,
+        deployment_data: schema.DeploymentCreate,
+    ) -> DeploymentResponse:
+        """
+        Create a new deployment
+
+        Args:
+            project_id: The ID of the project to create the deployment in
+            deployment_data: The data for the deployment
+
+        Returns:
+            The created deployment
+        Raises:
+            DeploymentNotFoundError: If the deployment ID is not found
+        """
+        ...
+
+    @abstractmethod
+    async def get_deployments(
+        self,
+        project_id: str,
+    ) -> schema.DeploymentsListResponse:
+        """
+        Get a list of deployments for a project
+
+        Args:
+            project_id: The ID of the project to get the deployments for
+
+        Returns:
+            A list of deployments
+        """
+        ...
+
+    @abstractmethod
+    async def get_deployment(
+        self,
+        project_id: str,
+        deployment_id: str,
+        include_events: bool = False,
+    ) -> schema.DeploymentResponse | None:
+        """
+        Get a deployment by ID
+
+        Args:
+            project_id: The ID of the project to get the deployment for
+            deployment_id: The ID of the deployment to get
+            include_events: Whether to include events in the response
+
+        Returns:
+            The deployment
+        Raises:
+            DeploymentNotFoundError: If the deployment ID is not found
+        """
+        ...
+
+    @abstractmethod
+    async def delete_deployment(
+        self,
+        project_id: str,
+        deployment_id: str,
+    ) -> None:
+        """
+        Delete a deployment
+
+        Args:
+            project_id: The ID of the project to delete the deployment from
+            deployment_id: The ID of the deployment to delete
+
+        Returns:
+            None
+        Raises:
+            DeploymentNotFoundError: If the deployment ID is not found
+        """
+        ...
+
+    @abstractmethod
+    async def update_deployment(
+        self,
+        project_id: str,
+        deployment_id: str,
+        update_data: schema.DeploymentUpdate,
+    ) -> DeploymentResponse:
+        """
+        Update a deployment
+
+        Args:
+            project_id: The ID of the project to update the deployment in
+            deployment_id: The ID of the deployment to update
+            update_data: The data to update the deployment with
+
+        Returns:
+            The updated deployment
+        Raises:
+            DeploymentNotFoundError: If the deployment ID is not found
+        """
+        ...
+
+    @abstractmethod
+    async def stream_deployment_logs(
+        self,
+        project_id: str,
+        deployment_id: str,
+        include_init_containers: bool = False,
+        since_seconds: int | None = None,
+        tail_lines: int | None = None,
+    ) -> AsyncGenerator[LogEvent, None]:
+        """
+        Stream the logs for a deployment
+
+        Args:
+            project_id: The ID of the project to stream the logs for
+            deployment_id: The ID of the deployment to stream the logs for
+            include_init_containers: Whether to include init containers in the logs
+            since_seconds: The number of seconds to stream the logs for
+            tail_lines: The number of lines to stream the logs for
+
+        Returns:
+            A generator of log events
+        Raises:
+            DeploymentNotFoundError: If the deployment ID is not found
+        """
+        # This method is abstract. The following unreachable code ensures type
+        # checkers treat it as an async generator, so call sites can `async for`.
+        raise NotImplementedError
+        if False:
+            yield cast(LogEvent, None)

llama_deploy/core/server/manage_api/_create_deployments_router.py

@@ -0,0 +1,188 @@
+import logging
+from typing import Awaitable, Callable
+
+from fastapi import APIRouter, Depends, HTTPException, Request, Response, params
+from fastapi.params import Query
+from fastapi.responses import StreamingResponse
+from llama_deploy.core import schema
+from typing_extensions import Annotated
+
+from ._abstract_deployments_service import (
+    AbstractDeploymentsService,
+    AbstractPublicDeploymentsService,
+)
+from ._exceptions import DeploymentNotFoundError, ReplicaSetNotFoundError
+
+logger = logging.getLogger(__name__)
+
+
+async def get_project_id(project_id: Annotated[str, Query()]) -> str:
+    return project_id
+
+
+def create_v1beta1_deployments_router(
+    deployments_service: AbstractDeploymentsService,
+    public_service: AbstractPublicDeploymentsService,
+    get_project_id: Callable[..., Awaitable[str]] = get_project_id,
+    dependencies: list[params.Depends] | None = None,
+    public_dependencies: list[params.Depends] | None = None,
+    include_in_schema: bool = True,
+) -> APIRouter:
+    base_router = APIRouter(prefix="/api/v1beta1", include_in_schema=include_in_schema)
+    public_router = APIRouter(
+        tags=["v1beta1-deployments-public"],
+        dependencies=public_dependencies,
+        include_in_schema=include_in_schema,
+    )
+    router = APIRouter(
+        tags=["v1beta1-deployments"],
+        dependencies=dependencies,
+        include_in_schema=include_in_schema,
+    )
+
+    @public_router.get("/version")
+    async def get_version() -> schema.VersionResponse:
+        return await public_service.get_version()
+
+    @router.get("/list-projects")
+    async def get_projects() -> schema.ProjectsListResponse:
+        """Get all unique projects with their deployment counts"""
+        return await deployments_service.get_projects()
+
+    @router.post("/validate-repository")
+    async def validate_repository(
+        project_id: Annotated[str, Depends(get_project_id)],
+        request: schema.RepositoryValidationRequest,
+    ) -> schema.RepositoryValidationResponse:
+        """Validate repository access and return unified response."""
+        return await deployments_service.validate_repository(
+            project_id=project_id,
+            request=request,
+        )
+
+    @router.post("", response_model=schema.DeploymentResponse)
+    async def create_deployment(
+        project_id: Annotated[str, Depends(get_project_id)],
+        deployment_data: schema.DeploymentCreate,
+    ) -> Response:
+        deployment_response = await deployments_service.create_deployment(
+            project_id=project_id,
+            deployment_data=deployment_data,
+        )
+        # Return deployment response with warning header if there are git issues
+
+        response = Response(
+            content=deployment_response.model_dump_json(),
+            status_code=201,
+            media_type="application/json",
+        )
+        return response
+
+    @router.get("")
+    async def get_deployments(
+        project_id: Annotated[str, Depends(get_project_id)],
+    ) -> schema.DeploymentsListResponse:
+        return await deployments_service.get_deployments(project_id=project_id)
+
+    @router.get("/{deployment_id}")
+    async def get_deployment(
+        project_id: Annotated[str, Depends(get_project_id)],
+        deployment_id: str,
+        include_events: Annotated[bool, Query()] = False,
+    ) -> schema.DeploymentResponse:
+        deployment = await deployments_service.get_deployment(
+            project_id=project_id,
+            deployment_id=deployment_id,
+            include_events=include_events,
+        )
+        if deployment is None:
+            raise HTTPException(
+                status_code=404,
+                detail=f"Deployment with id {deployment_id} not found",
+            )
+
+        return deployment
+
+    @router.delete("/{deployment_id}")
+    async def delete_deployment(
+        project_id: Annotated[str, Depends(get_project_id)],
+        deployment_id: str,
+    ) -> None:
+        await deployments_service.delete_deployment(
+            project_id=project_id, deployment_id=deployment_id
+        )
+
+    @router.patch("/{deployment_id}", response_model=schema.DeploymentResponse)
+    async def update_deployment(
+        project_id: Annotated[str, Depends(get_project_id)],
+        deployment_id: str,
+        update_data: schema.DeploymentUpdate,
+    ) -> Response:
+        """Update an existing deployment with patch-style changes
+
+        Args:
+            project_id: The project ID
+            deployment_id: The deployment ID to update
+            update_data: The patch-style update data
+        """
+
+        deployment_response = await deployments_service.update_deployment(
+            project_id=project_id,
+            deployment_id=deployment_id,
+            update_data=update_data,
+        )
+
+        response = Response(
+            content=deployment_response.model_dump_json(),
+            status_code=200,
+            media_type="application/json",
+        )
+        return response
+
+    @router.get("/{deployment_id}/logs")
+    async def stream_deployment_logs(
+        request: Request,
+        project_id: Annotated[str, Depends(get_project_id)],
+        deployment_id: str,
+        include_init_containers: Annotated[bool, Query()] = False,
+        since_seconds: Annotated[int | None, Query()] = None,
+        tail_lines: Annotated[int | None, Query()] = None,
+    ):
+        """Stream logs for the latest ReplicaSet of a deployment.
+
+        The stream ends when the latest ReplicaSet changes (e.g., a new rollout occurs).
+        """
+
+        try:
+            inner = deployments_service.stream_deployment_logs(
+                project_id=project_id,
+                deployment_id=deployment_id,
+                include_init_containers=include_init_containers,
+                since_seconds=since_seconds,
+                tail_lines=tail_lines,
+            )
+
+            async def sse_lines():
+                async for data in inner:
+                    yield "event: log\n"
+                    yield f"data: {data.model_dump_json()}\n\n"
+
+            return StreamingResponse(
+                sse_lines(),
+                media_type="text/event-stream",
+                headers={
+                    "Cache-Control": "no-cache",
+                    "Connection": "keep-alive",
+                    "X-Accel-Buffering": "no",
+                },
+            )
+
+        except DeploymentNotFoundError as e:
+            raise HTTPException(status_code=404, detail=str(e))
+        except ReplicaSetNotFoundError as e:
+            # Deployment exists but hasn't created a ReplicaSet yet
+            raise HTTPException(status_code=409, detail=str(e))
+
+    base_router.include_router(public_router, prefix="/deployments-public")
+    base_router.include_router(router, prefix="/deployments")
+    return base_router

llama_deploy/core/server/manage_api/_exceptions.py

@@ -0,0 +1,14 @@
+class DeploymentNotFoundError(Exception):
+    """
+    Raised when a deployment is not found
+    """
+
+    pass
+
+
+class ReplicaSetNotFoundError(Exception):
+    """
+    May be raised if a deployment does not set have a replica set
+    """
+
+    pass

llama_deploy/core/ui_build.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from .deployment_config import DeploymentConfig
+
+
+def resolve_ui_root(config_parent: Path, config: DeploymentConfig) -> Path | None:
+    """Return the absolute path to the UI root if UI is configured; otherwise None."""
+    if config.ui is None:
+        return None
+    return (config_parent / config.ui.directory).resolve()
+
+
+def ui_build_output_path(config_parent: Path, config: DeploymentConfig) -> Path | None:
+    """
+    Determine if the UI has a build script defined in package.json, and where the output will be.
+    Right now, assumes its just `/dist` in the UI root.
+
+    Returns:
+    - Path to the build output directory if a package.json exists and contains a "build" script
+    - None if there is no UI configured or no package.json exists
+    """
+    ui_root = resolve_ui_root(config_parent, config)
+    if ui_root is None:
+        return None
+    if config.ui is None:
+        return None
+    package_json = ui_root / "package.json"
+    if not package_json.exists():
+        return None
+    try:
+        with open(package_json, "r", encoding="utf-8") as f:
+            pkg = json.load(f)
+        if not isinstance(pkg, dict):
+            return None
+        scripts = pkg.get("scripts", {}) or {}
+        if config.ui.build_command in scripts:
+            return config.build_output_path()
+        return None
+    except Exception:
+        # Do not raise for malformed package.json in validation contexts
+        return None

{llama_deploy_core-0.2.7a1.dist-info → llama_deploy_core-0.3.0.dist-info}/METADATA

@@ -1,11 +1,18 @@
 Metadata-Version: 2.3
 Name: llama-deploy-core
-Version: 0.2.7a1
+Version: 0.3.0
 Summary: Core models and schemas for LlamaDeploy
 License: MIT
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: overrides>=7.7.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyyaml>=6.0.2
-Requires-Python: >=3.12, <4
+Requires-Dist: types-pyyaml>=6.0.12.20250822
+Requires-Dist: httpx>=0.24.0,<1.0.0 ; extra == 'client'
+Requires-Dist: fastapi>=0.115.0 ; extra == 'server'
+Requires-Python: >=3.11, <4
+Provides-Extra: client
+Provides-Extra: server
 Description-Content-Type: text/markdown
 
 > [!WARNING]

llama_deploy_core-0.3.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+llama_deploy/core/__init__.py,sha256=112612bf2e928c2e0310d6556bb13fc28c00db70297b90a8527486cd2562e408,43
+llama_deploy/core/client/manage_client.py,sha256=98715e323336fc9bc2730ecf585d6f9b862690fd6712998434cf9444d7bd47bc,7974
+llama_deploy/core/config.py,sha256=69bb0ea8ac169eaa4e808cd60a098b616bddd3145d26c6c35e56db38496b0e6a,35
+llama_deploy/core/deployment_config.py,sha256=bde431070758421f578f2e27f006152147e8cd752ee1054f1bf7c37ca95b0b38,15853
+llama_deploy/core/git/git_util.py,sha256=e62a5479c619a5973de203ebcc56b9729b5060c48fcb9cfc2e442756716c2abf,10960
+llama_deploy/core/iter_utils.py,sha256=68ac9dbf09f58315ffcfec6bd01ed50b88a954b00458da9bc28a0535b79ba29e,7042
+llama_deploy/core/path_util.py,sha256=14d50c0c337c8450ed46cafc88436027056b365a48370a69cdb76c88d7c26fd1,798
+llama_deploy/core/py.typed,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
+llama_deploy/core/schema/__init__.py,sha256=d1459ee50c690779a682130eff72f61dc1a687d2d4b26d8a5d3620a72d92d831,802
+llama_deploy/core/schema/base.py,sha256=2de6d23e58c36b6bb311ec0aea4b902661867056c1250c6b7ce3bad17141fe15,677
+llama_deploy/core/schema/deployments.py,sha256=d9254d9a478d7aeaf3d28ec6205215ea892dcfb245966d726d69d0418e03b03d,6486
+llama_deploy/core/schema/git_validation.py,sha256=27b306aa6ecabe58cab6381d92551545f263fe7550c58b3087115410bc71fd21,1915
+llama_deploy/core/schema/projects.py,sha256=726f91e90ff8699c90861d9740819c44c3f00d945ab09df71bd6d35fdc218a45,726
+llama_deploy/core/schema/public.py,sha256=022129c8fc09192f5e503b0500ccf54d106f5712b9cf8ce84b3b1c37e186f930,147
+llama_deploy/core/server/manage_api/__init__.py,sha256=e477ccab59cfd084edbad46f209972a282e623eb314d0847a754a46a16361db5,457
+llama_deploy/core/server/manage_api/_abstract_deployments_service.py,sha256=85ceab2a343c3642db7f77d4a665d5710a14bca920bbfdc25c5f1168cce30b22,4638
+llama_deploy/core/server/manage_api/_create_deployments_router.py,sha256=9bc8468169445e1cc7f2a479e1c7da42b4bdd7482fa3b440e03ee49cd09a75df,6801
+llama_deploy/core/server/manage_api/_exceptions.py,sha256=ee71cd9c2354a665e6905cd9cc752d2d65f71f0b936d33fec3c1c5229c38accf,246
+llama_deploy/core/ui_build.py,sha256=290dafa951918e5593b9035570fa4c66791d7e5ea785bd372ad11e99e8283857,1514
+llama_deploy_core-0.3.0.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
+llama_deploy_core-0.3.0.dist-info/METADATA,sha256=6030d472c3108b0db6d84f2464f71facf329aad2ab32b3f4989280c4b2345623,663
+llama_deploy_core-0.3.0.dist-info/RECORD,,

{llama_deploy_core-0.2.7a1.dist-info → llama_deploy_core-0.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.7.21
+Generator: uv 0.7.20
 Root-Is-Purelib: true
 Tag: py3-none-any

llama_deploy_core-0.2.7a1.dist-info/RECORD

@@ -1,11 +0,0 @@
-llama_deploy/core/__init__.py,sha256=112612bf2e928c2e0310d6556bb13fc28c00db70297b90a8527486cd2562e408,43
-llama_deploy/core/config.py,sha256=41c5a1baa25a67f0bb58b701ef8f0b8b3281714d7116580b8f87674eb9e396a3,51
-llama_deploy/core/git/git_util.py,sha256=da62903621e80e3a9ea80009d6b711533dfa2403bb2fe3b8c4ddf3cde9a019e3,8084
-llama_deploy/core/schema/__init__.py,sha256=c6821c749182cab73e5b21cce9e0f80d1e0f403f4abc3d050b84d613f640be60,713
-llama_deploy/core/schema/base.py,sha256=2de6d23e58c36b6bb311ec0aea4b902661867056c1250c6b7ce3bad17141fe15,677
-llama_deploy/core/schema/deployments.py,sha256=a269bcdc98b0a5ce09838dbc6dd68541720a0edb956ec8df5c123c3e1b253e80,5670
-llama_deploy/core/schema/git_validation.py,sha256=5faee3f5fc071f10813e7d3755f43fa11aae76a87467583ac7392bf1e8844f1c,1711
-llama_deploy/core/schema/projects.py,sha256=c97eda38207d80354c2ee3a237cba9c3f6838148197cfa2d97b9a18d3da1a38b,294
-llama_deploy_core-0.2.7a1.dist-info/WHEEL,sha256=cc8ae5806c5874a696cde0fcf78fdf73db4982e7c824f3ceab35e2b65182fa1a,79
-llama_deploy_core-0.2.7a1.dist-info/METADATA,sha256=bdcc94edd19ccb608b8526a454dd03cf70e623709b83fe9c5b525ddcbd8489bc,402
-llama_deploy_core-0.2.7a1.dist-info/RECORD,,