persian-names 1.5.1

Description:

persiannames 1.5.1

persian-names


A Python package for generating random Persian (Farsi) names.
This package generates frequently logical names
(a mix of popular Persian and Arabic names with common Persian family name suffixes).
Note: persian-names generates 90,000,000 unique full names (As Iran population in 2024) in less than 3 minutes.
Installation
Install from PyPI with pip by typing in your favorite terminal:
pip install persian-names
Usage
Let's take a look at what an example test case would look like using persian-names.
Generate Persian Full Names in Farsi:
from persian_names import fullname_fa

fullname_fa('male') # or fullname_fa('m')
fullname_fa('female') # or fullname_fa('f')
fullname_fa('random') # or fullname_fa('r')

Example:
from persian_names import fullname_fa

print(fullname_fa('m')) # اشکان محمدرضائیان
print(fullname_fa('f')) # مهسا امیری تهرانی
print(fullname_fa('r')) # بیتا خسروی راد

Generate Persian Full Names in English:
from persian_names import fullname_en

fullname_en('male') # or fullname_en('m')
fullname_en('female') # or fullname_en('f')
fullname_en('random') # or fullname_en('r')

Example:
from persian_names import fullname_en

print(fullname_en('m')) # Arsalan Mohammadi
print(fullname_en('f')) # Sara Alipour
print(fullname_en('r')) # Danial Ferdosi Khorasani

Generate First Names and Last Names in Farsi:
from persian_names import *

# First Name
firstname_fa('male') # or firstname_fa('m')
firstname_fa('female') # or firstname_fa('f')
firstname_fa('random') # or firstname_fa('r')

# Last Name
lastname_fa()

Example:
from persian_names import *

print(firstname_fa('m')) # آرمان
print(firstname_fa('f')) # ساحل
print(firstname_fa('r')) # علیرضا
print(lastname_fa()) # شیخ اسماعیلی

Generate First Names and Last Names in English:
from persian_names import *

# First Name
firstname_en('male') # or firstname_en('m')
firstname_en('female') # or firstname_en('f')
firstname_en('random') # or firstname_en('r')

# Last Name
lastname_en()

Example:
from persian_names import *

print(firstname_en('m')) # Mehrad
print(firstname_en('f')) # Darya
print(firstname_en('r')) # Baran
print(lastname_en()) # Bakhtiarizadeh

Issues
Feel free to submit issues and enhancement requests.
Contributing
Feel free to contribute names database with your kindly pull requests.
License
persian-names is available under the MIT license.