julee 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

julee/api/app.py

@@ -15,27 +15,28 @@ with proper HTTP status codes and error handling.
 """
 
 import logging
-import uvicorn
+from collections.abc import AsyncGenerator, Callable
 from contextlib import asynccontextmanager
-from typing import AsyncGenerator, Any, Callable
+from typing import Any
 
+import uvicorn
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi_pagination import add_pagination
 from fastapi_pagination.utils import disable_installed_extensions_check
 
+from julee.api.dependencies import (
+    get_knowledge_service_config_repository,
+    get_startup_dependencies,
+)
 from julee.api.routers import (
     assembly_specifications_router,
-    knowledge_service_queries_router,
+    documents_router,
     knowledge_service_configs_router,
+    knowledge_service_queries_router,
     system_router,
-    documents_router,
     workflows_router,
 )
-from julee.api.dependencies import (
-    get_startup_dependencies,
-    get_knowledge_service_config_repository,
-)
 
 # Disable pagination extensions check for cleaner startup
 disable_installed_extensions_check()

julee/api/dependencies.py

@@ -10,9 +10,9 @@ The dependencies focus on real Minio implementations for production use,
 with test overrides available through FastAPI's dependency override system.
 """
 
-import os
 import logging
-from typing import Any, Dict, TYPE_CHECKING
+import os
+from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     from julee.api.services.system_initialization import (
@@ -20,35 +20,35 @@ if TYPE_CHECKING:
     )
 
 from fastapi import Depends
+from minio import Minio
 from temporalio.client import Client
 from temporalio.contrib.pydantic import pydantic_data_converter
 
-from julee.domain.repositories.knowledge_service_query import (
-    KnowledgeServiceQueryRepository,
-)
-from julee.domain.repositories.knowledge_service_config import (
-    KnowledgeServiceConfigRepository,
-)
 from julee.domain.repositories.assembly_specification import (
     AssemblySpecificationRepository,
 )
 from julee.domain.repositories.document import (
     DocumentRepository,
 )
