f-ksa 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
f_ksa-1.0.0/PKG-INFO ADDED
@@ -0,0 +1,68 @@
1
+ Metadata-Version: 2.4
2
+ Name: f_ksa
3
+ Version: 1.0.0
4
+ Summary: مكتبة عربية ذكية لتنظيف البيانات ومعالجة النصوص والأرقام السعودية
5
+ Author-email: Fida <your_email@example.com>
6
+ Requires-Python: >=3.7
7
+ Description-Content-Type: text/markdown
8
+
9
+ # 🇸🇦 مكتبة `f_ksa` — أدوات البيانات السعودية والعربية الذكية
10
+
11
+ مكتبة بايثون خفيفة، سريعة، ومبسطة مصممة لتسهيل التعامل مع البيانات المحلية في المملكة العربية السعودية وتنظيف النصوص العربية بسطر واحد فقط، مع رسائل تفاعلية ذكية ومخصصة باللهجة السعودية.
12
+
13
+ * **المطوّرة:** Fida (`@fdoxsy`)
14
+ * **الإصدار الذهبي:** `1.0.0`
15
+ * **المستودع الرسمي:** [PyPI - f_ksa](https://pypi.org)
16
+
17
+ ---
18
+
19
+ ## ⚡ طريقة التثبيت
20
+
21
+ ### التثبيت الرسمي من مستودع بايثون (PyPI):
22
+ pip install f_ksa
23
+
24
+ ### أو التثبيت المباشر من GitHub:
25
+ pip install git+https://github.com/fdoxsy/f_ksa.git
26
+
27
+ ---
28
+
29
+ ## 🛠️ الأدوات المتوفرة (15 أداة متكاملة)
30
+
31
+ | الدالة | الوظيفة |
32
+ | :--- | :--- |
33
+ | `normalize_numbers()` | تحويل الأرقام العربية/الهندية (`٠١٢٣`) إلى إنجليزية (`0123`) |
34
+ | `fix_phone()` | تنسيق أرقام الجوال السعودية للصيغة الدولية الموحدة (`9665xxxxxxxx`) |
35
+ | `clean_text()` | إزالة التشكيل والرموز وتوحيد الهمزات والتاء المربوطة |
36
+ | `check_iban()` | فحص الآيبان السعودي وتحديد اسم البنك تلقائياً |
37
+ | `check_saudi_id()` | فحص صحة رقم الهوية الوطنية أو الإقامة بالخوارزمية الرياضية الرسمية |
38
+ | `calc_vat()` | حساب ضريبة القيمة المضافة السعودية (15%) أو استخراجها من مبلغ شامل |
39
+ | `get_region()` | تحديد المنطقة الإدارية لأي مدينة سعودية |
40
+ | `calc_zakat()` | حساب زكاة المال الشرعية (`2.5%`) والمبلغ المتبقي |
41
+ | `tafkeet()` | تحويل الأرقام إلى كتابة عربية رسمية للفواتير بالريال السعودي |
42
+ | `extract_data()` | استخراج أرقام الجوال والآيبان تلقائياً من أي نص فوضوي |
43
+ | `arabic_date()` | تحويل التاريخ إلى صيغة عربية كاملة مع اسم اليوم والشهر |
44
+ | `convert_sar()` | تحويل العملات من الريال السعودي إلى (USD, EUR, AED, KWD, GBP) والعكس |
45
+ | `calc_age()` | حساب العمر الدقيق بالسنوات والأشهر والأيام |
46
+ | `check_password()` | فحص قوة كلمة المرور وإعطاء نصائح ذكية لتقويتها |
47
+ | `saudi_holidays()` | عرض المناسبات الوطنية الرسمية في المملكة العربية السعودية |
48
+
49
+ ---
50
+
51
+ ## 💻 أمثلة سريعة للاستخدام
52
+
53
+ import f_ksa as fk
54
+
55
+ # توحيد رقم الجوال (يدعم تخصيص الخطاب: gender="f" للأنثى، gender="m" للذكر)
56
+ print(fk.fix_phone("050-123-4567"))
57
+
58
+ # تفقيط المبالغ للفواتير
59
+ print(fk.tafkeet(1250))
60
+
61
+ # فحص الآيبان ومعرفة البنك
62
+ print(fk.check_iban("SA0380000000608010167519"))
63
+
64
+ # حساب ضريبة القيمة المضافة 15%
65
+ print(fk.calc_vat(100))
66
+
67
+ # استخراج البيانات من نص فوضوي
68
+ print(fk.extract_data("رقمي 0551112222 وايباني SA0380000000608010167519"))
f_ksa-1.0.0/README.md ADDED
@@ -0,0 +1,60 @@
1
+ # 🇸🇦 مكتبة `f_ksa` — أدوات البيانات السعودية والعربية الذكية
2
+
3
+ مكتبة بايثون خفيفة، سريعة، ومبسطة مصممة لتسهيل التعامل مع البيانات المحلية في المملكة العربية السعودية وتنظيف النصوص العربية بسطر واحد فقط، مع رسائل تفاعلية ذكية ومخصصة باللهجة السعودية.
4
+
5
+ * **المطوّرة:** Fida (`@fdoxsy`)
6
+ * **الإصدار الذهبي:** `1.0.0`
7
+ * **المستودع الرسمي:** [PyPI - f_ksa](https://pypi.org)
8
+
9
+ ---
10
+
11
+ ## ⚡ طريقة التثبيت
12
+
13
+ ### التثبيت الرسمي من مستودع بايثون (PyPI):
14
+ pip install f_ksa
15
+
16
+ ### أو التثبيت المباشر من GitHub:
17
+ pip install git+https://github.com/fdoxsy/f_ksa.git
18
+
19
+ ---
20
+
21
+ ## 🛠️ الأدوات المتوفرة (15 أداة متكاملة)
22
+
23
+ | الدالة | الوظيفة |
24
+ | :--- | :--- |
25
+ | `normalize_numbers()` | تحويل الأرقام العربية/الهندية (`٠١٢٣`) إلى إنجليزية (`0123`) |
26
+ | `fix_phone()` | تنسيق أرقام الجوال السعودية للصيغة الدولية الموحدة (`9665xxxxxxxx`) |
27
+ | `clean_text()` | إزالة التشكيل والرموز وتوحيد الهمزات والتاء المربوطة |
28
+ | `check_iban()` | فحص الآيبان السعودي وتحديد اسم البنك تلقائياً |
29
+ | `check_saudi_id()` | فحص صحة رقم الهوية الوطنية أو الإقامة بالخوارزمية الرياضية الرسمية |
30
+ | `calc_vat()` | حساب ضريبة القيمة المضافة السعودية (15%) أو استخراجها من مبلغ شامل |
31
+ | `get_region()` | تحديد المنطقة الإدارية لأي مدينة سعودية |
32
+ | `calc_zakat()` | حساب زكاة المال الشرعية (`2.5%`) والمبلغ المتبقي |
33
+ | `tafkeet()` | تحويل الأرقام إلى كتابة عربية رسمية للفواتير بالريال السعودي |
34
+ | `extract_data()` | استخراج أرقام الجوال والآيبان تلقائياً من أي نص فوضوي |
35
+ | `arabic_date()` | تحويل التاريخ إلى صيغة عربية كاملة مع اسم اليوم والشهر |
36
+ | `convert_sar()` | تحويل العملات من الريال السعودي إلى (USD, EUR, AED, KWD, GBP) والعكس |
37
+ | `calc_age()` | حساب العمر الدقيق بالسنوات والأشهر والأيام |
38
+ | `check_password()` | فحص قوة كلمة المرور وإعطاء نصائح ذكية لتقويتها |
39
+ | `saudi_holidays()` | عرض المناسبات الوطنية الرسمية في المملكة العربية السعودية |
40
+
41
+ ---
42
+
43
+ ## 💻 أمثلة سريعة للاستخدام
44
+
45
+ import f_ksa as fk
46
+
47
+ # توحيد رقم الجوال (يدعم تخصيص الخطاب: gender="f" للأنثى، gender="m" للذكر)
48
+ print(fk.fix_phone("050-123-4567"))
49
+
50
+ # تفقيط المبالغ للفواتير
51
+ print(fk.tafkeet(1250))
52
+
53
+ # فحص الآيبان ومعرفة البنك
54
+ print(fk.check_iban("SA0380000000608010167519"))
55
+
56
+ # حساب ضريبة القيمة المضافة 15%
57
+ print(fk.calc_vat(100))
58
+
59
+ # استخراج البيانات من نص فوضوي
60
+ print(fk.extract_data("رقمي 0551112222 وايباني SA0380000000608010167519"))
@@ -0,0 +1,8 @@
1
+ from .tools import (
2
+ normalize_numbers, fix_phone, clean_text, check_iban, check_saudi_id,
3
+ calc_vat, get_region, calc_zakat, tafkeet, extract_data, arabic_date,
4
+ convert_sar, calc_age, check_password, saudi_holidays
5
+ )
6
+
7
+ __version__ = "1.0.0"
8
+ __author__ = "Fida"
@@ -0,0 +1,252 @@
1
+ import re
2
+ from datetime import datetime, date
3
+
4
+ def _msg(gender, female_text, male_text):
5
+ """دالة داخلية لتخصيص الخطاب بين البنت والولد"""
6
+ return female_text if str(gender).lower() in list(('f', 'female', 'بنت', 'انثى')) else male_text
7
+
8
+ def normalize_numbers(text):
9
+ """1. تحويل الأرقام العربية/الهندية (٠١٢٣) إلى إنجليزية (0123)"""
10
+ arabic_nums = "٠١٢٣٤٥٦٧٨٩"
11
+ english_nums = "0123456789"
12
+ return str(text).translate(str.maketrans(arabic_nums, english_nums))
13
+
14
+ def fix_phone(phone, gender="f"):
15
+ """2. تنظيف وتوحيد رقم الجوال السعودي إلى الصيغة الدولية (9665xxxxxxxx)"""
16
+ digits = re.sub(r'\D', '', normalize_numbers(phone))
17
+ if digits.startswith('9665') and len(digits) == 12:
18
+ return digits
19
+ elif digits.startswith('05') and len(digits) == 10:
20
+ return '966' + digits[1:]
21
+ elif digits.startswith('5') and len(digits) == 9:
22
+ return '966' + digits
23
+ else:
24
+ return _msg(
25
+ gender,
26
+ "❌ الرقم خطا يا مزه، تاكدي انه يبدا بـ 05 ويتكون من 10 ارقام!",
27
+ "❌ الرقم خطا يا مزه، تاكد انه يبدا بـ 05 ويتكون من 10 ارقام!"
28
+ )
29
+
30
+ def clean_text(text, gender="f"):
31
+ """3. تنظيف النص العربي من التشكيل والرموز وتوحيد الحروف"""
32
+ if not text or str(text).strip() == "":
33
+ return _msg(
34
+ gender,
35
+ "❌ النص فاضي يا مزه، اكتبي شي عشان انظفه لك!",
36
+ "❌ النص فاضي يا مزه، اكتب شي عشان انظفه لك!"
37
+ )
38
+ text = str(text)
39
+ text = re.sub(r'[\u064B-\u065F]', '', text)
40
+ text = re.sub(r'[إأآا]', 'ا', text)
41
+ text = re.sub(r'ى', 'ي', text)
42
+ text = re.sub(r'ة', 'ه', text)
43
+ text = re.sub(r'[^\w\s\u0600-\u06FF]', '', text)
44
+ return " ".join(text.split())
45
+
46
+ def check_iban(iban, gender="f"):
47
+ """4. التحقق من صيغة الآيبان السعودي ومعرفة اسم البنك تلقائياً"""
48
+ clean_iban = normalize_numbers(iban).replace(" ", "").upper()
49
+ if not clean_iban.startswith("SA") or len(clean_iban) != 24:
50
+ return _msg(
51
+ gender,
52
+ "❌ الايبان خطا يا مزه، تاكدي انه يبدا بـ SA ويتكون من 24 خانه!",
53
+ "❌ الايبان خطا يا مزه، تاكد انه يبدا بـ SA ويتكون من 24 خانه!"
54
+ )
55
+ banks = {
56
+ "80": "مصرف الراجحي", "10": "البنك الأهلي السعودي (SNB)", "20": "بنك الرياض",
57
+ "45": "البنك السعودي البريطاني (ساب)", "55": "البنك السعودي الفرنسي",
58
+ "60": "بنك الجزيرة", "05": "مصرف الإنماء", "15": "بنك البلاد", "30": "البنك العربي الوطني"
59
+ }
60
+ bank_code = clean_iban[4:6]
61
+ bank_name = banks.get(bank_code, "بنك سعودي آخر")
62
+ return f"✅ ايبان صحيح يا مزه - تابع لـ: {bank_name}"
63
+
64
+ def check_saudi_id(id_number, gender="f"):
65
+ """5. التحقق الرياضي الرسمي من صحة رقم الهوية الوطنية أو الإقامة"""
66
+ id_str = normalize_numbers(id_number).strip()
67
+ if not id_str.isdigit() or len(id_str) != 10 or id_str not in ('1', '2'):
68
+ return _msg(
69
+ gender,
70
+ "❌ الرقم خطا يا مزه، تاكدي انه 10 ارقام ويبدا بـ 1 او 2!",
71
+ "❌ الرقم خطا يا مزه، تاكد انه 10 ارقام ويبدا بـ 1 او 2!"
72
+ )
73
+ total = 0
74
+ for i in range(10):
75
+ digit = int(id_str[i])
76
+ if i % 2 == 0:
77
+ doubled = digit * 2
78
+ total += doubled if doubled < 10 else (doubled // 10) + (doubled % 10)
79
+ else:
80
+ total += digit
81
+ if total % 10 == 0:
82
+ id_type = "هوية وطنية سعودية" if id_str == '1' else "إقامة نظامية"
83
+ return f"✅ رقم صحيح يا مزه ({id_type})"
84
+ else:
85
+ return _msg(
86
+ gender,
87
+ "❌ الرقم خطا يا مزه، تاكدي من رقم الهوية او الاقامه!",
88
+ "❌ الرقم خطا يا مزه، تاكد من رقم الهوية او الاقامه!"
89
+ )
90
+
91
+ def calc_vat(amount, include_vat=False, gender="f"):
92
+ """6. حساب ضريبة القيمة المضافة السعودية (15%)"""
93
+ try:
94
+ amount = float(normalize_numbers(amount))
95
+ if amount < 0:
96
+ return _msg(gender, "❌ المبلغ خطا يا مزه، تاكدي انه رقم موجب!", "❌ المبلغ خطا يا مزه، تاكد انه رقم موجب!")
97
+ if include_vat:
98
+ base = round(amount / 1.15, 2)
99
+ vat = round(amount - base, 2)
100
+ return {"المبلغ_الأساسي": base, "الضريبة_15%": vat, "الإجمالي_شامل_الضريبة": amount}
101
+ else:
102
+ vat = round(amount * 0.15, 2)
103
+ total = round(amount + vat, 2)
104
+ return {"المبلغ_الأساسي": amount, "الضريبة_15%": vat, "الإجمالي_شامل_الضريبة": total}
105
+ except ValueError:
106
+ return _msg(gender, "❌ المبلغ خطا يا مزه، تاكدي انك كتبتي رقم صحيح!", "❌ المبلغ خطا يا مزه، تاكد انك كتبت رقم صحيح!")
107
+
108
+ def get_region(city, gender="f"):
109
+ """7. معرفة المنطقة الإدارية في السعودية من اسم المدينة"""
110
+ clean_city = clean_text(city).replace("ال", "")
111
+ regions = {
112
+ "رياض": "منطقة الرياض", "خرج": "منطقة الرياض", "درعيه": "منطقة الرياض", "مجمعه": "منطقة الرياض",
113
+ "مكه": "منطقة مكة المكرمة", "جده": "منطقة مكة المكرمة", "طائف": "منطقة مكة المكرمة", "رابع": "منطقة مكة المكرمة",
114
+ "مدينه": "منطقة المدينة المنورة", "ينبع": "منطقة المدينة المنورة", "علا": "منطقة المدينة المنورة",
115
+ "دمام": "المنطقة الشرقية", "خبر": "المنطقة الشرقية", "ظهران": "المنطقة الشرقية", "احساء": "المنطقة الشرقية", "جبيل": "المنطقة الشرقية", "قطيف": "المنطقة الشرقية",
116
+ "بريده": "منطقة القصيم", "عنيزه": "منطقة القصيم", "رس": "منطقة القصيم",
117
+ "ابها": "منطقة عسير", "خميس مشيط": "منطقة عسير", "بيشه": "منطقة عسير",
118
+ "تبوك": "منطقة تبوك", "نيوم": "منطقة تبوك", "وجه": "منطقة تبوك",
119
+ "حائل": "منطقة حائل", "عرعر": "منطقة الحدود الشمالية", "رفحاء": "منطقة الحدود الشمالية",
120
+ "جازان": "منطقة جازان", "صبياء": "منطقة جازان", "نجران": "منطقة نجران",
121
+ "باحه": "منطقة الباحة", "سكاكا": "منطقة الجوف", "دومه الجندل": "منطقة الجوف"
122
+ }
123
+ for key, region in regions.items():
124
+ if key in clean_city:
125
+ return f"📍 {region}"
126
+ return _msg(gender, "❓ المدينه مو مسجله يا مزه، تاكدي من كتابة اسمها صح!", "❓ المدينه مو مسجله يا مزه، تاكد من كتابة اسمها صح!")
127
+
128
+ def calc_zakat(amount, gender="f"):
129
+ """8. حساب زكاة المال الشرعية (ربع العشر 2.5%)"""
130
+ try:
131
+ amount = float(normalize_numbers(amount))
132
+ if amount < 0:
133
+ return _msg(gender, "❌ المبلغ خطا يا مزه، تاكدي انه رقم موجب!", "❌ المبلغ خطا يا مزه، تاكد انه رقم موجب!")
134
+ zakat = round(amount * 0.025, 2)
135
+ remaining = round(amount - zakat, 2)
136
+ return {"إجمالي_المبلغ": amount, "مقدار_الزكاة_2.5%": zakat, "المتبقي_بعد_الزكاة": remaining}
137
+ except ValueError:
138
+ return _msg(gender, "❌ المبلغ خطا يا مزه، تاكدي انك كتبتي رقم صحيح!", "❌ المبلغ خطا يا مزه، تاكد انك كتبت رقم صحيح!")
139
+
140
+ def tafkeet(number, gender="f"):
141
+ """9. تحويل الأرقام إلى كتابة عربية رسمية للفواتير (تفقيط بالريال السعودي)"""
142
+ try:
143
+ num = int(float(normalize_numbers(number)))
144
+ if num < 0 or num > 999999:
145
+ return _msg(gender, "❌ الرقم لازم يكون بين 0 و 999,999 يا مزه!", "❌ الرقم لازم يكون بين 0 و 999,999 يا مزه!")
146
+ if num == 0:
147
+ return "فقط صفر ريال سعودي لا غير"
148
+ ones = ("", "واحد", "اثنان", "ثلاثة", "أربعة", "خمسة", "ستة", "سبعة", "ثمانية", "تسعة", "عشرة",
149
+ "أحد عشر", "اثنا عشر", "ثلاثة عشر", "أربعة عشر", "خمسة عشر", "ستة عشر", "سبعة عشر", "ثمانية عشر", "تسعة عشر")
150
+ tens = ("", "", "عشرون", "ثلاثون", "أربعون", "خمسون", "ستون", "سبعون", "ثمانون", "تسعون")
151
+ hundreds = ("", "مائة", "مائتان", "ثلاثمائة", "أربعمائة", "خمسمائة", "ستمائة", "سبعمائة", "ثمانمائة", "تسعمائة")
152
+
153
+ def _convert_under_1000(n):
154
+ parts = list()
155
+ if n >= 100:
156
+ parts.append(hundreds[n // 100])
157
+ n %= 100
158
+ if n > 0:
159
+ if n < 20:
160
+ parts.append(ones[n])
161
+ else:
162
+ u = n % 10
163
+ t = n // 10
164
+ parts.append(f"{ones[u]} و{tens[t]}" if u > 0 else tens[t])
165
+ return " و".join(parts)
166
+
167
+ thousands = num // 1000
168
+ rest = num % 1000
169
+ result_parts = list()
170
+ if thousands > 0:
171
+ if thousands == 1: result_parts.append("ألف")
172
+ elif thousands == 2: result_parts.append("ألفان")
173
+ elif 3 <= thousands <= 10: result_parts.append(f"{ones[thousands]} آلاف")
174
+ else: result_parts.append(f"{_convert_under_1000(thousands)} ألف")
175
+ if rest > 0:
176
+ result_parts.append(_convert_under_1000(rest))
177
+ return f"فقط {' و'.join(result_parts)} ريال سعودي لا غير"
178
+ except ValueError:
179
+ return _msg(gender, "❌ الرقم خطا يا مزه، اكتبي رقم صحيح!", "❌ الرقم خطا يا مزه، اكتب رقم صحيح!")
180
+
181
+ def extract_data(text):
182
+ """10. استخراج أرقام الجوال السعودية والآيبان من أي نص فوضوي تلقائياً"""
183
+ clean = normalize_numbers(text)
184
+ phones = re.findall(r'(?:\+?9665|05)\d{8}', clean)
185
+ ibans = re.findall(r'SA\d{22}', clean.replace(" ", "").upper())
186
+ return {"أرقام_الجوال": list(set(phones)), "أرقام_الآيبان": list(set(ibans))}
187
+
188
+ def arabic_date(date_str, gender="f"):
189
+ """11. تحويل التاريخ (YYYY-MM-DD) إلى صيغة عربية كاملة مع اسم اليوم والشهر"""
190
+ try:
191
+ dt = datetime.strptime(normalize_numbers(date_str).strip(), "%Y-%m-%d")
192
+ days = ("الاثنين", "الثلاثاء", "الأربعاء", "الخميس", "الجمعة", "السبت", "الأحد")
193
+ months = ("", "يناير", "فبراير", "مارس", "أبريل", "مايو", "يونيو", "يوليو", "أغسطس", "سبتمبر", "أكتوبر", "نوفمبر", "ديسمبر")
194
+ return f"📅 {days[dt.weekday()]}، {dt.day} {months[dt.month]} {dt.year}"
195
+ except ValueError:
196
+ return _msg(gender, "❌ صيغة التاريخ خطا يا مزه، اكتبيها كذا: 2026-11-21", "❌ صيغة التاريخ خطا يا مزه، اكتبها كذا: 2026-11-21")
197
+
198
+ def convert_sar(amount, to_currency="USD", reverse=False, gender="f"):
199
+ """12. تحويل العملات من الريال السعودي (SAR) إلى العملات الرئيسية (USD, EUR, AED, KWD, GBP) والعكس"""
200
+ rates = {"USD": 3.75, "EUR": 4.08, "AED": 1.02, "KWD": 12.20, "GBP": 4.78}
201
+ curr = str(to_currency).upper().strip()
202
+ if curr not in rates:
203
+ return _msg(gender, "❌ العمله مو مدعومه يا مزه، اختاري: USD, EUR, AED, KWD, GBP", "❌ العمله مو مدعومه يا مزه، اختر: USD, EUR, AED, KWD, GBP")
204
+ try:
205
+ val = float(normalize_numbers(amount))
206
+ if reverse:
207
+ res = round(val * rates[curr], 2)
208
+ return f"💱 {val} {curr} = {res} ريال سعودي (SAR)"
209
+ else:
210
+ res = round(val / rates[curr], 2)
211
+ return f"💱 {val} ريال سعودي (SAR) = {res} {curr}"
212
+ except ValueError:
213
+ return _msg(gender, "❌ المبلغ خطا يا مزه، اكتبي رقم صحيح!", "❌ المبلغ خطا يا مزه، اكتب رقم صحيح!")
214
+
215
+ def calc_age(birth_date, gender="f"):
216
+ """13. حساب العمر الدقيق بالسنوات والأشهر والأيام من تاريخ الميلاد (YYYY-MM-DD)"""
217
+ try:
218
+ bdate = datetime.strptime(normalize_numbers(birth_date).strip(), "%Y-%m-%d").date()
219
+ today = date.today()
220
+ if bdate > today:
221
+ return _msg(gender, "❌ تاريخ الميلاد بالمستقبل يا مزه، تاكدي من التاريخ!", "❌ تاريخ الميلاد بالمستقبل يا مزه، تاكد من التاريخ!")
222
+ years = today.year - bdate.year - ((today.month, today.day) < (bdate.month, bdate.day))
223
+ months = (today.month - bdate.month - (today.day < bdate.day)) % 12
224
+ days = (today - bdate.replace(year=today.year if (today.month, today.day) >= (bdate.month, bdate.day) else today.year - 1)).days % 30
225
+ return {"السنوات": years, "الأشهر": months, "الأيام": days, "الوصف": f"🎂 عمرك {years} سنة و {months} شهر و {days} يوم"}
226
+ except ValueError:
227
+ return _msg(gender, "❌ صيغة التاريخ خطا يا مزه، اكتبيها كذا: 2000-05-15", "❌ صيغة التاريخ خطا يا مزه، اكتبها كذا: 2000-05-15")
228
+
229
+ def check_password(password, gender="f"):
230
+ """14. فحص قوة كلمة المرور وإعطاء نصائح لتقويتها"""
231
+ pwd = str(password)
232
+ tips = list()
233
+ if len(pwd) < 8:
234
+ tips.append("اجعليها 8 خانات على الأقل" if gender == "f" else "اجعلها 8 خانات على الأقل")
235
+ if not re.search(r'[A-Z]', pwd):
236
+ tips.append("أضيفي حرفاً كبيراً (A-Z)" if gender == "f" else "أضف حرفاً كبيراً (A-Z)")
237
+ if not re.search(r'[0-9]', pwd):
238
+ tips.append("أضيفي أرقاماً (0-9)" if gender == "f" else "أضف أرقاماً (0-9)")
239
+ if not re.search(r'[!@#$%^&*(),.?":{}|<>]', pwd):
240
+ tips.append("أضيفي رمزاً خاصاً مثل (@#$)" if gender == "f" else "أضف رمزاً خاصاً مثل (@#$)")
241
+
242
+ if not tips:
243
+ return "🛡️ كلمة مرور قوية وممتازة يا مزه!"
244
+ return f"⚠️ كلمة المرور ضعيفة يا مزه، نصيحتي: {' + '.join(tips)}"
245
+
246
+ def saudi_holidays():
247
+ """15. عرض المناسبات الوطنية الرسمية في المملكة العربية السعودية"""
248
+ return {
249
+ "يوم التأسيس السعودي": "22 فبراير من كل عام",
250
+ "يوم العلم السعودي": "11 مارس من كل عام",
251
+ "اليوم الوطني السعودي": "23 سبتمبر من كل عام"
252
+ }
@@ -0,0 +1,68 @@
1
+ Metadata-Version: 2.4
2
+ Name: f_ksa
3
+ Version: 1.0.0
4
+ Summary: مكتبة عربية ذكية لتنظيف البيانات ومعالجة النصوص والأرقام السعودية
5
+ Author-email: Fida <your_email@example.com>
6
+ Requires-Python: >=3.7
7
+ Description-Content-Type: text/markdown
8
+
9
+ # 🇸🇦 مكتبة `f_ksa` — أدوات البيانات السعودية والعربية الذكية
10
+
11
+ مكتبة بايثون خفيفة، سريعة، ومبسطة مصممة لتسهيل التعامل مع البيانات المحلية في المملكة العربية السعودية وتنظيف النصوص العربية بسطر واحد فقط، مع رسائل تفاعلية ذكية ومخصصة باللهجة السعودية.
12
+
13
+ * **المطوّرة:** Fida (`@fdoxsy`)
14
+ * **الإصدار الذهبي:** `1.0.0`
15
+ * **المستودع الرسمي:** [PyPI - f_ksa](https://pypi.org)
16
+
17
+ ---
18
+
19
+ ## ⚡ طريقة التثبيت
20
+
21
+ ### التثبيت الرسمي من مستودع بايثون (PyPI):
22
+ pip install f_ksa
23
+
24
+ ### أو التثبيت المباشر من GitHub:
25
+ pip install git+https://github.com/fdoxsy/f_ksa.git
26
+
27
+ ---
28
+
29
+ ## 🛠️ الأدوات المتوفرة (15 أداة متكاملة)
30
+
31
+ | الدالة | الوظيفة |
32
+ | :--- | :--- |
33
+ | `normalize_numbers()` | تحويل الأرقام العربية/الهندية (`٠١٢٣`) إلى إنجليزية (`0123`) |
34
+ | `fix_phone()` | تنسيق أرقام الجوال السعودية للصيغة الدولية الموحدة (`9665xxxxxxxx`) |
35
+ | `clean_text()` | إزالة التشكيل والرموز وتوحيد الهمزات والتاء المربوطة |
36
+ | `check_iban()` | فحص الآيبان السعودي وتحديد اسم البنك تلقائياً |
37
+ | `check_saudi_id()` | فحص صحة رقم الهوية الوطنية أو الإقامة بالخوارزمية الرياضية الرسمية |
38
+ | `calc_vat()` | حساب ضريبة القيمة المضافة السعودية (15%) أو استخراجها من مبلغ شامل |
39
+ | `get_region()` | تحديد المنطقة الإدارية لأي مدينة سعودية |
40
+ | `calc_zakat()` | حساب زكاة المال الشرعية (`2.5%`) والمبلغ المتبقي |
41
+ | `tafkeet()` | تحويل الأرقام إلى كتابة عربية رسمية للفواتير بالريال السعودي |
42
+ | `extract_data()` | استخراج أرقام الجوال والآيبان تلقائياً من أي نص فوضوي |
43
+ | `arabic_date()` | تحويل التاريخ إلى صيغة عربية كاملة مع اسم اليوم والشهر |
44
+ | `convert_sar()` | تحويل العملات من الريال السعودي إلى (USD, EUR, AED, KWD, GBP) والعكس |
45
+ | `calc_age()` | حساب العمر الدقيق بالسنوات والأشهر والأيام |
46
+ | `check_password()` | فحص قوة كلمة المرور وإعطاء نصائح ذكية لتقويتها |
47
+ | `saudi_holidays()` | عرض المناسبات الوطنية الرسمية في المملكة العربية السعودية |
48
+
49
+ ---
50
+
51
+ ## 💻 أمثلة سريعة للاستخدام
52
+
53
+ import f_ksa as fk
54
+
55
+ # توحيد رقم الجوال (يدعم تخصيص الخطاب: gender="f" للأنثى، gender="m" للذكر)
56
+ print(fk.fix_phone("050-123-4567"))
57
+
58
+ # تفقيط المبالغ للفواتير
59
+ print(fk.tafkeet(1250))
60
+
61
+ # فحص الآيبان ومعرفة البنك
62
+ print(fk.check_iban("SA0380000000608010167519"))
63
+
64
+ # حساب ضريبة القيمة المضافة 15%
65
+ print(fk.calc_vat(100))
66
+
67
+ # استخراج البيانات من نص فوضوي
68
+ print(fk.extract_data("رقمي 0551112222 وايباني SA0380000000608010167519"))
@@ -0,0 +1,8 @@
1
+ README.md
2
+ pyproject.toml
3
+ f_ksa/__init__.py
4
+ f_ksa/tools.py
5
+ f_ksa.egg-info/PKG-INFO
6
+ f_ksa.egg-info/SOURCES.txt
7
+ f_ksa.egg-info/dependency_links.txt
8
+ f_ksa.egg-info/top_level.txt
@@ -0,0 +1,2 @@
1
+ dist
2
+ f_ksa
@@ -0,0 +1,16 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "f_ksa"
7
+ version = "1.0.0"
8
+ authors = [
9
+ { name="Fida", email="your_email@example.com" },
10
+ ]
11
+ description = "مكتبة عربية ذكية لتنظيف البيانات ومعالجة النصوص والأرقام السعودية"
12
+ readme = "README.md"
13
+ requires-python = ">=3.7"
14
+
15
+ [tool.setuptools.packages.find]
16
+ where = ["."]
f_ksa-1.0.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+