geocase 1.0.0rc1__tar.gz

geocase-1.0.0rc1/.gitignore

@@ -0,0 +1,38 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# MkDocs
+site/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# GeoCase storage cache
+.geocase_cache/

geocase-1.0.0rc1/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+All notable changes to GeoCase are documented here.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this
+project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] — 2026-08-02
+
+First stable release, and the first release published to PyPI. Version `0.1.0` was never
+uploaded.
+
+### The compatibility promise
+
+v1.0 makes a stability commitment on **two surfaces only**:
+
+1. **The pytest workflow** — the `geocase_case` / `geocase` fixtures and the
+   `geocase_case`, `geocase_suite`, and `geocase_select` markers.
+2. **The public API** — the 27 names exported from `import geocase`, pinned against a
+   literal in `tests/unit/test_public_api.py`.
+
+Everything else — module layout, internal helpers, the shape of `geocase.catalog` — is
+internal and may change in a minor release. The promise is deliberately narrow because
+those two surfaces are the genuinely mature ones; a wider claim would make the 1.0 label
+dishonest.
+
+### Breaking changes
+
+- **The command-line interface and its `[project.scripts]` entry point have been
+  removed.** The declared `geocase` console script was broken in every install — it
+  pointed at a module that raised `ImportError` — so no working usage can depend on it.
+  There is no CLI in v1.0. Use the Python API or the pytest plugin.
+
+### Added
+
+- **Public API** (`import geocase`): a pinned 27-name surface covering case discovery,
+  loading, and inspection — `list_cases`, `get_case`, `load_case`, `show_case`,
+  `list_suites`, `get_suite`, `__version__`, the case classes, the metadata models and
+  enums, and `RemoteCaseUnavailableError`.
+- **`docs/dataset-catalog.md`**: what the catalog contains, why each format was chosen,
+  the geodetic rationale for every coordinate cluster, and an honest list of coverage
+  gaps.
+- **Generated catalog pages** under `docs/_generated/catalog/`: an index plus one page
+  per case, per risk type, and per format, carrying `schema.org/Dataset` JSON-LD.
+- **Manifest support**: `extended-manifests/*.yaml` parse and resolve, remote case ids are
+  discoverable through the registry and `show_case`, and `GEOCASE_MANIFESTS` selects which
+  manifests are loaded.
+- **CI quality gates**: `ruff check` and `ruff format --check`, `mypy`, a Python
+  3.11/3.14 test matrix, and non-blocking coverage reporting.
+- **Catalog integrity gates**: orphaned case metadata, manifest validity (shadowed ids,
+  cross-manifest duplicates, malformed digests, dangling `bundled_analog` references),
+  `size_class` versus real on-disk payload, generated-page drift, and case ids named in
+  hand-written docs.
+
+### Changed
+
+- **Bundled data shrank from 36 MB to 4.2 MB.** Five SpatiaLite fixtures declared
+  `size_class: tiny` were 6.7 MB each; `size_class` now has enforced byte thresholds.
+- `cases/raster.py` loads through `loaders/rasterio_loader.py`, making it the single
+  raster load path.
+- `requires-python` is `>=3.11`, with classifiers for 3.11 through 3.14 — the versions
+  actually tested rather than the ones plausibly supported.
+- Development status classifier: `3 - Alpha` → `5 - Production/Stable`.
+- `project.urls` now point at GitLab, where the project actually lives.
+- The case schema's `format` enum went from 7 values to 17, and its `assertions` block
+  from 6 documented fields to all 16. Both are now pinned to the models by a test.
+
+### Fixed
+
+- The raster coverage matrix reported 25 of 30 cases: the generator's glob missed the five
+  `footprint_edge_cases` files. Because the artifact was gated by `git diff --exit-code`,
+  CI was actively enforcing the wrong number.
+- Case pages linked risk hubs at `../../risk/`, one level too high, producing 187 broken
+  links. `mkdocs build --strict` now passes.
+- `materialize_case` raised an internal `No case root found` for manifest cases instead of
+  an actionable error; both error paths are now asserted in tests.
+- The registry singleton ignored `GEOCASE_MANIFESTS` changes after first use; resolved
+  manifest paths are part of the cache key.
+
+### Removed
+
+- The `cli/` package and its entry point (see Breaking changes).
+- `catalog/validators.py` — an empty stub nothing imported.
+- `raster/affine_transform_quirk/` — an empty case directory that shipped in the wheel
+  while appearing in no index. The rotated/skewed-transform coverage it implied is a
+  genuine gap, now tracked on the v1.1 list rather than implied by a placeholder.
+
+### Deferred to v1.1
+
+Stated as decisions, not omissions:
+
+- **Remote dataset transport.** Declared remote cases are discoverable and raise clear
+  errors, but nothing downloads, caches, or unpacks. Both manifests are entirely
+  placeholder — every `sha256` is `replace_me`, every `base_uri` is `example.org`. The
+  gate for reopening this is concrete: at least one real published archive with a real
+  sha256.
+- **Rotated/skewed affine transforms and non-square pixels**, and **southern-hemisphere
+  UTM coverage** — see the coverage gaps in the dataset catalog.
+
+### Known numbers
+
+134 bundled cases (103 vector, 30 raster, 1 NetCDF) across 16 formats, 4.2 MB of bundled
+data, 780 passing tests, 54% line coverage.