-from julee.repositories.minio.knowledge_service_query import (
-    MinioKnowledgeServiceQueryRepository,
+from julee.domain.repositories.knowledge_service_config import (
+    KnowledgeServiceConfigRepository,
 )
-from julee.repositories.minio.knowledge_service_config import (
-    MinioKnowledgeServiceConfigRepository,
+from julee.domain.repositories.knowledge_service_query import (
+    KnowledgeServiceQueryRepository,
 )
 from julee.repositories.minio.assembly_specification import (
     MinioAssemblySpecificationRepository,
 )
+from julee.repositories.minio.client import MinioClient
 from julee.repositories.minio.document import (
     MinioDocumentRepository,
 )
-from julee.repositories.minio.client import MinioClient
-from minio import Minio
+from julee.repositories.minio.knowledge_service_config import (
+    MinioKnowledgeServiceConfigRepository,
+)
+from julee.repositories.minio.knowledge_service_query import (
+    MinioKnowledgeServiceQueryRepository,
+)
 
 logger = logging.getLogger(__name__)
 
@@ -60,7 +60,7 @@ class DependencyContainer:
     """
 
     def __init__(self) -> None:
-        self._instances: Dict[str, Any] = {}
+        self._instances: dict[str, Any] = {}
 
     async def get_or_create(self, key: str, factory: Any) -> Any:
         """Get or create a singleton instance."""

julee/api/requests.py

@@ -7,9 +7,10 @@ to domain model class methods and reuse field descriptions to avoid
 duplication while maintaining single source of truth in the domain layer.
 """
 
-from typing import Dict, Any, Optional
-from pydantic import BaseModel, Field, field_validator, ValidationInfo
 from datetime import datetime, timezone
+from typing import Any
+
+from pydantic import BaseModel, Field, ValidationInfo, field_validator
 
 from julee.domain.models import (
     AssemblySpecification,
@@ -38,10 +39,10 @@ class CreateAssemblySpecificationRequest(BaseModel):
     applicability: str = Field(
         description=AssemblySpecification.model_fields["applicability"].description
     )
-    jsonschema: Dict[str, Any] = Field(
+    jsonschema: dict[str, Any] = Field(
         description=AssemblySpecification.model_fields["jsonschema"].description
     )
-    knowledge_service_queries: Dict[str, str] = Field(
+    knowledge_service_queries: dict[str, str] = Field(
         default_factory=dict,
         description=AssemblySpecification.model_fields[
             "knowledge_service_queries"
@@ -65,14 +66,14 @@ class CreateAssemblySpecificationRequest(BaseModel):
 
     @field_validator("jsonschema")
     @classmethod
-    def validate_jsonschema(cls, v: Dict[str, Any]) -> Dict[str, Any]:
+    def validate_jsonschema(cls, v: dict[str, Any]) -> dict[str, Any]:
         return AssemblySpecification.jsonschema_must_be_valid(v)
 
     @field_validator("knowledge_service_queries")
     @classmethod
     def validate_knowledge_service_queries(
-        cls, v: Dict[str, str], info: ValidationInfo
-    ) -> Dict[str, str]:
+        cls, v: dict[str, str], info: ValidationInfo
+    ) -> dict[str, str]:
         return AssemblySpecification.knowledge_service_queries_must_be_valid(v, info)
 
     @field_validator("version")
@@ -128,11 +129,11 @@ class CreateKnowledgeServiceQueryRequest(BaseModel):
     prompt: str = Field(
         description=KnowledgeServiceQuery.model_fields["prompt"].description
     )
-    query_metadata: Dict[str, Any] = Field(
+    query_metadata: dict[str, Any] = Field(
         default_factory=dict,
         description=KnowledgeServiceQuery.model_fields["query_metadata"].description,
     )
-    assistant_prompt: Optional[str] = Field(
+    assistant_prompt: str | None = Field(
         default=KnowledgeServiceQuery.model_fields["assistant_prompt"].default,
         description=KnowledgeServiceQuery.model_fields["assistant_prompt"].description,
     )

julee/api/responses.py

@@ -8,9 +8,10 @@ only response models that are specific to API concerns and not represented
 by existing domain models.
 """
 
-from pydantic import BaseModel
 from enum import Enum
 
+from pydantic import BaseModel
+
 
 class ServiceStatus(str, Enum):
     """Service status enumeration."""

julee/api/routers/__init__.py

@@ -20,17 +20,17 @@ Router modules follow the pattern:
 """
 
 # Import routers for convenient access
-from julee.api.routers.knowledge_service_queries import (
-    router as knowledge_service_queries_router,
+from julee.api.routers.assembly_specifications import (
+    router as assembly_specifications_router,
 )
+from julee.api.routers.documents import router as documents_router
 from julee.api.routers.knowledge_service_configs import (
     router as knowledge_service_configs_router,
 )
-from julee.api.routers.assembly_specifications import (
-    router as assembly_specifications_router,
+from julee.api.routers.knowledge_service_queries import (
+    router as knowledge_service_queries_router,
 )
 from julee.api.routers.system import router as system_router
-from julee.api.routers.documents import router as documents_router
 from julee.api.routers.workflows import router as workflows_router
 
 __all__ = [

julee/api/routers/assembly_specifications.py

@@ -14,17 +14,18 @@ These routes are mounted at /assembly_specifications in the main app.
 
 import logging
 from typing import cast
+
 from fastapi import APIRouter, Depends, HTTPException, Path
 from fastapi_pagination import Page, paginate
 
-from julee.domain.models import AssemblySpecification
-from julee.domain.repositories.assembly_specification import (
-    AssemblySpecificationRepository,
-)
 from julee.api.dependencies import (
     get_assembly_specification_repository,
 )
 from julee.api.requests import CreateAssemblySpecificationRequest
+from julee.domain.models import AssemblySpecification
+from julee.domain.repositories.assembly_specification import (
+    AssemblySpecificationRepository,
+)
 
 logger = logging.getLogger(__name__)
 

julee/api/routers/documents.py

@@ -19,9 +19,9 @@ from fastapi import APIRouter, Depends, HTTPException, Path
 from fastapi.responses import Response
 from fastapi_pagination import Page, paginate
 
+from julee.api.dependencies import get_document_repository
 from julee.domain.models.document import Document
 from julee.domain.repositories.document import DocumentRepository
-from julee.api.dependencies import get_document_repository
 
 logger = logging.getLogger(__name__)
 

julee/api/routers/knowledge_service_configs.py

@@ -13,18 +13,19 @@ These routes are mounted at /knowledge_service_configs in the main app.
 
 import logging
 from typing import cast
+
 from fastapi import APIRouter, Depends, HTTPException
 from fastapi_pagination import Page, paginate
 
+from julee.api.dependencies import (
+    get_knowledge_service_config_repository,
+)
 from julee.domain.models.knowledge_service_config import (
     KnowledgeServiceConfig,
 )
 from julee.domain.repositories.knowledge_service_config import (
     KnowledgeServiceConfigRepository,
 )
-from julee.api.dependencies import (
-    get_knowledge_service_config_repository,
-)
 
 logger = logging.getLogger(__name__)
 

julee/api/routers/knowledge_service_queries.py

@@ -14,18 +14,19 @@ These routes are mounted at /knowledge_service_queries in the main app.
 """
 
 import logging
-from typing import Optional, cast
+from typing import cast
+
 from fastapi import APIRouter, Depends, HTTPException, Query
 from fastapi_pagination import Page, paginate
 
-from julee.domain.models import KnowledgeServiceQuery
-from julee.domain.repositories.knowledge_service_query import (
-    KnowledgeServiceQueryRepository,
-)
 from julee.api.dependencies import (
     get_knowledge_service_query_repository,
 )
 from julee.api.requests import CreateKnowledgeServiceQueryRequest
+from julee.domain.models import KnowledgeServiceQuery
+from julee.domain.repositories.knowledge_service_query import (
+    KnowledgeServiceQueryRepository,
+)
 
 logger = logging.getLogger(__name__)
 
@@ -35,7 +36,7 @@ router = APIRouter()
 
 @router.get("/", response_model=Page[KnowledgeServiceQuery])
 async def get_knowledge_service_queries(
-    ids: Optional[str] = Query(
+    ids: str | None = Query(
         None,
         description="Comma-separated list of query IDs for bulk retrieval",
         openapi_examples={

julee/api/routers/system.py

@@ -10,13 +10,14 @@ Routes defined at root level:
 These routes are mounted at the root level in the main app.
 """
 
-import logging
 import asyncio
+import logging
+import os
 from datetime import datetime, timezone
+
 from fastapi import APIRouter
-from temporalio.client import Client
 from minio import Minio
-import os
+from temporalio.client import Client
 
 from julee.api.responses import (
     HealthCheckResponse,

julee/api/routers/workflows.py

@@ -14,7 +14,6 @@ These routes are mounted with '/workflows' prefix in the main app.
 
 import logging
 import uuid
-from typing import Optional
 
 from fastapi import APIRouter, Depends, HTTPException
 from pydantic import BaseModel, Field
@@ -22,8 +21,8 @@ from temporalio.client import Client
 
 from julee.api.dependencies import get_temporal_client
 from julee.workflows.extract_assemble import (
-    ExtractAssembleWorkflow,
     EXTRACT_ASSEMBLE_RETRY_POLICY,
+    ExtractAssembleWorkflow,
 )
 
 logger = logging.getLogger(__name__)
@@ -38,7 +37,7 @@ class StartExtractAssembleRequest(BaseModel):
     assembly_specification_id: str = Field(
         ..., min_length=1, description="Assembly specification ID to use"
     )
-    workflow_id: Optional[str] = Field(
+    workflow_id: str | None = Field(
         None,
         min_length=1,
         description=("Optional custom workflow ID (auto-generated if not provided)"),
@@ -51,8 +50,8 @@ class WorkflowStatusResponse(BaseModel):
     workflow_id: str
     run_id: str
     status: str  # "RUNNING", "COMPLETED", "FAILED", "CANCELLED", etc.
-    current_step: Optional[str] = None
-    assembly_id: Optional[str] = None
+    current_step: str | None = None
+    assembly_id: str | None = None
 
 
 class StartWorkflowResponse(BaseModel):

julee/api/services/system_initialization.py

@@ -11,7 +11,7 @@ to the appropriate use cases.
 """
 
 import logging
-from typing import Dict, Any
+from typing import Any
 
 from julee.domain.use_cases.initialize_system_data import (
     InitializeSystemDataUseCase,
@@ -46,7 +46,7 @@ class SystemInitializationService:
         self.initialize_system_data_use_case = initialize_system_data_use_case
         self.logger = logging.getLogger("SystemInitializationService")
 
-    async def initialize(self) -> Dict[str, Any]:
+    async def initialize(self) -> dict[str, Any]:
         """
         Initialize all required system data and configuration.
 
@@ -62,7 +62,7 @@ class SystemInitializationService:
         """
         self.logger.info("Starting system initialization")
 
-        initialization_results: Dict[str, Any] = {
+        initialization_results: dict[str, Any] = {
             "status": "in_progress",
             "tasks_completed": [],
             "tasks_failed": [],
@@ -112,7 +112,7 @@ class SystemInitializationService:
             raise
 
     async def _execute_system_data_initialization(
-        self, results: Dict[str, Any]
+        self, results: dict[str, Any]
     ) -> None:
         """
         Execute system data initialization use case.
@@ -159,7 +159,7 @@ class SystemInitializationService:
 
             raise
 
-    async def get_initialization_status(self) -> Dict[str, Any]:
+    async def get_initialization_status(self) -> dict[str, Any]:
         """
         Get the current initialization status.
 
@@ -180,7 +180,7 @@ class SystemInitializationService:
             "status": "ready",
         }
 
-    async def reinitialize(self) -> Dict[str, Any]:
+    async def reinitialize(self) -> dict[str, Any]:
         """
         Reinitialize system data.
 

julee/api/tests/routers/test_assembly_specifications.py

@@ -6,16 +6,17 @@ endpoints, focusing on testing the router behavior with proper dependency
 injection and mocking patterns.
 """
 
+from collections.abc import Generator
+
 import pytest
-from typing import Generator
-from fastapi.testclient import TestClient
 from fastapi import FastAPI
+from fastapi.testclient import TestClient
 from fastapi_pagination import add_pagination
 
-from julee.api.routers.assembly_specifications import router
 from julee.api.dependencies import (
     get_assembly_specification_repository,
 )
+from julee.api.routers.assembly_specifications import router
 from julee.domain.models import (
     AssemblySpecification,
     AssemblySpecificationStatus,

julee/api/tests/routers/test_documents.py

@@ -5,15 +5,16 @@ This module provides unit tests for the documents API endpoints,
 focusing on the core functionality of listing documents with pagination.
 """
 
-import pytest
+from collections.abc import Generator
 from datetime import datetime, timezone
-from typing import Generator
-from fastapi.testclient import TestClient
+
+import pytest
 from fastapi import FastAPI
+from fastapi.testclient import TestClient
 from fastapi_pagination import add_pagination
 
-from julee.api.routers.documents import router
 from julee.api.dependencies import get_document_repository
+from julee.api.routers.documents import router
 from julee.domain.models.document import Document, DocumentStatus
 from julee.repositories.memory import MemoryDocumentRepository
 

julee/api/tests/routers/test_knowledge_service_configs.py

@@ -6,20 +6,21 @@ ensuring they follow consistent patterns with proper error handling,
 pagination, and response formats.
 """
 
-import pytest
+from collections.abc import Generator
+from datetime import datetime, timezone
 from unittest.mock import AsyncMock
+
+import pytest
 from fastapi.testclient import TestClient
-from typing import Generator
 
 from julee.api.app import app
+from julee.api.dependencies import (
+    get_knowledge_service_config_repository,
+)
 from julee.domain.models.knowledge_service_config import (
     KnowledgeServiceConfig,
     ServiceApi,
 )
-from julee.api.dependencies import (
-    get_knowledge_service_config_repository,
-)
-from datetime import datetime, timezone
 
 
 @pytest.fixture

julee/api/tests/routers/test_knowledge_service_queries.py

@@ -6,16 +6,17 @@ endpoints, focusing on testing the router behavior with proper dependency
 injection and mocking patterns.
 """
 
+from collections.abc import Generator
+
 import pytest
-from typing import Generator
-from fastapi.testclient import TestClient
 from fastapi import FastAPI
+from fastapi.testclient import TestClient
 from fastapi_pagination import add_pagination
 
-from julee.api.routers.knowledge_service_queries import router
 from julee.api.dependencies import (
     get_knowledge_service_query_repository,
 )
+from julee.api.routers.knowledge_service_queries import router
 from julee.domain.models import KnowledgeServiceQuery
 from julee.repositories.memory import (
     MemoryKnowledgeServiceQueryRepository,

julee/api/tests/routers/test_system.py

@@ -5,16 +5,17 @@ This module provides tests for system-level endpoints including health checks
 and other operational endpoints.
 """
 
-import pytest
 import time
+from collections.abc import Generator
 from datetime import datetime
-from typing import Generator
 from unittest.mock import patch
-from fastapi.testclient import TestClient
+
+import pytest
 from fastapi import FastAPI
+from fastapi.testclient import TestClient
 
-from julee.api.routers.system import router
 from julee.api.responses import ServiceStatus
+from julee.api.routers.system import router
 
 
 @pytest.fixture

julee/api/tests/routers/test_workflows.py

@@ -5,15 +5,16 @@ This module provides unit tests for the workflows API endpoints,
 focusing on workflow triggering, status monitoring, and error handling.
 """
 
-import pytest
-from typing import Generator
+from collections.abc import Generator
 from unittest.mock import AsyncMock, MagicMock
-from fastapi.testclient import TestClient
+
+import pytest
 from fastapi import FastAPI
+from fastapi.testclient import TestClient
 from fastapi_pagination import add_pagination
 
-from julee.api.routers.workflows import router
 from julee.api.dependencies import get_temporal_client
+from julee.api.routers.workflows import router
 
 
 @pytest.fixture

julee/api/tests/test_app.py

@@ -5,16 +5,18 @@ This module provides tests for the API endpoints, focusing on testing the
 HTTP layer behavior with proper dependency injection and mocking patterns.
 """
 
-import pytest
-from typing import Generator
+from collections.abc import Generator
 from unittest.mock import patch
+
+import pytest
 from fastapi.testclient import TestClient
 
 from julee.api.app import app
 from julee.api.dependencies import (
-    get_knowledge_service_query_repository,
     get_knowledge_service_config_repository,
+    get_knowledge_service_query_repository,
 )
+from julee.api.responses import ServiceStatus
 from julee.domain.models import KnowledgeServiceQuery
 from julee.repositories.memory import (
     MemoryKnowledgeServiceQueryRepository,
@@ -22,7 +24,6 @@ from julee.repositories.memory import (
 from julee.repositories.memory.knowledge_service_config import (
     MemoryKnowledgeServiceConfigRepository,
 )
-from julee.api.responses import ServiceStatus
 
 
 @pytest.fixture

julee/api/tests/test_dependencies.py

@@ -6,12 +6,13 @@ StartupDependenciesProvider that provides clean access to dependencies
 during application startup without exposing internal container details.
 """
 
-import pytest
 from unittest.mock import AsyncMock, MagicMock
 
+import pytest
+
 from julee.api.dependencies import (
-    StartupDependenciesProvider,
     DependencyContainer,
+    StartupDependenciesProvider,
     get_startup_dependencies,
 )
 

julee/api/tests/test_requests.py

@@ -6,8 +6,9 @@ focus on verifying the delegation works correctly and that the API-specific
 behavior (like field copying and conversion methods) functions as expected.
 """
 
-import pytest
 from datetime import datetime
+
+import pytest
 from pydantic import ValidationError
 
 from julee.api.requests import (

julee/contrib/__init__.py

@@ -0,0 +1,15 @@
+"""
+Julee Contrib Modules.
+
+This package contains "contrib" modules - ready-made, batteries-included
+components that solutions can import and use. These modules follow the same
+clean architecture patterns as external Julee solutions.
+
+Contrib modules are accelerators - reusable bounded contexts that can be
+imported and composed into larger solutions.
+"""
+
+# Currently available contrib modules will be imported here as they are added
+# For now, this serves as the namespace package root
+
+__all__ = []

julee/contrib/polling/__init__.py

@@ -0,0 +1,47 @@
+"""
+Polling Contrib Module.
+
+This module provides ready-made polling functionality for external endpoints.
+It follows the Julee contrib module pattern, providing a complete polling
+solution that can be imported and used by Julee solutions.
+
+The polling module includes:
+- Domain models for polling configuration and results
+- Service protocols for polling operations
+- HTTP implementation for REST API polling
+- Co-located tests and examples
+
+Example usage:
+    from julee.contrib.polling import PollingConfig, HttpPollerService
+    from julee.contrib.polling import PollingProtocol, PollingResult
+
+    # Configure polling
+    config = PollingConfig(
+        endpoint_identifier="api-v1",
+        polling_protocol=PollingProtocol.HTTP,
+        connection_params={"url": "https://api.example.com/data"},
+        timeout_seconds=30
+    )
+
+    # Poll the endpoint
+    service = HttpPollerService()
+    result = await service.poll_endpoint(config)
+"""
+
+from .domain import PollerService, PollingConfig, PollingProtocol, PollingResult
+from .infrastructure import HttpPollerService, TemporalPollerService
+from .infrastructure.temporal import WorkflowPollerServiceProxy
+
+__all__ = [
+    # Domain models
+    "PollingConfig",
+    "PollingProtocol",
+    "PollingResult",
+    # Domain services
+    "PollerService",
+    # Infrastructure implementations
+    "HttpPollerService",
+    # Temporal integration
+    "TemporalPollerService",
+    "WorkflowPollerServiceProxy",
+]