exactdocs-kernel 0.1.0__tar.gz

exactdocs_kernel-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+reports/
+
+# Built web UI bundled into the wheel / image (see web/README.md)
+packages/exactdocs/src/exactdocs/_web/
+
+# Local data and secrets
+data/
+*.db
+.env
+.env.*
+!.env.example
+
+# Editors / OS
+.idea/
+.vscode/*
+!.vscode/extensions.json
+.DS_Store
+Thumbs.db
+
+# Claude Code local settings
+.claude/settings.local.json

exactdocs_kernel-0.1.0/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.5
+Name: exactdocs-kernel
+Version: 0.1.0
+Summary: Shared kernel for ExactDocs domains: framework-free building blocks every domain may import.
+Project-URL: Repository, https://github.com/SirCypkowskyy/ExactDocs
+Author: Cyprian Gburek
+License-Expression: Apache-2.0
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# exactdocs-kernel
+
+Shared kernel of [ExactDocs](https://github.com/SirCypkowskyy/ExactDocs).
+
+The only code every domain of the `exactdocs` modular monolith may import. It must stay
+small, stable and framework-free (no FastAPI, FastMCP, Pydantic or database drivers), and it
+must never import `exactdocs`.

exactdocs_kernel-0.1.0/README.md

@@ -0,0 +1,7 @@
+# exactdocs-kernel
+
+Shared kernel of [ExactDocs](https://github.com/SirCypkowskyy/ExactDocs).
+
+The only code every domain of the `exactdocs` modular monolith may import. It must stay
+small, stable and framework-free (no FastAPI, FastMCP, Pydantic or database drivers), and it
+must never import `exactdocs`.

exactdocs_kernel-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "exactdocs-kernel"
+dynamic = ["version"]
+description = "Shared kernel for ExactDocs domains: framework-free building blocks every domain may import."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.14"
+authors = [{ name = "Cyprian Gburek" }]
+classifiers = [
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Repository = "https://github.com/SirCypkowskyy/ExactDocs"
+
+[build-system]
+requires = ["hatchling>=1.27", "uv-dynamic-versioning>=0.11"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "uv-dynamic-versioning"
+
+[tool.uv-dynamic-versioning]
+vcs = "git"
+style = "pep440"
+fallback-version = "0.0.0"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/exactdocs_kernel"]

exactdocs_kernel-0.1.0/src/exactdocs_kernel/__init__.py

@@ -0,0 +1,16 @@
+"""Shared kernel: the only code every ExactDocs domain may import.
+
+Keep it small, stable and framework-free. It must never import ``exactdocs``.
+"""
+
+from exactdocs_kernel.clock import Clock, SystemClock
+from exactdocs_kernel.errors import ConflictError, DomainError, NotFoundError, ValidationError
+
+__all__ = [
+    "Clock",
+    "ConflictError",
+    "DomainError",
+    "NotFoundError",
+    "SystemClock",
+    "ValidationError",
+]

exactdocs_kernel-0.1.0/src/exactdocs_kernel/clock.py

@@ -0,0 +1,20 @@
+from dataclasses import dataclass
+from datetime import UTC, datetime
+from typing import Protocol
+
+
+class Clock(Protocol):
+    """Driven port for the current time, so time-dependent logic stays testable."""
+
+    def now(self) -> datetime:
+        """Return the current, timezone-aware time."""
+        ...
+
+
+@dataclass(frozen=True, slots=True)
+class SystemClock:
+    """Real wall clock (UTC)."""
+
+    def now(self) -> datetime:
+        """Return the current UTC time."""
+        return datetime.now(UTC)

exactdocs_kernel-0.1.0/src/exactdocs_kernel/errors.py

@@ -0,0 +1,29 @@
+"""Error vocabulary shared by all domains.
+
+Driving adapters translate these into transport errors (HTTP status codes, MCP tool errors)
+in one place, so domains never import a web framework to signal failure.
+"""
+
+
+class DomainError(Exception):
+    """Base class for expected, business-level failures."""
+
+    code: str = "domain_error"
+
+
+class NotFoundError(DomainError):
+    """The requested thing does not exist (or is not visible to the caller)."""
+
+    code = "not_found"
+
+
+class ConflictError(DomainError):
+    """The request conflicts with the current state."""
+
+    code = "conflict"
+
+
+class ValidationError(DomainError):
+    """The request is well-formed but violates a business rule."""
+
+    code = "validation_error"

exactdocs_kernel-0.1.0/tests/test_clock.py

@@ -0,0 +1,9 @@
+from datetime import UTC
+
+from exactdocs_kernel import Clock, SystemClock
+
+
+def test_system_clock_is_a_clock_and_returns_aware_utc_time() -> None:
+    clock: Clock = SystemClock()
+
+    assert clock.now().tzinfo is UTC