الوحدات (Modules) والحزم (Packages) في بايثون

python-modules-packages.png

الوحدات Modules
الوحدة مجموعة من شيفرات بايثون (دوال، أصناف…) يُمكن إعادة استخدامها من طرف المبرمج بسهولة، و يُمكن كذلك أن تسمى بالمكتبة.

يُمكن استيراد وحدة في برنامجك باستخدام كلمة import مع إلحاق اسم الوحدة. في المثال التالي نستورد وحدة time المُساعدة في التعامل مع الوقت في لغة بايثون، إذ توفّر دوالًا جاهزة تُمكننا من إجراء عدّة عمليات، كالحصول على الوقت الحالي، وكذلك التاريخ وغير ذلك.

import time
بعد أن قمنا باستيراد وحدة الوقت، يُمكننا الآن الوصول إلى العديد من الدوال والمتغيرات المتواجدة بهذه الوحدة.

يُمكننا مثلا الحصول على تاريخ اليوم والوقت باستدعاء الدالة asctime كالتالي:

>>> import time
>>> time.asctime()
'Fri Apr 8 19:47:35 2016'
يُمكننا كذلك الوصول إلى العديد من الدوال الأخرى المتعلّقة بالوقت، وهذه قائمة ببعض هذه الدوال:

time: الحصول على عدد الثواني التي مرّت منذ يوم 1 يناير 1970، الذي يُسمى توقيت يونكس أو Unix Time.
>>> time.time()
1460139948.733128
sleep: الانتظار لعدد من الثواني قبل تنفيذ أمر معيّن. الأمر التالي سيوقف مُفسّر لغة بايثون عن العمل لخمس ثوان قبل استكمال العمل:
>>> time.sleep(5)
البرنامج التالي سيقوم بالانتظار لمدة ثانية واحدة قبل طباعة كلمة !Hello:

>>> time.sleep(1); print 'Hello!'
يُمكننا كذلك استيراد دالة واحدة أو مجموعة من الدوال فقط دون كامل الوحدة، وذلك باستخدام الجملة from import. مثلا يُمكننا استيراد الدالة asctime بمُفردها بالسّطر التالي:

from time import asctime
لاستدعاء أكثر من دالة، افصل بينها بفواصل.

from time import asctime, sleep
لاستعمال هذه الدوال المُستوردة يكفي استدعاؤها باسمها دون البادئة time.

>>> from time import asctime, sleep
>>> sleep(1)
>>> asctime()
'Fri Apr 8 19:49:25 2016'
الحصول على مساعدة حول الوحدة أو حول دالة من وحدة ما
يُمكنك استعمال سطر الأوامر للحصول على التوثيق الخاص بالوحدة الذي يشرح كل دالة على حدة بتنفيذ الأمر التالي من برنامج الطّرفيّة Terminal:

pydoc time
غيّر time باسم الوحدة التي ترغب بالحصول على توثيق لها.

يُمكن كذلك استخدام الدالة help على بايثون مع تمرير اسم الوحدة أو الدالة التي ترغب في معرفة المزيد عنها:

help('time') # توثيق الوحدة time الكامل
help('time.sleep') # التوثيق الخاص بالدالة sleep
مُخرج السّطر الثاني:

Help on built-in function sleep in time:

time.sleep = sleep(...)
sleep(seconds)

Delay execution for a given number of seconds. The argument may be
a floating point number for subsecond precision