import time as t
import random as r
import string as s
صحيح = True
خطأ = False
مجهول = None
حروف_عربية = [
    'ا','ب','ت','ث','ج','ح','خ','د','ذ','ر','ز',
    'س','ش','ص','ض','ط','ظ','ع','غ','ف','ق','ك',
    'ل','م','ن','ه','و','ي'
]
رمز = s.punctuation
مسافة_واسعة = s.whitespace
ارقام = s.digits
هكس = s.hexdigits
كل_المكتوبات = s.printable
حروف_كبيرة= s.ascii_uppercase
حروف_صغيرة = s.ascii_lowercase
class ArabicList():
    def __init__(self):
        self.list = []
    def ضف(self, item):
        self.list.append(item)
    def حذف(self, item):
        self.list.remove(item)
    def عرض(self):
        print(self.list)
###################################
def اطبع(p):
    return print(p)
def ادخل(d):
    return input(d)
def عد(leen):
    return len(leen)
def عشري(رقم):
    return float(رقم)
def رقم_صحيح(رقم):
    return int(رقم)
def متغير_قائمة(قائمة):
    return list(قائمة)
def نص(قائمة):
    return str(قائمة)
def توقف(ثانية):
    t.sleep(ثانية)
def عدد_عشوائي(a,b):
    return r.randint(a,b)
def اختيار_عشوائي(a):
    return r.choice(a)

def اختيارات_عشوائية(القائمة, عدد):
    عدد = int(عدد)                   # تحويل العدد إلى int
    return r.choices(القائمة, k=عدد) # اختيار عدد عناصر عشوائية
def عشري_عشوائي(a, b):
    return r.uniform(a, b)

def ترتيب_عشوائي(قائمة):
    r.shuffle(قائمة)
    return قائمة 
#مساعدات
def ساعدني():
    return print( """
📘 Arabic Utility Library — Documentation

هذه المكتبة تضيف دوال وأصناف بواجهات عربية لتسهيل استخدام بايثون للمبتدئين أو للمشاريع ذات الطابع العربي.
جميع الدوال تعتمد على مكتبات Python القياسية مثل time, random, و string.

🔹 الثوابت الأساسية
صحيح = True
خطأ = False
مجهول = None


بدائل عربية لقيم بايثون المنطقية:

صحيح = True

خطأ = False

مجهول = None

🔹 الحروف الإنجليزية
حروف_كبيرة = s.ascii_uppercase
حروف_صغيرة = s.ascii_lowercase


حروف_كبيرة: جميع الحروف الإنجليزية الكبيرة (A–Z).

حروف_صغيرة: جميع الحروف الإنجليزية الصغيرة (a–z).

🧱 ArabicList — قائمة عربية

صنف بسيط يوفر طرقًا عربية للتعامل مع القوائم.

إنشاء قائمة
l = ArabicList()

الخصائص والوظائف
الدالة	الوظيفة
ضف(item)	إضافة عنصر إلى القائمة
حذف(item)	حذف عنصر من القائمة
عرض()	طباعة محتوى القائمة
🛠 الدوال العامة
✔ الطباعة والإدخال
الدالة	الوظيفة
اطبع(p)	يطبع القيمة p
ادخل(d)	يعرض رسالة ويعيد إدخال المستخدم
✔ التعامل مع الأنواع
الدالة	الوظيفة
عد(leen)	يعيد طول الكائن
عشري(رقم)	يحول إلى float
رقم_صحيح(رقم)	يحول إلى int
متغير_قائمة(قائمة)	يحول إلى قائمة
نص(قيمة)	يحول أي قيمة إلى نص
✔ التأخير
توقف(ثانية)


إيقاف تنفيذ البرنامج لعدد معين من الثواني.

🎲 دوال العشوائية
الدالة	الوظيفة
عدد_عشوائي(a,b)	رقم صحيح بين a و b
اختيار_عشوائي(a)	اختيار عنصر واحد من قائمة
اختيارات_عشوائية(a,c)	اختيار عدة عناصر (ملاحظة: لا تُرجع قيمة، يجب إصلاحها)
عشري_عشوائي(a,b)	رقم عشوائي باستخدام randrange
ترتيب_عشوائي(قائمة)	خلط عناصر القائمة وإرجاعها
⚠ ملاحظات تقنية مهمّة
1. دالة اختيارات_عشوائية تحتاج تصحيحًا

حالياً:

def اختيارات_عشوائية(a,c):
    r.choices(a,c)


لا تُرجع أي قيمة.

يجب أن تكون:

def اختيارات_عشوائية(a,c):
    return r.choices(a, k=c)

🎯 خلاصة

هذه المكتبة تقدّم أسلوباً عربياً مبسطاً للتعامل مع المهام الأساسية:
القوائم، الإدخال، التحويلات، الوقت، والعشوائية.
مفيدة للمبتدئين، أو للبرامج التعليمية، أو للمطورين الراغبين في بناء شيفرة عربية بالكامل.
""")