Registry / data / random-address

random-address

JSON →
library1.3.0pypypi✓ verified 82d ago

A Python library for generating real random addresses that geocode successfully. It scrapes addresses from online sources and validates them via geocoding. Version 1.3.0 (last released) supports Python >=3.6.

data
pip install random-address
github ↗package ↗changelog ↗
INSTALL
IMPORT
SIG · RANDOM-ADDRESS
R
random-address
datapythonv1.3.0
Install
1.6s avg
Import
—
Disk
16MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v1.3.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 18.3MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 1.6s · import 0.000s · 19MB
16MB installed
● package 16MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

random_address
✓ from random_address import random_address
✗ from random_address import RandomAddress
real_random_address
✓ from random_address import real_random_address
list_available_states
✓ from random_address import list_available_states

Generate a random address.

from random_address import RandomAddress ra = RandomAddress() address = ra.random_address() print(address)
Debug
Known issues
gotchaThe library relies on scraping a third-party website. If the site changes its HTML structure or blocks requests, the library may break without warning.
fix
Use with caution; consider caching results or maintaining a fallback.
affects: all
gotchaThe random_address() method may raise an exception if the scraping fails or no valid address is found. Not all calls succeed.
fix
Wrap calls in try/except to handle failures gracefully.
affects: all
deprecatedThe library has not been updated since 2021. It may have compatibility issues with newer Python versions beyond 3.11.
fix
Pin Python version to <=3.11 if issues arise, or consider alternative libraries.
affects: >=1.3.0
Upgrade
Version history
1.3.0latest on PyPI · released Apr 7, 2025
Audit
Dependencies
requestsrequiredHTTP requests to fetch addresses
Agent activity
15 hits · last 30 days
node
12
Bingbot
1
Resources
githubhttps://github.com/neosergio/random-address ↗
packagehttps://pypi.org/project/random-address/ ↗
changeloghttps://github.com/neosergio/random-address/blob/main/CHANGELOG.md ↗
random-address — pip install random-address · libregistry