mirror of
https://github.com/Hestia-Homes/Model.git
synced 2026-07-19 08:53:17 +00:00
9be95a0d3b
Slice 3c.1. Ingestion will persist a UPRN's coordinates and planning protections together as a write-through cache, so resolve them in a single partition read rather than two. `SpatialReference` bundles the coordinates (which drive the Solar fetch) and the `PlanningRestrictions` (which gate wall insulation per ADR-0019/ADR-0020); `GeospatialRepository.spatial_for(uprn)` returns it, and `coordinates_for`/`planning_restrictions_for` now delegate to the one lookup. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
133 lines
4.2 KiB
Python
133 lines
4.2 KiB
Python
"""GeospatialRepo resolves a Property's coordinates from the OS Open-UPRN data.
|
|
|
|
A reference-data lookup, not a Fetcher (ADR-0011): no live OS API call. The
|
|
adapter reads the partitioned Open-UPRN parquet via an injected reader, so the
|
|
test exercises the partition lookup + filter against real fixture parquets with
|
|
no network.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Callable
|
|
from pathlib import Path
|
|
|
|
import pandas as pd
|
|
|
|
from typing import Optional
|
|
|
|
from domain.geospatial.coordinates import Coordinates
|
|
from domain.geospatial.planning_restrictions import PlanningRestrictions
|
|
from domain.geospatial.spatial_reference import SpatialReference
|
|
from repositories.geospatial.geospatial_s3_repository import GeospatialS3Repository
|
|
|
|
|
|
def _reader(base: Path) -> Callable[[str], pd.DataFrame]:
|
|
def read(key: str) -> pd.DataFrame:
|
|
return pd.read_parquet(base / key)
|
|
|
|
return read
|
|
|
|
|
|
def _write_open_uprn(base: Path) -> None:
|
|
spatial = base / "spatial"
|
|
spatial.mkdir(parents=True, exist_ok=True)
|
|
pd.DataFrame(
|
|
{"lower": [0], "upper": [100000], "filenames": ["0_100000.parquet"]}
|
|
).to_parquet(spatial / "filename_meta.parquet")
|
|
pd.DataFrame(
|
|
{
|
|
"UPRN": [12345, 12346],
|
|
"LATITUDE": [51.5074, 51.6000],
|
|
"LONGITUDE": [-0.1278, -0.2000],
|
|
# Planning flags co-located with the coordinates in the partition
|
|
# (legacy column names — confirm exact names in the S3 deep-dive).
|
|
"conservation_status": [True, False],
|
|
"is_listed_building": [False, True],
|
|
"is_heritage_building": [False, False],
|
|
}
|
|
).to_parquet(spatial / "0_100000.parquet")
|
|
|
|
|
|
def test_coordinates_for_returns_lon_lat(tmp_path: Path) -> None:
|
|
# Arrange
|
|
_write_open_uprn(tmp_path)
|
|
repo = GeospatialS3Repository(_reader(tmp_path))
|
|
|
|
# Act
|
|
coords = repo.coordinates_for(12345)
|
|
|
|
# Assert
|
|
assert coords == Coordinates(longitude=-0.1278, latitude=51.5074)
|
|
|
|
|
|
def test_coordinates_for_returns_none_when_uprn_absent(tmp_path: Path) -> None:
|
|
# Arrange
|
|
_write_open_uprn(tmp_path)
|
|
repo = GeospatialS3Repository(_reader(tmp_path))
|
|
|
|
# Act / Assert — uprn inside the partition range but not present in the data
|
|
assert repo.coordinates_for(99999) is None
|
|
|
|
|
|
def test_coordinates_for_returns_none_when_no_partition_covers_uprn(
|
|
tmp_path: Path,
|
|
) -> None:
|
|
# Arrange
|
|
_write_open_uprn(tmp_path)
|
|
repo = GeospatialS3Repository(_reader(tmp_path))
|
|
|
|
# Act / Assert — uprn beyond every partition's range
|
|
assert repo.coordinates_for(500000) is None
|
|
|
|
|
|
def test_planning_restrictions_for_reads_the_co_located_flags(tmp_path: Path) -> None:
|
|
# Arrange — same partition, planning flags alongside the coordinates.
|
|
_write_open_uprn(tmp_path)
|
|
repo = GeospatialS3Repository(_reader(tmp_path))
|
|
|
|
# Act
|
|
restrictions = repo.planning_restrictions_for(12345)
|
|
|
|
# Assert — the three flags come back as the Property's PlanningRestrictions.
|
|
assert restrictions == PlanningRestrictions(
|
|
in_conservation_area=True, is_listed=False, is_heritage=False
|
|
)
|
|
|
|
|
|
def test_planning_restrictions_for_returns_none_when_uprn_absent(
|
|
tmp_path: Path,
|
|
) -> None:
|
|
# Arrange
|
|
_write_open_uprn(tmp_path)
|
|
repo = GeospatialS3Repository(_reader(tmp_path))
|
|
|
|
# Act / Assert
|
|
assert repo.planning_restrictions_for(99999) is None
|
|
|
|
|
|
def test_spatial_for_returns_coordinates_and_restrictions_together(
|
|
tmp_path: Path,
|
|
) -> None:
|
|
# Arrange — one partition row carries the coordinates and the planning flags.
|
|
_write_open_uprn(tmp_path)
|
|
repo = GeospatialS3Repository(_reader(tmp_path))
|
|
|
|
# Act — a single reference lookup yields both, so Ingestion reads the row once.
|
|
reference: Optional[SpatialReference] = repo.spatial_for(12346)
|
|
|
|
# Assert
|
|
assert reference == SpatialReference(
|
|
coordinates=Coordinates(longitude=-0.2000, latitude=51.6000),
|
|
restrictions=PlanningRestrictions(
|
|
in_conservation_area=False, is_listed=True, is_heritage=False
|
|
),
|
|
)
|
|
|
|
|
|
def test_spatial_for_returns_none_when_uprn_absent(tmp_path: Path) -> None:
|
|
# Arrange
|
|
_write_open_uprn(tmp_path)
|
|
repo = GeospatialS3Repository(_reader(tmp_path))
|
|
|
|
# Act / Assert
|
|
assert repo.spatial_for(99999) is None
|