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