Metadata-Version: 2.4
Name: ghNum
Version: 1.1.3
Summary: Professional Persian text to number converter
Author-email: Ghasem Jahed <ghasem.jahed2008@gmail.com>
License: MIT
Description-Content-Type: text/markdown

معرفی کتابخانه ghNum

این کتابخانه یک ابزار تخصصی برای تبدیل کلمات و اعداد حروفی فارسی به معادل عددی (ریاضی) در زبان پایتون است. من این پروژه را برای ساده‌سازی فرآیند پردازش متن در اپلیکیشن‌های فارسی‌زبان توسعه داده‌ام.
🌟 قابلیت‌های برجسته

 پشتیبانی از اعداد بسیار بزرگ: تبدیل کلمات از یکان تا مقیاس‌های عظیمی مثل تریلیون و کوادریلیون.

 هوشمندی در اعداد ترتیبی: تشخیص و تبدیل خودکار کلماتی که به پسوندهای «م»، «ام»، «مین» و «امین» ختم می‌شوند (مثلاً: دویست و پنجاهم -> 2000050).

 جداکننده هزارگان (Thousand Separator): قابلیت نمایش خروجی به صورت دسته‌بندی شده با کاما (مثلاً: 1،250،000) برای خوانایی بهتر.

 خروجی چندزبانه: امکان دریافت ارقام در سه حالت انگلیسی (123)، فارسی (۱۲۳) و عربی (١٢٣).

 نرمال‌سازی خودکار متن: مدیریت هوشمند حروف «ی» و «ک» (عربی/فارسی) و حذف نیم‌فاصله‌ها و کاراکترهای مزاحم.

 پردازش لیستی: متدی اختصاصی برای تبدیل همزمان مجموعه‌ای از متون به لیست اعداد.

🛠 پارامترهای اصلی متد convert

برای استفاده حداکثری از قابلیت‌ها، پارامترهای زیر در اختیار شماست:
پارامتر	توضیحات
text	متن ورودی شما به زبان فارسی.
lang	تعیین زبان ارقام خروجی (en برای انگلیسی، fa برای فارسی، ar برای عربی).
thousand_separator	اگر True باشد، عدد را با ویرگول (کاما) جدا می‌کند.
💻 مثال‌های کاربردی

تبدیل پایه (خروجی Integer)
p2n.convert("هزار و سیصد و هشتاد و پنج")
# خروجی: 1385

تبدیل اعداد ترتیبی (Ordinal)
p2n.convert("دو میلیون و پنجاهم")
# خروجی: 2000050

خروجی فرمت‌دهی شده (فارسی + جداکننده)
p2n.convert("هفت میلیارد و دویست میلیون"، lang='fa'، thousand_separator=True)
# خروجی: "۷،۲۰۰،۰۰۰،۰۰۰"

تبدیل لیستی (Batch)
p2n.convert_list(["ده"، "بیست"، "سی"])
# خروجی: [10، 20، 30]
