gla-data 0.1.0__tar.gz → 0.1.2__tar.gz

{gla_data-0.1.0 → gla_data-0.1.2}/.github/workflows/publish.yml

@@ -19,9 +19,19 @@ jobs:
           name: dist
           path: dist/
 
-  publish:
+  integration-test:
     needs: build
     runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: prefix-dev/setup-pixi@v0.8.3
+        with:
+          pixi-version: latest
+      - run: pixi run test-integration
+
+  publish:
+    needs: [build, integration-test]
+    runs-on: ubuntu-latest
     environment: pypi
     permissions:
       id-token: write

{gla_data-0.1.0 → gla_data-0.1.2}/.gitignore

@@ -32,3 +32,9 @@ outputs/
 # OS
 .DS_Store
 Thumbs.db
+
+# Plan docs and Claude instructions — internal, not part of the shipped project
+PLAN*.md
+WORKPLAN.md
+DESIGN.md
+CLAUDE.md

gla_data-0.1.2/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: gla-data
+Version: 0.1.2
+Summary: Shared tools for loading, transforming, and visualising the GLA datasets used in City Data analysis.
+Author-email: Conor Dempsey <conor.dempsey@london.gov.uk>
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: geopandas>=1.0
+Requires-Dist: pandas>=2.2
+Requires-Dist: pandera>=0.32.1
+Requires-Dist: pyarrow>=24.0.0
+Requires-Dist: pydantic-settings
+Requires-Dist: requests>=2.32
+Requires-Dist: typer>=0.26.8
+Description-Content-Type: text/markdown
+
+# gla-data
+
+Shared tools for loading, transforming, and visualising the GLA datasets used in City Data analysis.
+
+## Installation
+
+### Global install (CLI)
+
+To install `gla-data` globally so the `gla-data` CLI is available anywhere in your terminal, use `uv tool`:
+
+```bash
+uv tool install gla-data
+```
+
+Normally `pixi global install` would be the preferred approach, but it does not yet support PyPI packages — so `uv tool` is the right choice for now.
+
+If you don't have `uv` installed, you can install it via pixi:
+
+```bash
+pixi global install uv
+```
+
+### pip
+
+```bash
+pip install gla-data
+```
+
+### pixi
+
+```bash
+pixi add gla-data
+```
+
+Pixi pulls geospatial dependencies (geopandas, pyproj, etc.) from conda-forge, which provides reliable pre-built binaries across all platforms and Python versions.
+
+## Usage
+
+### Python API
+
+```python
+import gla_data
+
+# Load 2021 LSOA boundaries for London
+lsoa_gdf = gla_data.load_boundaries(geography='lsoa', year=2021)
+
+# Load census dwelling counts
+dwellings_2021 = gla_data.load_census_dwellings(year=2021)
+dwellings_2011 = gla_data.load_census_dwellings(year=2011)
+
+# Crosswalk 2011 dwelling counts onto 2021 LSOA boundaries
+dwellings_2011_xw = gla_data.crosswalk(
+    dwellings_2011,
+    from_year=2011,
+    to_year=2021,
+    value_cols=['dwellings_total'],
+)
+
+# Load an OA → LSOA geography lookup
+lookup = gla_data.load_geography_lookup(year=2021, smallest_geography='oa')
+
+# Aggregate OA-level data up to LSOA level
+lsoa_totals = gla_data.aggregate(
+    df,
+    from_geography='oa',
+    to_geography='lsoa',
+    value_cols=['count'],
+    year=2021,
+)
+```
+
+### CLI
+
+The package installs a `gla-data` command. Run `catalogue` to list all available datasets:
+
+```bash
+gla-data catalogue
+```
+
+This prints a table of every dataset, the function used to load it, a description, and its access tier (public/S3).
+
+## Development
+
+```bash
+git clone <repo-url>
+cd gla-data
+pixi install
+
+pixi run test       # run tests
+pixi run lint       # check code style
+pixi run format     # auto-format
+pixi run typecheck  # type checking
+```

gla_data-0.1.2/README.md

