random-address

1.3.0 verified Fri May 01 auth: no python

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.

pip install random-address

Common errors

error ModuleNotFoundError: No module named 'random_address' ↓

cause The package is installed but imported incorrectly (e.g., `import random_address` instead of `from random_address import RandomAddress`).

fix

Use: from random_address import RandomAddress

error AttributeError: module 'random_address' has no attribute 'RandomAddress' ↓

cause Importing the module without the correct submodule or class.

fix

Correct import: from random_address import RandomAddress

error requests.exceptions.ConnectionError: HTTPSConnectionPool ... ↓

cause The library fails to fetch data from the source website due to network issues or site changes.

fix

Check internet connection; the source may be temporarily unavailable.

Warnings

gotcha The 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.

gotcha The 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.

deprecated The 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.

Imports

RandomAddress
wrong
```
import random_address
```
correct
```
from random_address import RandomAddress
```
Importing the module directly doesn't give access to RandomAddress class.

Quickstart

Generate a random address.

from random_address import RandomAddress
ra = RandomAddress()
address = ra.random_address()
print(address)