culvert 0.1.0__tar.gz

culvert-0.1.0/.gitignore

@@ -0,0 +1,131 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environment
+venv/
+ENV/
+env/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Jupyter Notebooks
+.ipynb_checkpoints
+*.ipynb
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+.pytest_results*.txt
+
+# Environment variables
+.env
+.env.local
+
+# GCP
+.gcp/
+credentials.json
+service-account.json
+
+# Logs
+*.log
+logs/
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+
+# Data files (large datasets should not be committed)
+data/output/*
+data/archive/*
+!data/input/applications_20250119_1.csv  # Keep sample data
+*.png
+!blueprint/docs/08-reference/Tasks.png
+
+# Terraform
+.terraform/
+*.tfstate
+*.tfstate.*
+crash.log
+*.tfvars
+*.tfvars.json
+override.tf
+override.tf.json
+_override.tf
+_override.tf.json
+.terraformrc
+terraform.rc
+
+# DBT
+dbt_packages/
+dbt_modules/
+target/
+profiles.yml
+!deployments/*/dbt/profiles.yml
+shared_macros/
+
+# Compiled files
+*.pyc
+*.pyo
+
+# Local prompts and session scratchpads
+NEXT_PROMPT.md
+ANALYSIS_AND_PROMPT.md
+docs/COPILOT_NEXT_SESSION_PROMPT.md
+
+# Claude Code local settings (per-user, not shared)
+.claude/
+
+# Scratch CLI output and test logs that should never be committed
+/1pip
+/transform_log.txt
+**/tester_tests.log
+
+
+# Additional venv directories
+.venv_*/
+venv*/
+.venv*/
+infrastructure/terraform/systems/generic/.terraform.lock.hcl
+dependency-reduced-pom.xml
+
+# Helm vendored subchart tarballs (Chart.lock is the source of truth)
+deployments/*/helm/charts/*.tgz
+
+# Per-deployment terraform provider lock (single-platform; regenerated on init)
+**/.terraform.lock.hcl
+
+# culvert distribution build artifacts
+python-culvert/dist/

