Skip to content

v3.0.0b2

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 12 Oct 01:37
e2912e2

Added

  • Country.continent, a Continent with name, geonames_code and geonames_id for the seven continents, from GeoNames, filterable with countries.filter(continent=...) by name or GeoNames code; None for a country GeoNames doesn't list. Continents are GeoNames enrichment, not an authoritative standard, and separate from macroregions (#25).
  • Each release's Data subsection: every data refresh it ships, dated, with each dataset's record counts and changed fields, linked to the records it renamed, added and removed in DATA_CHANGELOG.md, recorded back to 2026-10-04.

Changed

  • The installed package is about 40% smaller (about 32MB, from 53.6MB): every data file now ships gzipped. The data and the API are unchanged (#29).
  • Each data file starts with a header naming its columns after the fields its registry serves, and loading one built for another version raises ValueError with both column lists instead of misreading its rows.

Fixed

  • cities.search() ranks cities with the same score by population, largest first, so "Paris" returns Paris, France before Paris, Ontario, and a large city among many same-name places is never cut before it's scored. Reported by @SchubmannM in #8 (#26).
  • The ingest pipeline's cldr-json commit lookup authenticates with the workflow's token, so a scheduled or CI run no longer fails on the rate limit GitHub-hosted runners share (#27).
  • Subdivision skill decisions are rechecked on every ingest run instead of applying permanently: a merge whose GeoNames record was deleted or is named by another decision, or an add-as-is GeoNames now has a matching record for, goes back for review rather than shipping a duplicate or being replaced by an unreviewed fuzzy match, and a decision whose code ISO removed is retired with its history kept (#28).

Data

2026-10-11 23:52 UTC

Dataset Records Added Removed Changed Changed fields
Countries 281 → 281 0 0 252 continent (252)

2026-10-11 21:33 UTC

Dataset Records Added Removed Changed Changed fields
Subdivisions 51,711 → 51,710 1 2 409 name (335), aliases (323)
Cities 235,970 → 236,041 71 0 22 subdivisions (13), population (6), lat (3), lng (3), name (2)

Records renamed, added and removed