Metadata-Version: 2.4
Name: arprint
Version: 0.1.2
Summary: A library to print and input Arabic text correctly in terminal with color support
Home-page: https://github.com/cymoussa/arprint
Author: youcef
Author-email: youcef.dev0@gmail.com
Keywords: arabic,terminal,print,input,bidi,reshaper,cybersecurity,arprint
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: arabic-reshaper
Requires-Dist: python-bidi
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# arprint 📝

**arprint** هي مكتبة بايثون احترافية تهدف لحل مشكلة عرض وإدخال اللغة العربية في "الترمينال" (Terminal) والأنظمة التي لا تدعم النصوص من اليمين إلى اليسار (RTL) بشكل افتراضي، مثل Kali Linux و Termux.

تُعد هذه المكتبة أداة مثالية لمطوري أدوات الأمن السيبراني والسكربتات الذين يرغبون في بناء واجهات تفاعلية باللغة العربية.

---

## الميزات الجديدة في الإصدار 0.1.2 ✨

* **دعم الألوان:** طباعة النصوص العربية بألوان مختلفة لجعل الواجهة أكثر احترافية.
* **الإدخال العربي (arinput):** أول دالة تتيح استقبال مدخلات المستخدم باللغة العربية المنسقة.
* **دعم كلمة المرور (Secure Input):** ميزة إخفاء النصوص عند إدخال كلمات المرور، ضرورية جداً للأدوات الأمنية.
* **تصحيح الحروف والاتجاه:** معالجة كاملة للنصوص لتظهر من اليمين إلى اليسار (RTL) بشكل سليم.

---

## التثبيت (Installation) 📥

يمكنك تثبيت أو تحديث المكتبة بسهولة عبر `pip`:

```bash
pip install --upgrade arprint
أمثلة الاستخدام (Usage Examples) 🚀
​1. الطباعة العادية والملونة
from arprint import arprint

arprint("تجربة المكتبة")
arprint("تجرية اللون الأحمر", color='red')
arprint("تجربة اللون الأخضر", color='green')
2. استقبال مدخلات المستخدم (Arabic Input)
from arprint import arprint, arinput
name = arinput("ادخل اسمك:", color='cyan')

password = arinput("ادخل كلمة مرور: ", color='yellow', password=True)

arprint(f"أهلاً بك يا {name}، جاري البدء...", color='blue')
قائمة الألوان المدعومة 🎨
​يمكنك تمرير اسم اللون كمتغير color في الدوال:
​red (أحمر)
​green (أخضر)
​yellow (أصفر)
​blue (أزرق)
​magenta (أرجواني)
​cyan (سماوي)
​white (أبيض)
​التواصل 📩
​للمساهمة في تطوير المكتبة أو الإبلاغ عن مشاكل، يمكنك التواصل مع المطور عبر تلغرام:
@cymoussa

تم التطوير بواسطة يوسف موسى طالب المدرسة العليا للأمن السيبراني
