quadkit 0.0.3__tar.gz → 0.0.41__tar.gz

quadkit-0.0.41/PKG-INFO

@@ -0,0 +1,270 @@
+Metadata-Version: 2.5
+Name: quadkit
+Version: 0.0.41
+Summary: Async-first DI/IoC framework for Python — core package
+Project-URL: Homepage, https://dbtinoy-.github.io/quadkit/
+Project-URL: Repository, https://github.com/dbtinoy-/quadkit
+Project-URL: Documentation, https://dbtinoy-.github.io/quadkit/
+Project-URL: Issues, https://github.com/dbtinoy-/quadkit/issues
+Project-URL: Changelog, https://github.com/dbtinoy-/quadkit/blob/main/CHANGELOG.md
+Author-email: Quadkit Framework Team <team@quadkit.dev>
+Maintainer-email: Quadkit Framework Team <team@quadkit.dev>
+License: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: async,dependency-injection,framework,ioc,provider-pattern
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: orjson<4,>=3.0.0
+Requires-Dist: pydantic<3,>=2.10.0
+Requires-Dist: quadkit-contracts>=0.0.2
+Requires-Dist: structlog<27,>=25.1.0
+Provides-Extra: codegen
+Requires-Dist: jinja2<4,>=3.1.0; extra == 'codegen'
+Provides-Extra: dev
+Requires-Dist: mypy<3,>=1.0.0; extra == 'dev'
+Requires-Dist: pre-commit<5,>=3.0.0; extra == 'dev'
+Requires-Dist: ruff<1,>=0.16.4; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material<10,>=9.0.0; extra == 'docs'
+Requires-Dist: mkdocs<2,>=1.4.0; extra == 'docs'
+Provides-Extra: security
+Requires-Dist: cryptography<52,>=41.0.0; extra == 'security'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio<2,>=0.21.0; extra == 'test'
+Requires-Dist: pytest-cov<8,>=4.0.0; extra == 'test'
+Requires-Dist: pytest-mock<4,>=3.10.0; extra == 'test'
+Requires-Dist: pytest<10,>=8.0.0; extra == 'test'
+Provides-Extra: web
+Requires-Dist: quadkit-web[granian]>=0.0.2; extra == 'web'
+Description-Content-Type: text/markdown
+
+# quadkit
+
+![Quadkit](https://raw.githubusercontent.com/dbtinoy-/quadkit/main/banner.jpg)
+
+[![PyPI](https://img.shields.io/pypi/v/quadkit?color=%2322c55e&label=pypi)](https://pypi.org/project/quadkit/)
+[![Python](https://img.shields.io/pypi/pyversions/quadkit?color=%2322c55e)](https://pypi.org/project/quadkit/)
+[![License](https://img.shields.io/pypi/l/quadkit?color=%2322c55e)](https://github.com/dbtinoy-/quadkit/blob/main/LICENSE)
+
+Async-first application framework for Python: dependency-injection
+container, application lifecycle, typed configuration, and the `Result`
+error model. This is the core package; everything else published from
+this repository builds on it.
+
+For application developers — write providers and modules, bind
+contracts, and let one container boot them in order.
+
+What's in the box:
+
+- **DI container** — singleton, scoped, and transient bindings, async
+  factories, override support for tests; the graph resolves once, at
+  boot.
+- **Provider & module system** — providers register bindings, boot
+  resources, and shut them down in reverse order; modules compose
+  providers into reusable units.
+- **Typed configuration** — `application.yaml` validated against
+  dataclass models at boot (unknown keys fail fast), every key
+  overridable via `QK_*` environment variables, profiles via `QK_PROFILE`.
+- **The `Result` model** — expected failures are values
+  (`Ok`/`Err`), not exceptions; `ResultPipeline` chains them fluently
+  while keeping the error type visible to mypy.
+- **Structured logging** — `get_logger()` gives every service a
+  keyed, structlog-style logger out of the box.
+- **Domain primitives** — `AggregateRoot`, `Entity`, `DomainEvent`,
+  `AbstractUnitOfWork` for DDD-style modelling without a framework
+  tax.
+
+## The quadkit family
+
+| Package | Role |
+| --- | --- |
+| [`quadkit-contracts`](https://pypi.org/project/quadkit-contracts/) | zero-dependency protocols, types, exception hierarchy |
+| [`quadkit`](https://pypi.org/project/quadkit/) | the framework core — DI container, modules, config, logging, `Result` |
+| [`quadkit-web`](https://pypi.org/project/quadkit-web/) | ASGI layer — controllers, routing, middleware, OpenAPI docs |
+| [`quadkit-cli`](https://pypi.org/project/quadkit-cli/) | project scaffolding and code generators |
+| [`quadkit-testing`](https://pypi.org/project/quadkit-testing/) | in-process test beds, fakes, fixtures |
+
+## Installation
+
+```bash
+uv add quadkit
+# batteries-included web stack:
+uv add "quadkit[web]"
+```
+
+Requires **Python >= 3.11**.
+
+## Minimal working example
+
+```python
+import asyncio
+
+from quadkit import Application
+from quadkit.contracts.core.di import ContainerRegistrarProtocol
+from quadkit.di.provider import Provider
+
+
+class Settings:
+    greeting = "hello, quadkit"
+
+
+class SettingsProvider(Provider):
+    async def register(self, container: ContainerRegistrarProtocol) -> None:
+        container.singleton(Settings, instance=Settings())
+
+
+async def main() -> None:
+    app = Application()
+    app.add_provider(SettingsProvider())
+    await app.start()
+    try:
+        settings = await app.container.resolve(Settings)
+        print(settings.greeting)
+    finally:
+        await app.stop()
+
+
+asyncio.run(main())
+```
+
+For the web quickstart (a real endpoint in minutes), see
+[the docs](https://dbtinoy-.github.io/quadkit/getting-started/first-app/).
+
+## Expected failures are values
+
+`Result[T, E]` keeps the happy path and the failure path in the type
+system — `pipeline()` chains fallible steps without `try/except`
+pyramids, and `mypy` sees the error type at every step:
+
+```python
+from quadkit.result import Err, Ok, pipeline
+
+
+def parse_port(raw: str):
+    try:
+        port = int(raw)
+    except ValueError as exc:
+        return Err(exc)
+    if not 1 <= port <= 65535:
+        return Err(ValueError(f"port out of range: {port}"))
+    return Ok(port)
+
+
+result = (
+    pipeline("8080")  # infallible start
+    .then(parse_port)  # Result[int, ValueError]
+    .map(lambda port: f"listening on :{port}")
+    .finalize()  # Result[str, ValueError]
+)
+```
+
+In controllers, returning an `Err` renders as an RFC 7807 problem
+response automatically — see the
+[error-handling guide](https://dbtinoy-.github.io/quadkit/guides/error-handling/).
+
+## Optional extras
+
+| Extra | Contents |
+| --- | --- |
+| `quadkit[web]` | `quadkit-web[granian]` — the full web stack |
+| `quadkit[test]` | `pytest`, `pytest-asyncio`, `pytest-cov`, `pytest-mock` |
+| `quadkit[security]` | `cryptography` (signing/token helpers) |
+| `quadkit[codegen]` | code generation toolchain |
+| `quadkit[docs]` / `[dev]` | documentation / development tooling |
+
+## Public API entry points
+
+```python
+from quadkit import Application, Result, Ok, Err
+from quadkit.di.provider import Provider
+from quadkit.di.container import Container
+from quadkit.config import BaseConfig, ConfigLoader
+from quadkit.logging import get_logger
+from quadkit.domain import AggregateRoot, Entity, DomainEvent, AbstractUnitOfWork
+from quadkit.contracts.core.di import (
+    ContainerRegistrarProtocol,
+    ContainerResolverProtocol,
+)
+```
+
+Providers can also define an async `boot()` (acquire resources) and
+`shutdown()` (release them, in reverse registration order) — the
+container drives the whole lifecycle.
+
+Concepts: [contracts](https://dbtinoy-.github.io/quadkit/concepts/contracts/) ·
+[dependency injection](https://dbtinoy-.github.io/quadkit/concepts/dependency-injection/) ·
+[modules](https://dbtinoy-.github.io/quadkit/concepts/modules/) ·
+[lifecycle](https://dbtinoy-.github.io/quadkit/concepts/lifecycle/) ·
+[async model](https://dbtinoy-.github.io/quadkit/concepts/async-model/).
+
+## Configuration
+
+`application.yaml` at the working directory, validated against typed
+config models at boot (unknown keys fail fast); application metadata
+lives at the root (`name`, `version`, `description`); every typed key
+overrides from the environment with `QK_<SECTION>__<KEY>`. Use
+`QK_PROFILE` to select a profile.
+
+```bash
+QK_QUADKIT__LOGGING__LEVEL=DEBUG   # fold into the root `logging` section
+QK_PROFILE=production              # select a profile block
+```
+
+See
+[configuration](https://dbtinoy-.github.io/quadkit/getting-started/configuration/).
+
+## Error handling
+
+`Result[T, E]` for expected domain failures; the
+`quadkit-contracts` exception hierarchy (`QuadkitError → DomainError →
+NotFoundError`, `ValidationError`, `ConflictError`, ...) for everything
+else. The web layer renders both as problem responses — see
+[error handling](https://dbtinoy-.github.io/quadkit/guides/error-handling/).
+
+## Testing
+
+Pair with `quadkit-testing`: `AppTestBed.from_factory(create_app)` boots
+your application in-process (with `overrides={Contract: fake}` for test
+doubles), no server required. See
+[testing](https://dbtinoy-.github.io/quadkit/getting-started/testing/).
+
+## Security
+
+Never put secrets in `application.yaml` — pass them through `QK_*`
+environment variables or a secret store. Unexpected exceptions never
+leak internals to clients. See
+[secure configuration](https://dbtinoy-.github.io/quadkit/security/secure-configuration/) and
+report vulnerabilities privately per
+[SECURITY.md](https://github.com/dbtinoy-/quadkit/blob/main/SECURITY.md).
+
+## Stability
+
+Version `0.0.3` in the `0.x` series, released in lockstep with the
+other four distributions; APIs may change between minor versions until
+1.0 — pin an exact version
+(`quadkit==0.0.3`) or a tight range (`>=0.0.3,<0.1.0`). Full policy:
+[stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
+
+## Links
+
+- **Documentation** — <https://dbtinoy-.github.io/quadkit/>
+- **Getting started** — <https://dbtinoy-.github.io/quadkit/getting-started/installation/>
+- **Changelog** — <https://github.com/dbtinoy-/quadkit/blob/main/CHANGELOG.md>
+- **Issues** — <https://github.com/dbtinoy-/quadkit/issues>
+- **Security** — report privately per [SECURITY.md](https://github.com/dbtinoy-/quadkit/blob/main/SECURITY.md)
+- **Contributing** — [CONTRIBUTING.md](https://github.com/dbtinoy-/quadkit/blob/main/CONTRIBUTING.md)
+
+Apache-2.0 — see [LICENSE](https://github.com/dbtinoy-/quadkit/blob/main/LICENSE). "Quadkit" and the
+Quadkit logo are trademarks of the project — see
+[TRADEMARK.md](https://github.com/dbtinoy-/quadkit/blob/main/TRADEMARK.md).

quadkit-0.0.41/README.md

@@ -0,0 +1,219 @@
+# quadkit
+
+![Quadkit](https://raw.githubusercontent.com/dbtinoy-/quadkit/main/banner.jpg)
+
+[![PyPI](https://img.shields.io/pypi/v/quadkit?color=%2322c55e&label=pypi)](https://pypi.org/project/quadkit/)
+[![Python](https://img.shields.io/pypi/pyversions/quadkit?color=%2322c55e)](https://pypi.org/project/quadkit/)
+[![License](https://img.shields.io/pypi/l/quadkit?color=%2322c55e)](https://github.com/dbtinoy-/quadkit/blob/main/LICENSE)
+
+Async-first application framework for Python: dependency-injection
+container, application lifecycle, typed configuration, and the `Result`
+error model. This is the core package; everything else published from
+this repository builds on it.
+
+For application developers — write providers and modules, bind
+contracts, and let one container boot them in order.
+
+What's in the box:
+
+- **DI container** — singleton, scoped, and transient bindings, async
+  factories, override support for tests; the graph resolves once, at
+  boot.
+- **Provider & module system** — providers register bindings, boot
+  resources, and shut them down in reverse order; modules compose
+  providers into reusable units.
+- **Typed configuration** — `application.yaml` validated against
+  dataclass models at boot (unknown keys fail fast), every key
+  overridable via `QK_*` environment variables, profiles via `QK_PROFILE`.
+- **The `Result` model** — expected failures are values
+  (`Ok`/`Err`), not exceptions; `ResultPipeline` chains them fluently
+  while keeping the error type visible to mypy.
+- **Structured logging** — `get_logger()` gives every service a
+  keyed, structlog-style logger out of the box.
+- **Domain primitives** — `AggregateRoot`, `Entity`, `DomainEvent`,
+  `AbstractUnitOfWork` for DDD-style modelling without a framework
+  tax.
+
+## The quadkit family
+
+| Package | Role |
+| --- | --- |
+| [`quadkit-contracts`](https://pypi.org/project/quadkit-contracts/) | zero-dependency protocols, types, exception hierarchy |
+| [`quadkit`](https://pypi.org/project/quadkit/) | the framework core — DI container, modules, config, logging, `Result` |
+| [`quadkit-web`](https://pypi.org/project/quadkit-web/) | ASGI layer — controllers, routing, middleware, OpenAPI docs |
+| [`quadkit-cli`](https://pypi.org/project/quadkit-cli/) | project scaffolding and code generators |
+| [`quadkit-testing`](https://pypi.org/project/quadkit-testing/) | in-process test beds, fakes, fixtures |
+
+## Installation
+
+```bash
+uv add quadkit
+# batteries-included web stack:
+uv add "quadkit[web]"
+```
+
+Requires **Python >= 3.11**.
+
+## Minimal working example
+
+```python
+import asyncio
+
+from quadkit import Application
+from quadkit.contracts.core.di import ContainerRegistrarProtocol
+from quadkit.di.provider import Provider
+
+
+class Settings:
+    greeting = "hello, quadkit"
+
+
+class SettingsProvider(Provider):
+    async def register(self, container: ContainerRegistrarProtocol) -> None:
+        container.singleton(Settings, instance=Settings())
+
+
+async def main() -> None:
+    app = Application()
+    app.add_provider(SettingsProvider())
+    await app.start()
+    try:
+        settings = await app.container.resolve(Settings)
+        print(settings.greeting)
+    finally:
+        await app.stop()
+
+
+asyncio.run(main())
+```
+
+For the web quickstart (a real endpoint in minutes), see
+[the docs](https://dbtinoy-.github.io/quadkit/getting-started/first-app/).
+
+## Expected failures are values
+
+`Result[T, E]` keeps the happy path and the failure path in the type
+system — `pipeline()` chains fallible steps without `try/except`
+pyramids, and `mypy` sees the error type at every step:
+
+```python
+from quadkit.result import Err, Ok, pipeline
+
+
+def parse_port(raw: str):
+    try:
+        port = int(raw)
+    except ValueError as exc:
+        return Err(exc)
+    if not 1 <= port <= 65535:
+        return Err(ValueError(f"port out of range: {port}"))
+    return Ok(port)
+
+
+result = (
+    pipeline("8080")  # infallible start
+    .then(parse_port)  # Result[int, ValueError]
+    .map(lambda port: f"listening on :{port}")
+    .finalize()  # Result[str, ValueError]
+)
+```
+
+In controllers, returning an `Err` renders as an RFC 7807 problem
+response automatically — see the
+[error-handling guide](https://dbtinoy-.github.io/quadkit/guides/error-handling/).
+
+## Optional extras
+
+| Extra | Contents |
+| --- | --- |
+| `quadkit[web]` | `quadkit-web[granian]` — the full web stack |
+| `quadkit[test]` | `pytest`, `pytest-asyncio`, `pytest-cov`, `pytest-mock` |
+| `quadkit[security]` | `cryptography` (signing/token helpers) |
+| `quadkit[codegen]` | code generation toolchain |
+| `quadkit[docs]` / `[dev]` | documentation / development tooling |
+
+## Public API entry points
+
+```python
+from quadkit import Application, Result, Ok, Err
+from quadkit.di.provider import Provider
+from quadkit.di.container import Container
+from quadkit.config import BaseConfig, ConfigLoader
+from quadkit.logging import get_logger
+from quadkit.domain import AggregateRoot, Entity, DomainEvent, AbstractUnitOfWork
+from quadkit.contracts.core.di import (
+    ContainerRegistrarProtocol,
+    ContainerResolverProtocol,
+)
+```
+
+Providers can also define an async `boot()` (acquire resources) and
+`shutdown()` (release them, in reverse registration order) — the
+container drives the whole lifecycle.
+
+Concepts: [contracts](https://dbtinoy-.github.io/quadkit/concepts/contracts/) ·
+[dependency injection](https://dbtinoy-.github.io/quadkit/concepts/dependency-injection/) ·
+[modules](https://dbtinoy-.github.io/quadkit/concepts/modules/) ·
+[lifecycle](https://dbtinoy-.github.io/quadkit/concepts/lifecycle/) ·
+[async model](https://dbtinoy-.github.io/quadkit/concepts/async-model/).
+
+## Configuration
+
+`application.yaml` at the working directory, validated against typed
+config models at boot (unknown keys fail fast); application metadata
+lives at the root (`name`, `version`, `description`); every typed key
+overrides from the environment with `QK_<SECTION>__<KEY>`. Use
+`QK_PROFILE` to select a profile.
+
+```bash
+QK_QUADKIT__LOGGING__LEVEL=DEBUG   # fold into the root `logging` section
+QK_PROFILE=production              # select a profile block
+```
+
+See
+[configuration](https://dbtinoy-.github.io/quadkit/getting-started/configuration/).
+
+## Error handling
+
+`Result[T, E]` for expected domain failures; the
+`quadkit-contracts` exception hierarchy (`QuadkitError → DomainError →
+NotFoundError`, `ValidationError`, `ConflictError`, ...) for everything
+else. The web layer renders both as problem responses — see
+[error handling](https://dbtinoy-.github.io/quadkit/guides/error-handling/).
+
+## Testing
+
+Pair with `quadkit-testing`: `AppTestBed.from_factory(create_app)` boots
+your application in-process (with `overrides={Contract: fake}` for test
+doubles), no server required. See
+[testing](https://dbtinoy-.github.io/quadkit/getting-started/testing/).
+
+## Security
+
+Never put secrets in `application.yaml` — pass them through `QK_*`
+environment variables or a secret store. Unexpected exceptions never
+leak internals to clients. See
+[secure configuration](https://dbtinoy-.github.io/quadkit/security/secure-configuration/) and
+report vulnerabilities privately per
+[SECURITY.md](https://github.com/dbtinoy-/quadkit/blob/main/SECURITY.md).
+
+## Stability
+
+Version `0.0.3` in the `0.x` series, released in lockstep with the
+other four distributions; APIs may change between minor versions until
+1.0 — pin an exact version
+(`quadkit==0.0.3`) or a tight range (`>=0.0.3,<0.1.0`). Full policy:
+[stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
+
+## Links
+
+- **Documentation** — <https://dbtinoy-.github.io/quadkit/>
+- **Getting started** — <https://dbtinoy-.github.io/quadkit/getting-started/installation/>
+- **Changelog** — <https://github.com/dbtinoy-/quadkit/blob/main/CHANGELOG.md>
+- **Issues** — <https://github.com/dbtinoy-/quadkit/issues>
+- **Security** — report privately per [SECURITY.md](https://github.com/dbtinoy-/quadkit/blob/main/SECURITY.md)
+- **Contributing** — [CONTRIBUTING.md](https://github.com/dbtinoy-/quadkit/blob/main/CONTRIBUTING.md)
+
+Apache-2.0 — see [LICENSE](https://github.com/dbtinoy-/quadkit/blob/main/LICENSE). "Quadkit" and the
+Quadkit logo are trademarks of the project — see
+[TRADEMARK.md](https://github.com/dbtinoy-/quadkit/blob/main/TRADEMARK.md).

{quadkit-0.0.3 → quadkit-0.0.41}/example.yaml

@@ -119,9 +119,6 @@ concurrency:
   # Default capacity for BoundedChannel instances.
   default_channel_capacity: 100
 
-  # Default semaphore acquisition timeout (seconds).
-  default_semaphore_timeout: 30.0
-
   # Number of worker threads for the thread pool executor.
   worker_threads: 4
 
@@ -132,8 +129,6 @@ concurrency:
   dispatcher:
     max_concurrent_tasks: 100
     queue_timeout: 30.0
-    retry_failed_tasks: true
-    max_retries: 3
 
     pool:
       min_size: 1
@@ -185,9 +180,6 @@ middleware:
   default_retry_count: 3
   default_retry_delay: 1.0
 
-  # HTTP header for correlation ID propagation.
-  correlation_header: "X-Correlation-ID"
-
   # Default timeout for TimeoutMiddleware (seconds).
   default_timeout: 30.0
 
@@ -203,15 +195,6 @@ middleware:
   # Rate limiter: window duration in seconds.
   rate_limit_window: 60.0
 
-# -- Domain ----------------------------------------------------------------
-
-domain:
-  # Raise at runtime when code mutates a frozen ValueObject.
-  strict_immutability: false
-
-  # Prefix prepended to auto-generated entity IDs (deprecated -- use identity.prefix_map).
-  id_prefix: ""
-
 # -- Mapping ---------------------------------------------------------------
 
 mapping:

{quadkit-0.0.3 → quadkit-0.0.41}/pyproject.toml

@@ -27,7 +27,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quadkit"
-version = "0.0.3"
+version = "0.0.41"
 description = "Async-first DI/IoC framework for Python — core package"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -68,9 +68,9 @@ maintainers = [
 
 dependencies = [
     "quadkit-contracts>=0.0.2",
-    "orjson>=3.0.0",
+    "orjson>=3.0.0,<4",
     "structlog>=25.1.0,<27",         # Structured logging foundation
-    "pydantic>=2.10.0",              # Required: used unconditionally by config, validation
+    "pydantic>=2.10.0,<3",              # Required: used unconditionally by config, validation
 ]
 
 # =============================================================================
@@ -85,33 +85,33 @@ dependencies = [
 # ── Development ────────────────────────────────────────────────────────
 
 dev = [
-    "ruff>=0.16.4",
-    "mypy>=1.0.0",
-    "pre-commit>=3.0.0",
+    "ruff>=0.16.4,<1",
+    "mypy>=1.0.0,<3",
+    "pre-commit>=3.0.0,<5",
 ]
 
 # Codegen extra — opt-in template engine for quadkit.codegen scaffolders.
 # The base classes import jinja2 lazily; only template rendering needs it.
 codegen = [
-    "jinja2>=3.1.0",
+    "jinja2>=3.1.0,<4",
 ]
 
 test = [
-    "pytest>=8.0.0",
-    "pytest-asyncio>=0.21.0",
-    "pytest-cov>=4.0.0",
-    "pytest-mock>=3.10.0",
+    "pytest>=8.0.0,<10",
+    "pytest-asyncio>=0.21.0,<2",
+    "pytest-cov>=4.0.0,<8",
+    "pytest-mock>=3.10.0,<4",
 ]
 
 docs = [
-    "mkdocs>=1.4.0",
-    "mkdocs-material>=9.0.0",
+    "mkdocs>=1.4.0,<2",
+    "mkdocs-material>=9.0.0,<10",
 ]
 
 # Security extras — opt-in deps for quadkit.security.* implementations
 # Encryption requires cryptography.
 security = [
-    "cryptography>=41.0.0",
+    "cryptography>=41.0.0,<52",
 ]
 
 # ── Extension Convenience Groups ──────────────────────────────────────
@@ -135,9 +135,9 @@ web = [
 # =============================================================================
 
 [project.urls]
-Homepage = "https://quadkit.dev"
+Homepage = "https://dbtinoy-.github.io/quadkit/"
 Repository = "https://github.com/dbtinoy-/quadkit"
-Documentation = "https://quadkit.dev"
+Documentation = "https://dbtinoy-.github.io/quadkit/"
 Issues = "https://github.com/dbtinoy-/quadkit/issues"
 Changelog = "https://github.com/dbtinoy-/quadkit/blob/main/CHANGELOG.md"
 
@@ -283,5 +283,3 @@ show_missing = true
 
 [tool.uv.sources]
 quadkit-contracts = { workspace = true }
-
-

{quadkit-0.0.3 → quadkit-0.0.41}/src/quadkit/concurrency/config.py

@@ -13,7 +13,6 @@ from dataclasses import dataclass, field
 from quadkit.concurrency.constants import (
     DEFAULT_CHANNEL_CAPACITY,
     DEFAULT_DISPATCHER_SHUTDOWN_TIMEOUT,
-    DEFAULT_SEMAPHORE_TIMEOUT,
     DEFAULT_WORKER_THREADS,
 )
 
@@ -98,11 +97,6 @@ class DispatcherConfig:
     Attributes:
         max_concurrent_tasks: Maximum number of concurrent tasks (>= 1).
         queue_timeout: Queue timeout in seconds (>= 0).
-        retry_failed_tasks: Reserved: DispatcherImpl propagates task
-            exceptions today (retrying non-idempotent tasks silently would be
-            unsafe); will gate automatic retries when implemented.
-        max_retries: Maximum number of retries (>= 0); only meaningful
-            together with retry_failed_tasks (see above).
         pool: Worker pool configuration.
         cpu_pool: CPU-bound thread pool configuration.
         io_pool: I/O-bound thread pool configuration.
@@ -110,8 +104,6 @@ class DispatcherConfig:
 
     max_concurrent_tasks: int = 100
     queue_timeout: float = 30.0
-    retry_failed_tasks: bool = True
-    max_retries: int = 3
     pool: PoolConfig = field(default_factory=PoolConfig)
     cpu_pool: ThreadPoolConfig = field(default_factory=ThreadPoolConfig)
     io_pool: ThreadPoolConfig = field(default_factory=ThreadPoolConfig)
@@ -123,8 +115,6 @@ class DispatcherConfig:
             )
         if self.queue_timeout < 0:
             raise ValueError(f"queue_timeout must be >= 0, got {self.queue_timeout}")
-        if self.max_retries < 0:
-            raise ValueError(f"max_retries must be >= 0, got {self.max_retries}")
 
     def get_cpu_pool_config(self) -> ThreadPoolConfig:
         """Return the CPU-bound thread pool configuration.
@@ -156,11 +146,6 @@ class ConcurrencyConfig:
     # consumed by: ConcurrencyProvider.boot() -> BoundedChannel.configure();
     #   channels created without an explicit capacity pick this up (explicit
     #   ``capacity=0`` still means unbounded).
-    default_semaphore_timeout: float = DEFAULT_SEMAPHORE_TIMEOUT
-    # reserved: core dispatch uses ``asyncio.Semaphore`` with no default
-    #   acquisition timeout; applying one would convert unbounded waits in
-    #   saturated batch workloads into timeouts. Wire when a dedicated
-    #   Semaphore primitive lands.
     worker_threads: int = DEFAULT_WORKER_THREADS
     # consumed by: thread pool executor in ConcurrencyProvider.register()
     dispatcher_shutdown_timeout: float = DEFAULT_DISPATCHER_SHUTDOWN_TIMEOUT

{quadkit-0.0.3 → quadkit-0.0.41}/src/quadkit/concurrency/constants.py

@@ -25,9 +25,6 @@ ENV_NESTED_DELIMITER: str = "__"
 DEFAULT_CHANNEL_CAPACITY: int = 100
 """Default bounded-channel buffer size; consumed by: Channel.__init__."""
 
-DEFAULT_SEMAPHORE_TIMEOUT: float = 30.0
-"""Default semaphore acquisition timeout in seconds; consumed by: Semaphore default."""
-
 DEFAULT_WORKER_THREADS: int = 4
 """Default thread-pool size; consumed by: thread pool executor in Dispatcher."""
 
@@ -37,7 +34,6 @@ DEFAULT_DISPATCHER_SHUTDOWN_TIMEOUT: float = 10.0
 __all__ = [
     "DEFAULT_CHANNEL_CAPACITY",
     "DEFAULT_DISPATCHER_SHUTDOWN_TIMEOUT",
-    "DEFAULT_SEMAPHORE_TIMEOUT",
     "DEFAULT_WORKER_THREADS",
     "ENV_NESTED_DELIMITER",
     "ENV_PREFIX",