geocase-1.0.0rc1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Farzin Ashouri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

geocase-1.0.0rc1/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: geocase
+Version: 1.0.0rc1
+Summary: A curated library of geospatial test cases for automated and parameterized testing.
+Project-URL: Homepage, https://github.com/farzinashouri/geocase
+Project-URL: Documentation, https://farzinashouri.github.io/geocase
+Project-URL: Repository, https://github.com/farzinashouri/geocase
+Project-URL: Issues, https://github.com/farzinashouri/geocase/issues
+Project-URL: Changelog, https://github.com/farzinashouri/geocase/blob/main/CHANGELOG.md
+Author: Farzin Ashouri
+License-Expression: MIT
+License-File: LICENSE
+Keywords: geospatial,gis,pytest,test-cases,testing
+Classifier: Development Status :: 5 - Production/Stable
+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: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: all
+Requires-Dist: geopandas>=0.14; extra == 'all'
+Requires-Dist: netcdf4>=1.6; extra == 'all'
+Requires-Dist: pyarrow>=14.0; extra == 'all'
+Requires-Dist: rasterio>=1.3; extra == 'all'
+Requires-Dist: shapely>=2.0; extra == 'all'
+Requires-Dist: xarray>=2023.1; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: geopandas>=0.14; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: netcdf4>=1.6; extra == 'dev'
+Requires-Dist: pyarrow>=14.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: rasterio>=1.3; extra == 'dev'
+Requires-Dist: ruff<0.16,>=0.15.7; extra == 'dev'
+Requires-Dist: shapely>=2.0; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Requires-Dist: types-shapely; extra == 'dev'
+Requires-Dist: xarray>=2023.1; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.5; extra == 'docs'
+Provides-Extra: netcdf
+Requires-Dist: netcdf4>=1.6; extra == 'netcdf'
+Requires-Dist: xarray>=2023.1; extra == 'netcdf'
+Provides-Extra: raster
+Requires-Dist: rasterio>=1.3; extra == 'raster'
+Provides-Extra: vector
+Requires-Dist: geopandas>=0.14; extra == 'vector'
+Requires-Dist: pyarrow>=14.0; extra == 'vector'
+Requires-Dist: shapely>=2.0; extra == 'vector'
+Description-Content-Type: text/markdown
+
+# GeoCase
+
+GeoCase is a geospatial testing toolkit and case catalog for realistic, reproducible `pytest` tests.
+
+> Status: **1.0**. The compatibility promise covers two surfaces — the `pytest` workflow (fixtures and markers) and the `import geocase` public API. 134 bundled cases, 4.2 MB. Remote dataset transport is deferred to v1.1; see the [changelog](CHANGELOG.md).
+
+The main goal is simple: use plain `pytest` with a few GeoCase fixtures and markers to run your geospatial code against curated edge cases.
+
+Instead of hand-picking random sample files, you select packaged cases (vector, raster, NetCDF) and run your function against scenarios such as CRS issues, dateline crossing, topology problems, and NoData behavior.
+
+## Quick Start
+
+### 1) Install
+
+For local development in this repo:
+
+```bash
+pip install -e ".[dev]"
+```
+
+When a package release is published, install from the package index:
+
+```bash
+pip install "geocase[all]"
+```
+
+Or from conda-forge — note the extras are not packaged there, since bundling
+GDAL would make the conda package far heavier than the PyPI equivalent:
+
+```bash
+conda install -c conda-forge geocase
+```
+
+### 2) Write a test with GeoCase markers
+
+```python
+import pytest
+
+
+@pytest.mark.geocase_case("dateline_crossing_polygon")
+def test_vector_case_loads(geocase_case) -> None:
+    gdf = geocase_case.load()
+    assert geocase_case.id == "dateline_crossing_polygon"
+    assert gdf.crs is not None
+
+
+@pytest.mark.geocase_select(category="raster")
+def test_all_raster_cases_have_pixels(geocase) -> None:
+    data, _, _ = geocase.read(1)
+    assert data.size > 0
+```
+
+### 3) Run tests
+
+```bash
+pytest -v
+```
+
+Run only GeoCase-marked tests:
+
+```bash
+pytest -m "geocase_case or geocase_suite or geocase_select" -v
+```
+
+## CI Jobs
+
+This repository uses GitHub Actions, defined in `.github/workflows/`.
+
+`ci.yml` runs on pushes to `main` and on pull requests:
+
+- `catalog` — catalog integrity checks (`build_case_index.py` smoke check,
+  `validate_catalog.py`, fixture and checksum gates, generated-page freshness)
+- `tests` — the whole `tests/` directory on Python 3.11 and 3.14, reporting
+  coverage (not gated)
+- `lint` — `ruff format --check` and `ruff check` over `src` and `tests`
+- `typecheck` — `mypy src`
+- `docs` — `mkdocs build --strict`
+
+`release.yml` runs only on `vX.Y.Z` tags; see
+[Releasing](contributing/releasing.md).
+
+Local equivalents:
+
+```bash
+python scripts/build_case_index.py --check
+python scripts/validate_catalog.py
+
+python -m pytest tests -q
+ruff format --check src tests && ruff check src tests
+```
+
+## Core Concepts
+
+- `@pytest.mark.geocase_case(...)`: select explicit case IDs.
+- `@pytest.mark.geocase_suite(...)`: use named suites.
+- `@pytest.mark.geocase_select(...)`: select by metadata (`category`, `format`, `geometry_type`, `tags`, `risk_types_any`, etc.).
+- `geocase`: auto-parameterized fixture (one invocation per resolved case).
+- `geocase_case`: convenience fixture for exactly one resolved case.
+- CLI tooling is optional; the primary workflow is plain `pytest`.
+
+If a GeoCase marker is missing, resolves no cases, refers to an unknown suite, or `geocase_case` resolves more than one case, the plugin now raises a focused `pytest.UsageError` that explains what to fix.
+
+## Learn More
+
+- [`docs/getting-started.md`](docs/getting-started.md)
+- [`docs/testing-your-function-with-geocase.md`](docs/testing-your-function-with-geocase.md)
+- [`docs/case-discovery.md`](docs/case-discovery.md)
+- [`docs/assertions-reference.md`](docs/assertions-reference.md)
+- [`docs/examples-index.md`](docs/examples-index.md)
+- [`docs/plans/development-plan.md`](docs/plans/development-plan.md)
+- [`docs/contributing/workflow.md`](docs/contributing/workflow.md)
+- [`docs/design/case-recommendation-service.md`](docs/design/case-recommendation-service.md)

