Source code for unsprawl.adapters.us

"""unsprawl.adapters.us.

US adapter (skeleton).

This is the normalization layer mapping US provider outputs into universal ``Asset`` objects.

NOTE: This file intentionally contains no city-specific logic yet.
"""

from __future__ import annotations

from unsprawl.adapters.base import CountryAdapter
from unsprawl.core.schemas import Asset




class USAdapter(CountryAdapter):
    """Normalize US datasets into core ``Asset`` objects."""



    def fetch(self, region_code: str) -> list[Asset]:
        """Fetch assets from US datasets (not implemented)."""
        # TODO(engineering): implement dynamic subregion dispatch (e.g., US-CA-SF).
        raise NotImplementedError(
            f"USAdapter not implemented yet (requested region_code={region_code!r})"
        )