summaryrefslogtreecommitdiffhomepage
path: root/ar-ar/python3-ar.html.markdown
diff options
context:
space:
mode:
authorSimon Shine <shreddedglory@gmail.com>2020-02-12 04:54:36 +0100
committerSimon Shine <shreddedglory@gmail.com>2020-02-12 04:54:36 +0100
commita3b0585374d69e392fdb724bde30bc4048358d31 (patch)
tree6a5520ab2f1146939f15b9db6dddcc7271fbcfef /ar-ar/python3-ar.html.markdown
parent1adab9bc3f80d82123987ff34083568030735db7 (diff)
Rename Python 3 markdown files into 'python'
``` for f in $(find . -iname "*python3*" | grep -vE 'git'); do fnew=$(echo "$f" | sed 's/python3/python/') git mv "$f" "$fnew" done
Diffstat (limited to 'ar-ar/python3-ar.html.markdown')
-rw-r--r--ar-ar/python3-ar.html.markdown1019
1 files changed, 0 insertions, 1019 deletions
diff --git a/ar-ar/python3-ar.html.markdown b/ar-ar/python3-ar.html.markdown
deleted file mode 100644
index e1a12690..00000000
--- a/ar-ar/python3-ar.html.markdown
+++ /dev/null
@@ -1,1019 +0,0 @@
----
-language: python3
-contributors:
- - ["Louie Dinh", "http://pythonpracticeprojects.com"]
- - ["Steven Basart", "http://github.com/xksteven"]
- - ["Andre Polykanine", "https://github.com/Oire"]
- - ["Zachary Ferguson", "http://github.com/zfergus2"]
- - ["evuez", "http://github.com/evuez"]
- - ["Rommel Martinez", "https://ebzzry.io"]
- - ["Roberto Fernandez Diaz", "https://github.com/robertofd1995"]
-translators:
- - ["Ahmad Hegazy", "https://github.com/ahegazy"]
-lang: ar-ar
-filename: learnpython3-ar.py
----
-
-لقد أُنشئت لغة البايثون بواسطة جايدو ڤان روسم في بداية التسعينات. هي الأن أحد أشهر اللغات الموجودة.
-لقد أحببت لغة البايثون بسبب وضوحها. هي في الأساس عبارة عن سودوكود قابل للتنفيذ.
-
-ردود أفعالكم عن المقال مُقدرة بشدة. يمكنكم التواصل مع الكاتب الاساسي من خلال [@louiedinh](http://twitter.com/louiedinh) أو louiedinh [at] [google's email service]
-
-ملحوظة: هذا المقال يُطبق على بايثون 3 فقط. راجع المقال [هنا](http://learnxinyminutes.com/docs/python/) إذا أردت تعلم لغة البايثون نسخة 2.7 الأقدم
-
-```python
-
-# تعليق من سطر واحد يبدأ برمز الرقم.
-
-""" يمكن كتابة تعليق يتكون من أكثر من سطر
- باستخدام ثلاثة علامات "
- ، وعادة يُستخدم في كتابة التوثيقات.
-"""
-
-####################################################
-## 1. أنواع البيانات البدائية والعمليات
-####################################################
-
-# لديك أرقام
-3 # => 3
-
-# العمليات الحسابية هي ما تتوقعه
-1 + 1 # => 2
-8 - 1 # => 7
-10 * 2 # => 20
-35 / 5 # => 7.0
-
-# نتائج قسمة الأرقام الصحيحية تُقرب للأصغر سواءًا كانت الأرقام موجبة أو سالبة.
-5 // 3 # => 1
-5.0 // 3.0 # => 1.0 # يعمل في حالة الكسور أيضا
--5 // 3 # => -2
--5.0 // 3.0 # => -2.0
-
-# ناتج القسمة هو دائما كسر
-10.0 / 3 # => 3.3333333333333335
-
-# عملية باقي القسمة
-7 % 3 # => 1
-
-# الأُس (س ** ص، رفع س لقوى ص)
-2**3 # => 8
-
-# أفرض ترتيب العمليات الحسابية بالأقواس
-(1 + 3) * 2 # => 8
-
-# القيم الثنائية هي المعروفة عموما (ﻻحظ: تكبير أول حرف)
-True
-False
-
-# أنفي بـ (not)
-not True # => False
-not False # => True
-
-# العمليات على القيم الثنائية
-# ﻻحظ ﻻيهم حالة الحرف (كبير أو صغير) في "and" و "or"
-True and False # => False
-False or True # => True
-
-# True و False هما في الواقع 1 و 0 لكن بمسميات مختلفة
-True + True # => 2
-True * 8 # => 8
-False - 5 # => -5
-
-# عمليات المقارنة تنظر الي القيمة الرقمية لل True وال False
-0 == False # => True
-1 == True # => True
-2 == True # => False
--5 != False # => True
-
-# عند استخدام المنطق الثنائي على القيم الصحيحة يتم تحويلهم الي قيم ثنائية لإجرات العمليات عليهم، لكن قيمهم الأصلية تعود
-# ﻻ تخلط بين bool(قيمة صحيحة) و العمليات المنطقية الثناية and/or (&,|)
-bool(0) # => False
-bool(4) # => True
-bool(-6) # => True
-0 and 2 # => 0
--5 or 0 # => -5
-
-# مقارنة التساوي ب ==
-1 == 1 # => True
-2 == 1 # => False
-
-# مقارنة الاختلاف ب !=
-1 != 1 # => False
-2 != 1 # => True
-
-# مقارنات أخرى
-1 < 10 # => True
-1 > 10 # => False
-2 <= 2 # => True
-2 >= 2 # => True
-
-# لمعرفة هل القيمة في نطاق معين
-1 < 2 and 2 < 3 # => True
-2 < 3 and 3 < 2 # => False
-
-# التسلسل يجعلها تبدو أجمل
-1 < 2 < 3 # => True
-2 < 3 < 2 # => False
-
-# (is مقابل ==) is تتحق من أن المتغيرين يشيران إلي نفس العنصر,
-# لكن == تتحقق من أن العنصرين المُشار اليهما بالمتغيرين لهما نفس القيمة.
-a = [1, 2, 3, 4] # اجعل a تشير إلي قائمة جديدة, [1, 2, 3, 4]
-b = a # اجعل a تُشير الي ما تُشير إليه b
-b is a # => True, a و b يُشيران إلي نفس العنصر
-b == a # => True, قيمة عنصر a و b متساوية
-b = [1, 2, 3, 4] # اجعل b تشير الي قائمة جديدة , [1, 2, 3, 4]
-b is a # => False, a و b do ﻻ يشيران إلي نفس العنصر
-b == a # => True, قيمة عنصر a و b متساوية
-
-# يمكنك إنشاء الكلمات (تسلسلات الحروف) عن طريق " أو '
-"This is a string."
-'This is also a string.'
-
-# يمكنك جمع هذا النوع أيضا! لكن حاول ألا تفعل هذا.
-"Hello " + "world!" # => "Hello world!"
-# يمكنك الربط بين الكلمات بدون استخدام '+' (لكن ليس المتغيرات)
-"Hello " "world!" # => "Hello world!"
-
-# يمكنك معاملة الكلمات كقائمة من الحروف
-"This is a string"[0] # => 'T'
-
-# يمكنك معرفة طول الكلمة
-len("This is a string") # => 16
-
-# .format يمكنك استخدامها لبناء الجمل بشكل معين, مثل هذا:
-"{} can be {}".format("Strings", "interpolated") # => "Strings can be interpolated"
-
-# يمكنك تكرار معاملات بناء الجملة لتقليل الكتابة.
-"{0} be nimble, {0} be quick, {0} jump over the {1}".format("Jack", "candle stick")
-# => "Jack be nimble, Jack be quick, Jack jump over the candle stick"
-
-# يمكنك استخدام الكلمات المفتاحية إذا لم تُرد العد.
-"{name} wants to eat {food}".format(name="Bob", food="lasagna") # => "Bob wants to eat lasagna"
-
-# إذا كان كود بايثون 3 الخاص بك يحتاج لبايثون 2.5 أو نسخة أقدم
-# يمكنك استخدام أسلوب بناء الجمل القديم:
-"%s can be %s the %s way" % ("Strings", "interpolated", "old") # => "Strings can be interpolated the old way"
-
-# يمكنك أبضا بناء الجمل باستخدام f-strings أو حروف بناء الجمل (في بايثون 3.6 فما فوق)
-name = "Reiko"
-f"She said her name is {name}." # => "She said her name is Reiko"
-# يمكنك ببساطة وضع أي كود بايثون داخل أقواس وستقوم بإخراج الجملة.
-f"{name} is {len(name)} characters long."
-
-
-# None عبارة عن كائن
-None # => None
-
-# ﻻ تستخدم رمز المساواة "==" لمقارنة العناصر ب None
-# استخدم is بدلا منه. يقوم بالتحقق من مساواة هوية العنصر
-"etc" is None # => False
-None is None # => True
-
-# None, 0, قوائم/جمل/قواميس/صفوف فارغة كلها تُترجم إلي False.
-# كل القيم الأخرى True.
-bool(0) # => False
-bool("") # => False
-bool([]) # => False
-bool({}) # => False
-bool(()) # => False
-
-####################################################
-## 2. المتغيرات والمجموعات
-####################################################
-
-# بايثون لديها دالة عرض "print"
-print("I'm Python. Nice to meet you!") # => I'm Python. Nice to meet you!
-
-# الافتراضي دالة print تطبع سطر جديد في النهاية.
-# استخدم المعامل end لتغيير أخر الجملة المعروضة.
-print("Hello, World", end="!") # => Hello, World!
-
-# طريقة بسيطة لطلب مدخل من الطرفية
-input_string_var = input("Enter some data: ") # يقوم بإعادة البيانات ك "string"
-# لاحظ: في النسخ القديمة من بايثون، دالة input() كان اسمها raw_input()
-
-# ﻻ يوجد تعريفات للمتغيرات، يتم تعيين قيمة المتغير مباشرة.
-# العٌرف تسمية المتغيرات حروف_صغيرة_مع_خطوط_سُفلية
-some_var = 5
-some_var # => 5
-
-# محاولة استخدام متغير غير مُعين يعتبر خطأ
-# إقرأ جزء 3.مسار التحكم لمعرفة المزيد عن التحكم في الأخطاء
-some_unknown_var # يعرض خطأ NameError
-
-# يمكن استخدام if كتعبير واحد
-# مساوِ للتعبير الأتي في لغة السي '?:' عملية ثلاثية
-"yahoo!" if 3 > 2 else 2 # => "yahoo!"
-
-# القوائم تحفظ المتسلسلات
-li = []
-# يمكنك البدأ بقائمة مليئة
-other_li = [4, 5, 6]
-
-# إضافة بيانات لأخر القائمة عن طريق append
-li.append(1) # li is now [1]
-li.append(2) # li is now [1, 2]
-li.append(4) # li is now [1, 2, 4]
-li.append(3) # li is now [1, 2, 4, 3]
-# حذف أخر عنصر في القائمة عن طريق pop
-li.pop() # => 3 and li is now [1, 2, 4]
-# هيا نعيده ثانية
-li.append(3) # li is now [1, 2, 4, 3] again.
-
-# يمكنك الوصول لعناصر القائمة كما تفعل في ال array
-# Access a list like you would any array
-li[0] # => 1
-# للوصول لأخر عنصر
-li[-1] # => 3
-
-# محاولة الوصول لعنصر خارج نطاق القائمة يعتبر خطأ: IndexError
-li[4] # يعرض خطأ IndexError
-
-# يمكنك النظر للنطاقات باستخدام تركيب التقطيع
-# مؤشر/رقم/فهرس البداية مُضمن، مؤشر النهاية ﻻ
-# (لمحبي الرياضيات هو نطاق مفتوح/مغلق)
-li[1:3] # => [2, 4]
-# إحذف أول عنصر ثم إعرض القائمة
-li[2:] # => [4, 3]
-# إحذف أخر عنصر ثم إعرض القائمة
-li[:3] # => [1, 2, 4]
-# حدد عنصر ثم إحذف الذي يليه ثم حدد عنصر وهكذا
-li[::2] # =>[1, 4]
-# اعرض نسخة معكوسة من القائمة
-li[::-1] # => [3, 4, 2, 1]
-# إستخدم أي تجميعة من الطرق المذكورة لعمل تقطيعات متقدمة
-# li[start:end:step]
-
-# عمل نسخة من طبقة واحدة باستخدم التقطيع
-li2 = li[:] # => li2 = [1, 2, 4, 3] لكن عند عمل(li2 is li) سينتج False.
-
-# إمسح أي عنصر من القائمة باستخدام "del"
-del li[2] # li is now [1, 2, 3]
-
-# إمسح أول ظهور لقيمة.
-li.remove(2) # li is now [1, 3]
-li.remove(2) # يعرض خطأ ValueError لأن 2 غير موجود في القائمة
-
-# أضف عنصر في خانة معينة
-li.insert(1, 2) # li is now [1, 2, 3] مرة أخرى
-
-# أحصل على مؤشر/رقم لأول ظهور للقيمة
-li.index(2) # => 1
-li.index(4) # يعرض خطأ ValueError لأن 4 غير موجودة في القائمة
-
-# يمكنك جمع قوائم
-# لاحظ: لا يتم تعديل قيمة li و other_li
-li + other_li # => [1, 2, 3, 4, 5, 6]
-
-# إستخدم دالة "extend()" لربط القوائم
-li.extend(other_li) # Now li is [1, 2, 3, 4, 5, 6]
-
-# راجع وجود قيمة في القائمة باستخدام "in"
-1 in li # => True
-
-# إحصل على طول القائمة باستخدام دالة "len()"
-len(li) # => 6
-
-
-# الصفوف تشبه القوائم لكنها غير قابلة للتغيير.
-tup = (1, 2, 3)
-tup[0] # => 1
-tup[0] = 3 # يعرض خطأ TypeError
-
-# لاحظ أن صف طوله عنصر واحد يحتاج لإضافة فاصلة "," بعد أخر عنصر
-# لكن الصفوف من أي طول أخر، حتى صفر لا تحتاج.
-type((1)) # => <class 'int'>
-type((1,)) # => <class 'tuple'>
-type(()) # => <class 'tuple'>
-
-# يمكنك عمل معظم عمليات القوائم على الصفوف.
-len(tup) # => 3
-tup + (4, 5, 6) # => (1, 2, 3, 4, 5, 6)
-tup[:2] # => (1, 2)
-2 in tup # => True
-
-# يمكنك تفريغ الصفوف (أو القوائم) في متغيرات
-a, b, c = (1, 2, 3) # a is now 1, b is now 2 and c is now 3
-# يمكنك أيضا عمل تفريغ واسع
-a, *b, c = (1, 2, 3, 4) # a is now 1, b is now [2, 3] and c is now 4
-# الصفوف تُنشأ تلقائيا إذا تركت الأقواس
-d, e, f = 4, 5, 6 # تم توسعة الصف 4, 5 ,6 في المتغيرات d, e, f
-# بالترتيب حيث d = 4, e = 5 و f = 6
-# الأن إنظر إلي مدى سهولة التبديل بين قيم متغيرين
-e, d = d, e # d is now 5 and e is now 4
-
-
-# القواميس تُخزن خرائط من المفتاح للقيمة
-empty_dict = {}
-# هذا قاموس مملوء
-filled_dict = {"one": 1, "two": 2, "three": 3}
-
-# لاحظ أن القواميس يجب أن تكون أنواع غير قابلة للتغيير.
-# هذا للتأكد من أن المفتاح يمكن تحويله لقيمة ثابتة للوصول السريع.
-# الأنواع الغير قابلة للتغير تتضمن: الأرقام الصحيحة، الكسور، الكلمات، الصفوف.
-invalid_dict = {[1,2,3]: "123"} # =>يعرض خطأ TypeError: unhashable type: 'list'
-valid_dict = {(1,2,3):[1,2,3]} # القيم يمكن أن تكون من أي نوع.
-
-# يمكنك البحث عن قيمة باستخدام []
-filled_dict["one"] # => 1
-
-# يمكنك الحصول على كل المفاتيح باستخدام "keys()".
-# نحتاج لإرسالها لدالة list() لتحويلها لقائمة. سنتعلم هذا لاحقًا
-# لاحظ - لنسخ بايثون قبل 3.7، ترتيب مفاتيح القاموس غير مضمون. نتائجك
-# يمكن ألا تساوي المثال بالأسفل. مع ذلك، من أول بايثون 3.7،
-# عناصر القاموس تحتفظ بالترتيب الذي تم إضافة المفاتيح به في القاموس.
-list(filled_dict.keys()) # => ["three", "two", "one"] in Python <3.7
-list(filled_dict.keys()) # => ["one", "two", "three"] in Python 3.7+
-
-# يمكنك الحصول على كل القيم باستخدام "values()".
-# مرة أخرى نستخدم list() للحصول عليها كقائمة.
-# نفس الكلام السابق بخصوص ترتيب المفاتيح
-list(filled_dict.values()) # => [3, 2, 1] in Python <3.7
-list(filled_dict.values()) # => [1, 2, 3] in Python 3.7+
-
-# إفحص للتأكد من وجود مغتاح في القاموس باستخدام "in"
-"one" in filled_dict # => True
-1 in filled_dict # => False
-
-# البحث عن مفتاح غير موجود يعرض خطأ KeyError
-filled_dict["four"] # KeyError
-
-# استخدم "get()" لتجنب الخطأ KeyError
-filled_dict.get("one") # => 1
-filled_dict.get("four") # => None
-# دالة get تدعم إدخال قيمة افتراضية عند عدم وجود البحث
-filled_dict.get("one", 4) # => 1
-filled_dict.get("four", 4) # => 4
-
-# "setdefault()" تقوم بإدخال قيمة جديدة في القاموس في حالة عدم وجود المفتاح فقط.
-filled_dict.setdefault("five", 5) # filled_dict["five"] is set to 5
-filled_dict.setdefault("five", 6) # filled_dict["five"] is still 5
-
-# إضافة عنصر للقاموس
-filled_dict.update({"four":4}) # => {"one": 1, "two": 2, "three": 3, "four": 4}
-filled_dict["four"] = 4 # طريقة أخرى للإضافة
-
-# مسح المفاتيح من القاموس باستخدام del
-del filled_dict["one"] # Removes the key "one" from filled dict
-
-# من بايثون 3.5 فما فوق يمكنك أيضا استخدام خيارات تفريغ إضافية
-{'a': 1, **{'b': 2}} # => {'a': 1, 'b': 2}
-{'a': 1, **{'a': 2}} # => {'a': 2}
-
-
-# المجموعات تُخزن .. مجموعات
-empty_set = set()
-# .تهيئة مجموعة بمجموعة قيم. نعم، تشبه قليلا تهيئة القاموس. أسف
-some_set = {1, 1, 2, 2, 3, 4} # some_set is now {1, 2, 3, 4}
-
-# مثل مفتاح القاموس، عناصر المجموعة يجب أن تكون غير قابلة للتغيير.
-invalid_set = {[1], 1} # => يعرض خطأ TypeError: unhashable type: 'list'
-valid_set = {(1,), 1}
-
-# إضافة عنصر أخر للمجموعة
-filled_set = some_set
-filled_set.add(5) # filled_set is now {1, 2, 3, 4, 5}
-# المجموعات لا يمكن أن تحتوي على عناصر مكررة
-filled_set.add(5) # it remains as before {1, 2, 3, 4, 5}
-
-# تقاطع مجموعتين باستخدام &
-other_set = {3, 4, 5, 6}
-filled_set & other_set # => {3, 4, 5}
-
-# اتحاد مجموعتين باستخدام |
-filled_set | other_set # => {1, 2, 3, 4, 5, 6}
-
-# الفرق بين مجموعتين باستخدام -
-{1, 2, 3, 4} - {2, 3, 5} # => {1, 4}
-
-# الفروق بين مجموعتين باستخدام ^
-{1, 2, 3, 4} ^ {2, 3, 5} # => {1, 4, 5}
-
-# لفحص هل المجموعة على اليسار مجموعة عُليا للمجموعة على اليمين (تحتوي على كل عناصرها)
-{1, 2} >= {1, 2, 3} # => False
-
-# لفحص هل المجموعة على اليسار مجموعة فرعية من المجموعة على اليمين
-{1, 2} <= {1, 2, 3} # => True
-
-# للتأكد من وجود عن في مجموعة استخدم in
-2 in filled_set # => True
-10 in filled_set # => False
-
-
-
-####################################################
-## 3. مسار التحكم والعمليات التكرارية #Control Flow and Iterables
-####################################################
-
-# هيا ننشيء متغير
-some_var = 5
-
-# الأن الأمر if. الفجوات (المسافات قبل الأوامر) مهمة في البايثون!
-# العُرف استخدام أربع مسافات. ليس تبويب.
-# هذا السطر البرمجي يطبع "some_var is smaller than 10"
-if some_var > 10:
- print("some_var is totally bigger than 10.")
-elif some_var < 10: # This elif clause is optional.
- print("some_var is smaller than 10.")
-else: # This is optional too.
- print("some_var is indeed 10.")
-
-
-"""
-For عبارة عن حلقات تدور حول عناصر قوائم
-:ثم تطبع
- dog is a mammal
- cat is a mammal
- mouse is a mammal
-"""
-for animal in ["dog", "cat", "mouse"]:
- # يمكنك استخدام format() لترجمة كلمات بشكل معين.
- print("{} is a mammal".format(animal))
-
-"""
-"range(number)" يقوم بإعادة مجموعة من الأرقام يمكن الدوران حولها
-من الصفر إلي رقم معين
-ثم يطبع:
- 0
- 1
- 2
- 3
-"""
-
-for i in range(4):
- print(i)
-
-"""
-"range(lower, upper)" يقوم بإعادة مجموعة من الأرقام يمكن الدوران حولها من القيمة السُفلى
-lower حتى القيمة العُليا upper
-ثم يطبع:
- 4
- 5
- 6
- 7
-"""
-for i in range(4, 8):
- print(i)
-
-"""
-"range(lower, upper, step)" يقوم بإعادة مجموعة من الأرقام يمكن الدوران حولها من القيمة السُفلى
-lower حتى القيمة العُليا upper، ثم يقوم بالزيادة قيمة الstep.
-إذا لم تُحدد ال step, القيمة الأفتراضية 1.
-ثم يطبع:
- 4
- 6
-"""
-for i in range(4, 8, 2):
- print(i)
-
-"""
-While هي عبارة عن حلقات تدور حتى عدم تحقق شرط معين.
-وتطبع:
- 0
- 1
- 2
- 3
-"""
-x = 0 for
-while x < 4:
- print(x)
- x += 1 # اختصار ل x = x + 1
-
-# يمكنك التحكم في الأخطاء والاستثناءات باستخدام مجموعة try/except
-try:
- # استخدم "raise" لرفع خطأ.
- raise IndexError("This is an index error")
-except IndexError as e:
- pass # Pass: هو مجرد أمر ﻻ تفعل شيء. عادة تقوم بتصحيح الخطأ هنا.
-except (TypeError, NameError):
- pass # يمكنك التحكم في أكثر من خطأ في نفس الوقت، إذا أقتضت الضرورة
-else: # فقرة اختيارية في مجموعة try/except. يجب أن يتبع جميع مجموعات معارضة الأخطاء
- print("All good!") # تُنفذ في حالة أن السطور البرمجية داخل ال try لم ترفع أي خطأ
-finally: # تُنفذ في كل الحالات
- print("We can clean up resources here")
-
-# بدلا من مجموعة try/finally لتنظيف الموارد يمكنك استخدام سطر with
-with open("myfile.txt") as f:
- for line in f:
- print(line)
-
-# يتيح البايثون تجريد أساسي يسمى المُكرَر.
-# المُكرٍَر عبارة عن متغير يمكن التعامل معه كسلسلة.
-# الكائن الذي يعود من دالة نطاق، يسمى المُكرَر.
-
-filled_dict = {"one": 1, "two": 2, "three": 3}
-our_iterable = filled_dict.keys()
-print(our_iterable) # => dict_keys(['one', 'two', 'three'])
-# هذا عبارة عن متغير يعرض عناصر مفاتيح المُكرَر.
-
-# يمكننا الدوران حوله.
-for i in our_iterable:
- print(i) # Prints one, two, three
-
-# مع ذلك ﻻ يمكننا الوصول للعناصر بالمؤشر.
-our_iterable[1] # يرفع خطأ TypeError
-
-# المُكرَر هو عبارة عن عنصر يعلم كيفية إنشاء مُكرِر
-our_iterator = iter(our_iterable)
-
-# المُكرِر هو عبارة عن عنصر يمكنه تذكر الحالة أثناء مرورنا بعناصره.
-# يمكننا الحصول على العنصر التالي عن طريق "next()"
-next(our_iterator) # => "one"
-
-# يحفظ الحالة أثناء الدوران.
-next(our_iterator) # => "two"
-next(our_iterator) # => "three"
-
-# بعد عرض المُكرِر كل عناصره، يرفع استثناء StopIteration
-next(our_iterator) # يرفع StopIteration
-
-# يمكنك الحصول على كل عناصر المُكرر بمناداة دالة list() عليه.
-list(filled_dict.keys()) # => Returns ["one", "two", "three"]
-
-
-####################################################
-## 4. الدوال
-####################################################
-
-# إستخدم "def" لإنشاء دوال جديدة.
-def add(x, y):
- print("x is {} and y is {}".format(x, y))
- return x + y # يمكنك إرجاع قيمة من الدالة بسطر return
-
-# مناداة دوال بمعطيات
-add(5, 6) # => prints out "x is 5 and y is 6" and returns 11
-
-# طريقة أخرى لمناداة دوال باستخدام كلمات مفتاحية.
-add(y=6, x=5) # الكلمة المفتاحية يمكن أن تُعطى بأي ترتيب.
-
-# يمكنك تعريف دوال تأخذ عدد متغير من المُعطيات
-
-def varargs(*args):
- return args
-
-varargs(1, 2, 3) # => (1, 2, 3)
-
-# يمكنك تعريف دوال تأخذ عدد متغير من الكلمات المفتاحية كمعطيات أيضا.
-def keyword_args(**kwargs):
- return kwargs
-
-# هيا ننادي على الدالة لنرى ماذا سيحدث
-keyword_args(big="foot", loch="ness") # => {"big": "foot", "loch": "ness"}
-
-
-# يمكنك فعل الأثنين معًا في نفس الوقت، إذا أردت
-def all_the_args(*args, **kwargs):
- print(args)
- print(kwargs)
-"""
-all_the_args(1, 2, a=3, b=4) prints:
- (1, 2)
- {"a": 3, "b": 4}
-"""
-
-# عندما تنادي على دوال، يمكنك عمل عكس المعطيات/المفاتيح!
-# استخدم * لتوسعة الصفوف، واستخدم ** لتوسعة المفاتيح.
-args = (1, 2, 3, 4)
-kwargs = {"a": 3, "b": 4}
-all_the_args(*args) # مساوٍ ل all_the_args(1, 2, 3, 4)
-all_the_args(**kwargs) # مساوٍ ل to all_the_args(a=3, b=4)
-all_the_args(*args, **kwargs) # مساوٍ ل to all_the_args(1, 2, 3, 4, a=3, b=4)
-
-# يقوم بإعادة مجموعة من القيم (بتعيين الصفوف)
-def swap(x, y):
- return y, x # يقوم بإعادة مجموعة من القيم على شكل صفوف بدون الأقواس
- # (لاحظ: الأقواس حُذفت لكن يمكن إضافتها)
-
-x = 1
-y = 2
-x, y = swap(x, y) # => x = 2, y = 1
-# (x, y) = swap(x,y) # مرة أخرى الأقواس حُذفت لكن يمكن إضافتها.
-
-# مجال الدالة
-x = 5
-
-def set_x(num):
- # المتغير المحلي x ليس هو المتغير العام x
- x = num # => 43
- print(x) # => 43
-
-def set_global_x(num):
- global x
- print(x) # => 5
- x = num #المتغير العام x الأن مساوٍ ل 6
- print(x) # => 6
-
-set_x(43)
-set_global_x(6)
-
-
-# بايثون تدعم دوال الفئة أولية [first class functions] (أي أنه يمكن إرسال الدوال كمعطيات لدوال أخرى)
-def create_adder(x):
- def adder(y):
- return x + y
- return adder
-
-add_10 = create_adder(10)
-add_10(3) # => 13
-
-# يوجد أيضا دوال مجهولة
-(lambda x: x > 2)(3) # => True
-(lambda x, y: x ** 2 + y ** 2)(2, 1) # => 5
-
-# يوجد دوال مدمجة من درجة أعلى
-list(map(add_10, [1, 2, 3])) # => [11, 12, 13]
-list(map(max, [1, 2, 3], [4, 2, 1])) # => [4, 2, 3]
-
-list(filter(lambda x: x > 5, [3, 4, 5, 6, 7])) # => [6, 7]
-
-# يمكن إشتمال القوائم على خرائط وفلاتر حسنة الشكل
-# هذه القوائم تحفظ المُخرج كقائمة والتي بدورها يمكن أن تكون قائمة مداخلة
-[add_10(i) for i in [1, 2, 3]] # => [11, 12, 13]
-[x for x in [3, 4, 5, 6, 7] if x > 5] # => [6, 7]
-
-# يمكنك بناء مجموعات وقواميس على هذا المنوال أيضا
-{x for x in 'abcddeef' if x not in 'abc'} # => {'d', 'e', 'f'}
-{x: x**2 for x in range(5)} # => {0: 0, 1: 1, 2: 4, 3: 9, 4: 16}
-
-
-####################################################
-## 5. الوحدات البرمجية (الموديولات)
-####################################################
-
-# يمكنك استدعاء موديولات
-import math
-print(math.sqrt(16)) # => 4.0
-
-# يمكنك استدعاء دالة معينة من موديول
-from math import ceil, floor
-print(ceil(3.7)) # => 4.0
-print(floor(3.7)) # => 3.0
-
-# يمكنك استدعاء كل الدوال من مديول.
-# تحذير: هذا الفعل غير موصى به
-from math import *
-
-# يمكنك تصغير اسم موديول
-import math as m
-math.sqrt(16) == m.sqrt(16) # => True
-
-# موديولات البايثون عبارة عن ملفات بايثون عادية.
-# يمكنك كتابة الموديولات الخاصة بك, واستدعاها.
-# اسم الموديول يكون نفس اسم الملف.
-
-# يمكنك معرفة أي الدوال والصفات مُعرفة في الموديول.
-import math
-dir(math)
-
-# إذا كان لديك سكربت بايثون يسمى math.py
-# في نفس المجلد الموجود به السكربت الخاص بك، الملف الخاص بك math.py
-# سَيُستدعى بدلا من موديول البايثون بنفس الاسم
-# هذا يحدث لأن المجلدات المحلية لديها أولوية عن مكتبات البايثون المُدمجة
-
-
-####################################################
-## 6. الفئات/القوالب (الكلاسات)
-####################################################
-
-# نستخدم السطر البرمجي "class" لإنشاء قالب
-class Human:
-
- # صفة القالب. مشتركة بين كل نسخ القالب
- species = "H. sapiens"
-
- # مُهيئ إبتدائي، يُنادى عليه عندما يتم استدعاء القالب.
- # لاحظ أن الشرطة السٌفلية المُكررة مرتين __ قبل وبعد الاسم تُعبر عن الكائنات
- # أو الصفات المُستخدمة عن طريق بايثون لكنها تعيش في مساحة تحكم المُستخدم.
- # العمليات -الدوال- (أو الكائنات أو الصفات) مثل: __init__, __str__,__repr__ ألخ.
- # تُسمى عمليات خاصة (أو أحيانا تسمى عمليات سحرية أو dunder methods)
- # يجب عليك ألا تُسمي مثل هذه الاسماء بنفسك.
- def __init__(self, name):
- # ساوِ المُعطى بالصفة name الخاصة بهذه النسخة من القالب.
- self.name = name
-
- # هيئ الصفة
- self._age = 0
-
- # عملية/دالة خاصة بنسخة القالب. كل العمليات تأخذ "self" كأول مُعطى
- # An instance method. All methods take "self" as the first argument
- def say(self, msg):
- print("{name}: {message}".format(name=self.name, message=msg))
-
- # عملية أخرى خاصة بنسخة القالب.
- def sing(self):
- return 'yo... yo... microphone check... one two... one two...'
-
- # عمليات القالب مشتركة بين كل أجزاء القالب
- # يتم مناداتهم عن طريق جعل القالب المُنادي أول معطى
- # They are called with the calling class as the first argument
- @classmethod
- def get_species(cls):
- return cls.species
-
- # تُنادى العملية الثابتة بدون قالب أو نسخة قالب
- @staticmethod
- def grunt():
- return "*grunt*"
-
- # الخاصية تشبه تماما إمر الطلب
- # تُحَوِل العملية age() إلي صفة مقروءة فقط بنفس الاسم.
- # ﻻ حاجة لكتابة أوامر طلب أو تهيئة
- @property
- def age(self):
- return self._age
-
- # هذا يتيح تهيئة الخاصية
- @age.setter
- def age(self, age):
- self._age = age
-
- # هذا يتيح حذف الخاصية
- @age.deleter
- def age(self):
- del self._age
-
-
-# عندما يقرأ مُترجم البايثون ملف مصدري يقوم بتنفيذ كل الكود.
-# فحص ال __name__ يجعل هذا الجزء من الكود يُنَفَذ فقط
-# في حالة أن هذا الموديول هو البرنامج الرئيسي
-if __name__ == '__main__':
- # Instantiate a class
- i = Human(name="Ian")
- i.say("hi") # "Ian: hi"
- j = Human("Joel")
- j.say("hello") # "Joel: hello"
- # i و j نُسخ من النوع Human, أول بكلمات أخرى: هما كائنات للقالب Human
-
- # نادي على عملية القالب
- i.say(i.get_species()) # "Ian: H. sapiens"
- # عدل الخاصية المُشتركة
- Human.species = "H. neanderthalensis"
- i.say(i.get_species()) # => "Ian: H. neanderthalensis"
- j.say(j.get_species()) # => "Joel: H. neanderthalensis"
-
- # نادي على العملية الثابتة
- print(Human.grunt()) # => "*grunt*"
-
- # لا يمكن مناداة العملية الثابتة من نسخة الكائن
- # لأن i.grunt() سيقوم تلقائيا بوضع "self" (الكائن i) كمُعطى للعملية
- print(i.grunt()) # => TypeError: grunt() takes 0 positional arguments but 1 was given
-
- # حدًث الخاصية لهذه النسخة
- i.age = 42
- # أحصل على الخاصية
- i.say(i.age) # => "Ian: 42"
- j.say(j.age) # => "Joel: 0"
- # إحذف الخاصية
- del i.age
- # i.age # => سوف يرفع استثناء AttributeError
-
-
-####################################################
-## 6.1 الإرث
-####################################################
-
-# الإرث يتيح لقالب ابن أن يُعَرف ويرث بعض عمليات/دوال ومتغيرات القالب الأب.
-
-# باستخدام القالب Human المُعَرف بالأعلى كأساس أو كقالب أب،
-# يمكننا تعريف قالب ابن،Superhero ، يرث متغيرات القالب مثل "species", "name", و "age"،
-# وأيضا العمليات، مثل "sing", "grunt"
-# من القالب Human، لكنه أيضا لديه خواصه الفريدة
-
-# للاستفادة من التقطيع بالملف يمكنك وضع القوالب بالأعلى في ملفاتهم الخاصة،
-# مثلا، human.py
-
-# لاستيراد دالة من ملف أخر استخدم الطريقة التالية
-# from "اسم الملف بدون مُلحق" import "اسم الدالة أو القالب"
-
-from human import Human
-
-# حدد القالب/ات الأب كمُعطى أثناء تعريف القالب.
-class Superhero(Human):
-
- # إذا أردت أن يرث القالب الابن كل تعريفات القالب الأب بدون تعديل
- # يمكنك استخدام الكلمة المفتاحية "pass" (بدون شيء أخر)
- # لكن في هذه الحالة تم أهمالها لإنشاء قالب ابن فريد:
- # pass
-
- # القوالب الابن يمكنها تعديل صفات القوالب الأب
- species = 'Superhuman'
-
- # القوالب الابن ترث تلقائيا عمليات الإنشاء الخاصة بالقالب الأب بالإضافة إلي مُعطياتهم
- # لكن يمكن أيضا تعريف مُعطيات إضافية أو تعريفات
- # وتعديل العمليات مثل منشيء القالب.
- # هذا المُنشيء يرث المُعطى "name" من القالب "Human"
- # ويضيف المعطيات"superpower" و "movies":
- def __init__(self, name, movie=False,
- superpowers=["super strength", "bulletproofing"]):
-
- # إضافة صفة جديدة للقالب
- self.fictional = True
- self.movie = movie
- # كن على علم بالقيم الافتراضية المتغيرة، حيث أن القيم الافتراضية تُشارك
- self.superpowers = superpowers
-
- # الدالة "super" تتيح لك الوصول لعمليات القالب الأب
- # التي تم تغييرها عن طريق الابن، في هذه الحالة، العملية __init__<
- # هذا السطر يُنادي على منشيء القالب الأب.
- super().__init__(name)
-
- # تعديل العملية sing
- def sing(self):
- return 'Dun, dun, DUN!'
-
- # إضافة عملية جديدة للنسخة
- def boast(self):
- for power in self.superpowers:
- print("I wield the power of {pow}!".format(pow=power))
-
-
-if __name__ == '__main__':
- sup = Superhero(name="Tick")
-
- # فحص نوع النسخة
- if isinstance(sup, Human):
- print('I am human')
- if type(sup) is Superhero:
- print('I am a superhero')
-
- # إحصل على ترتيب قرار البحث للعملية (Method Resolution search Order) المُستخدمة بواسطة العمليات getattr() و super()
- # هذه الصفة ديناميكية ويمكن أن تُحَدًث.
- print(Superhero.__mro__) # => (<class '__main__.Superhero'>,
- # => <class 'human.Human'>, <class 'object'>)
-
- # نادي العملية الأب لكن استخدم صفات القالب الخاص بها.
- print(sup.get_species()) # => Superhuman
-
- # نادي العملية المُعدلة.
- print(sup.sing()) # => Dun, dun, DUN!
-
- # نادي العملية من القالب Human
- sup.say('Spoon') # => Tick: Spoon
-
- # نادي عملية موجودة فقط في Superhero
- sup.boast() # => I wield the power of super strength!
- # => I wield the power of bulletproofing!
-
- # وَرَثَ صفات القالب
- sup.age = 31
- print(sup.age) # => 31
-
- # صفة موجودة فقط في القالب Superhero
- print('Am I Oscar eligible? ' + str(sup.movie))
-
-####################################################
-## 6.2 الإرث المُتعدد
-####################################################
-
-# تعريف قالب أخرA
-# bat.py
-class Bat:
-
- species = 'Baty'
-
- def __init__(self, can_fly=True):
- self.fly = can_fly
-
- # هذا القالب لديه عملية تسمى say
- def say(self, msg):
- msg = '... ... ...'
- return msg
-
- # ولديه عمليته الخاصة به أيضا
- def sonar(self):
- return '))) ... ((('
-
-if __name__ == '__main__':
- b = Bat()
- print(b.say('hello'))
- print(b.fly)
-
-# تعريف قالب أخر يرث من Superhero و Bat
-# superhero.py
-from superhero import Superhero
-from bat import Bat
-
-# عَرٍف Batman كقالب ابن يرث من كلا من Superhero و Bat
-class Batman(Superhero, Bat):
-
- def __init__(self, *args, **kwargs):
- # عادة لكي ترث صفة يجد أن تنادي على super:
- # super(Batman, self).__init__(*args, **kwargs)
- # لكننا في هذه الحالة نتعامل مع إرث متعدد هنا، و super()
- # تعمل فقط مع القالب التالي في قائمة ال MRO.
- # لذا بدلا من ذلك ننادي على __init__ صراحة لكل الأباء.
- # استخدام *args و **kwargs يتيح طريقة نظيفة لتمرير المعطيات.
- # لكل أب "تقشير طبقة من البصل".
- Superhero.__init__(self, 'anonymous', movie=True,
- superpowers=['Wealthy'], *args, **kwargs)
- Bat.__init__(self, *args, can_fly=False, **kwargs)
- # تعديل قيمة الصفة name
- self.name = 'Sad Affleck'
-
- def sing(self):
- return 'nan nan nan nan nan batman!'
-
-
-if __name__ == '__main__':
- sup = Batman()
-
- # إحصل على ترتيب قرار البحث للعملية (Method Resolution search Order) المُستخدمة بواسطة العمليات getattr() و super()
- # هذه الصفة ديناميكية ويمكن أن تُحَدًث.
- print(Batman.__mro__) # => (<class '__main__.Batman'>,
- # => <class 'superhero.Superhero'>,
- # => <class 'human.Human'>,
- # => <class 'bat.Bat'>, <class 'object'>)
-
- # نادي على العملية الخاصة بالأب لكن استخدم الصفات الخاصة بالقالب الابن
- print(sup.get_species()) # => Superhuman
-
- # نادي على العملية المُعدلة
- print(sup.sing()) # => nan nan nan nan nan batman!
-
- # نادي على العملية من القالب Human, لأن الترتيب في الأرث مهم.
- sup.say('I agree') # => Sad Affleck: I agree
-
- # نادي على العملية الموجودة فقط في القالب الأب الثاني
- print(sup.sonar()) # => ))) ... (((
-
- # الصفة الموروثة من القالب الأب
- sup.age = 100
- print(sup.age) # => 100
-
- # الصفة الموروثة من القالب الأب الثاني، الذي تم تعديل قيمته الافتراضية
- print('Can I fly? ' + str(sup.fly)) # => Can I fly? False
-
-
-
-####################################################
-## 7. مُتَقدم
-####################################################
-
-# المولدات تُساعدك على كتابة كود كسول.
-def double_numbers(iterable):
- for i in iterable:
- yield i + i
-
-# المولدات فعالة من حيث الذاكرة، لأنها تُحمٍل الذاكرة بالبيانات التي تحتاج
-# لإجراء العملية عليها في الخطوة التالية في المُكَرِر.
-# هذا يتيح إجراء عمليات على قيم كبيرة ممنوعة في حالات أخرى.
-# ﻻحظ: `range` بديل ل `xrange` في بايثون 3.
-for i in double_numbers(range(1, 900000000)): # `range` is a generator.
- print(i)
- if i >= 30:
- break
-
-# كما يمكنك إنشاء قوائم اشتمال، يمكنك إنشاء مولدات اشتمال أيضا
-values = (-x for x in [1,2,3,4,5])
-for x in values:
- print(x) # prints -1 -2 -3 -4 -5 to console/terminal
-
-# يمكنك أيضا تغيير نوع مولد الاشتمال مباشرة إلي قائمة
-values = (-x for x in [1,2,3,4,5])
-gen_to_list = list(values)
-print(gen_to_list) # => [-1, -2, -3, -4, -5]
-
-
-# المُحسنات
-# في هذا المثال الدالة`beg` تُغلف الدالة `say`.
-# إذا كانت say_please تساوي True
-# إذا ستُغير الرسالة الراجعة من الدالة
-from functools import wraps
-
-def beg(target_function):
- @wraps(target_function)
- def wrapper(*args, **kwargs):
- msg, say_please = target_function(*args, **kwargs)
- if say_please:
- return "{} {}".format(msg, "Please! I am poor :(")
- return msg
-
- return wrapper
-
-
-@beg
-def say(say_please=False):
- msg = "Can you buy me a beer?"
- return msg, say_please
-
-
-print(say()) # Can you buy me a beer?
-print(say(say_please=True)) # Can you buy me a beer? Please! I am poor :(
-```
-
-## جاهز للمزيد?
-
-### مجانا عبر الانترنت
-
-* [أتمتتة المهمات المُملة عبر بايثون](https://automatetheboringstuff.com)
-* [أفكار لمشروعات بلغة البايثون](http://pythonpracticeprojects.com)
-* [التوثيقات الرسمية](http://docs.python.org/3/)
-* [دليل المُسافر لبايثون](http://docs.python-guide.org/en/latest/)
-* [دورة بايثون](http://www.python-course.eu/index.php)
-* [أولى الخطوات مع بايثون](https://realpython.com/learn/python-first-steps/)
-* [قائمة مُختارة من إطارات عمل بايثون الرائعة, المكتبات والبرمجيات](https://github.com/vinta/awesome-python)
-* [ثلاثون خاصية وخدعة للغة البايثون ربما لم تعرف بها](http://sahandsaba.com/thirty-python-language-features-and-tricks-you-may-not-know.html)
-* [الدليل الرسمي لنمط البايثون](https://www.python.org/dev/peps/pep-0008/)
-* [بايثون 3 دوائر علوم الحاسب](http://cscircles.cemc.uwaterloo.ca/)
-* [غُص في بايثون 3](http://www.diveintopython3.net/index.html)
-* [دورة سريعة في البايثون للعلماء](http://nbviewer.jupyter.org/gist/anonymous/5924718)