quadkit-testing 0.0.42__tar.gz → 0.0.44__tar.gz

quadkit_testing-0.0.44/.gitignore

@@ -0,0 +1,24 @@
+# Generated public-repository ignore rules.
+# Private monorepo paths are intentionally not referenced here.
+
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+.venv/
+venv/
+.env
+.env.*
+!.env.example
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+coverage.xml
+htmlcov/
+build/
+dist/
+*.log
+.DS_Store
+.idea/
+.vscode/

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: quadkit-testing
-Version: 0.0.42
+Version: 0.0.44
 Summary: Centralized testing infrastructure for Quadkit Framework - Fixtures, factories, and utilities
 Project-URL: Homepage, https://dbtinoy-.github.io/quadkit/
 Project-URL: Repository, https://github.com/dbtinoy-/quadkit
@@ -32,23 +32,9 @@ Requires-Dist: pytest-mock<4,>=3.10.0
 Requires-Dist: pytest<10,>=8.0.0
 Requires-Dist: quadkit-contracts>=0.0.2
 Requires-Dist: quadkit>=0.0.2
-Provides-Extra: all
-Requires-Dist: aiosqlite<1,>=0.19.0; extra == 'all'
-Requires-Dist: asyncpg<1,>=0.29.0; extra == 'all'
-Requires-Dist: httpx2<3,>=2.0.0; extra == 'all'
-Requires-Dist: httpx<1,>=0.26.0; extra == 'all'
-Requires-Dist: quadkit-auth>=0.0.2; extra == 'all'
-Requires-Dist: quadkit-cache>=0.0.2; extra == 'all'
-Requires-Dist: quadkit-storage>=0.0.2; extra == 'all'
-Requires-Dist: starlette<2,>=0.28.0; extra == 'all'
-Provides-Extra: auth
-Requires-Dist: quadkit-auth>=0.0.2; extra == 'auth'
-Provides-Extra: cache
-Requires-Dist: quadkit-cache>=0.0.2; extra == 'cache'
 Provides-Extra: db
-Requires-Dist: aiosqlite<1,>=0.19.0; extra == 'db'
-Requires-Dist: asyncpg<1,>=0.29.0; extra == 'db'
-Requires-Dist: quadkit-sql>=0.0.2; extra == 'db'
+Requires-Dist: aiosqlite>=0.19.0; extra == 'db'
+Requires-Dist: asyncpg>=0.29.0; extra == 'db'
 Provides-Extra: dev
 Requires-Dist: black<27,>=23.0.0; extra == 'dev'
 Requires-Dist: mypy<3,>=1.0.0; extra == 'dev'
@@ -62,8 +48,6 @@ Requires-Dist: motor<4,>=3.3.0; extra == 'integration'
 Requires-Dist: neo4j<7,>=5.18.0; extra == 'integration'
 Requires-Dist: qdrant-client<2,>=1.9.0; extra == 'integration'
 Requires-Dist: redis<9,>=5.0.0; extra == 'integration'
-Provides-Extra: storage
-Requires-Dist: quadkit-storage>=0.0.2; extra == 'storage'
 Provides-Extra: web
 Requires-Dist: httpx2<3,>=2.0.0; extra == 'web'
 Requires-Dist: httpx<1,>=0.26.0; extra == 'web'
@@ -250,10 +234,10 @@ vulnerabilities privately per [SECURITY.md](https://github.com/dbtinoy-/quadkit/
 
 ## Stability
 
-Version `0.0.42` in the `0.x` series, released in lockstep with the
+Version `0.0.44` 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-testing==0.0.42`) or a tight range
-(`>=0.0.42,<0.1.0`). Full policy:
+1.0 — pin an exact version (`quadkit-testing==0.0.44`) or a tight range
+(`>=0.0.44,<0.1.0`). Full policy:
 [stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
 
 ## Links

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/README.md

@@ -178,10 +178,10 @@ vulnerabilities privately per [SECURITY.md](https://github.com/dbtinoy-/quadkit/
 
 ## Stability
 
-Version `0.0.42` in the `0.x` series, released in lockstep with the
+Version `0.0.44` 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-testing==0.0.42`) or a tight range
-(`>=0.0.42,<0.1.0`). Full policy:
+1.0 — pin an exact version (`quadkit-testing==0.0.44`) or a tight range
+(`>=0.0.44,<0.1.0`). Full policy:
 [stability and compatibility](https://dbtinoy-.github.io/quadkit/reference/stability/).
 
 ## Links

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quadkit-testing"
-version = "0.0.42"
+version = "0.0.44"
 description = "Centralized testing infrastructure for Quadkit Framework - Fixtures, factories, and utilities"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -53,39 +53,19 @@ text = "Apache-2.0"
 
 [project.optional-dependencies]
 db = [
-    "aiosqlite>=0.19.0,<1",
-    "asyncpg>=0.29.0,<1",
-    "quadkit-sql>=0.0.2",
+    "aiosqlite>=0.19.0",
+    "asyncpg>=0.29.0",
 ]
 web = [
     "httpx>=0.26.0,<1",
     "httpx2>=2.0.0,<3",
     "starlette>=0.28.0,<2",
 ]
-auth = [
-    "quadkit-auth>=0.0.2",
-]
-cache = [
-    "quadkit-cache>=0.0.2",
-]
-storage = [
-    "quadkit-storage>=0.0.2",
-]
 dev = [
     "black>=23.0.0,<27",
     "ruff>=0.16.4,<1",
     "mypy>=1.0.0,<3",
 ]
-all = [
-    "aiosqlite>=0.19.0,<1",
-    "asyncpg>=0.29.0,<1",
-    "httpx>=0.26.0,<1",
-    "httpx2>=2.0.0,<3",
-    "starlette>=0.28.0,<2",
-    "quadkit-auth>=0.0.2",
-    "quadkit-cache>=0.0.2",
-    "quadkit-storage>=0.0.2",
-]
 integration = [
     "asyncpg>=0.29.0,<1",
     "aiosqlite>=0.19.0,<1",
@@ -184,9 +164,6 @@ workspace = true
 [tool.uv.sources.quadkit-contracts]
 workspace = true
 
-[tool.uv.sources.quadkit-secrets]
-workspace = true
-
 [tool.uv.sources.quadkit-sql]
 workspace = true
 

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/src/quadkit/testing/compliance/__init__.py

@@ -8,7 +8,7 @@ method, and pytest runs the contract checks::
             return RedisCacheBackend("redis://localhost:6379/15")
 
 Every suite named in `__all__` is importable; the secret-store suite ships only
-with the optional `quadkit-secrets` extra, so accessing it without that extra
+with the optional `the optional provider` extra, so accessing it without that extra
 raises `AttributeError` instead of failing at import time.
 """
 

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/src/quadkit/testing/compliance/flags.py

@@ -23,7 +23,7 @@ import pytest
 def _flag_not_found_error() -> type[Exception]:
     """Return the optional provider exception without a static private import."""
     try:
-        module = import_module("quadkit.features.exceptions")
+        module = import_module("the optional provider module")
         # The attribute ships only with a feature-provider install.
         return cast("type[Exception]", getattr(module, "FlagNotFoundError"))  # noqa: B009
     except (ImportError, AttributeError):

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/src/quadkit/testing/fakes/__init__.py

@@ -25,7 +25,7 @@ _LAZY_IMPORTS: Final[dict[str, tuple[str, str]]] = {
     ),
 }
 
-# Re-exports the production memory backend owned by ``quadkit-secrets``, which
+# Re-exports the production memory backend owned by ``the optional provider``, which
 # is not part of the published set.
 _OPTIONAL_MODULES: Final[frozenset[str]] = frozenset({"quadkit.testing.fakes.secrets"})
 

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/src/quadkit/testing/generators_contract.py

@@ -8,6 +8,30 @@ from pathlib import Path
 from typing import Any
 
 
+def _assert_marker_convention(py_path: Path, text: str) -> None:
+    """Enforce the generated-stub marker convention on one rendered ``.py``.
+
+    Generated stubs pair ``# @INTENT: <goal>`` directly above ``# @TODO:
+    <action>`` and never ship a bare ``# TODO:`` (the ``@`` prefix keeps both
+    greppable). See ``docs/09-27-2026/GENERATED_CODE_MARKERS.md``.
+    """
+    lines = text.splitlines()
+    for i, line in enumerate(lines):
+        stripped = line.strip()
+        if stripped.startswith("# TODO"):
+            raise AssertionError(
+                f"{py_path}: bare '# TODO' in generated code must be '# @TODO' "
+                f"-> {line!r}"
+            )
+        if stripped.startswith("# @TODO:"):
+            prev = lines[i - 1].strip() if i > 0 else ""
+            if not prev.startswith("# @INTENT:"):
+                raise AssertionError(
+                    f"{py_path}: '# @TODO' at line {i + 1} is not preceded by "
+                    f"a '# @INTENT:' line (found {prev!r})"
+                )
+
+
 def assert_contributor_generators_render(
     contributor: Any,
     *,
@@ -77,6 +101,15 @@ def assert_contributor_generators_render(
             f"(created={len(created)}, overwritten={len(overwritten)}, "
             f"staged={len(staged)})"
         )
+
+        # Every rendered Python stub must follow the @INTENT/@TODO marker
+        # convention — a single gate so a new generator (or a template at a
+        # deeper package nesting) cannot reintroduce a bare ``# TODO``.
+        for py_file in out.rglob("*.py"):
+            if "__pycache__" in py_file.parts:
+                continue
+            _assert_marker_convention(py_file, py_file.read_text(encoding="utf-8"))
+
         exercised += 1
     return exercised
 

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/src/quadkit/testing/integration/probes.py

@@ -51,7 +51,7 @@ class ServiceProbe:
             await client.close()
             return True
         except Exception as e:  # noqa: BLE001
-            logger.debug("probe_failed", service="redis", url=url, error=str(e))
+            logger.debug("probe_failed", dependency="redis", url=url, error=str(e))
             return False
 
     @staticmethod
@@ -66,7 +66,7 @@ class ServiceProbe:
             await conn.close()
             return True
         except Exception as e:  # noqa: BLE001
-            logger.debug("probe_failed", service="postgres", dsn=dsn, error=str(e))
+            logger.debug("probe_failed", dependency="postgres", dsn=dsn, error=str(e))
             return False
 
     @staticmethod
@@ -79,7 +79,9 @@ class ServiceProbe:
                 response = await client.get(url)
                 return response.status_code == 200
         except Exception as e:  # noqa: BLE001
-            logger.debug("probe_failed", service="elasticsearch", url=url, error=str(e))
+            logger.debug(
+                "probe_failed", dependency="elasticsearch", url=url, error=str(e)
+            )
             return False
 
     @staticmethod
@@ -94,7 +96,7 @@ class ServiceProbe:
             await connection.close()
             return True
         except Exception as e:  # noqa: BLE001
-            logger.debug("probe_failed", service="rabbitmq", url=url, error=str(e))
+            logger.debug("probe_failed", dependency="rabbitmq", url=url, error=str(e))
             return False
 
     @staticmethod
@@ -107,7 +109,9 @@ class ServiceProbe:
                 response = await client.get(f"{url}/health")
                 return response.status_code == 200
         except Exception as e:  # noqa: BLE001
-            logger.debug("probe_failed", service="meilisearch", url=url, error=str(e))
+            logger.debug(
+                "probe_failed", dependency="meilisearch", url=url, error=str(e)
+            )
             return False
 
     @staticmethod
@@ -125,7 +129,7 @@ class ServiceProbe:
             return True
         except Exception as e:  # noqa: BLE001
             logger.debug(
-                "probe_failed", service="smtp", host=host, port=port, error=str(e)
+                "probe_failed", dependency="smtp", host=host, port=port, error=str(e)
             )
             return False
 
@@ -152,7 +156,7 @@ class ServiceProbe:
             return True
         except Exception as e:  # noqa: BLE001
             logger.debug(
-                "probe_failed", service="kafka", bootstrap=bootstrap, error=str(e)
+                "probe_failed", dependency="kafka", bootstrap=bootstrap, error=str(e)
             )
             return False
 
@@ -179,7 +183,7 @@ class ServiceProbe:
             return True
         except Exception as e:  # noqa: BLE001
             logger.debug(
-                "probe_failed", service="minio", endpoint=endpoint, error=str(e)
+                "probe_failed", dependency="minio", endpoint=endpoint, error=str(e)
             )
             return False
 
@@ -207,7 +211,7 @@ class ServiceProbe:
             await writer.wait_closed()
             return True
         except Exception as e:  # noqa: BLE001
-            logger.debug("probe_failed", service="mongodb", dsn=dsn, error=str(e))
+            logger.debug("probe_failed", dependency="mongodb", dsn=dsn, error=str(e))
             return False
 
     @staticmethod
@@ -234,7 +238,7 @@ class ServiceProbe:
             await writer.wait_closed()
             return True
         except Exception as e:  # noqa: BLE001
-            logger.debug("probe_failed", service="qdrant", url=url, error=str(e))
+            logger.debug("probe_failed", dependency="qdrant", url=url, error=str(e))
             return False
 
     @staticmethod
@@ -261,5 +265,5 @@ class ServiceProbe:
             await writer.wait_closed()
             return True
         except Exception as e:  # noqa: BLE001
-            logger.debug("probe_failed", service="neo4j", url=url, error=str(e))
+            logger.debug("probe_failed", dependency="neo4j", url=url, error=str(e))
             return False

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/src/quadkit/testing/lib/admin_helpers.py

@@ -1,4 +1,4 @@
-"""Admin-specific test helpers for quadkit-admin tests."""
+"""Admin-specific test helpers for the optional provider tests."""
 
 from __future__ import annotations
 
@@ -42,7 +42,7 @@ class AdminResponse:
 
 
 class AdminTestClient:
-    """Test client with helpers for quadkit-admin endpoints.
+    """Test client with helpers for the optional provider endpoints.
 
     Wraps a Starlette ``TestClient`` (or any httpx-compatible sync client)
     and provides assertion helpers and convenience methods for CRUD operations.

{quadkit_testing-0.0.42 → quadkit_testing-0.0.44}/tests/unit/test_subpackage_exports.py

@@ -18,6 +18,8 @@ from typing import Any
 
 import pytest
 
+from quadkit.testing._lazy_exports import module_shipped
+
 
 def get_public_members(module: Any) -> set[str]:
     """Get all public member names from a module (not starting with _)."""
@@ -45,6 +47,29 @@ def get_public_defined_members(module: Any) -> set[str]:
     return defined
 
 
+def optional_module_absent(subpackage: Any, export_name: str) -> bool:
+    """Whether an export belongs to an optional module this installation omits.
+
+    A facade keeps the names of an absent optional module in ``__all__`` so the
+    declared surface stays truthful, and ``resolve_export`` answers an access
+    with ``AttributeError``. That is the designed outcome for a name whose
+    module is not part of the installation, so it is not an export failure.
+
+    Args:
+        subpackage: Facade module holding ``_LAZY_IMPORTS`` and ``__all__``.
+        export_name: One name from that facade's ``__all__``.
+
+    Returns:
+        Whether the name's module is an optional one that is not shipped here.
+    """
+    table = getattr(subpackage, "_LAZY_IMPORTS", None)
+    entry = table.get(export_name) if table is not None else None
+    if entry is None:
+        return False
+    optional = getattr(subpackage, "_OPTIONAL_MODULES", frozenset())
+    return entry[0] in optional and not module_shipped(entry[0])
+
+
 class TestComplianceSubpackageExports:
     """Test that compliance subpackage exports all public APIs."""
 
@@ -185,6 +210,8 @@ class TestFixturesSubpackageExports:
         from quadkit.testing import fixtures
 
         for export_name in fixtures.__all__:
+            if optional_module_absent(fixtures, export_name):
+                continue
             assert hasattr(fixtures, export_name), (
                 f"fixtures.{export_name} not accessible but listed in __all__"
             )
@@ -196,6 +223,8 @@ class TestFixturesSubpackageExports:
         from quadkit.testing import fixtures
 
         for export_name in fixtures.__all__:
+            if optional_module_absent(fixtures, export_name):
+                continue
             obj = getattr(fixtures, export_name)
             # Fixtures are callables, some might be test utilities
             assert callable(obj) or inspect.isclass(obj), (
@@ -250,6 +279,8 @@ class TestAllSubpackagesConsistency:
 
         for subpackage in [compliance, fixtures, memory]:
             for export_name in subpackage.__all__:
+                if optional_module_absent(subpackage, export_name):
+                    continue
                 try:
                     obj = getattr(subpackage, export_name)
                     assert obj is not None, (

quadkit_testing-0.0.42/.gitignore

@@ -1,214 +0,0 @@
-*
-!tests/
-!tests/**
-!README.md
-!AGENTS.md
-!DEVELOPMENT.md
-!QUICKGUIDE.md
-!MILESTONE*.md
-!TESTS*.md
-!CHANGELOG.md
-!AUDIT*.md
-!REF*.md
-!AUDIT*.json
-!LICENSE
-!LICENSE-MIT.txt
-!NOTICE
-!TRADEMARK.md
-!conftest.py
-!CONTRIBUTING.md
-!CODE_OF_CONDUCT.md
-!SECURITY.md
-!GOVERNANCE.md
-!pyproject.toml
-!uv.lock
-!docker-compose.yml
-!.env.example
-!.env.full.example
-!.importlinter
-!.superpowers/
-!.superpowers/**
-!.gitattributes
-!.editorconfig
-!Makefile
-!docker-compose.test.yml
-!quadkit.yaml.example
-!.github/
-!.github/workflows/
-!.github/workflows/**
-!.github/dependabot.yml
-!.devcontainer/
-!.devcontainer/**
-!tools/
-!tools/**
-!*example.yaml
-
-# Quadkit Packages
-!quadkit*/
-!quadkit*/pyproject.toml
-!quadkit*/CHANGELOG.md
-!quadkit*/README.md
-!quadkit*/alembic.ini
-!quadkit*/mypy.ini
-!quadkit*/*.yaml.example
-!quadkit*/src/
-!quadkit*/src/**
-!quadkit*/docs/
-!quadkit*/docs/**
-!quadkit*/tests/
-!quadkit*/tests/**
-
-# Keep quadkit docs
-!/docs/
-!docs/**
-
-# Session / cutover plans at the repo root
-!plans/
-!plans/**
-
-# Keep example files for README examples
-!/examples/
-!/examples/**
-
-# Re-ignore these AFTER negations (last match wins)
-*.tape
-examples/*/runs/
-__pycache__/
-*.pyc
-*.pyo
-*.egg-info/
-dist/
-build/
-.eggs/
-*.egg
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-htmlcov/
-.coverage
-coverage.xml
-test.db
-!quadkit*/tests/fixtures/test.db
-*.log
-*.tmp
-
-# Company-specific files (keep private, do not commit)
-.company/
-COMPANY_*.md
-company-config/
-internal-docs/
-# Editor swap files
-*.swp
-
-!core/
-!packages/
-!core/quadkit*/
-!packages/quadkit*/
-!core/quadkit*/pyproject.toml
-!packages/quadkit*/pyproject.toml
-!core/quadkit*/CHANGELOG.md
-!packages/quadkit*/CHANGELOG.md
-!core/quadkit*/README.md
-!packages/quadkit*/README.md
-!core/quadkit*/alembic.ini
-!packages/quadkit*/alembic.ini
-!core/quadkit*/mypy.ini
-!packages/quadkit*/mypy.ini
-!core/quadkit*/*.yaml.example
-!packages/quadkit*/*.yaml.example
-!core/quadkit*/src/
-!core/quadkit*/src/**
-!packages/quadkit*/src/
-!packages/quadkit*/src/**
-!core/quadkit*/tests/
-!core/quadkit*/tests/**
-!packages/quadkit*/tests/
-!packages/quadkit*/tests/**
-!core/quadkit*/docs/
-!core/quadkit*/docs/**
-!packages/quadkit*/docs/
-!packages/quadkit*/docs/**
-
-# dev/
-!dev/
-!dev/**
-
-# Admin dev playground (committed dev asset; local SQLite files stay ignored)
-!packages/quadkit-admin/playground/
-!packages/quadkit-admin/playground/serve.py
-
-# gatewai apps
-!apps/
-!apps/**
-!apps/gatewai/
-!apps/gatewai/**
-apps/**/node_modules/
-apps/**/dist/
-apps/**/__pycache__/
-apps/**/*.pyc
-apps/**/*.db
-apps/**/*.db-wal
-apps/**/*.db-shm
-apps/**/.env
-apps/**/.env.*
-!apps/**/.env.example
-!apps/**/.env.full.example
-
-# Piccolina — nested app tracked in this monorepo (standalone .git removed).
-# Keep marketing packages and deployment secrets out of the tree.
-apps/piccolina/piccolina-marketing/
-apps/piccolina/piccolina-marketing-plans/
-apps/piccolina/secrets/
-apps/piccolina/**/secrets/
-apps/piccolina/**/*.pem
-apps/piccolina/**/*.key
-apps/piccolina/**/.venv/
-apps/piccolina/**/node_modules/
-apps/piccolina/**/__pycache__/
-apps/piccolina/**/*.pyc
-apps/piccolina/**/*.pbf
-apps/piccolina/**/.open-next/
-apps/piccolina/**/storage/
-apps/piccolina/**/.deploy-host
-
-# Re-exclude private content under the tiered paths.
-# MUST come after the !...docs/** negations above — last match wins.
-core/quadkit*/docs/plans/
-packages/quadkit*/docs/plans/
-core/quadkit*/docs/**/
-packages/quadkit*/docs/**/
-
-# Re-exclude tooling artifacts under the tiered paths
-__pycache__/
-*.pyc
-*.pyo
-*.egg-info/
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-htmlcov/
-.coverage
-coverage.xml
-test.db
-*.tmp
-*.log
-!core/quadkit*/tests/fixtures/test.db
-!packages/quadkit*/tests/fixtures/test.db
-
-# Allow the generated example gifs to be tracked (README hero images).
-!core/quadkit*/docs/gifs/
-!core/quadkit*/docs/gifs/**
-!packages/*/quadkit*/docs/gifs/
-!packages/*/quadkit*/docs/gifs/**
-examples/*/screenshot.png
-!banner*
-apps/quadkit-playground/**/node_modules/
-apps/quadkit-playground/**/dist/
-apps/quadkit-playground/**/__pycache__/
-apps/quadkit-playground/**/*.pyc
-apps/quadkit-playground/**/*.db
-apps/quadkit-playground/**/*.db-wal
-apps/quadkit-playground/**/*.db-shm
-apps/quadkit-playground/projects/
-apps/quadkit-playground/quadkit/
-docs/superpowers/