indian-names (v0.2)

Python module to generate random names of Indian origin.

Installation

You can install it using pip from the repository as:

pip install indian-names

Usage

Indian-names can be used as a command line utility or imported as a Python module.

Command Line Usage

To use the script from the command line:

    $ indian-names
    Anand Dubey

Python Module Usage

Here are examples of all current features:

    >>> import indian_names
    >>> indian_names.get_full_name()
    'Nisha Asthana'
    >>> indian_names.get_full_name(gender='male')
    'Manish Gupta'
    >>> indian_names.get_first_name()
    'Siddhant'
    >>> indian_names.get_first_name(gender='female')
    'Kajal'
    >>> indian_names.get_last_name()
    'Tripathi'

The module can currently generate 550+ first names for male and female each, and 350+ last names. Overall 400,000+ full names can be generated.

TODO (Future):

• Increase the number of names possible.
• Implement first/last name pairs for regional names as well. Emphasis on handling first names that are compatible with only certain last names & vice-versa.

License

This project is released under a BSD 3-Clause License.

Names are compiled in the following files through various online sources available publically:

• first.male.names
• first.female.names
• last.names