A Python package for generating random Persian (Farsi) names.
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for persian_names-1.5.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 412202569e0e99046e312612aaa8055d925c5270ba196a4688f4027b1c12f0aa |
|
MD5 | 9a27b84a03a5a2799687d6a3678b57e1 |
|
BLAKE2b-256 | e72eed2630cf772a2ff663dd2271221e35082826414525a4609c3bff3d6377bf |