Release 3.0.0

3.0.0 - 2025-09-26

Compare with 2.0.0

Added

• Add test.yml GitHub workflow. (633071d by Ramiro Gómez).
• Add pyproject.toml. (9a11a11 by Ramiro Gómez).
• Add mypy check to test task. (804ad02 by Ramiro Gómez).
• add typing overloads for geonamescache.mappers.country (d0cc123 by jicruz96).
• add type hints (854a4d6 by jicruz96).
• Adding brackets for readability (0b51b61 by Chris Pigden).
• Add JSON data to git (2ebb5b9 by Ramiro Gómez).
• Add markdown PyPI support (fbdc8af by Ramiro Gómez).
• Add base and dev requirements Upgrade dependencies Replace assertEquals with assertEqual (38ef8f8 by Ramiro Gómez).
• Adding the functionality to do case insensitive search in the search_cities function. If using python3 the function used during comparison will be casefold. In python2 the function used during comparison will be lower. (27370a5 by Chris Pigden).
• Add github funding info (4c434c6 by Ramiro Gómez).
• Adds admin1code to cities.json (9061cbb by Matt Webb).
• Add funding (0aea364 by Ramiro Gómez).
• Add entry to country name mapping (67c20bf by Ramiro Gómez).
• Add documentation for country mapper (65e041b by Ramiro Gómez).
• Add records to mappings, add mapper tests (fc054db by Ramiro Gómez).
• added python 3.5 to travis (d7b1eb9 by Ramiro Gómez).
• added python 3.5 to supported versions (62471d4 by Ramiro Gómez).
• added makefile tasks and version bump (b515713 by Ramiro Gómez).
• Adds travis file to the develop branch so that Travis CI doesn't flip out and do crazy things. (55f15b0 by Michael Lissner).
• Adds a new dependency that wasn't listed before. (c4ee9f7 by Michael Lissner).
• added country name mappings (02a695a by Ramiro Gómez).
• added 2 country name mappings (f858f96 by Ramiro Gómez).
• added new method to readme (c84bed1 by Ramiro Gómez).
• added mappings and tests for mappings (bc14b0e by Ramiro Gómez).
• added landscape config: ignore docs dir (b0deb19 by Ramiro Gómez).
• added pandas as dev req (6168781 by Ramiro Gómez).
• added countries as CSV (7d97e5a by Ramiro Gómez).
• added fips to us states data (9b2c87a by Ramiro Gómez).
• added travis and pypi badges (8d945c0 by Ramiro Gómez).
• added travis config (594f09d by Ramiro Gómez).
• added pypi command to fab (0583b3c by Ramiro Gómez).
• added fips code to countries (2880d63 by Ramiro Gomez).
• added more country data and moved it to json file, load country data from json file in module (1cbbf5d by Ramiro Gomez).
• added doc (c6e4a60 by Ramiro Gomez).
• added get_us_states_by_names method (8cd8ca4 by Ramiro Gomez).
• Added cities greater than 15k (56aa267 by Ramiro Gomez).
• added get_countries_by_names and TODOs (e498269 by Ramiro Gomez).
• added MANIFEST (eb00373 by Ramiro Gomez).
• add scripts (03f271d by Ramiro Gomez).

Fixed

• Fix paths and linting errors (1f5a93e by Ramiro Gómez).
• Fix #43: Remove JSON data from git. Add hatch_build.py to temprarily remove "geonamescache/data" from .gitignore so data is included when package is installed using pip. (2a3da25 by Ramiro Gómez).
• Fix issue #1: Download US states data with Python and save as JSON. (277439c by Ramiro Gómez).
• Fix linting issues: use absolute imports, sys.exit and dict comprehensions. (b30e161 by Ramiro Gómez).
• fix mypy errors by loosening type restrictions of helper functions (01e8341 by jicruz96).
• Fix event name (3a17926 by Ramiro Gómez).
• fix test_data.py function name (f763f96 by Mikhael Gaster).
• Fix importib files is only support 3.9 so revert (81b9aab by Benny Elgazar).
• Fix #32: Document min_city_population (39525e7 by Ramiro Gómez).
• Fix issue #23: Convert README from restructured text to markdown (5b4a49f by Ramiro Gómez).
• Fix issue #28: Remove check for casefold (0bfe583 by Ramiro Gómez).
• Fix typo (00e9edc by Ramiro Gómez).
• Fix issue #12: use io.open in setup.py to set encoding explicitly. (c65fc89 by Ramiro Gómez).
• Fix issue 12: use io.open in setup.py to set encoding explicitly. (122a780 by Ramiro Gómez).
• fix travis (d914c1e by Ramiro Gómez).
• Fixes #8 by adding type conversions to the cities script. Regenerates cities.json with the new data. (0638b0e by Michael Lissner).
• Fixes #9 by nuking the requirements.txt file in the dev branch and replacing it with the dev_requirements.txt file. (8aff055 by Michael Lissner).
• fixed rst (f93e126 by Ramiro Gómez).
• fix rst (d41e75e by Ramiro Gómez).
• fix #2: added mappings module with country name mappings (fcc662a by Ramiro Gómez).
• fixed...

Release 2.0.0

• More consistent behavior of 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.
• Update geo data.

Release 1.6.0

• Update GeoNames data
• Fix data test name, contributed by @m-gaster

Release 1.5.0

• Use os module and open function in _load_data instead of importlib.resources for compatibilty with Python 3.8, implemented by Benny Elgazar @Bennyelg

Release 1.4.0

• Include 4 different sized city datasets, that can be accessed via the new min_city_population parameter when creating a GeonamesCache class object.

Release 1.3.0

• Add case_sensitive parameter in the search_cities function and the functionality to do case insensitive search implemented by Chris Pigden @pigden
• Update geo data
• Upgrade dependencies
• Only support currently supported Python version 3.7, 3.8, 3.9, i.e. no more Python 2.7 support

Release 1.2.0

• Add alternatenames attribute to entries in cities.json with a list of alternate city names.
• Add search_cities function which returns a list of entries that include the query in given attribute.

Release 1.1.0

Adds admin1code to cities.json. Thanks to Matt Webb (@genmon) for adding this feature.