culvert-0.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: culvert
+Version: 0.1.0
+Summary: Cloud-agnostic, polyglot data-pipeline framework: one contract set, adapters per cloud. Python side of Culvert (Java twin on Maven Central: com.enrichmeai.culvert).
+Project-URL: Homepage, https://github.com/enrichmeai/culvert
+Project-URL: Repository, https://github.com/enrichmeai/culvert
+Project-URL: Issues, https://github.com/enrichmeai/culvert/issues
+Author: Joseph Aruja
+License: MIT
+Keywords: airflow,bigquery,cloud-agnostic,contracts,data-pipeline,dbt,framework,gcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.10
+Requires-Dist: typing-extensions>=4.7
+Provides-Extra: all
+Requires-Dist: dbt-bigquery>=1.5.0; extra == 'all'
+Requires-Dist: google-cloud-bigquery>=3.11.0; extra == 'all'
+Requires-Dist: google-cloud-datacatalog>=3.14.0; extra == 'all'
+Requires-Dist: google-cloud-monitoring>=2.14.0; extra == 'all'
+Requires-Dist: google-cloud-pubsub>=2.18.0; extra == 'all'
+Requires-Dist: google-cloud-secret-manager>=2.16.0; extra == 'all'
+Requires-Dist: google-cloud-storage>=2.10.0; extra == 'all'
+Requires-Dist: opentelemetry-api>=1.20.0; extra == 'all'
+Requires-Dist: pyyaml>=6.0; extra == 'all'
+Provides-Extra: contract-tests
+Requires-Dist: pytest>=7.4; extra == 'contract-tests'
+Provides-Extra: gcp
+Requires-Dist: google-cloud-bigquery>=3.11.0; extra == 'gcp'
+Requires-Dist: google-cloud-datacatalog>=3.14.0; extra == 'gcp'
+Requires-Dist: google-cloud-monitoring>=2.14.0; extra == 'gcp'
+Requires-Dist: google-cloud-pubsub>=2.18.0; extra == 'gcp'
+Requires-Dist: google-cloud-secret-manager>=2.16.0; extra == 'gcp'
+Requires-Dist: google-cloud-storage>=2.10.0; extra == 'gcp'
+Requires-Dist: opentelemetry-api>=1.20.0; extra == 'gcp'
+Provides-Extra: orchestration
+Requires-Dist: google-cloud-bigquery>=3.11.0; extra == 'orchestration'
+Requires-Dist: google-cloud-pubsub>=2.18.0; extra == 'orchestration'
+Requires-Dist: google-cloud-storage>=2.10.0; extra == 'orchestration'
+Requires-Dist: pyyaml>=6.0; extra == 'orchestration'
+Provides-Extra: tester
+Requires-Dist: apache-beam[gcp]==2.56.0; extra == 'tester'
+Requires-Dist: google-cloud-bigquery>=3.11.0; extra == 'tester'
+Requires-Dist: google-cloud-pubsub>=2.18.0; extra == 'tester'
+Requires-Dist: google-cloud-storage>=2.10.0; extra == 'tester'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'tester'
+Requires-Dist: pytest-mock>=3.10.0; extra == 'tester'
+Requires-Dist: pytest>=7.0.0; extra == 'tester'
+Provides-Extra: transform
+Requires-Dist: dbt-bigquery>=1.5.0; extra == 'transform'
+Description-Content-Type: text/markdown
+
+# Culvert
+
+**A cloud-agnostic, polyglot data-pipeline framework.** One contract set —
+`Source`, `Sink`, `Transform`, `Pipeline`, `RuntimeContext`, `BlobStore`,
+`Warehouse`, `JobControlRepository`, and friends — realised in **Java and
+Python**, with cloud specifics behind adapters. Define the pipeline once
+against contracts; point it at an emulator on your laptop, a dev project, or
+production by wiring, not rewriting.
+
+- **Contract-driven** — the [language-neutral spec](https://github.com/enrichmeai/culvert/blob/main/docs/CONTRACT.md)
+  is the portability boundary. Business logic depends only on contracts.
+- **Two clouds today** — GCP is the first full implementation; AWS is a real
+  (Java) adapter family with the same pipeline proven on both. Azure is on the
+  roadmap.
+- **No application framework in the core** — plain Python Protocols +
+  entry-point auto-discovery; composes into Beam pipelines, Airflow DAGs, or a
+  script on your laptop.
+- **Local-first** — the whole stack runs against emulators with zero cloud
+  account; cloud is where you prove and ship, not where you develop.
+
+## Install
+
+```bash
+pip install culvert                 # core contracts only (no cloud SDKs)
+pip install culvert[gcp]            # + BigQuery, GCS, Pub/Sub, Secret Manager, observability
+pip install culvert[orchestration]  # + Airflow-side DAG factory, operators, sensors
+pip install culvert[transform]      # + dbt integration
+pip install culvert[all]
+```
+
+Python ≥ 3.10. For 0.1.0 the import packages keep their library names — the
+contracts live in `data_pipeline_core`:
+
+```python
+from data_pipeline_core import autoconfig
+
+config = autoconfig.discover()          # entry-point adapter discovery
+blob_store = config.blob_store()        # GcsBlobStore if culvert[gcp] installed
+```
+
+The Java twin ships as `com.enrichmeai.culvert:*` on Maven Central — same
+contracts, Java owns the Beam/Dataflow execution layer; Python owns the
+Airflow runtime and dbt packaging.
+
+## Status
+
+`0.1.0` — first public release. Built and validated against a real GCP
+project (Cloud Run, BigQuery, Pub/Sub, event-driven end-to-end) before
+publishing. GCP adapters are production-shaped; the AWS family is Java-side;
+Azure is a roadmap skeleton. Honest limitations are documented per adapter in
+the source.
+
+Docs, architecture, worked example deployments, and the engineering story:
+**https://github.com/enrichmeai/culvert**
+
+MIT licensed.

culvert-0.1.0/README.md

@@ -0,0 +1,56 @@
+# Culvert
+
+**A cloud-agnostic, polyglot data-pipeline framework.** One contract set —
+`Source`, `Sink`, `Transform`, `Pipeline`, `RuntimeContext`, `BlobStore`,
+`Warehouse`, `JobControlRepository`, and friends — realised in **Java and
+Python**, with cloud specifics behind adapters. Define the pipeline once
+against contracts; point it at an emulator on your laptop, a dev project, or
+production by wiring, not rewriting.
+
+- **Contract-driven** — the [language-neutral spec](https://github.com/enrichmeai/culvert/blob/main/docs/CONTRACT.md)
+  is the portability boundary. Business logic depends only on contracts.
+- **Two clouds today** — GCP is the first full implementation; AWS is a real
+  (Java) adapter family with the same pipeline proven on both. Azure is on the
+  roadmap.
+- **No application framework in the core** — plain Python Protocols +
+  entry-point auto-discovery; composes into Beam pipelines, Airflow DAGs, or a
+  script on your laptop.
+- **Local-first** — the whole stack runs against emulators with zero cloud
+  account; cloud is where you prove and ship, not where you develop.
+
+## Install
+
+```bash
+pip install culvert                 # core contracts only (no cloud SDKs)
+pip install culvert[gcp]            # + BigQuery, GCS, Pub/Sub, Secret Manager, observability
+pip install culvert[orchestration]  # + Airflow-side DAG factory, operators, sensors
+pip install culvert[transform]      # + dbt integration
+pip install culvert[all]
+```
+
+Python ≥ 3.10. For 0.1.0 the import packages keep their library names — the
+contracts live in `data_pipeline_core`:
+
+```python
+from data_pipeline_core import autoconfig
+
+config = autoconfig.discover()          # entry-point adapter discovery
+blob_store = config.blob_store()        # GcsBlobStore if culvert[gcp] installed
+```
+
+The Java twin ships as `com.enrichmeai.culvert:*` on Maven Central — same
+contracts, Java owns the Beam/Dataflow execution layer; Python owns the
+Airflow runtime and dbt packaging.
+
+## Status
+
+`0.1.0` — first public release. Built and validated against a real GCP
+project (Cloud Run, BigQuery, Pub/Sub, event-driven end-to-end) before
+publishing. GCP adapters are production-shaped; the AWS family is Java-side;
+Azure is a roadmap skeleton. Honest limitations are documented per adapter in
+the source.
+
+Docs, architecture, worked example deployments, and the engineering story:
+**https://github.com/enrichmeai/culvert**
+
+MIT licensed.

culvert-0.1.0/hatch_build.py

@@ -0,0 +1,48 @@
+"""Hatchling build hook: locate the library packages in either context.
+
+The wheel is built from two places:
+  - the repo (CI / local): packages live at ../data-pipeline-libraries/*/src/
+  - an extracted sdist (pip building from source): packages were packed into
+    this project's own src/ by the sdist force-include
+
+A static [tool.hatch.build.targets.wheel.force-include] can only express one
+of those, so this hook resolves each package at build time.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+# import package -> distribution dir under data-pipeline-libraries/
+PACKAGES = {
+    "data_pipeline_core": "data-pipeline-core",
+    "data_pipeline_gcp_bigquery": "data-pipeline-gcp-bigquery",
+    "data_pipeline_gcp_gcs": "data-pipeline-gcp-gcs",
+    "data_pipeline_gcp_pubsub": "data-pipeline-gcp-pubsub",
+    "data_pipeline_gcp_secrets": "data-pipeline-gcp-secrets",
+    "data_pipeline_gcp_observability": "data-pipeline-gcp-observability",
+    "data_pipeline_orchestration": "data-pipeline-orchestration",
+    "data_pipeline_transform": "data-pipeline-transform",
+    "data_pipeline_tester": "data-pipeline-tester",
+    "data_pipeline_contract_tests": "data-pipeline-contract-tests",
+}
+
+
+class LibraryPackagesHook(BuildHookInterface):
+    PLUGIN_NAME = "library-packages"
+
+    def initialize(self, version, build_data):
+        if self.target_name != "wheel":
+            return
+        root = Path(self.root)
+        force_include = build_data.setdefault("force_include", {})
+        for pkg, dist in PACKAGES.items():
+            repo_src = root.parent / "data-pipeline-libraries" / dist / "src" / pkg
+            sdist_src = root / "src" / pkg
+            src = repo_src if repo_src.is_dir() else sdist_src
+            if not src.is_dir():
+                raise FileNotFoundError(
+                    f"package {pkg} not found at {repo_src} or {sdist_src}")
+            force_include[str(src)] = pkg

culvert-0.1.0/pyproject.toml

@@ -0,0 +1,118 @@
+# The `culvert` PyPI distribution (D1 decision, 2026-07: ONE distribution with
+# extras — the Maven side stays modular; Python presents one front door).
+#
+# This pyproject assembles the data-pipeline-libraries/* import packages into a
+# single wheel via hatchling force-include. Import names stay `data_pipeline_*`
+# for 0.1.0 so every path:line citation in the book remains true; the `culvert`
+# import package is a thin front door (version + re-exports).
+#
+# Excluded on purpose: data_pipeline_framework (the legacy bundle — predecessor
+# deps; removed entirely at the F1 legacy cleanup).
+#
+# Entry points: the per-library `data_pipeline_core.adapters` registrations are
+# merged here — without them AutoConfig discovery finds nothing. autoconfig
+# skips entry points whose deps aren't installed (core-only install is safe).
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "culvert"
+version = "0.1.0"
+description = "Cloud-agnostic, polyglot data-pipeline framework: one contract set, adapters per cloud. Python side of Culvert (Java twin on Maven Central: com.enrichmeai.culvert)."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "Joseph Aruja" }]
+keywords = ["data-pipeline", "framework", "cloud-agnostic", "gcp", "bigquery", "dbt", "airflow", "contracts"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+    "typing-extensions>=4.7",
+]
+
+[project.urls]
+Homepage = "https://github.com/enrichmeai/culvert"
+Repository = "https://github.com/enrichmeai/culvert"
+Issues = "https://github.com/enrichmeai/culvert/issues"
+
+[project.optional-dependencies]
+gcp = [
+    "google-cloud-bigquery>=3.11.0",
+    "google-cloud-storage>=2.10.0",
+    "google-cloud-pubsub>=2.18.0",
+    "google-cloud-secret-manager>=2.16.0",
+    "google-cloud-monitoring>=2.14.0",
+    "google-cloud-datacatalog>=3.14.0",
+    "opentelemetry-api>=1.20.0",
+]
+orchestration = [
+    "PyYAML>=6.0",
+    "google-cloud-storage>=2.10.0",
+    "google-cloud-pubsub>=2.18.0",
+    "google-cloud-bigquery>=3.11.0",
+]
+transform = [
+    "dbt-bigquery>=1.5.0",
+]
+tester = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-mock>=3.10.0",
+    "apache-beam[gcp]==2.56.0",
+    "google-cloud-bigquery>=3.11.0",
+    "google-cloud-storage>=2.10.0",
+    "google-cloud-pubsub>=2.18.0",
+]
+contract-tests = [
+    "pytest>=7.4",
+]
+all = [
+    "culvert[gcp,orchestration,transform]",
+]
+
+[project.entry-points."data_pipeline_core.adapters"]
+blob_store = "data_pipeline_gcp_gcs:GcsBlobStore"
+warehouse = "data_pipeline_gcp_bigquery:BigQueryWarehouse"
+finops = "data_pipeline_gcp_bigquery:BigQueryFinOpsSink"
+source = "data_pipeline_gcp_pubsub:PubSubSource"
+sink = "data_pipeline_gcp_pubsub:PubSubSink"
+secrets = "data_pipeline_gcp_secrets:SecretManagerProvider"
+observability = "data_pipeline_gcp_observability:CloudTraceObservabilityHook"
+stage_metrics = "data_pipeline_gcp_observability:CloudMonitoringMetricsHook"
+lineage = "data_pipeline_gcp_observability:DataCatalogLineageEmitter"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/culvert"]
+
+# Library packages are force-included by the build hook (hatch_build.py),
+# which resolves them from the repo or from an extracted sdist.
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = "hatch_build.py"
+
+
+[tool.hatch.build.targets.sdist]
+include = ["src/culvert", "README.md", "pyproject.toml", "hatch_build.py"]
+
+[tool.hatch.build.targets.sdist.force-include]
+"../data-pipeline-libraries/data-pipeline-core/src/data_pipeline_core" = "src/data_pipeline_core"
+"../data-pipeline-libraries/data-pipeline-gcp-bigquery/src/data_pipeline_gcp_bigquery" = "src/data_pipeline_gcp_bigquery"
+"../data-pipeline-libraries/data-pipeline-gcp-gcs/src/data_pipeline_gcp_gcs" = "src/data_pipeline_gcp_gcs"
+"../data-pipeline-libraries/data-pipeline-gcp-pubsub/src/data_pipeline_gcp_pubsub" = "src/data_pipeline_gcp_pubsub"
+"../data-pipeline-libraries/data-pipeline-gcp-secrets/src/data_pipeline_gcp_secrets" = "src/data_pipeline_gcp_secrets"
+"../data-pipeline-libraries/data-pipeline-gcp-observability/src/data_pipeline_gcp_observability" = "src/data_pipeline_gcp_observability"
+"../data-pipeline-libraries/data-pipeline-orchestration/src/data_pipeline_orchestration" = "src/data_pipeline_orchestration"
+"../data-pipeline-libraries/data-pipeline-transform/src/data_pipeline_transform" = "src/data_pipeline_transform"
+"../data-pipeline-libraries/data-pipeline-tester/src/data_pipeline_tester" = "src/data_pipeline_tester"
+"../data-pipeline-libraries/data-pipeline-contract-tests/src/data_pipeline_contract_tests" = "src/data_pipeline_contract_tests"
+
+[tool.hatch.build]
+exclude = ["**/__pycache__", "**/*.pyc", "**/.pytest_cache", "**/*.egg-info"]

culvert-0.1.0/src/culvert/__init__.py

@@ -0,0 +1,27 @@
+"""Culvert — a cloud-agnostic, polyglot data-pipeline framework.
+
+One language-neutral contract set (Source, Sink, Transform, Pipeline,
+RuntimeContext, BlobStore, Warehouse, JobControlRepository, ...), realised in
+Java and Python, with cloud specifics behind adapters. This distribution is the
+Python side; the Java twin ships as ``com.enrichmeai.culvert:*`` on Maven
+Central.
+
+For 0.1.0 the import packages keep their library names — start at
+``data_pipeline_core`` for the contracts::
+
+    from data_pipeline_core import autoconfig
+    from data_pipeline_core.contracts.blob_store import BlobStore
+
+Install extras for the adapters you need::
+
+    pip install culvert[gcp]            # BigQuery, GCS, Pub/Sub, Secret Manager, observability
+    pip install culvert[orchestration]  # Airflow-side DAG factory, operators, sensors
+    pip install culvert[transform]      # dbt runner assets
+    pip install culvert[all]
+
+Docs and worked examples: https://github.com/enrichmeai/culvert
+"""
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]

culvert-0.1.0/src/data_pipeline_contract_tests/__init__.py

@@ -0,0 +1,28 @@
+"""Abstract pytest contract tests for the Culvert data pipeline framework.
+
+Each cloud adapter library inherits the relevant mixin and supplies the
+adapter under test. The mixin tests prove the adapter honours the
+Protocol's documented behaviour.
+
+Mirror of the Java ``data-pipeline-contract-tests`` library.
+
+Sprint-5 deliverable. Sprint-17 (T17.3): added
+:class:`StageMetricsHookContract` and brought existing mixins to 1:1
+method-level parity with their Java counterparts (null-rejection tests).
+"""
+
+from __future__ import annotations
+
+from data_pipeline_contract_tests.blob_store import BlobStoreContract
+from data_pipeline_contract_tests.secrets import SecretProviderContract
+from data_pipeline_contract_tests.stage_metrics_hook import StageMetricsHookContract
+from data_pipeline_contract_tests.warehouse import WarehouseContract
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "BlobStoreContract",
+    "SecretProviderContract",
+    "StageMetricsHookContract",
+    "WarehouseContract",
+]

culvert-0.1.0/src/data_pipeline_contract_tests/blob_store.py

@@ -0,0 +1,34 @@
+"""BlobStore contract test mixin.
+
+Java mirror: ``com.enrichmeai.culvert.contracttests.BlobStoreContractTest``
+"""
+
+from __future__ import annotations
+
+import pytest
+
+
+class BlobStoreContract:
+    """Mixin — subclasses provide ``store``, ``known_uri``, ``missing_uri``
+    fixtures. ``known_uri`` resolves to bytes equal to ``b"hello"``.
+
+    Java mirror: ``BlobStoreContractTest`` (Sprint-5 deliverable).
+    """
+
+    def test_get_known_returns_bytes(self, store, known_uri):
+        assert store.get(known_uri) == b"hello"
+
+    def test_exists_known_true(self, store, known_uri):
+        assert store.exists(known_uri) is True
+
+    def test_exists_missing_false(self, store, missing_uri):
+        assert store.exists(missing_uri) is False
+
+    def test_delete_missing_idempotent(self, store, missing_uri):
+        # Should not raise.
+        store.delete(missing_uri)
+
+    def test_null_arguments_rejected(self, store):
+        # Java: ``nullArgumentsRejected`` — get(null) must raise.
+        with pytest.raises((TypeError, ValueError)):
+            store.get(None)

culvert-0.1.0/src/data_pipeline_contract_tests/secrets.py

@@ -0,0 +1,41 @@
+"""SecretProvider contract test mixin.
+
+Java mirror: ``com.enrichmeai.culvert.contracttests.SecretProviderContractTest``
+"""
+
+from __future__ import annotations
+
+import pytest
+
+
+class SecretProviderContract:
+    """Mixin — subclasses provide ``self.provider`` via a pytest fixture
+    named ``provider`` (and configure it so ``get("known")`` returns
+    ``"the-secret"`` and ``get("missing")`` raises ``KeyError``).
+
+    Java mirror: ``SecretProviderContractTest`` (Sprint-5 deliverable).
+
+    Example wiring in a cloud adapter's test sources:
+
+    .. code-block:: python
+
+        from data_pipeline_contract_tests import SecretProviderContract
+
+        class TestMySecretProvider(SecretProviderContract):
+            @pytest.fixture
+            def provider(self):
+                client = make_mock_client({"known": "the-secret"})
+                return MySecretProvider("my-project", client)
+    """
+
+    def test_get_known_returns_value(self, provider):
+        assert provider.get("known") == "the-secret"
+
+    def test_get_missing_raises(self, provider):
+        with pytest.raises((KeyError, LookupError)):
+            provider.get("missing")
+
+    def test_null_name_rejected(self, provider):
+        # Java: ``nullNameRejected`` — get(null, ...) must raise.
+        with pytest.raises((TypeError, ValueError)):
+            provider.get(None)