mnk-persian-words 1.0.2

Creates REALLY random Persian words

PersianWords

Version: 1.0.1
License: MIT
Author: Masoud Najafzadeh Kalat
Email: [e-mail]
GitHub: https://github.com/masoudnk/PersianWordsLib

---

DOWNLOAD LATEST VERSION FROM GITHUB!👈

📝 Summary

PersianWords is a Python library that provides random words and paragraphs in the Persian language.
The internal word list is extensive and includes various types, forms, and orthographic variants (including diacritics).

This library currently contains over 600,000 unique Persian words, making it ideal for:

• UI/UX text generation (like "Lorem Ipsum" for Persian)
• Educational apps and games
• NLP model testing
• Language research and simulations

---

📦 Installation

Coming soon to PyPI...

For now, you can install directly from source:

git clone https://github.com/masoudnk/PersianWordsLib.git
cd PersianWordsLib

---

🔧 Usage

Import the package and use the functions as follows:

from mnk_persian_words.persian_words import (
    get_random_persian_word,
    get_random_persian_paragraph
)

---

🧠 Functions

get_random_persian_word(words_count: int = 1) -> str

Returns a space-separated string of words_count randomly selected Persian words.

• Output contains no punctuation or trailing dots
• Maximum count: 600,000+

get_random_persian_word(3)
# Output: 'خانه گل زیبا'

---

get_random_persian_paragraph(words_count: int = 5, paragraphs: int = 1) -> str

Returns paragraphs paragraphs, each containing words_count words.

• Words in each paragraph are space-separated
• Each paragraph (except the last) ends with a line break (\n)
• No punctuation is included in the output

get_random_persian_paragraph(5, 2)
# Output:
# 'صبح روشن خانه امید درخت
# شب آرام رود ساکت طلوع'

---

🔗 Sources / Data References

This project uses publicly available Persian word lists from the following sources:

• https://github.com/shahind/Persian-Words-Database
• http://khodam.altervista.org/لیست-همه-کلمات-فارسی-مجموعه-کامل/

---

✅ Suitable for

• Random Persian content generation
• Educational applications
• Linguistic research
• UI/UX placeholder text
• Fun language experiments!

---

📌 License

This project is licensed under the MIT License. You are free to use, modify, and distribute with attribution.