Skip to content

Release 2.2.0

Latest
Latest

Choose a tag to compare

View all tags
@neosergio neosergio released this 13 Oct 08:44
v2.2.0
3e61dc4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

What's new

  • Addresses near a point: near= and within_km= filters on real_random_address(), real_random_addresses() and count(). near takes a (lat, lng) pair or an address from an earlier call.
  • Groups of nearby addresses: real_random_cluster(count, within_km=...) returns addresses that lie close together, with no centre to pick.
  • Nine new states: IL, ID, LA, IN, OH, PA, SC, NM and MN, bringing the dataset to 3,850 addresses across 29 states. Every source was checked against the publisher's own license terms, so every address is still public domain.
  • CLI: new random-address count and random-address cluster commands, plus --near LAT,LNG and --within-km KM options.
  • Friendlier inputs: a postal code can be passed as an int (6040 finds 06040), and extra spaces in a city name are ignored.
  • Coverage page: COVERAGE.md lists what the dataset holds, state by state. It is generated from the data and checked in CI.
  • Python 3.15 is supported.

Compatibility

  • Everything from 2.1.1 keeps working unchanged.
  • Python 3.11 is now the minimum. Python 3.10 reached end of life on 2026-10-01. Nothing breaks for anyone still on it: pip keeps installing 2.1.1 on Python 3.10, and 1.3.0 on 3.9 or older.

Installation

pip install --upgrade random-address

See the CHANGELOG for the full list of changes.

Assets 2
Loading