ورقة مرجعية لـ Python: الصياغة والأوامر والدوال المدمجة في جداول

تجمع هذه الورقة المرجعية لـ Python في صفحة واحدة كل ما تحتاج إلى حفظه في الأشهر الأولى: صياغة Python، والحلقات، والدوال المدمجة، وطرق النصوص والقوائم والقواميس، وأوامر الطرفية. كل جدول مرجع قصير فيه أمثلة عملية يمكنك لصقها مباشرة في REPL.

أساسيات صياغة Python

أهم ما يميز اللغة أن الكتل تُحدَّد بالمسافات البادئة لا بالأقواس. بعد السطر الذي ينتهي بنقطتين (if وfor وdef وclass) تُزاح الأسطر التالية بأربع مسافات. ولا يجوز خلط الجدولة (Tab) بالمسافات، وإلا ستحصل على IndentationError.

أنواع البيانات

العوامل

الشروط والمطابقة

if score >= 90:
    grade = "A"
elif score >= 70:
    grade = "B"
else:
    grade = "C"

status = "بالغ" if age >= 18 else "طفل"   # العامل الشرطي الثلاثي

match command:
    case "start":
        print("تشغيل")
    case "stop" | "exit":
        print("إيقاف")
    case _:
        print("أمر غير معروف")

القيم الخاطئة (False) هي False وNone و0 والنص الفارغ والمجموعات الفارغة، لذلك بدلاً من if len(items) > 0 يُكتب ببساطة if items.

الحلقات في Python: صياغة for وwhile

حلقة for

صياغة حلقة for في Python: for متغير in تسلسل: ثم الجسم بالإزاحة. تمر الحلقة على أي كائن قابل للتكرار: نص أو قائمة أو قاموس أو ملف أو range.

for i in range(5):              # 0 1 2 3 4
    print(i)

for i in range(10, 0, -2):      # 10 8 6 4 2
    print(i)

for i, fruit in enumerate(["تفاحة", "كمثرى"], start=1):
    print(i, fruit)

for name, score in zip(names, scores):
    print(name, score)

for key, value in prices.items():
    print(key, value)

حلقة while

attempts = 3
while attempts > 0:
    password = input("كلمة المرور: ")
    if password == "secret":
        print("تم تسجيل الدخول")
        break
    attempts -= 1
else:
    print("انتهت المحاولات")   # تُنفَّذ إذا لم يحدث break

تعابير الإدراج (comprehensions)

squares = [x ** 2 for x in range(10)]
evens = [x for x in numbers if x % 2 == 0]
lengths = {word: len(word) for word in words}
unique = {c.lower() for c in text}
total = sum(x * x for x in range(100))   # تعبير مولّد

الدوال

def greet(name: str, greeting: str = "مرحباً") -> str:
    """تعيد عبارة الترحيب."""
    return f"{greeting}، {name}!"

def total(*args, **kwargs):
    return sum(args), kwargs

square = lambda x: x * x
print(greet("سارة"))                 # مرحباً، سارة!
print(greet("سارة", greeting="أهلاً"))  # أهلاً، سارة!

لا تستخدم قيمة افتراضية قابلة للتعديل مثل def f(items=[]): فالقائمة تُنشأ مرة واحدة وتتراكم بين الاستدعاءات. الصواب هو items=None ثم داخل الدالة if items is None: items = [].

الدوال المدمجة في Python

الدوال المدمجة في Python متاحة دون استيراد. وهذه أهم الدوال التي تظهر في تقريباً كل سكربت.

أفضل مرجع دائماً في متناولك هو الدالة help() في REPL: فـ help(dict) تعرض كل طرق القاموس مع وصف، وdir(obj) تعرض قائمة الأسماء المتاحة.

طرق النصوص

صياغة النصوص في Python: النص غير قابل للتعديل، وكل طريقة تعيد نصاً جديداً. والتقطيع يعمل كما في القوائم: s[1:4]، وs[::-1] لعكس النص.

أوامر القائمة في Python

القائمة مجموعة مرتبة قابلة للتعديل. معظم طرقها تغيّر القائمة في مكانها وتعيد None، لذلك فـ a = a.sort() خطأ شائع.

أوامر القاموس في Python

الصفوف والمجموعات (sets)

الاستثناءات والملفات

try:
    number = int(input("رقم: "))
except ValueError as err:
    print("هذا ليس رقماً:", err)
else:
    print("نجاح")
finally:
    print("يُنفَّذ دائماً")

with open("data.txt", "w", encoding="utf-8") as f:
    f.write("سطر\n")

with open("data.txt", encoding="utf-8") as f:
    for line in f:
        print(line.rstrip())

الأصناف

from dataclasses import dataclass

class Dog:
    def __init__(self, name: str):
        self.name = name

    def bark(self) -> str:
        return f"{self.name}: هاو!"

@dataclass
class Point:
    x: float
    y: float

print(Dog("ريكس").bark())   # ريكس: هاو!
print(Point(1, 2))           # Point(x=1, y=2)

الوحدات المدمجة في Python

تأتي المكتبة القياسية مع المفسِّر، ويكفي import لاستخدامها.

ظهر في Python 3.15 الاستيراد الكسول (PEP 810): فالأمر lazy import pandas as pd يؤجل تحميل الوحدة حتى أول استخدام لها، فيبدأ السكربت الذي فيه مكتبات ثقيلة أسرع بوضوح.

أوامر Python في الطرفية

مجموعة من الأوامر تُطلب كثيراً بعبارة «أوامر python»: وهي أوامر تشغيل المفسِّر وتثبيت المكتبات. وعلى Windows يُكتب عادةً python أو py بدلاً من python3.

أخطاء شائعة للمبتدئين

• المقارنة بـ = — في الشرط يلزم ==؛ أما الرمز المفرد = فهو تعيين.
• نسيان النقطتين بعد if وfor وdef يسبب SyntaxError.
• جمع نص مع رقم: "العمر: " + 25 خطأ، اكتب f"العمر: {25}".
• تعديل القائمة أثناء المرور عليها — مرّ على نسخة for x in a[:] أو اجمع قائمة جديدة.
• input() يعيد نصاً — لإجراء حساب لفّه بـ int() أو float().

الخلاصة

صياغة Python تقوم على المسافات البادئة والنقطتين ومجموعة صغيرة من البنى: الشروط، والحلقات for وwhile، والدوال، والأصناف. أضف إليها عشرين دالة مدمجة وطرق النصوص والقوائم والقواميس، فتغطي معظم المهام اليومية. احفظ الورقة، وحين تصبح الجداول مألوفة انتقل إلى الوحدات وغير المتزامن؛ وكل ذلك مشروح خطوة بخطوة عملياً في دورة «Python 3.15: من المبتدئ إلى المحترف».