@@ -0,0 +1,93 @@
+# gla-data
+
+Shared tools for loading, transforming, and visualising the GLA datasets used in City Data analysis.
+
+## Installation
+
+### Global install (CLI)
+
+To install `gla-data` globally so the `gla-data` CLI is available anywhere in your terminal, use `uv tool`:
+
+```bash
+uv tool install gla-data
+```
+
+Normally `pixi global install` would be the preferred approach, but it does not yet support PyPI packages — so `uv tool` is the right choice for now.
+
+If you don't have `uv` installed, you can install it via pixi:
+
+```bash
+pixi global install uv
+```
+
+### pip
+
+```bash
+pip install gla-data
+```
+
+### pixi
+
+```bash
+pixi add gla-data
+```
+
+Pixi pulls geospatial dependencies (geopandas, pyproj, etc.) from conda-forge, which provides reliable pre-built binaries across all platforms and Python versions.
+
+## Usage
+
+### Python API
+
+```python
+import gla_data
+
+# Load 2021 LSOA boundaries for London
+lsoa_gdf = gla_data.load_boundaries(geography='lsoa', year=2021)
+
+# Load census dwelling counts
+dwellings_2021 = gla_data.load_census_dwellings(year=2021)
+dwellings_2011 = gla_data.load_census_dwellings(year=2011)
+
+# Crosswalk 2011 dwelling counts onto 2021 LSOA boundaries
+dwellings_2011_xw = gla_data.crosswalk(
+    dwellings_2011,
+    from_year=2011,
+    to_year=2021,
+    value_cols=['dwellings_total'],
+)
+
+# Load an OA → LSOA geography lookup
+lookup = gla_data.load_geography_lookup(year=2021, smallest_geography='oa')
+
+# Aggregate OA-level data up to LSOA level
+lsoa_totals = gla_data.aggregate(
+    df,
+    from_geography='oa',
+    to_geography='lsoa',
+    value_cols=['count'],
+    year=2021,
+)
+```
+
+### CLI
+
+The package installs a `gla-data` command. Run `catalogue` to list all available datasets:
+
+```bash
+gla-data catalogue
+```
+
+This prints a table of every dataset, the function used to load it, a description, and its access tier (public/S3).
+
+## Development
+
+```bash
+git clone <repo-url>
+cd gla-data
+pixi install
+
+pixi run test       # run tests
+pixi run lint       # check code style
+pixi run format     # auto-format
+pixi run typecheck  # type checking
+```