geocase-1.0.0rc1/README.md

@@ -0,0 +1,112 @@
+# GeoCase
+
+GeoCase is a geospatial testing toolkit and case catalog for realistic, reproducible `pytest` tests.
+
+> Status: **1.0**. The compatibility promise covers two surfaces — the `pytest` workflow (fixtures and markers) and the `import geocase` public API. 134 bundled cases, 4.2 MB. Remote dataset transport is deferred to v1.1; see the [changelog](CHANGELOG.md).
+
+The main goal is simple: use plain `pytest` with a few GeoCase fixtures and markers to run your geospatial code against curated edge cases.
+
+Instead of hand-picking random sample files, you select packaged cases (vector, raster, NetCDF) and run your function against scenarios such as CRS issues, dateline crossing, topology problems, and NoData behavior.
+
+## Quick Start
+
+### 1) Install
+
+For local development in this repo:
+
+```bash
+pip install -e ".[dev]"
+```
+
+When a package release is published, install from the package index:
+
+```bash
+pip install "geocase[all]"
+```
+
+Or from conda-forge — note the extras are not packaged there, since bundling
+GDAL would make the conda package far heavier than the PyPI equivalent:
+
+```bash
+conda install -c conda-forge geocase
+```
+
+### 2) Write a test with GeoCase markers
+
+```python
+import pytest
+
+
+@pytest.mark.geocase_case("dateline_crossing_polygon")
+def test_vector_case_loads(geocase_case) -> None:
+    gdf = geocase_case.load()
+    assert geocase_case.id == "dateline_crossing_polygon"
+    assert gdf.crs is not None
+
+
+@pytest.mark.geocase_select(category="raster")
+def test_all_raster_cases_have_pixels(geocase) -> None:
+    data, _, _ = geocase.read(1)
+    assert data.size > 0
+```
+
+### 3) Run tests
+
+```bash
+pytest -v
+```
+
+Run only GeoCase-marked tests:
+
+```bash
+pytest -m "geocase_case or geocase_suite or geocase_select" -v
+```
+
+## CI Jobs
+
+This repository uses GitHub Actions, defined in `.github/workflows/`.
+
+`ci.yml` runs on pushes to `main` and on pull requests:
+
+- `catalog` — catalog integrity checks (`build_case_index.py` smoke check,
+  `validate_catalog.py`, fixture and checksum gates, generated-page freshness)
+- `tests` — the whole `tests/` directory on Python 3.11 and 3.14, reporting
+  coverage (not gated)
+- `lint` — `ruff format --check` and `ruff check` over `src` and `tests`
+- `typecheck` — `mypy src`
+- `docs` — `mkdocs build --strict`
+
+`release.yml` runs only on `vX.Y.Z` tags; see
+[Releasing](contributing/releasing.md).
+
+Local equivalents:
+
+```bash
+python scripts/build_case_index.py --check
+python scripts/validate_catalog.py
+
+python -m pytest tests -q
+ruff format --check src tests && ruff check src tests
+```
+
+## Core Concepts
+
+- `@pytest.mark.geocase_case(...)`: select explicit case IDs.
+- `@pytest.mark.geocase_suite(...)`: use named suites.
+- `@pytest.mark.geocase_select(...)`: select by metadata (`category`, `format`, `geometry_type`, `tags`, `risk_types_any`, etc.).
+- `geocase`: auto-parameterized fixture (one invocation per resolved case).
+- `geocase_case`: convenience fixture for exactly one resolved case.
+- CLI tooling is optional; the primary workflow is plain `pytest`.
+
+If a GeoCase marker is missing, resolves no cases, refers to an unknown suite, or `geocase_case` resolves more than one case, the plugin now raises a focused `pytest.UsageError` that explains what to fix.
+
+## Learn More
+
+- [`docs/getting-started.md`](docs/getting-started.md)
+- [`docs/testing-your-function-with-geocase.md`](docs/testing-your-function-with-geocase.md)
+- [`docs/case-discovery.md`](docs/case-discovery.md)
+- [`docs/assertions-reference.md`](docs/assertions-reference.md)
+- [`docs/examples-index.md`](docs/examples-index.md)
+- [`docs/plans/development-plan.md`](docs/plans/development-plan.md)
+- [`docs/contributing/workflow.md`](docs/contributing/workflow.md)
+- [`docs/design/case-recommendation-service.md`](docs/design/case-recommendation-service.md)

