Consolidation cluster 7: kwarg / signature / parity tails (long-tail epic #2424)

[brendancol]

Follow-up to epic #2424 / #2390. Cluster 7 of 16. Parallel-safe, but expect this to land as two PRs because the kwarg-signature half and the parity-tail half belong in different homes.

Scope

Two related tails: function signatures / kwargs / docstring parity (heading into unit/), and parity-tail (extending the existing parity/ cluster).

Files to consolidate (17)

Sub-PR A: kwarg and signature (9 files)

• xrspatial/geotiff/tests/test_experimental_internal_optin_2352.py
• xrspatial/geotiff/tests/test_gil_friendly_kwarg_1830.py
• xrspatial/geotiff/tests/test_kwarg_behaviour_2026_05_12.py
• xrspatial/geotiff/tests/test_kwarg_behaviour_2026_05_12_v2.py
• xrspatial/geotiff/tests/test_kwarg_coverage_2026_05_11_r4.py
• xrspatial/geotiff/tests/test_photometric_kwarg_1769.py
• xrspatial/geotiff/tests/test_reader_kwarg_order_1935.py
• xrspatial/geotiff/tests/test_signature_annotations_1654.py
• xrspatial/geotiff/tests/test_signature_annotations_1705.py

Target: new xrspatial/geotiff/tests/unit/test_signatures.py.

Sub-PR B: parity tail (8 files)

• xrspatial/geotiff/tests/test_degenerate_shapes_backends_2026_05_11.py
• xrspatial/geotiff/tests/test_dispatch_validation_parity_2162.py
• xrspatial/geotiff/tests/test_eager_finalization_parity_2162.py
• xrspatial/geotiff/tests/test_lazy_finalization_parity_2162.py
• xrspatial/geotiff/tests/test_read_entry_points_doc_param_parity_2274.py
• xrspatial/geotiff/tests/test_release_contract_parity_2389.py
• xrspatial/geotiff/tests/test_round_trip_parity_rasterio_zarr_1961.py
• xrspatial/geotiff/tests/test_signature_parity_1631.py

Target: extend xrspatial/geotiff/tests/parity/test_backend_matrix.py (or add a sibling parity/test_finalization.py if backend_matrix grows past 2500 lines).

Note: test_read_entry_points_doc_param_parity_2274.py and test_signature_parity_1631.py are signature-flavoured and could land in Sub-PR A instead. Pick whichever home keeps related tests together; do not duplicate.

Constraints

• Tests-only.
• Markers from _helpers/markers.py; make_minimal_tiff from _helpers/tiff_builders.py.
• Descriptive IDs.
• CLUSTER_AUDIT_KWARG.md and CLUSTER_AUDIT_PARITY.md deleted before merge of each sub-PR.

Verification

pytest xrspatial/geotiff/tests/unit/test_signatures.py -v
pytest xrspatial/geotiff/tests/parity/ -v
pytest xrspatial/geotiff/tests/ -x -q

File count drops by 15 (17 deleted, 2 added across the two sub-PRs).