Skip to main content

Generate random first and last names in Hebrew

Project description

hebrew_names

Random Hebrew name generator

Installation

The script is available on PyPI. To install with pip:

pip install hebrew-names

Usage

Hebrew Names can be used as a command line utility or imported as a Python package.

Command Line Usage

To use the script from the command line:

$ hebrew_names
צבי כהן

Python Package Usage

Here are examples of all current features:

>>> import hebrew_names
>>> hebrew_names.get_first_name('jew', 'female')
'יעל'
>>> hebrew_names.get_first_name('jew', 'female')
'תמר'
>>> hebrew_names.get_first_name('jew', 'male')
'אהרון'
>>> hebrew_names.get_first_name()
'מקסים'
>>> hebrew_names.get_first_name()
'נור'
>>> hebrew_names.get_first_name('muslim', 'male')
"מג'די"
>>> hebrew_names.get_first_name('muslim', 'male')
'מוחמד'
>>> hebrew_names.get_first_name('christian', 'male')
"'ג'ורג'"
>>> hebrew_names.get_first_name('druze', 'male')
'ריאן'
>>> hebrew_names.get_first_name('other', 'male')
'אנטוני'
>>> hebrew_names.get_last_name('jew')
'גלברד'
>>> hebrew_names.get_full_name('muslim', 'female')
'אמירה איוב'

License

This project is released under an MIT License.

Data in the following files are public domain (derived from Israel’s Central Bureau of Statistics 1948-2021 data):

  • dist.jew.male.first

  • dist.jew.female.first

  • dist.jew.last

  • dist.muslim.male.first

  • dist.muslim.female.first

  • dist.muslim.last

  • dist.christian.male.first

  • dist.christian.female.first

  • dist.christian.last

  • dist.druze.male.first

  • dist.druze.female.first

  • dist.druze.last

  • dist.other.male.first

  • dist.other.female.first

  • dist.other.last

Changes

tip (unreleased)

  • Add Hebrew dataset for last names

  • Add Hebrew dataset for first names

  • Modified names.get_first_name to only accept ‘male’ and ‘female’ gender values

0.3.0 (2013-05-14)

  • Fixed Python 3 support

  • Improved tests and fixed minor bugs

0.2 (2013-02-17)

  • Initial release

Contributing

Please file bugs to the Github issue tracker. Pull requests are welcome.

Hacking and Pull Requests

Please try to conform to PEP8 for code contributions and ensure that the tests continue to function.

Please include new tests with your pull requests when appropriate.

Feel free to open pull requests before you’ve finished your code or tests. Opening your pull request sooner will allow others to comment on it sooner.

A checklist of things to remember when making a feature:

  • Write tests if applicable

  • Note important changes in the CHANGES file

  • Update the README file if needed

  • Update the documentation if needed

  • Add yourself to the AUTHORS file

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hebrew-names-0.0.1.tar.gz (587.7 kB view hashes)

Uploaded Source

Built Distribution

hebrew_names-0.0.1-py3-none-any.whl (597.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page