NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #4301 most downloaded on PyPI
Geonames data for continents, cities and US states.
Last release 2 months ago
28 Jul 2026
Release timing varies
gaps range from 2 weeks to 2.2 years
Some releases are documented
notes for 13 of 29 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
29 releases · first in 2012
Improve country mapping by adding missing and updating outdated country aliases. See issue https://github.com/yaph/geonamescache/issues/47 reported by
Improve country mapping by adding missing and updating outdated country aliases. See issue https://github.com/yaph/geonamescache/issues/47 reported by @ihor-voronin.
fix: use stdlib typing on Python 3.11+ to avoid deadlock on Python 3.13 (7eb1637 by rotem dafni).
<small>Compare with 3.0.0</small>
One column per quarter.
Add test.yml GitHub workflow. (633071d by Ramiro Gómez).
<small>Compare with 2.0.0</small>
More consistent behavior of search_cities function. By default the attribute value is search for partial matches and search is performed case insensit
search_cities function. By default the attribute value is search for partial matches and search is performed case insensitive. This is different from the previous behavior, where list values were treated differently from string values and search was case sensitive by default. See issue 38. The new behavior was implemented by Chris Pigden @pigden.Fix data test name, contributed by @m-gaster
Use os module and open function in _load_data instead of importlib.resources for compatibilty with Python 3.8, implemented by Benny Elgazar @Bennyelg
os module and open function in _load_data instead of importlib.resources for compatibilty with Python 3.8, implemented by Benny Elgazar @Bennyelg<small>Compare with 1.4.0</small>
Include 4 different sized city datasets, that can be accessed via the new min_city_population parameter when creating a GeonamesCache class object.
min_city_population parameter when creating a GeonamesCache class object.<small>Compare with 1.3.0</small>
Add case_sensitive parameter in the search_cities function and the functionality to do case insensitive search implemented by Chris Pigden @pigden
<small>Compare with 1.2.0</small>
Add alternatenames attribute to entries in cities.json with a list of alternate city names.
alternatenames attribute to entries in cities.json with a list of alternate city names.search_cities function which returns a list of entries that include the query in given attribute.Adds admin1code to cities.json. Thanks to Matt Webb (@genmon) for adding this feature.
Adds admin1code to cities.json. Thanks to Matt Webb (@genmon) for adding this feature.
<small>Compare with 1.0.3</small>
Compare with 1.0.2
<small>Compare with 1.0.2</small>
Add entry to country name mapping (297fe31 by Ramiro Gómez).
<small>Compare with 1.0.1</small>
added python 3.5 to travis (1fc98d4 by Ramiro Gómez).
<small>Compare with first commit</small>
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →