owgee/niafaker

NiaFaker is a Python package that generates fake data localized for African regions # NiaFaker Fake data generator localized for African regions. Names, phone numbers, mobile money, national IDs, and more — culturally accurate for 10 African economies. ## Install ```bash pip install niafaker ``` ## Usage ```python from niafaker import NiaFaker fake = NiaFaker("tz") # Tanzania fake.name() # "Baraka Kimaro" fake.name(gender="f") # "Amina Mwakasege" fake.phone() # "+255754832109" fake.mobile_money() # {"provider": "M-Pesa", "number": "+255754832109"} 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): ```python 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 ```python 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