geocase-1.0.0rc1/conftest.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from importlib import metadata
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent
+SRC = ROOT / "src"
+
+if str(SRC) not in sys.path:
+    sys.path.insert(0, str(SRC))
+
+
+def _has_geocase_pytest_entry_point() -> bool:
+    try:
+        metadata.version("geocase")
+    except metadata.PackageNotFoundError:
+        return False
+    return True
+
+
+pytest_plugins = [] if _has_geocase_pytest_entry_point() else ["geocase.pytest_plugin"]

geocase-1.0.0rc1/examples/conftest.py

@@ -0,0 +1,172 @@
+"""Pytest configuration for the GeoCase example suites.
+
+The "simple" interview suite (``test_easy_geospatial_interview_questions_simple``)
+runs the shared edge-case scenarios against the *naive* reference
+implementation. Those scenarios are "expose"/"discover" demonstrations: they
+assert the correct, edge-case-aware behaviour that only the ``_perfect``
+implementation provides, so the simple helper is expected to fail exactly the
+inputs listed below (every other input, and every ``_perfect`` counterpart,
+passes).
+
+We mark only those specific nodes ``xfail(strict=True)`` from here, instead of
+marking whole test functions, so that:
+
+* the parametrized "handles_all_cases" tests still report normal ``passed`` on
+  the inputs the simple helper *does* handle (no ``xpassed`` noise), and
+* if the simple helper is ever improved to handle one of these inputs, the
+  strict xfail turns into a failure and prompts us to drop it from this list.
+"""
+
+from __future__ import annotations
+
+_SIMPLE_SUITE_FILENAME = "test_easy_geospatial_interview_questions_simple.py"
+
+# One reason per demonstration scenario, keyed by the (unparametrized) test
+# function name.
+_SIMPLE_LIMITATION_REASONS: dict[str, str] = {
+    "test_reproject_point_normalizes_wrapped_longitude_fixture": (
+        "simple reproject_point does not normalize wrapped longitudes"
+    ),
+    "test_reproject_point_handles_all_point_cases": (
+        "simple reproject_point does not normalize dateline-wrapped longitudes"
+    ),
+    "test_point_in_polygon_excludes_boundary_point": (
+        "simple point_in_polygon treats boundary points as inside"
+    ),
+    "test_get_bbox_classic_antimeridian_polygon_uses_minimal_span": (
+        "simple get_bbox does not compute the minimal antimeridian span"
+    ),
+    "test_get_bbox_handles_all_polygon_cases": (
+        "simple get_bbox does not compute the minimal antimeridian span"
+    ),
+    "test_buffer_in_meters_keeps_dateline_polygon_valid": (
+        "simple buffer_in_meters does not handle dateline-crossing geometries"
+    ),
+    "test_buffer_in_meters_handles_all_polygon_cases": (
+        "simple buffer_in_meters assumes WGS84 input and breaks on projected/"
+        "dateline geometries"
+    ),
+    "test_get_utm_epsg_handles_svalbard_special_zone": (
+        "simple get_utm_epsg lacks Svalbard/Norway special-zone handling"
+    ),
+    "test_get_utm_epsg_handles_all_utm_polygon_cases": (
+        "simple get_utm_epsg lacks UTM special-zone handling"
+    ),
+    "test_area_m2_rejects_invalid_self_intersection": (
+        "simple area_m2 does not validate or reject invalid geometries"
+    ),
+    "test_area_m2_handles_all_polygon_cases": (
+        "simple area_m2 assumes WGS84 input and does not reject invalid geometries"
+    ),
+    "test_dissolve_polygons_repairs_invalid_inputs_before_union": (
+        "simple dissolve_polygons does not repair invalid inputs before union"
+    ),
+    "test_dissolve_polygons_handles_all_polygon_cases": (
+        "simple dissolve_polygons does not repair invalid inputs before union"
+    ),
+    "test_clip_raster_accepts_wgs84_bbox_for_projected_raster": (
+        "simple clip_raster assumes the bbox CRS matches the raster CRS"
+    ),
+    "test_pixel_to_world_returns_pixel_center_coordinates": (
+        "simple pixel_to_world returns the pixel corner, not its center"
+    ),
+    "test_rasters_aligned_accepts_shifted_raster_on_same_pixel_lattice": (
+        "simple rasters_aligned is overly strict about origin offsets"
+    ),
+    "test_reproject_geometry_handles_all_polygon_cases": (
+        "simple reproject_geometry does not normalize dateline longitudes"
+    ),
+    "test_reproject_geometry_normalizes_dateline_case_longitudes": (
+        "simple reproject_geometry does not normalize dateline longitudes"
+    ),
+    "test_find_intersections_reports_metric_area": (
+        "simple find_intersections reports area in degrees, not metres"
+    ),
+    "test_validate_polygon_geometry_accepts_repairable_invalid_polygon": (
+        "simple validate_polygon_geometry does not repair fixable invalid polygons"
+    ),
+    "test_validate_polygon_geometry_handles_all_polygon_cases": (
+        "simple validate_polygon_geometry does not repair fixable invalid polygons"
+    ),
+    "test_sample_raster_at_lonlat_masks_nodata_pixel": (
+        "simple sample_raster_at_lonlat returns the raw NoData sentinel"
+    ),
+    "test_cluster_points_keeps_dateline_chain_connected": (
+        "simple cluster_points does not keep a transitive dateline chain together"
+    ),
+    "test_cluster_points_handles_all_point_cases": (
+        "simple cluster_points assumes WGS84 input and breaks on projected/dateline "
+        "points"
+    ),
+    "test_fix_geometry_returns_polygonal_output_for_spike_case": (
+        "simple fix_geometry returns mixed-geometry output for spike fixtures"
+    ),
+    "test_rasterize_geometries_burns_pixels_for_geocase_polygon": (
+        "simple rasterize_geometries does not reproject geometry to the raster CRS"
+    ),
+    "test_rasterize_geometries_handles_all_rasterization_polygon_cases": (
+        "simple rasterize_geometries does not reproject geometry to the raster CRS"
+    ),
+    "test_crosses_antimeridian_matches_case_expectation": (
+        "simple crosses_antimeridian misses >180-degree dateline encodings"
+    ),
+    "test_crosses_antimeridian_handles_all_polygon_cases": (
+        "simple crosses_antimeridian misses >180-degree encodings and 3D coords"
+    ),
+}
+
+# The exact set of node names (``item.name``, including any ``[param]`` suffix)
+# in the simple suite that the naive implementation is expected to fail.
+_SIMPLE_EXPECTED_FAILURES: frozenset[str] = frozenset({
+    "test_reproject_point_normalizes_wrapped_longitude_fixture",
+    "test_reproject_point_handles_all_point_cases[vector-point-epsg4326-dateline-longitude-wrapping-reprojection]",
+    "test_point_in_polygon_excludes_boundary_point",
+    "test_get_bbox_classic_antimeridian_polygon_uses_minimal_span",
+    "test_get_bbox_handles_all_polygon_cases[vector-polygon-epsg4326-antimeridian-dateline]",
+    "test_buffer_in_meters_keeps_dateline_polygon_valid",
+    "test_buffer_in_meters_handles_all_polygon_cases[vector-polygon-epsg32633-rasterization-utm]",
+    "test_buffer_in_meters_handles_all_polygon_cases[vector-polygon-epsg4326-antimeridian-dateline-2]",
+    "test_get_utm_epsg_handles_svalbard_special_zone",
+    "test_get_utm_epsg_handles_all_utm_polygon_cases",
+    "test_area_m2_rejects_invalid_self_intersection",
+    "test_area_m2_handles_all_polygon_cases[vector-polygon-epsg32633-rasterization-utm]",
+    "test_area_m2_handles_all_polygon_cases[vector-polygon-epsg4326-invalid-self-intersection-topology]",
+    "test_area_m2_handles_all_polygon_cases[vector-polygon-epsg4326-invalid-repair-spike]",
+    "test_dissolve_polygons_repairs_invalid_inputs_before_union",
+    "test_dissolve_polygons_handles_all_polygon_cases[vector-polygon-epsg4326-invalid-self-intersection-topology]",
+    "test_dissolve_polygons_handles_all_polygon_cases[vector-polygon-epsg4326-invalid-repair-spike]",
+    "test_clip_raster_accepts_wgs84_bbox_for_projected_raster",
+    "test_pixel_to_world_returns_pixel_center_coordinates",
+    "test_rasters_aligned_accepts_shifted_raster_on_same_pixel_lattice",
+    "test_reproject_geometry_handles_all_polygon_cases[vector-polygon-epsg4326-antimeridian-dateline-2]",
+    "test_reproject_geometry_normalizes_dateline_case_longitudes",
+    "test_find_intersections_reports_metric_area",
+    "test_validate_polygon_geometry_accepts_repairable_invalid_polygon",
+    "test_validate_polygon_geometry_handles_all_polygon_cases[vector-polygon-epsg32633-rasterization-utm]",
+    "test_sample_raster_at_lonlat_masks_nodata_pixel",
+    "test_cluster_points_keeps_dateline_chain_connected",
+    "test_cluster_points_handles_all_point_cases[vector-point-epsg3857-epsg3857-valid-web-mercator]",
+    "test_cluster_points_handles_all_point_cases[vector-point-epsg4326-clustering-dateline-transitive-connectivity]",
+    "test_fix_geometry_returns_polygonal_output_for_spike_case",
+    "test_rasterize_geometries_burns_pixels_for_geocase_polygon",
+    "test_rasterize_geometries_handles_all_rasterization_polygon_cases",
+    "test_crosses_antimeridian_matches_case_expectation[_dateline_polygon_geometry-True]",
+    "test_crosses_antimeridian_handles_all_polygon_cases[vector-polygon-epsg32633-rasterization-utm]",
+    "test_crosses_antimeridian_handles_all_polygon_cases[vector-polygon-epsg4326-antimeridian-dateline-2]",
+    "test_crosses_antimeridian_handles_all_polygon_cases[vector-polygon-epsg4326-attributes-format-limitation-format-specific]",
+})
+
+
+def pytest_collection_modifyitems(config, items):  # noqa: ARG001
+    """Mark the known simple-implementation deficiencies as strict xfails."""
+    import pytest
+
+    for item in items:
+        if item.fspath.basename != _SIMPLE_SUITE_FILENAME:
+            continue
+        if item.name not in _SIMPLE_EXPECTED_FAILURES:
+            continue
+        reason = _SIMPLE_LIMITATION_REASONS.get(item.originalname)
+        if reason is None:
+            continue
+        item.add_marker(pytest.mark.xfail(reason=reason, strict=True))