{gla_data-0.1.0 → gla_data-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gla-data"
-version = "0.1.0"
+version = "0.1.2"
 description = "Shared tools for loading, transforming, and visualising the GLA datasets used in City Data analysis."
 readme = "README.md"
 license = { text = "MIT" }
@@ -40,11 +40,16 @@ select = ["E", "F", "I", "UP", "B"]
 
 [tool.mypy]
 strict                 = true
-packages               = ["gla_data"]
+packages               = ["gla_data", "tests"]
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+
 [tool.bumpversion]
-current_version = "0.1.0"
+current_version = "0.1.2"
 commit = true
 tag    = true
 

{gla_data-0.1.0 → gla_data-0.1.2}/src/gla_data/_schemas.py

@@ -8,7 +8,7 @@ Schemas are constructed as factory functions rather than class-level constants
 because the expected columns depend on function parameters (year, geography).
 """
 
-import pandera as pa
+import pandera.pandas as pa
 
 # LAD column year suffix varies by lookup vintage — this is what ONS provides.
 LAD_YEAR_BY_LOOKUP_YEAR = {2021: "22", 2011: "20"}
@@ -26,7 +26,7 @@ def boundary_schema(geography: str, year: int | None) -> pa.DataFrameSchema:
         code_col = f"{geo}{yr}CD"
         name_col = f"{geo}{yr}NM"
 
-    return pa.DataFrameSchema(  # type: ignore[no-untyped-call]
+    return pa.DataFrameSchema(
         {
             code_col: pa.Column(str, nullable=False),
             name_col: pa.Column(str, nullable=False),
@@ -53,13 +53,13 @@ def geography_lookup_schema(year: int, smallest_geography: str) -> pa.DataFrameS
     cols[f"LAD{lad_yr}CD"] = pa.Column(str, nullable=False)
     cols[f"LAD{lad_yr}NM"] = pa.Column(str, nullable=False)
 
-    return pa.DataFrameSchema(cols, coerce=False)  # type: ignore[no-untyped-call]
+    return pa.DataFrameSchema(cols, coerce=False)
 
 
 def census_dwellings_schema(year: int) -> pa.DataFrameSchema:
     """Schema for the output of load_census_dwellings()."""
     yr = str(year)[2:]
-    return pa.DataFrameSchema(  # type: ignore[no-untyped-call]
+    return pa.DataFrameSchema(
         {
             f"LSOA{yr}CD": pa.Column(str, nullable=False),
             "dwellings_total": pa.Column(int, pa.Check.ge(0), nullable=False),

{gla_data-0.1.0 → gla_data-0.1.2}/src/gla_data/census.py

@@ -25,10 +25,19 @@ _EXCEL_KWARGS = {
 
 
 def _fetch_census_dwellings(year: int) -> pd.DataFrame:
-    """Download and normalise the raw UKDS census dwellings file for the given year."""
+    """Download the raw UKDS census dwellings
+    file for the given year and normalise it."""
     kwargs = _EXCEL_KWARGS.get(year, {})
     raw = _ukds.fetch(f"census_dwellings_{year}", **kwargs)
+    return _clean_census_dwellings(raw, year)
 
+
+def _clean_census_dwellings(raw: pd.DataFrame, year: int) -> pd.DataFrame:
+    """Select and rename the raw UKDS columns into the public schema for a given year.
+
+    Pure and deterministic — no I/O — so it can be unit-tested directly with an
+    in-memory fixture, without mocking ``_ukds.fetch``.
+    """
     cols = _RAW_COLUMNS[year]
     code_col = f"LSOA{str(year)[2:]}CD"
 

{gla_data-0.1.0 → gla_data-0.1.2}/src/gla_data/cli.py

@@ -1,5 +1,7 @@
 """Command-line interface for gla_data."""
 
+from typing import Annotated
+
 import typer
 from rich.console import Console
 from rich.table import Table
@@ -11,6 +13,23 @@ app = typer.Typer(
 )
 
 
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(gla_data.__version__)
+        raise typer.Exit()
+
+
+@app.callback()
+def main_callback(
+    version: Annotated[
+        bool,
+        typer.Option("--version", "-V", callback=_version_callback, is_eager=True,
+                     help="Show version and exit."),
+    ] = False,
+) -> None:
+    pass
+
+
 @app.command()
 def catalogue() -> None:
     """List all datasets available in gla_data."""

{gla_data-0.1.0 → gla_data-0.1.2}/tests/test_census_dwellings.py

@@ -5,6 +5,7 @@ import pytest
 
 import gla_data
 import gla_data._cache as cache_module
+from gla_data.census import _clean_census_dwellings
 
 # ---------------------------------------------------------------------------
 # Fixtures
@@ -31,6 +32,42 @@ def fake_dwellings_2011():
     )
 
 
+# ---------------------------------------------------------------------------
+# Pure transform (no I/O, no mocking needed)
+# ---------------------------------------------------------------------------
+
+
+def test_clean_census_dwellings_2021_selects_and_renames():
+    raw = pd.DataFrame(
+        {
+            "Lower layer Super Output Areas Code": ["E01000001", "E01000002"],
+            "Observation": [1079, 1178],
+            "Some Other Column": ["x", "y"],
+        }
+    )
+
+    result = _clean_census_dwellings(raw, year=2021)
+
+    assert list(result.columns) == ["LSOA21CD", "dwellings_total"]
+    assert result["LSOA21CD"].tolist() == ["E01000001", "E01000002"]
+    assert result["dwellings_total"].tolist() == [1079, 1178]
+
+
+def test_clean_census_dwellings_2011_selects_and_renames():
+    raw = pd.DataFrame(
+        {
+            "GEO_CODE": ["E01000001", "E01000002"],
+            "Dwellings : Total\\ Dwellings - Unit : Dwellings": [950, 1050],
+        }
+    )
+
+    result = _clean_census_dwellings(raw, year=2011)
+
+    assert list(result.columns) == ["LSOA11CD", "dwellings_total"]
+    assert result["LSOA11CD"].tolist() == ["E01000001", "E01000002"]
+    assert result["dwellings_total"].tolist() == [950, 1050]
+
+
 # ---------------------------------------------------------------------------
 # Validation (no network calls)
 # ---------------------------------------------------------------------------

gla_data-0.1.2/tests/test_cli.py

@@ -0,0 +1,19 @@
+"""Tests for the gla_data command-line interface."""
+
+from typer.testing import CliRunner
+
+from gla_data.cli import app
+
+runner = CliRunner()
+
+
+def test_catalogue_command_exits_cleanly():
+    result = runner.invoke(app, ["catalogue"])
+    assert result.exit_code == 0
+
+
+def test_catalogue_command_lists_implemented_datasets():
+    result = runner.invoke(app, ["catalogue"])
+    assert "Census Dwellings" in result.output
+    assert "load_census_dwel" in result.output
+    assert "ONS Boundaries" in result.output

gla_data-0.1.0/DESIGN.md

@@ -1,283 +0,0 @@
-# gla-data design
-
-## Purpose
-
-`gla-data` is a shared Python package for the GLA City Intelligence Data Science team. It provides clean, consistent access to the GLA-relevant datasets used across City Data analysis projects.
-
-The primary goal is to reduce the cost of getting started with a new dataset. A user who knows a dataset exists but has not yet used it — because the API is unfamiliar, credentials are unclear, or the raw data requires significant cleaning — should be able to load analysis-ready data in a few lines of code.
-
-## Who this is for
-
-Data scientists on the City Intelligence team working on GLA analysis projects. Users are assumed to have some familiarity with the datasets, but `gla-data` should make it easy to discover what is available and how to use it, including:
-
-- What credentials or sign-ups are required to access a dataset
-- What the default filters are and why
-- What parameters are available to adjust those defaults
-
-## What this package does
-
-- Loads GLA-relevant datasets from public sources and (in future) from the GLA S3 data lake
-- Returns data filtered to sensible defaults (typically London, latest available year)
-- Provides standard geography transformations: aggregation, disaggregation, and year crosswalks
-- Documents required credentials and setup steps for each data source in the README; functions raise clear errors with a pointer to the README if credentials are missing
-
-## What this package does not do
-
-- Project-specific cleaning, transformation, or modelling — these belong in project code
-- Cross-dataset merging — users join datasets themselves; `gla-data` provides the building blocks
-- Exploratory analysis or visualisation — may be revisited once clear patterns emerge across projects
-
----
-
-## Design principles
-
-**Defaults should be sensible and explicit.** Every parameter with a default should have a reason for that default, and the docstring should state it. A user should be able to call any function with no arguments and get something useful.
-
-**Return types are consistent.** All load functions return a `pd.DataFrame`. Functions that return geographic data return a `gpd.GeoDataFrame`. Column naming follows ONS conventions where they exist (e.g. `LSOA21CD`, `LAD22NM`).
-
-**Functions are stateless.** Call a function, get data back. No objects to manage, no state to track between calls.
-
-**Private functions do the work, public functions are the interface.** HTTP calls, API authentication, raw data parsing, and column renaming all happen in private functions prefixed with `_`. Public functions are thin and readable.
-
-**Source switching is per-function.** Each function accepts a `source` parameter defaulting to `"public"`. As datasets become available on the GLA S3 data lake, `source="s3"` is added to that function. Functions that do not yet support S3 raise a clear error if `source="s3"` is passed.
-
----
-
-## Data access tiers
-
-Datasets differ in what setup is required. Each function's docstring and the catalogue state which tier it belongs to. Setup instructions for datasets requiring credentials are in the README. Functions that require credentials raise a clear, descriptive error if the relevant environment variable is missing — for example:
-
-```
-EnvironmentError: EPC_API_KEY not set. This dataset requires a free DLUHC account.
-See the README for setup instructions.
-```
-
-| Tier | Description | Examples |
-|---|---|---|
-| `public` | No credentials required. URLs are embedded in the package. | ONS boundaries, census data via Nomis |
-| `registered` | Requires a free account or API key. Set via environment variable. | EPC (DLUHC portal), Nomis bulk API key |
-| `licensed` | Requires a government or commercial licence. | OS AddressBase |
-| `s3` | Requires access to the GLA internal data lake (provisioned by GLA engineering). | TBD |
-
----
-
-## API conventions
-
-### Naming
-
-- Data loading functions: `load_<dataset>` or `load_boundaries(geography=...)`
-- Geography transformation functions: `aggregate(...)`, `crosswalk(...)`
-- Discovery functions: `catalogue()`
-
-Parameters describe what the user wants, not how the code fetches it.
-
-### Standard parameters
-
-| Parameter | Type | Notes |
-|---|---|---|
-| `geography` | `str` | Geographic unit: `"oa"`, `"lsoa"`, `"msoa"`, `"ward"`, `"borough"`, `"london"` |
-| `year` | `int` | Reference year. Valid values are documented per function |
-| `source` | `Literal["public", "s3"]` | Data source. Defaults to `"public"` |
-
-### Return types
-
-| Function type | Return type | Notes |
-|---|---|---|
-| Tabular data | `pd.DataFrame` | Index is always a plain integer range index |
-| Geographic data | `gpd.GeoDataFrame` | CRS is always British National Grid (EPSG:27700) |
-
-### Column naming
-
-- Geography codes follow ONS conventions: `LSOA21CD`, `LAD22NM`, `OA21CD` etc.
-- The year in a geography code column name reflects the geography vintage, not the data year
-- All column names are uppercase with underscores
-
----
-
-## Public API
-
-### Discovery
-
-```python
-gla_data.catalogue()
-```
-
-Returns a `pd.DataFrame` listing all available datasets with columns: `dataset`, `description`, `access_tier`, `status`, `source_supported`. For datasets with `access_tier` other than `public`, the catalogue notes that setup is required — see the README for instructions.
-
----
-
-### Boundaries
-
-```python
-gdf = gla_data.load_boundaries(geography="lsoa", year=2021)
-```
-
-Returns boundary polygons for London at the specified geography and year.
-
-**Parameters:**
-- `geography`: `"oa"`, `"lsoa"`, `"msoa"`, `"ward"`, `"borough"`, `"london"`
-- `year`: valid values depend on geography (e.g. LSOAs: `2011`, `2021`; borough boundaries do not have a year)
-- `source`: `"public"` only for now
-
-**Returns:** `gpd.GeoDataFrame` with columns:
-- Geography code and name (e.g. `LSOA21CD`, `LSOA21NM`)
-- `geometry` — polygon in EPSG:27700
-
-**Access tier:** `public`
-
----
-
-### Geography lookup
-
-```python
-df = gla_data.load_geography_lookup(year=2021, smallest_geography="lsoa")
-```
-
-Returns the ONS lookup table mapping London LSOAs (or OAs) to higher geographies (MSOA, borough).
-
-**Parameters:**
-- `year`: `2011` or `2021`
-- `smallest_geography`: `"lsoa"` (default, one row per LSOA) or `"oa"` (one row per OA, includes OA code column)
-- `source`: `"public"` only for now
-- `cache`: if `True` (default), result is cached to `~/.cache/gla_data/`
-
-**Returns:** `pd.DataFrame`. Columns for 2021 (lsoa grain):
-`LSOA21CD`, `LSOA21NM`, `MSOA21CD`, `MSOA21NM`, `LAD22CD`, `LAD22NM`.
-For 2011: `LSOA11CD`, `LSOA11NM`, `MSOA11CD`, `MSOA11NM`, `LAD20CD`, `LAD20NM`.
-Note: the 2011 table uses 2020 LAD boundaries — this is what ONS provides at this grain.
-
-**Access tier:** `public`
-
-**Notes:**
-- Source tables are at OA grain. For `smallest_geography="lsoa"`, deduplication is applied.
-- Fetching is slow (~17s). A `UserWarning` is raised on first call; result is cached to disk by default.
-
----
-
-### Census dwellings
-
-```python
-df = gla_data.load_census_dwellings(year=2021, geography="lsoa")
-```
-
-Returns dwelling counts for London at the specified geography and census year.
-
-**Parameters:**
-- `year`: `2011` or `2021`
-- `geography`: `"oa"`, `"lsoa"`, `"msoa"`, `"borough"`, `"london"`
-- `source`: `"public"` only for now
-
-**Returns:** `pd.DataFrame` with a geography code column (e.g. `LSOA21CD`) and:
-- `dwellings_total`
-- Dwelling type breakdown: `dwellings_detached`, `dwellings_semi_detached`, `dwellings_terraced`, `dwellings_flat`, `dwellings_other`
-- Household space type breakdown: `spaces_total`, `spaces_occupied`, `spaces_vacant`
-
-**Access tier:** `public`
-
-**Notes:**
-- 2011 data uses 2011 LSOA boundaries; 2021 data uses 2021 LSOA boundaries. Use `crosswalk()` if you need both years on consistent boundaries.
-- When `geography` is above LSOA, data is aggregated via the standard ONS lookup.
-
----
-
-### EPC
-
-```python
-df = gla_data.load_epc(geography="lsoa", year=2023)
-```
-
-Returns Energy Performance Certificate data for London.
-
-**Access tier:** `registered` — requires a free account at the DLUHC EPC portal. Run `gla_data.setup_instructions(dataset="epc")` for details.
-
-*Further design TBD once initial datasets are implemented.*
-
----
-
-### Geography transformation
-
-#### Aggregation
-
-```python
-df_msoa = gla_data.aggregate(
-    df,
-    from_geography="lsoa",
-    to_geography="msoa",
-    value_cols=["dwellings_total", "dwellings_vacant"],
-    method="sum",
-    year=2021,
-)
-```
-
-Aggregates a DataFrame from a lower to a higher geography using the standard ONS lookup. The `year` parameter specifies which vintage of lookup to use.
-
-**Parameters:**
-- `df`: input DataFrame containing a geography code column (auto-detected by name)
-- `from_geography`: source geography
-- `to_geography`: target geography (must be higher than `from_geography`)
-- `value_cols`: columns to aggregate
-- `method`: `"sum"` or `"mean"`
-- `year`: lookup vintage
-
-#### Crosswalk (same geography, different year)
-
-```python
-df_2021 = gla_data.crosswalk(
-    df,
-    geography="lsoa",
-    from_year=2011,
-    to_year=2021,
-    value_cols=["dwellings_total"],
-    method="proportional",
-)
-```
-
-Converts a DataFrame from one year's geography boundaries to another using the ONS exact-fit or best-fit lookup.
-
-**Parameters:**
-- `df`: input DataFrame
-- `geography`: the geographic unit
-- `from_year`, `to_year`: boundary vintages
-- `value_cols`: numeric columns to convert
-- `method`: `"proportional"` (split values by area overlap) or `"exact_fit"` (for cases where boundaries nest cleanly)
-
-**Notes:**
-- Disaggregation (higher to lower geography) is not supported in the first version. The `aggregate` function is one-directional.
-- Disaggregation requires assumptions about how values are distributed within a higher geography. If this is needed, it should be designed explicitly with a stated method (e.g. uniform distribution, population-weighted).
-
----
-
-## Package structure
-
-```
-src/gla_data/
-├── __init__.py      ← public API: re-exports all public functions
-├── py.typed
-├── config.py        ← environment variable handling (S3 config etc.)
-├── _arcgis.py       ← private: generic ArcGIS FeatureServer HTTP/pagination
-├── _ons.py          ← private: ONS service constants and fetch functions
-├── _ukds.py         ← private: UKDS dataset registry and static file downloads
-├── _cache.py        ← private: shared disk cache (~/.cache/gla_data/)
-├── geography.py     ← load_boundaries(), load_geography_lookup()
-├── transforms.py    ← crosswalk() [aggregate() to be added]
-├── catalogue.py     ← catalogue() [not yet implemented]
-├── census.py        ← load_census_dwellings()
-├── epc.py           ← load_epc() [not yet implemented]
-```
-
-### Notes on the private layer
-
-`_arcgis.py` contains generic ArcGIS FeatureServer pagination logic (no ONS-specific
-knowledge). `_ons.py` holds ONS service constants and the fetch functions that use them.
-When new data sources are added (e.g. Nomis for census, DLUHC for EPC), they get their
-own private module and introduce new HTTP helpers only if needed.
-
----
-
-## Open questions
-
-- `aggregate` and `crosswalk` are generic functions (not per-geography-pair). They auto-detect the geography code column by name — open question: what happens if detection is ambiguous?
-- What is the right disaggregation method for numeric quantities (MSOA → LSOA)? Uniform? Population-weighted? Defer until there is a concrete use case.
-- Should `load_boundaries` accept `year=None` for geographies that do not have vintages (e.g. borough boundaries)?
-- Where does Land Registry data fit — access tier, likely `public` (price paid) or `registered` (title register)?
-- OS AddressBase: confirm whether the GLA licence covers use in this package or whether each team member needs their own licence.

gla_data-0.1.0/PKG-INFO

@@ -1,43 +0,0 @@
-Metadata-Version: 2.4
-Name: gla-data
-Version: 0.1.0
-Summary: Shared tools for loading, transforming, and visualising the GLA datasets used in City Data analysis.
-Author-email: Conor Dempsey <conor.dempsey@london.gov.uk>
-License: MIT
-Requires-Python: >=3.12
-Requires-Dist: geopandas>=1.0
-Requires-Dist: pandas>=2.2
-Requires-Dist: pandera>=0.32.1
-Requires-Dist: pyarrow>=24.0.0
-Requires-Dist: pydantic-settings
-Requires-Dist: requests>=2.32
-Requires-Dist: typer>=0.26.8
-Description-Content-Type: text/markdown
-
-# gla-data
-
-Shared tools for loading, transforming, and visualising the GLA datasets used in City Data analysis.
-
-## Installation
-
-Add `gla-data` as a PyPI dependency in your `pixi.toml`:
-
-```toml
-[pypi-dependencies]
-gla-data = ">=0.1"
-```
-
-Then run `pixi install`. Pixi pulls geospatial dependencies (geopandas, pyproj, etc.) from conda-forge, which provides reliable pre-built binaries across all platforms and Python versions.
-
-## Development
-
-```bash
-git clone <repo-url>
-cd gla-data
-pixi install
-
-pixi run test       # run tests
-pixi run lint       # check code style
-pixi run format     # auto-format
-pixi run typecheck  # type checking
-```

gla_data-0.1.0/README.md

@@ -1,27 +0,0 @@
-# gla-data
-
-Shared tools for loading, transforming, and visualising the GLA datasets used in City Data analysis.
-
-## Installation
-
-Add `gla-data` as a PyPI dependency in your `pixi.toml`:
-
-```toml
-[pypi-dependencies]
-gla-data = ">=0.1"
-```
-
-Then run `pixi install`. Pixi pulls geospatial dependencies (geopandas, pyproj, etc.) from conda-forge, which provides reliable pre-built binaries across all platforms and Python versions.
-
-## Development
-
-```bash
-git clone <repo-url>
-cd gla-data
-pixi install
-
-pixi run test       # run tests
-pixi run lint       # check code style
-pixi run format     # auto-format
-pixi run typecheck  # type checking
-```

gla_data-0.1.0/tests/test_placeholder.py

@@ -1,6 +0,0 @@
-# Replace this file with real tests as you add functions to the package.
-import gla_data
-
-
-def test_package_importable():
-    assert gla_data.__version__ is not None

{gla_data-0.1.0 → gla_data-0.1.2}/src/gla_data/__init__.py

@@ -8,9 +8,9 @@ from gla_data.transforms import aggregate, crosswalk
 __version__ = version("gla-data")
 __all__ = [
     "load_boundaries",
-    "crosswalk",
-    "aggregate",
     "load_geography_lookup",
     "load_census_dwellings",
+    "crosswalk",
+    "aggregate",
     "catalogue",
 ]