NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #2422 most downloaded on PyPI
US state metadata
Latest stable
4.0.0
Last release 1 months ago
29 Sep 2026
Release timing varies
gaps range from 8 days to 3.1 years
Nearly every release is documented
notes for 17 of 18 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
18 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
Add counties by @rkiddy in https://github.com/unitedstates/python-us/pull/89
Full Changelog: https://github.com/unitedstates/python-us/compare/3.2.0...v4.0.0
ASSOCIATED_STATES list with entries for Marshall Islands, Federated States of Micronesia, and Palau, plus a new is_associated attribute on Stateclean_name() method and fallback_func parameter to lookup() to provide customizable matching, thanks to Max Filenko and Charlie TonneslanSTATES_AND_TERRITORIES, thanks to Kavi Guptaus.states.enumeration() for dynamic Enum construction from State attributesus.__version__ and deprecate us.versionpy.typed location, thanks to johnw-bluemarkstates CLI when printing counties, thanks to Arpit JainYour coding agent can read these notes before it upgrades. Set up the MCP server →
Drop support for Python 3.6 and 3.7
Thanks to @pauldhawk, @dgilmanAIDENTIFIED, @BR0kEN-, and @pedrocamargo.
* add support for Python 3.11 * upgrade to jellyfish 0.11.2
restore DC in lookup and mapping
restore DC in lookup and mapping
fix Python 2.7 tests that ran with Python 3
add support for Python 3.7 and 3.8
* full Python 3.6 support * use pytest
Nothing published for this version
add information on whether a state is contiguous and/or continental, thanks to chebee7i
add obsolete territories, thanks to Ben Chartoff
upgrade to jellyfish 0.5.1 to fix metaphone case bug
add time zones, thanks to Paul Tagliamonte
add AP-style state abbreviations
fix state abbreviation for Nebraska
* add state capitals * add years of statehood
add mapping method to generate dicts of arbitrary fields
add command line script for quick access to state data
shapefile URLs for various regions
lookup() methodOne column per quarter.