شرح درس المكتبات البرمجية ثالث متوسط الفصل الأول
المكتبة البرمجية ملف جاهز يحتوي على دوال مفيدة نستوردها إلى برنامجنا بالأمر import فنستخدمها دون أن نكتبها من جديد.

أهداف الدرس
- يوضح معنى المكتبة والوحدة (module) في بايثون وفائدتهما.
- يستورد المكتبات بالصيغ import وfrom ... import وas.
- يستخدم دوال مكتبة math ومكتبة random في برامج بسيطة.
- يتعرف على مكتبة datetime وفكرة التثبيت بالأمر pip.
- يبني لعبة تخمين رقم باستخدام مكتبة random.
المفهوم الأساسي
المكتبة البرمجية ملف جاهز يحتوي على دوال مفيدة نستوردها إلى برنامجنا بالأمر import فنستخدمها دون أن نكتبها من جديد.
شرح الدرس
عندما تريد حساب الجذر التربيعي لعدد، هل تكتب خطوات الحساب بنفسك؟ بايثون توفر مكتبات جاهزة كتبها مبرمجون من قبل، وكل ما نفعله أن نستدعيها في برنامجنا.
ما المكتبة؟ وكيف نستوردها؟
الوحدة (module) ملف يحتوي على دوال وقيم جاهزة، والمكتبة (library) مجموعة من هذه الوحدات. نستورد ما نحتاجه في أول البرنامج بإحدى ثلاث صيغ.
import math
from math import sqrt
import math as m
print(math.sqrt(16))
print(sqrt(25))
print(m.sqrt(36))4.0
5.0
6.0- import math: نستورد المكتبة كاملة ونكتب اسمها قبل كل دالة مثل math.sqrt.
- from math import sqrt: نستورد دالة واحدة ونستخدمها باسمها مباشرة.
- import math as m: نعطي المكتبة اسمًا مختصرًا نكتبه بدلًا من اسمها الطويل.
«نستورد المكتبة مرة واحدة في أول البرنامج»
مكتبة math
تحتوي مكتبة math على الدوال الرياضية والقيمة الثابتة pi. لاحظ أن sqrt وpow ترجعان عددًا عشريًّا دائمًا.
import math
print(math.sqrt(49))
print(math.pi)
print(math.ceil(4.2))
print(math.floor(4.8))
print(math.pow(2, 3))7.0
3.141592653589793
5
4
8.0- sqrt: ترجع الجذر التربيعي للعدد.
- pi: قيمة ثابتة تقارب النسبة بين محيط الدائرة وقطرها.
- ceil: تقرّب العدد إلى أصغر عدد صحيح أكبر منه أو يساويه.
- floor: تقرّب العدد إلى أكبر عدد صحيح أصغر منه أو يساويه.
- pow: ترفع العدد الأول إلى قوة العدد الثاني.
لحساب مساحة دائرة نصف قطرها r نكتب math.pi * r ** 2.
مكتبة random
تعطينا مكتبة random أرقامًا واختيارات عشوائية، ولذلك يتغير الناتج في كل مرة نشغّل فيها البرنامج. الناتج المكتوب هنا مثال على ناتج فقط وقد يختلف عندك.
import random
names = ["سالم", "فهد", "نايف", "ماجد"]
print(random.randint(1, 6))
print(random.choice(names))
random.shuffle(names)
print(names)4
نايف
['ماجد', 'سالم', 'نايف', 'فهد']- randint(a, b): ترجع عددًا صحيحًا عشوائيًّا بين a وb ويدخل الطرفان.
- choice: تختار عنصرًا واحدًا عشوائيًّا من القائمة.
- shuffle: تخلط ترتيب عناصر القائمة نفسها.
لا تسمِّ ملفك random.py أو math.py لأن بايثون ستستورد ملفك بدلًا من المكتبة.
مكتبة datetime والأمر pip
تتعامل مكتبة datetime مع التواريخ والأوقات. في المثال التالي نحسب عدد الأيام بين بداية الشهر واليوم الوطني.
from datetime import date
national_day = date(2026, 9, 23)
start = date(2026, 9, 1)
print(national_day.year)
print(national_day.month)
print(national_day.day)
print(national_day.strftime("%d/%m/%Y"))
print((national_day - start).days)2026
9
23
23/09/2026
22أما الدالة date.today() فترجع تاريخ اليوم الحالي، ولذلك يختلف ناتجها من يوم إلى آخر.
المكتبات التي لا تأتي مع بايثون نثبتها بأداة تسمى pip من سطر الأوامر، مثل الأمر pip install requests. نثبّت المكتبات الخارجية من مصادرها الرسمية فقط وبعلم المعلم.
مشروع: لعبة تخمين الرقم
يختار البرنامج رقمًا سريًّا من 1 إلى 20، ويطلب من اللاعب أن يخمّنه، ويرشده في كل محاولة إلى أن يصيب.
import random
secret = random.randint(1, 20)
tries = 0
while True:
guess = int(input("خمّن الرقم من 1 إلى 20: "))
tries = tries + 1
if guess == secret:
print("أحسنت! عدد المحاولات:", tries)
break
elif guess < secret:
print("الرقم أكبر")
else:
print("الرقم أصغر")وهذا مثال على تشغيل اللعبة عندما كان الرقم السري 14:
خمّن الرقم من 1 إلى 20: 10
الرقم أكبر
خمّن الرقم من 1 إلى 20: 17
الرقم أصغر
خمّن الرقم من 1 إلى 20: 14
أحسنت! عدد المحاولات: 3الحلقة while True لا تتوقف إلا عند تنفيذ الأمر break عند التخمين الصحيح.
نشاط تعليمي
التطبيق الأول
اكتب برنامجًا يطلب من الطالب نصف قطر دائرة ويحسب مساحتها باستخدام math.pi.
r = float(input("نصف القطر: ")) ثم print(math.pi * r ** 2) بعد import math.
أن يستخدم الطالب القيمة pi داخل برنامج.
التدريب الثاني
اكتب برنامجًا يختار اسم طالب عشوائيًّا من قائمة أسماء حلقة التحفيظ ليبدأ الفعالية.
import random ثم print(random.choice(names)) بعد تعريف القائمة names.
أن يوظف الطالب الدالة choice.
المشروع الثالث: عدّل لعبة التخمين لتجعل اللاعب يخسر إذا تجاوزت محاولاته الخمس.
نضيف شرطًا يفحص tries فإذا بلغ 5 ولم يصب اللاعب نطبع رسالة الخسارة وننفذ break.
أن يطوّر الطالب البرنامج بشرط جديد.
ملاحظات مهمة
- 1نكتب أوامر import في أول البرنامج.
- 2الأمر random.randint(1, 6) قد يرجع أي عدد من 1 إلى 6 بما فيهما.
- 3ناتج random يتغير في كل تشغيل فلا نتوقع قيمة محددة.
- 4لا نثبّت مكتبة خارجية إلا من مصدر رسمي وبعلم المعلم.
أخطاء شائعة
- ✗ خطأاستخدام sqrt(16) بعد الأمر import math فقط.✓ الصواب: نكتب math.sqrt(16) أو نستورد الدالة بالأمر from math import sqrt.
- ✗ خطأتسمية الملف random.py.✓ الصواب: نختار اسمًا آخر مثل guess_game.py.
+عرض جميع الأخطاء (3) ←إخفاء الأخطاء الإضافية
- ✗ خطأكتابة random.randint(1) بقيمة واحدة.✓ الصواب: نكتب حدّين هما أصغر عدد وأكبر عدد مثل random.randint(1, 20).
ملخص الدرس
- المكتبة ملفات جاهزة من الدوال نستوردها بالأمر import.
- الصيغ هي import x وfrom x import y وimport x as z.
- مكتبة math فيها sqrt وpi وceil وfloor وpow.
- مكتبة random فيها randint وchoice وshuffle وناتجها يتغير.
- الأداة pip تثبّت المكتبات الخارجية.
هل أتقنت الدرس؟اختبر نفسك من خلال اختبار قصير من عدة أسئلة.