engineervix / zambian-names

A collection of Zambian names

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Zambian Names

forthebadge

python3 Code style: black Requirements Status

What is this about?

The purpose of this project is to have a comprehensive collection of Zambian names that can be used in a variety of contexts. The project was born as a result of seeking to contribute to joke2k's Faker by creating an en_ZM locale so that Faker can be used to generate Zambian specific data, such as names, addresses, etc.

When I did a quick Google search on May 19th, 2020, I found that thezambian.com had a more comprehensive list of names, which were arranged in alphabetical order. However, these names had no indication of

  1. whether they were first names or last names (or both)
  2. gender

I decided to create this project in an attempt to resolve the above two issues, which I perceive to be important factors in the Faker package.

First Step

The first thing to do is fetch the names from thezambian.com! The python script fetch_names.py does exactly this. It uses requests and BeautifulSoup to achieve this. The fetched names are saved in the file zambian_names.md.

Categorizing names by gender and first/last name

TODO


About

A collection of Zambian names

License:MIT License


Languages

Language:Python 100.0%