unsprawl.adapters.base

Adapter interfaces.

Adapters translate local/provider data into the universal core schemas.

Anti-circular protocol

Adapters may import from: - unsprawl.core (schemas) - unsprawl.providers (fetchers)

Adapters MUST NOT import from loaders.

Classes

CountryAdapter

Abstract adapter for a country-level normalization layer.

Module Contents

class CountryAdapter[source]

Bases: abc.ABC

Abstract adapter for a country-level normalization layer.

abstractmethod fetch(region_code)[source]

Fetch and normalize assets for a specific region.

Parameters:

region_code – Hyphenated region code string (e.g., ‘SG’ or ‘US-CA-SF’).

Returns:

Normalized assets.

Return type:

list[Asset]