julee 0.1.3__tar.gz → 0.1.5__tar.gz

julee-0.1.5/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: julee
+Version: 0.1.5
+Summary: Julee - Clean architecture for accountable and transparent digital supply chains
+Author-email: Pyx Industries <chris@pyx.io>
+License: GPL-3.0
+Project-URL: Homepage, https://github.com/pyx-industries/julee
+Project-URL: Repository, https://github.com/pyx-industries/julee
+Project-URL: Documentation, https://github.com/pyx-industries/julee#readme
+Project-URL: Issues, https://github.com/pyx-industries/julee/issues
+Keywords: temporal,workflow,document-processing,ai,supply-chain
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn>=0.20.0
+Requires-Dist: python-multipart
+Requires-Dist: fastapi-pagination>=0.12.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: temporalio[pydantic]>=1.3.0
+Requires-Dist: minio>=7.0.0
+Requires-Dist: anthropic>=0.66.0
+Requires-Dist: click>=0.8.0
+Requires-Dist: Jinja2>=3.0.0
+Requires-Dist: PyYAML>=6.0.0
+Requires-Dist: python-magic>=0.4.27
+Requires-Dist: multihash>=0.1.1
+Requires-Dist: six>=1.16.0
+Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: jsonpointer>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-xdist>=3.5.0; extra == "dev"
+Requires-Dist: hypothesis>=6.0.0; extra == "dev"
+Requires-Dist: factory-boy>=3.2.0; extra == "dev"
+Requires-Dist: mypy>=1.7.0; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Requires-Dist: types-jsonschema; extra == "dev"
+Requires-Dist: types-python-dateutil; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: ruff>=0.5.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
+Requires-Dist: pip-tools>=7.0.0; extra == "dev"
+Requires-Dist: asyncpg; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.0.0; extra == "docs"
+Requires-Dist: sphinx-autobuild>=2021.3.14; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
+Requires-Dist: furo>=2023.9.10; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=1.25.0; extra == "docs"
+Requires-Dist: sphinxcontrib-mermaid>=0.9.2; extra == "docs"
+Requires-Dist: sphinxcontrib-plantuml>=0.25; extra == "docs"
+Requires-Dist: sphinx-autoapi>=3.0.0; extra == "docs"
+Dynamic: license-file
+
+# Julee
+
+Clean architecture for accountable and transparent digital supply chains.
+
+Julee is a Python framework for building resilient, auditable business processes using Temporal workflows. Solutions are organized around your business domain—your bounded contexts become "accelerators" that speak your business language, not framework jargon.
+
+**Use Julee when:** processes must be done correctly, may be complex or long-running, need compliance audit trails (responsible AI, algorithmic due-diligence), or depend on unreliable services that may fail, timeout, or be rate-limited.
+
+**Core concepts:** Accelerators are collections of pipelines that automate a business area. Pipelines are use cases wrapped with Temporal, providing durability (survives crashes), reliability (automatic retries), observability (complete execution history), and supply chain provenance (audit trails that become "digital product passports").
+
+## Installation
+
+```bash
+pip install julee
+```
+
+## Runtime Dependencies
+
+Julee applications require: [Temporal](https://temporal.io/) (workflow orchestration), S3-compatible object storage (e.g. MinIO), PostgreSQL (for Temporal).
+
+## Documentation
+
+Full documentation at [julee.readthedocs.io](https://julee.readthedocs.io), package on [PyPI](https://pypi.org/project/julee/).
+
+## Example
+
+This repository includes a Docker Compose example demonstrating a meeting minutes extraction system:
+
+```bash
+cp .env.example .env  # Add your ANTHROPIC_API_KEY
+docker compose up --build
+```
+
+See the `demo-ui/` directory for the UI source.
+
+## License
+
+GPL-3.0 — see [LICENSE](LICENSE) for details.

julee-0.1.5/README.md

@@ -0,0 +1,38 @@
+# Julee
+
+Clean architecture for accountable and transparent digital supply chains.
+
+Julee is a Python framework for building resilient, auditable business processes using Temporal workflows. Solutions are organized around your business domain—your bounded contexts become "accelerators" that speak your business language, not framework jargon.
+
+**Use Julee when:** processes must be done correctly, may be complex or long-running, need compliance audit trails (responsible AI, algorithmic due-diligence), or depend on unreliable services that may fail, timeout, or be rate-limited.
+
+**Core concepts:** Accelerators are collections of pipelines that automate a business area. Pipelines are use cases wrapped with Temporal, providing durability (survives crashes), reliability (automatic retries), observability (complete execution history), and supply chain provenance (audit trails that become "digital product passports").
+
+## Installation
+
+```bash
+pip install julee
+```
+
+## Runtime Dependencies
+
+Julee applications require: [Temporal](https://temporal.io/) (workflow orchestration), S3-compatible object storage (e.g. MinIO), PostgreSQL (for Temporal).
+
+## Documentation
+
+Full documentation at [julee.readthedocs.io](https://julee.readthedocs.io), package on [PyPI](https://pypi.org/project/julee/).
+
+## Example
+
+This repository includes a Docker Compose example demonstrating a meeting minutes extraction system:
+
+```bash
+cp .env.example .env  # Add your ANTHROPIC_API_KEY
+docker compose up --build
+```
+
+See the `demo-ui/` directory for the UI source.
+
+## License
+
+GPL-3.0 — see [LICENSE](LICENSE) for details.

{julee-0.1.3 → julee-0.1.5}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "julee"
-version = "0.1.3"
+version = "0.1.5"
 description = "Julee - Clean architecture for accountable and transparent digital supply chains"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = {text = "GPL-3.0"}
 authors = [
     {name = "Pyx Industries", email = "chris@pyx.io"}
@@ -18,7 +18,6 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Topic :: Software Development :: Libraries :: Python Modules",
@@ -55,6 +54,7 @@ dev = [
     "pytest>=8.0.0",
     "pytest-asyncio>=1.0.0",
     "pytest-cov>=4.1.0",
+    "pytest-xdist>=3.5.0",
     "hypothesis>=6.0.0",
     "factory-boy>=3.2.0",
     # Type checking
@@ -107,10 +107,20 @@ asyncio_mode = "auto"
 addopts = [
     "--strict-markers",
     "--tb=short",
+    "-n", "auto",
+    "--dist", "loadgroup",
     "--cov=src/julee",
     "--cov-report=term-missing",
     "--cov-report=html",
 ]
+markers = [
+    "unit: Unit tests (fast, isolated)",
+    "integration: Integration tests (slower, with dependencies)",
+    "e2e: End-to-end tests (slowest, full stack)",
+    "llm: Tests that use real LLM API calls (slow, costs money)",
+    "contract: Contract tests (verify external API shapes and mock fidelity)",
+    "slow: Slow tests (stress tests, load tests)",
+]
 
 [tool.coverage.run]
 source = ["src/julee"]

{julee-0.1.3 → julee-0.1.5}/src/julee/__init__.py

@@ -1,3 +1,3 @@
 """Julee - Clean architecture for accountable and transparent digital supply chains."""
 
-__version__ = "0.1.1"
+__version__ = "0.1.5"

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/routers/test_assembly_specifications.py

@@ -25,6 +25,8 @@ from julee.repositories.memory import (
     MemoryAssemblySpecificationRepository,
 )
 
+pytestmark = pytest.mark.unit
+
 
 @pytest.fixture
 def memory_repo() -> MemoryAssemblySpecificationRepository:

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/routers/test_documents.py

@@ -18,6 +18,8 @@ from julee.api.routers.documents import router
 from julee.domain.models.document import Document, DocumentStatus
 from julee.repositories.memory import MemoryDocumentRepository
 
+pytestmark = pytest.mark.unit
+
 
 @pytest.fixture
 def memory_repo() -> MemoryDocumentRepository:
@@ -61,7 +63,7 @@ def sample_documents() -> list[Document]:
             created_at=datetime(2024, 1, 1, 12, 0, 0, tzinfo=timezone.utc),
             updated_at=datetime(2024, 1, 1, 12, 0, 0, tzinfo=timezone.utc),
             additional_metadata={"type": "test"},
-            content_string="test content",
+            content_bytes="test content",
         ),
         Document(
             document_id="doc-2",
@@ -73,7 +75,7 @@ def sample_documents() -> list[Document]:
             created_at=datetime(2024, 1, 2, 12, 0, 0, tzinfo=timezone.utc),
             updated_at=datetime(2024, 1, 2, 12, 0, 0, tzinfo=timezone.utc),
             additional_metadata={"type": "report"},
-            content_string="pdf content",
+            content_bytes="pdf content",
         ),
     ]
 
@@ -203,7 +205,7 @@ class TestGetDocument:
         assert data["additional_metadata"] == doc.additional_metadata
 
         # Content should NOT be included in metadata endpoint
-        assert data["content_string"] is None
+        assert data["content_bytes"] is None
         # Content field is excluded from JSON response
         assert "content" not in data
 
@@ -273,7 +275,7 @@ class TestGetDocumentContent:
         memory_repo: MemoryDocumentRepository,
     ) -> None:
         """Test content retrieval when document has no content."""
-        # Create document with content_string first to pass validation
+        # Create document with content_bytes first to pass validation
         doc = Document(
             document_id="doc-no-content",
             original_filename="empty.txt",
@@ -282,7 +284,7 @@ class TestGetDocumentContent:
             content_multihash="empty_hash",
             status=DocumentStatus.CAPTURED,
             additional_metadata={"type": "empty"},
-            content_string="temp",
+            content_bytes="temp",
         )
 
         # Save document normally, then manually remove content from storage
@@ -290,7 +292,7 @@ class TestGetDocumentContent:
         stored_doc = memory_repo.storage_dict[doc.document_id]
         # Remove content from the stored document
         memory_repo.storage_dict[doc.document_id] = stored_doc.model_copy(
-            update={"content": None, "content_string": None}
+            update={"content": None, "content_bytes": None}
         )
 
         # Make request

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/routers/test_knowledge_service_configs.py

@@ -22,6 +22,8 @@ from julee.domain.models.knowledge_service_config import (
     ServiceApi,
 )
 
+pytestmark = pytest.mark.unit
+
 
 @pytest.fixture
 def mock_repository() -> AsyncMock:

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/routers/test_knowledge_service_queries.py

@@ -22,6 +22,8 @@ from julee.repositories.memory import (
     MemoryKnowledgeServiceQueryRepository,
 )
 
+pytestmark = pytest.mark.unit
+
 
 @pytest.fixture
 def memory_repo() -> MemoryKnowledgeServiceQueryRepository:

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/routers/test_system.py

@@ -17,6 +17,8 @@ from fastapi.testclient import TestClient
 from julee.api.responses import ServiceStatus
 from julee.api.routers.system import router
 
+pytestmark = pytest.mark.unit
+
 
 @pytest.fixture
 def app_with_router() -> FastAPI:

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/routers/test_workflows.py

@@ -16,6 +16,8 @@ from fastapi_pagination import add_pagination
 from julee.api.dependencies import get_temporal_client
 from julee.api.routers.workflows import router
 
+pytestmark = pytest.mark.unit
+
 
 @pytest.fixture
 def mock_temporal_client() -> MagicMock:

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/test_app.py

@@ -25,6 +25,8 @@ from julee.repositories.memory.knowledge_service_config import (
     MemoryKnowledgeServiceConfigRepository,
 )
 
+pytestmark = pytest.mark.unit
+
 
 @pytest.fixture
 def memory_repo() -> MemoryKnowledgeServiceQueryRepository:

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/test_dependencies.py

@@ -16,6 +16,8 @@ from julee.api.dependencies import (
     get_startup_dependencies,
 )
 
+pytestmark = pytest.mark.unit
+
 
 @pytest.fixture
 def mock_container() -> AsyncMock:

{julee-0.1.3 → julee-0.1.5}/src/julee/api/tests/test_requests.py

@@ -21,6 +21,8 @@ from julee.domain.models import (
     KnowledgeServiceQuery,
 )
 
+pytestmark = pytest.mark.unit
+
 
 class TestCreateAssemblySpecificationRequest:
     """Test CreateAssemblySpecificationRequest model."""

julee-0.1.5/src/julee/contrib/polling/__init__.py

@@ -0,0 +1,50 @@
+"""
+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.domain.models.polling_config import PollingConfig, PollingProtocol
+    from julee.contrib.polling.infrastructure.services.polling.http import HttpPollerService
+    from julee.contrib.polling.domain.services.poller import PollerService
+    from julee.contrib.polling.domain.models.polling_config import 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)
+
+Note: All imports must be explicit to avoid import chains that can pull
+non-deterministic code into Temporal workflows. Import directly from
+the specific modules you need rather than using this convenience module.
+"""
+
+# No re-exports to avoid import chains that pull non-deterministic code
+# into Temporal workflows. Import from specific submodules instead:
+#
+# Domain:
+# - from julee.contrib.polling.domain.models.polling_config import PollingConfig, PollingProtocol, PollingResult
+# - from julee.contrib.polling.domain.services.poller import PollerService
+#
+# Infrastructure:
+# - from julee.contrib.polling.infrastructure.services.polling.http import HttpPollerService
+# - from julee.contrib.polling.infrastructure.temporal.manager import PollingManager
+# - from julee.contrib.polling.infrastructure.temporal.proxies import WorkflowPollerServiceProxy
+# - from julee.contrib.polling.infrastructure.temporal.activities import TemporalPollerService
+
+__all__ = []

julee-0.1.5/src/julee/contrib/polling/apps/__init__.py

@@ -0,0 +1,17 @@
+"""
+Application entry points for the polling contrib module.
+
+This module contains the application-layer components that provide entry points
+for the polling contrib module, including worker pipelines, API routes, and
+CLI commands.
+
+Following the ADR contrib module structure, this layer wires together domain
+services and infrastructure implementations into runnable applications.
+
+No re-exports to avoid import chains that pull non-deterministic code
+into Temporal workflows. Import directly from specific modules:
+
+- from julee.contrib.polling.apps.worker.pipelines import NewDataDetectionPipeline
+"""
+
+__all__ = []

julee-0.1.5/src/julee/contrib/polling/apps/worker/__init__.py

@@ -0,0 +1,17 @@
+"""
+Worker applications for the polling contrib module.
+
+This module contains worker-specific entry points for the polling contrib module,
+including Temporal workflows (pipelines) that orchestrate polling operations
+with durability guarantees.
+
+The worker applications in this module can be registered with Temporal workers
+to provide polling capabilities within workflow contexts.
+
+No re-exports to avoid import chains that pull non-deterministic code
+into Temporal workflows. Import directly from specific modules:
+
+- from julee.contrib.polling.apps.worker.pipelines import NewDataDetectionPipeline
+"""
+
+__all__ = []