unsprawl.providers.data.us.ca.sf.datasf

unsprawl.providers.data.us.ca.sf.datasf.

DataSFProvider (US-CA-SF) – placeholder provider for housing transactions.

This is a dumb fetcher: - handles HTTP/auth/caching - returns raw tabular data - does NOT create Asset objects (adapter layer does that)

TODO(hackathon): For the demo, we can start with a single public dataset endpoint from data.sfgov.org and a minimal schema.

Classes

DataSFProvider

Provider for San Francisco open data (housing transactions).

Functions

_default_data_root()

Module Contents

_default_data_root()

class DataSFProvider

Provider for San Francisco open data (housing transactions).

data_root: Path

property transactions_path: Path

Default cache location for housing transactions.

fetch_housing_transactions(*, force=False)

Fetch housing transaction records as a DataFrame.

Notes

This is currently a stub to establish the interface. The first implementation should: - fetch from data.sfgov.org (Socrata) or another SF open data source - cache to transactions_path - provide an offline fallback for CI