niafaker 1.0.0

Fake data generator localized for African regions — names, phones, addresses, mobile money, national IDs, and more.

NiaFaker

Fake data generator localized for African regions. Names, phone numbers, mobile money, national IDs, and more — culturally accurate for 10 African economies.

Install

pip install niafaker

Usage

from niafaker import NiaFaker

fake = NiaFaker("tz")  # Tanzania

fake.name()            # "Baraka Kimaro"
fake.name(gender="f")  # "Amina Mwakasege"
fake.phone()           # "[phone]"
fake.mobile_money()    # {"provider": "M-Pesa", "number": "[phone]"}
fake.national_id()     # "19901234-12345-00001-01"
fake.company()         # "Bakhresa Holdings"
fake.amount()          # "TSh 425,000"
fake.address()         # "1234 Samora Avenue, Dodoma, Dodoma"

For reproducible output (useful in tests):

fake = NiaFaker("ke", seed=42)
fake.name()  # same result every time

Supported Countries

tz Tanzania · ke Kenya · ng Nigeria · za South Africa · gh Ghana · ug Uganda · rw Rwanda · et Ethiopia · eg Egypt · ma Morocco

NiaFaker.locales()  # {'tz': 'Tanzania', 'ke': 'Kenya', ...}

What You Can Generate

Person — name(), first_name(), last_name(), email() Phone — phone(), phone(carrier="Safaricom") Address — city(), region(), address(), country() Company — company(), registration_number() Mobile Money — mobile_money(), transaction_id() National ID — national_id() Currency — amount()

Contributing

See CONTRIBUTING.md. Adding a new country is just 7 JSON files and one line in the config.

License

MIT — Owden Godson