pytest-extended-data 0.1.0__tar.gz

pytest_extended_data-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.hypothesis/
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.py[cod]
+*.log
+coverage.xml
+.coverage
+.tox/
+packages/extended-data/docs/apidocs/
+packages/extended-data/docs/_build/

pytest_extended_data-0.1.0/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0 (2026-06-27)
+
+
+### Features
+
+* split extended data workspace packages ([5d49998](https://github.com/jbcom/extended-data/commit/5d4999836ff5c42faf1c9082e014a85d266845e4))

pytest_extended_data-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: pytest-extended-data
+Version: 0.1.0
+Summary: Pytest fixtures and assertions for projects using extended-data
+Project-URL: Documentation, https://extended-data.dev
+Project-URL: Issues, https://github.com/jbcom/extended-data/issues
+Project-URL: Source, https://github.com/jbcom/extended-data
+Project-URL: Changelog, https://github.com/jbcom/extended-data/blob/main/packages/pytest-extended-data/CHANGELOG.md
+Author-email: Jon Bogaty <jon@jonbogaty.com>
+Maintainer-email: Jon Bogaty <jon@jonbogaty.com>
+License: MIT
+Keywords: extended-data,fixtures,pytest,testing
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: extended-data>=8.3.1
+Requires-Dist: pytest>=9.0.3
+Description-Content-Type: text/markdown
+
+# pytest-extended-data
+
+`pytest-extended-data` publishes reusable pytest fixtures and assertions for
+projects built on `extended-data`.
+
+Install it in test environments:
+
+```bash
+uv add --dev pytest-extended-data
+```
+
+The plugin is exposed through the standard `pytest11` entry point. It provides:
+
+- `extended_data_factory`: the `ExtendedData` polymorphic constructor.
+- `extended_data_payload`: a small nested mapping payload for examples and smoke tests.
+- `extended_data_value`: the payload wrapped as an `ExtendedData` value.
+- `assert_extended_shape(value, shape)`: assertion helper for shape checks.
+- `assert_builtin_round_trip(value, expected)`: assertion helper for export-boundary checks.

pytest_extended_data-0.1.0/README.md

@@ -0,0 +1,18 @@
+# pytest-extended-data
+
+`pytest-extended-data` publishes reusable pytest fixtures and assertions for
+projects built on `extended-data`.
+
+Install it in test environments:
+
+```bash
+uv add --dev pytest-extended-data
+```
+
+The plugin is exposed through the standard `pytest11` entry point. It provides:
+
+- `extended_data_factory`: the `ExtendedData` polymorphic constructor.
+- `extended_data_payload`: a small nested mapping payload for examples and smoke tests.
+- `extended_data_value`: the payload wrapped as an `ExtendedData` value.
+- `assert_extended_shape(value, shape)`: assertion helper for shape checks.
+- `assert_builtin_round_trip(value, expected)`: assertion helper for export-boundary checks.

pytest_extended_data-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pytest-extended-data"
+version = "0.1.0"
+description = "Pytest fixtures and assertions for projects using extended-data"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+readme = "README.md"
+keywords = [
+    "extended-data",
+    "pytest",
+    "fixtures",
+    "testing",
+]
+authors = [{ name = "Jon Bogaty", email = "jon@jonbogaty.com" }]
+maintainers = [{ name = "Jon Bogaty", email = "jon@jonbogaty.com" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: Pytest",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+dependencies = [
+    "extended-data>=8.3.1",
+    "pytest>=9.0.3",
+]
+
+[project.urls]
+Documentation = "https://extended-data.dev"
+Issues = "https://github.com/jbcom/extended-data/issues"
+Source = "https://github.com/jbcom/extended-data"
+Changelog = "https://github.com/jbcom/extended-data/blob/main/packages/pytest-extended-data/CHANGELOG.md"
+
+[project.entry-points.pytest11]
+extended_data = "pytest_extended_data.plugin"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pytest_extended_data"]

pytest_extended_data-0.1.0/src/pytest_extended_data/__init__.py

@@ -0,0 +1,11 @@
+"""Pytest helpers for projects using Extended Data."""
+
+from __future__ import annotations
+
+from pytest_extended_data.plugin import assert_builtin_round_trip, assert_extended_shape
+
+
+__all__ = [
+    "assert_builtin_round_trip",
+    "assert_extended_shape",
+]

pytest_extended_data-0.1.0/src/pytest_extended_data/plugin.py

@@ -0,0 +1,63 @@
+"""Pytest fixtures and assertions for Extended Data consumers."""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping
+from typing import TYPE_CHECKING, Any
+
+import pytest
+
+
+if TYPE_CHECKING:
+    from extended_data import ExtendedData
+
+
+def _extended_data_type() -> type[ExtendedData]:
+    from extended_data import ExtendedData
+
+    return ExtendedData
+
+
+def assert_extended_shape(value: ExtendedData, shape: str) -> None:
+    """Assert that an Extended Data value has the expected broad shape."""
+    extended_data = _extended_data_type()
+    if not isinstance(value, extended_data):
+        raise TypeError(f"expected ExtendedData value, got {type(value).__name__}")
+    assert value.shape == shape, f"expected ExtendedData shape {shape!r}, got {value.shape!r}"
+
+
+def assert_builtin_round_trip(value: ExtendedData, expected: Any) -> None:
+    """Assert that an Extended Data value lowers to the expected built-in data."""
+    extended_data = _extended_data_type()
+    if not isinstance(value, extended_data):
+        raise TypeError(f"expected ExtendedData value, got {type(value).__name__}")
+
+    actual = value.as_builtin()
+    assert actual == expected, f"expected built-in data {expected!r}, got {actual!r}"
+
+    round_trip = extended_data(actual).as_builtin()
+    assert round_trip == expected, f"expected round-trip data {expected!r}, got {round_trip!r}"
+
+
+@pytest.fixture
+def extended_data_factory() -> Callable[[Any], ExtendedData]:
+    """Return the polymorphic Extended Data constructor."""
+    return _extended_data_type()
+
+
+@pytest.fixture
+def extended_data_payload() -> Mapping[str, Any]:
+    """Return a representative nested mapping payload."""
+    return {
+        "service": {
+            "name": "api",
+            "ports": [8080, 8443],
+        },
+        "enabled": True,
+    }
+
+
+@pytest.fixture
+def extended_data_value(extended_data_payload: Mapping[str, Any]) -> ExtendedData:
+    """Return the sample payload promoted to Extended Data."""
+    return _extended_data_type()(extended_data_payload)

pytest_extended_data-0.1.0/src/pytest_extended_data/py.typed

@@ -0,0 +1 @@
+

pytest_extended_data-0.1.0/tests/test_plugin.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping
+from typing import Any
+
+import pytest
+
+from extended_data import ExtendedData, ExtendedDict
+from pytest_extended_data import assert_builtin_round_trip, assert_extended_shape, plugin
+
+
+def test_extended_data_factory_fixture_promotes_payload(
+    extended_data_factory: Callable[[Any], ExtendedData],
+    extended_data_payload: Mapping[str, Any],
+) -> None:
+    value = extended_data_factory(extended_data_payload)
+
+    assert isinstance(value, ExtendedDict)
+    assert_extended_shape(value, "mapping")
+    assert_builtin_round_trip(value, dict(extended_data_payload))
+
+
+def test_extended_data_value_fixture_is_ready_to_assert(extended_data_value: ExtendedData) -> None:
+    assert_extended_shape(extended_data_value, "mapping")
+    assert extended_data_value["service"]["name"] == "api"
+
+
+def test_assert_extended_shape_rejects_non_extended_values() -> None:
+    with pytest.raises(TypeError, match="expected ExtendedData value"):
+        assert_extended_shape("api", "scalar")
+
+
+def test_assert_extended_shape_rejects_wrong_shape() -> None:
+    with pytest.raises(AssertionError, match="expected ExtendedData shape 'sequence'"):
+        assert_extended_shape(ExtendedData({"service": "api"}), "sequence")
+
+
+def test_assert_builtin_round_trip_rejects_non_extended_values() -> None:
+    with pytest.raises(TypeError, match="expected ExtendedData value"):
+        assert_builtin_round_trip({"service": "api"}, {"service": "api"})
+
+
+def test_assert_builtin_round_trip_rejects_wrong_builtin_value() -> None:
+    with pytest.raises(AssertionError, match="expected built-in data"):
+        assert_builtin_round_trip(ExtendedData({"service": "api"}), {"service": "worker"})
+
+
+def test_assert_builtin_round_trip_rejects_unstable_round_trip(monkeypatch: pytest.MonkeyPatch) -> None:
+    class UnstableExtendedData:
+        shape = "mapping"
+
+        def __init__(self, value: Any, *, stable: bool = False) -> None:
+            self.value = value
+            self.stable = stable
+
+        def as_builtin(self) -> Any:
+            if self.stable:
+                return self.value
+            return {"changed": self.value}
+
+    monkeypatch.setattr(plugin, "_extended_data_type", lambda: UnstableExtendedData)
+
+    with pytest.raises(AssertionError, match="expected round-trip data"):
+        plugin.assert_builtin_round_trip(UnstableExtendedData({"service": "api"}, stable=True), {"service": "api"})