https://github.com/engineervix/zambian-names

A collection of Zambian names
https://github.com/engineervix/zambian-names

Last synced: 12 months ago
JSON representation

A collection of Zambian names

• Host: GitHub
• URL: https://github.com/engineervix/zambian-names
• Owner: engineervix
• License: mit
• Created: 2020-05-19T02:29:41.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2025-02-02T22:42:00.000Z (about 1 year ago)
• Last Synced: 2025-02-02T23:23:57.254Z (about 1 year ago)
• Language: Python
• Size: 85 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Zambian Names

[![forthebadge](https://forthebadge.com/images/badges/made-with-python.svg)](https://forthebadge.com)

[![python3](https://img.shields.io/badge/python-3.6%20%7C%203.7-brightgreen.svg)](https://python3statement.org/#sections50-why) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![Requirements Status](https://requires.io/github/engineervix/zambian-names/requirements.svg?branch=master)](https://requires.io/github/engineervix/zambian-names/requirements/?branch=master)

## 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`](https://github.com/joke2k/)'s **Faker** by creating an [`en_ZM`](https://www.localeplanet.com/icu/en-ZM/index.html) locale so that _Faker_ can be used to generate Zambian specific data, such as names, addresses, etc.

When I did a quick [Google search](https://www.google.com/search?q=Zambian+Names) on May 19th, 2020, I found that [thezambian.com](https://thezambian.com/online/zambian-names/) 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`](./fetch_names.py) does exactly this. It uses [requests](https://github.com/psf/requests) and [BeautifulSoup](https://www.crummy.com/software/BeautifulSoup/) to achieve this. The fetched names are saved in the file [`zambian_names.md`](./zambian_names.md).

## Categorizing names by gender and first/last name

TODO

---