NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #2871 most downloaded on PyPI
US state metadata
Last release 5 days 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
move py.typed to correct location by @johnw-bluemark in #88
Full Changelog: 3.2.0...v4.0.0
One column per quarter.
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 JainDrop 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() methodYour coding agent can read these notes before it upgrades. Set up the MCP server →