ورقاتورقات تعليمية
تسجيل الدخولإنشاء حساب
درس

شرح درس المكتبات البرمجية ثالث متوسط الفصل الأول

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

المرحلة
المتوسطة
المادة
المهارات الرقمية
وقت القراءة
15 دقائق
الاختبار
متاح

🎯أهداف الدرس

  • يوضح معنى المكتبة والوحدة (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. 1نكتب أوامر ⁦import⁩ في أول البرنامج.
  2. 2الأمر ⁦random.randint(1, 6)⁩ قد يرجع أي عدد من ⁦1⁩ إلى ⁦6⁩ بما فيهما.
  3. 3ناتج ⁦random⁩ يتغير في كل تشغيل فلا نتوقع قيمة محددة.
  4. 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⁩ تثبّت المكتبات الخارجية.

هل أتقنت الدرس؟اختبر نفسك من خلال اختبار قصير من عدة أسئلة.

حزمة الدرس