{"id":13826006,"url":"https://github.com/armanyazdi/persian-names","last_synced_at":"2025-07-08T22:33:06.880Z","repository":{"id":63254172,"uuid":"566428053","full_name":"armanyazdi/persian-names","owner":"armanyazdi","description":"A Python package for generating random Persian (Farsi) names.","archived":false,"fork":false,"pushed_at":"2024-08-21T09:15:35.000Z","size":65,"stargazers_count":17,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-14T10:49:58.752Z","etag":null,"topics":["farsi","iranian","name-generation","name-generator","persian","pypi","pypi-package","pypi-packages","python","python-library","python3"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/persian-names","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/armanyazdi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-15T16:47:15.000Z","updated_at":"2025-04-24T21:20:13.000Z","dependencies_parsed_at":"2024-01-15T15:47:50.016Z","dependency_job_id":"edd27703-8d43-42b0-a41e-37f3e2251ebb","html_url":"https://github.com/armanyazdi/persian-names","commit_stats":{"total_commits":100,"total_committers":2,"mean_commits":50.0,"dds":"0.050000000000000044","last_synced_commit":"c6794aebff7fb0970c9d3e833a4e88bd9cd17138"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/armanyazdi/persian-names","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armanyazdi%2Fpersian-names","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armanyazdi%2Fpersian-names/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armanyazdi%2Fpersian-names/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armanyazdi%2Fpersian-names/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/armanyazdi","download_url":"https://codeload.github.com/armanyazdi/persian-names/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armanyazdi%2Fpersian-names/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264360314,"owners_count":23596104,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["farsi","iranian","name-generation","name-generator","persian","pypi","pypi-package","pypi-packages","python","python-library","python3"],"created_at":"2024-08-04T09:01:30.675Z","updated_at":"2025-07-08T22:33:06.605Z","avatar_url":"https://github.com/armanyazdi.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# persian-names\n\n[![PyPI](https://img.shields.io/pypi/v/persian-names?style=for-the-badge)](https://pypi.org/project/persian-names)\n[![GitHub](https://img.shields.io/github/license/armanyazdi/persian-names?style=for-the-badge)](https://pypi.org/project/persian-names)\n\nA Python package for generating random Persian (Farsi) names.\n\nThis package generates frequently logical names \n(a mix of popular Persian and Arabic names with common Persian family name suffixes).\n\nNote: `persian-names` generates **90,000,000** unique full names (As Iran population in 2024) in less than 3 minutes.\n\n## Installation\n\nInstall from [PyPI](https://pypi.org/project/persian-names) with pip by typing in your favorite terminal:\n\n`pip install persian-names`\n\n## Usage\n\nLet's take a look at what an example test case would look like using `persian-names`.\n\n### Generate Persian Full Names in Farsi:\n\n```python\nfrom persian_names import fullname_fa\n\nfullname_fa('male')   # or fullname_fa('m')\nfullname_fa('female') # or fullname_fa('f')\nfullname_fa('random') # or fullname_fa('r')\n```\n\n#### Example:\n\n```python\nfrom persian_names import fullname_fa\n\nprint(fullname_fa('m')) # اشکان محمدرضائیان\nprint(fullname_fa('f')) # مهسا امیری تهرانی\nprint(fullname_fa('r')) # بیتا خسروی راد\n```\n\n### Generate Persian Full Names in English:\n\n```python\nfrom persian_names import fullname_en\n\nfullname_en('male')   # or fullname_en('m')\nfullname_en('female') # or fullname_en('f')\nfullname_en('random') # or fullname_en('r')\n```\n\n#### Example:\n\n```python\nfrom persian_names import fullname_en\n\nprint(fullname_en('m')) # Arsalan Mohammadi\nprint(fullname_en('f')) # Sara Alipour\nprint(fullname_en('r')) # Danial Ferdosi Khorasani\n```\n\n### Generate First Names and Last Names in Farsi:\n\n```python\nfrom persian_names import *\n\n# First Name\nfirstname_fa('male')   # or firstname_fa('m')\nfirstname_fa('female') # or firstname_fa('f')\nfirstname_fa('random') # or firstname_fa('r')\n\n# Last Name\nlastname_fa()\n```\n\n#### Example:\n\n```python\nfrom persian_names import *\n\nprint(firstname_fa('m')) # آرمان\nprint(firstname_fa('f')) # ساحل\nprint(firstname_fa('r')) # علیرضا\nprint(lastname_fa())     # شیخ اسماعیلی\n```\n\n### Generate First Names and Last Names in English:\n\n```python\nfrom persian_names import *\n\n# First Name\nfirstname_en('male')   # or firstname_en('m')\nfirstname_en('female') # or firstname_en('f')\nfirstname_en('random') # or firstname_en('r')\n\n# Last Name\nlastname_en()\n```\n\n#### Example:\n\n```python\nfrom persian_names import *\n\nprint(firstname_en('m')) # Mehrad\nprint(firstname_en('f')) # Darya\nprint(firstname_en('r')) # Baran\nprint(lastname_en())     # Bakhtiarizadeh\n```\n\n## Issues\n\nFeel free to submit issues and enhancement requests.\n\n## Contributing\n\nFeel free to contribute names database with your kindly pull requests.\n\n## License\n\n`persian-names` is available under the [MIT license](https://github.com/armanyazdi/persian-names/blob/main/LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farmanyazdi%2Fpersian-names","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farmanyazdi%2Fpersian-names","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farmanyazdi%2Fpersian-names/lists"}