نتائج البحث

تفتح الدالة العنوان المعطى في تبويب جديد (tab) في المتصفّح الافتراضي، إن كان ذلك ممكنًا، وإلّا فإنّ الدالة تكون مكافئة للدالة webbrowser.open_new()‎. البنية العامة webbrowser.open_new_tab(url) المعاملات ‎url العنوان المراد فتحه في المتصفّح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> webbrowser.open_new_tab("http://wiki.hsoub.com") انظر أيضًا الدالة webbrowser.open()‎: تعرض الدالة العنوان المعطى في المتصفّح الافتراضي. الدالة webbrowser.open_new()‎: تفتح الدالة العنوان المعطى في نافذة جديدة في المتصفّح الافتراضي، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون الرسمي.

يضيف التابع صنف معالجة إلى كائن OpenerDirector. البنية العامة OpenerDirector.add_handler(handler) ‎المعاملات ‎يبحث التابع في التوابع التالية وتُضاف إلى سلاسل التوابع المحتملة (لاحظ أنّ أخطاء HTTP تعدّ حالة خاصة). protocol_open()‎: إشارة إلى أنّ المعالج يعرف كيف يفتح عناوين URL الخاصة بالبروتوكول. http_error_type()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج أخطاء HTTP مع شيفرة أخطاء HTTP ‏type. protocol_error()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج أخطاء من بروتوكول (غير http). protocol_request()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج طلبات protocol مسبقًا. protocol_response()‎: ...

تقدم كائنات Counter (العدادات) أداة سريعة ومريحة لإجراء عمليات العدّ والحصول على المجموع. العدّاد هو صنف متفرع من الصنف dict وظيفته عدّ الكائنات القابلة للتقطيع hashable. وهو عبارة عن مجموعة غير مرتّبة تكون فيها العناصر مخزّنة على هيئة مفاتيح قاموس ويخزّن تعداد هذه العناصر كقيم لتلك المفاتيح. يمكن للتعداد أن يكون عددًا صحيحًا وأن يكون صفرًا أو عددًا سالبًا. جدير بالذكر أن الصنف Counter مشابه للـ bags أو multisets في لغات البرمجة الأخرى. البنية العامة ‎class collections.Counter([iterable-or-mapping]) يمكن عدّ العناصر ...

صنف مخلوط mixin class يساعد في عمليات استيثاق HTTP لكلٍّ من المضيف البعيد remote host والوسيط proxy. البنية العامة urllib.request.AbstractDigestAuthHandler(password_mgr=None) المعاملات password_mgr معامل اختياري، ويجب أن تكون قيمته متوافقة مع الصنف HTTPPasswordMgr. راجع قسم كائنات HTTPPasswordMgr للاطلاع على معلومات مفصّلة حول الواجهة التي يجب أن تكون مدعومة. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يحلّل التابع النموذج المعطى ويعيد صنفًا متفرعًا من الصنف Dialect الذي يعكس المعاملات التي عثر عليها التابع. البنية العامة sniff(sample, delimiters=None) المعاملات ‎delimiters معامل اختياري، تُفسّر قيمته كسلسلة نصية تحتوي على المحارف التي يحتمل استخدامها كفواصل في ملف CSV. القيمة المعادة يعيد التابع صنفًا متفرعًا من الصنف Dialect. أمثلة يبين المثال التالي طريقة عمل التابع: with open('example.csv', newline='') as csvfile: dialect = csv.Sniffer().sniff(csvfile.read(1024)) csvfile.seek(0) reader = csv.reader(csvfile, dialect) ...

البنية العامة HTTPPasswordMgrWithPriorAuth.add_password(realm, uri, user, passwd, is_authenticated=False) المعاملات realm, uri, user, passwd هذه المعاملات مشابهة لنظيراتها في التابع HTTPPasswordMgr.add_password()‎. is_authenticated يعين هذا المعامل القيمة الابتدائية للراية is_authenticated لعنوان URI المعطى أو لقائمة عناوين URI المعطاة. في حال تعيين القيمة True للمعامل is_authenticated، سيتجاهل التابع قيمة المعامل realm. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

صنف متفرّع من الصنف الداخلي dict يعيد تعريف override تابع واحد ويضيف متغير نسخة واحدًا قابلًا للكتابة. البنية العامة ‎class collections.defaultdict([default_factory[, ...]]) تعيد الدالة البانية لهذا الصنف كائنًا جديدًا شبيهًا بالقاموس، وdefaultdict هو صنف متفرّع من الصنف الداخلي dict يعيد تعريف override تابع واحد ويضيف متغير نسخة واحدًا قابلًا للكتابة. أما بقية التوابع فهي مماثلة للصنف الرئيسي ولن توثّق هنا. يحدّد المعامل الأول القيمة الابتدائية للخاصية default_factory ويأخذ هذا المعامل القيمة الافتراضية None. أما بقية المعاملات (ومن ضمنها المعاملات المفتاحية) ...

يقدّم هذا الصنف توابع لقراءة الأسئلة عن ملف robots.txt وتحليلها والإجابة عن الأسئلة المتعلّقة بها في عنوان URL المعطى. البنية العامة urllib.robotparser.RobotFileParser(url='') توابع الصنف RobotFileParser يقدّم الصنف RobotFileParser التوابع التالية: التابع set_url(url)‎ يعين التابع عنوان URL الذي يشير إلى ملف robots.txt. التابع read()‎ ‎يقرأ التابع عنوان URL الخاص بملف robots.txt ويرسله إلى المحلّ. التابع parse(lines)‎ يحلّل التابع الأسطر المعطاة في الملف. التابع can_fetch(useragent, url)‎ يعيد التابع القيمة True إن كان مسموحًا لوكيل المستخدم المعطى أن يجلب عنوان URL بالاعتماد على القواعد المضمّنة ...

يعيد التابع سلسلة نصية تمثل التاريخ، وتتضمّن الاسم المختصر لكل من اليوم والشهر يتبعهما اليوم ثم الساعة والدقيقة والثانية ثم السنة. البنية العامة ‎date.ctime() القيمة المعادة يعيد التابع سلسلة نصية تمثل التاريخ. التعبير d.ctime()‎ مكافئ للتعبير time.ctime(time.mktime(d.timetuple()))‎ في المنصّات التي تكون فيها دالة ctime()‎ بلغة C (والتي يستدعيها التابع time.ctime()‎ ولا يستدعيها التابع date.ctime()‎) متوافقة مع معايير لغة C. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.ctime() 'Wed Jun 27 00:00:00 ...

هذه الدالة مشابهة للدالة quote()‎ ولكنّها تستبدل المسافات الفارغة بعلامات +، وهذا هو المطلوب لاقتباس قيم نماذج HTML عند بناء سلاسل الاستعلام النصية التي ستُستخدم في عنوان URL. البنية العامة urllib.parse.quote_plus(string, safe='', encoding=None, errors=None) ‎المعاملات safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. تُهرّب علامات + في السلسلة النصية الأصلية إلا إذا أدرجت كقيمة للمعامل safe. لا يأخذ المعامل safe القيمة الافتراضية '/' كما هو الحال مع الدالة quote()‎. string يمكن أن ...

تعيد الدالة كائن فك الضغط يمكن استخدامه لفك الضغط عن البيانات التي لا يمكن وضعها في الذاكرة دفعة واحدة. البنية العامة zlib.decompressobj(wbits=MAX_WBITS[, zdict]) ‎المعاملات wbits يتحكّم المعامل wbits بحجم ذاكرة تخزين التاريخ history buffer (أو ما يطلق عليه "حجم النافذة window size") المستخدمة في ضغط البيانات، ويتحكّم كذلك فيما إذا كانت مخرجات الدالة تتضمّن ترويسة وتذييلًا. يماثل هذا المعامل ذلك الموصوف في الدالة decompress()‎. zdict يحدّد المعامل zdict قاموس ضغط معرّف مسبقًا. في حال تقديم قيمة لهذا المعامل، فإنّه يجب ...

يطلق هذا التابع افتراضيًا الاستثناء UnpicklingError. البنية العامة persistent_load(pid) المعاملات pid في حال تعريف هذا التابع فإنّه يعيد الكائن المحدّد بواسطة المعرّف المستمر pid، وإذا كان المعرّف المستمّر غير صالحٍ فإنّ التابع يُطلق الاستثناء UnpicklingError. راجع قسم "استمرارية الكائنات الخارجية" في وحدة pickle للاطلاع على المزيد من التفاصيل والأمثلة حول هذا الموضوع. انظر أيضًا التابع Unpickler.persistent_id()‎ : لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. مصادر صفحة DB-API 2.0 interface for ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. البنية العامة itermonthdates(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year، وسيعيد هذا الكائن جميع الأيام (ككائنات datetime.date) للأشهر والأيام كلها قبل بداية الشهر أو بعد نهاية الشهر والتي تكون مطلوبة للحصول على أسبوع كامل. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in cal.itermonthdates(2018, 8): ... ...

تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. البنية العامة marshal.load(file) ‎المعاملات file الملف الذي ستقرأ الدالة منه قيمة واحدة. يجب أن يكون الملف المعطى ملفًّا ثنائيًا قابلًا للقراءة. القيمة المعادة تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. في حال عدم تمكّن الدالة من قراءة أيّ قيمة سليمة (كأن يكون السبب هو أنّ البيانات تمتلك نسخة ترتيب مختلفة وغير متوافقة مع نسخة الترتيب في إصدار بايثون المستخدم) تطلق اللغة الخطأ EOFError أو ValueError أو TypeError. أمثلة يبين المثال التالي ...

يعالج هذا الصنف عملية الاستيثاق مع الوسيط. البنية العامة urllib.request.ProxyDigestAuthHandler(password_mgr=None) المعاملات password_mgr معامل اختياري، ويجب أن تكون قيمته متوافقة مع الصنف HTTPPasswordMgr. راجع قسم كائنات HTTPPasswordMgr للاطلاع على معلومات مفصّلة حول الواجهة التي يجب أن تكون مدعومة. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تختبر الدالة ما إذا كان اختبار السلامة مدعومًا من قبل نظام التشغيل أم لا. البنية العامة lzma.is_check_supported(check) المعاملات ‎check الاختباران CHECK_NONE و CHECK_CRC32 مدعومان دائمًا، أما الاختباران CHECK_CRC64 و CHECK_CRC256 فقد لا يكونان متوفّرين إن كنت تستخدم نسخة من liblzma بنيت مع مجموعة محدّدة من الميزات. القيمة المعادة تعيد الدالة القيمة True إن كان اختبار السلامة مدعومًا من قبل نظام التشغيل. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

يعيد التابع نسخة من كائن الضغط. يمكن استخدام هذا التابع لإجراء عملية ضغط وبكفاءة عالية لمجموعة من البيانات التي تمتلك سابقة prefix مشتركة. البنية العامة Compress.copy() انظر أيضًا التابع Decompress.copy()‎: يعيد التابع نسخة من كائن فك الضغط. مصادر صفحة Compression compatible with gzip في توثيق بايثون الرسمي.

يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601. البنية العامة ‎date.isoformat() القيمة المعادة يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601 وهي 'YYYY-MM-DD'. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.isoformat() '2018-06-27' انظر أيضًا التابع date.isocalendar()‎: يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). التابع date.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد ...

يحدّد التابع مقدار إزاحة الوقت في كائن datetime عن التوقيت العالمي المنسّق. البنية العامة ‎datetime.utcoffset() القيمة المعادة إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.utcoffset(None)‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد. ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقيّدًا بعدد صحيح من الدقائق. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime ...

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح. البنية العامة ‎datetime.weekday() القيمة المعادة يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد الرقم 6. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> d = date(2018, 6, 26, 20, 47) >>> d.weekday() 1 انظر أيضًا التابع datetime.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 1 ويوم الأحد الرقم 7. مصادر قسم datetime Objects ...

تابع صنف classmethod ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. البنية العامة TarInfo.frombuf(buf, encoding, errors) المعاملات buf سلسلة ذاكرة نصية string buffer يستخدمها التابع لإنشاء كائن TarInfo. القيمة المعادة يعيد التابع كائن TarInfo. يطلق التابع الاستثناء HeaderError إن كان ملف الذاكرة غير صالح للاستخدام. انظر أيضًا التابع TarInfo.fromtarfile()‎: تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo. مصادر صفحة Read and write tar archive files في توثيق ...

يفسّر التابع الإعدادات من سلسلة نصية. ملاحظة: هذا التابع جديد في الإصدار 3.2 من بايثون. البنية العامة read_string(string, source='<string>') المعاملات ‎string السلسلة النصية المراد تفسير الإعدادات فيها. source معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name للسلسلة النصية الممرّرة. تُستخدم القيمة '<string>' في حال عدم استخدام هذا المعامل. عادة ما تكون قيمة هذا المعامل مسارًا في ملفات النظام أو عنوان URL. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> sample_config = """ ... [mysqld] ... user = mysql ... ...

يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time()‎. البنية العامة ‎datetime.fromtimestamp(timestamp, tz=None) المعاملات timestamp سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime. tz صنف فرعي من الصنف tzinfo، يحدّد المنطقة الزمنية. يحوّل الختم الزمني إلى التاريخ والوقت المحلّيين في المنصّة ويكون كائن datetime المعاد كائنًا بسيطًا في حال إعطاء القيمة None إلى المعامل الاختياري tz أو في حال عدم تحديد أيّ قيمة له. إن لم يأخذ المعامل tz القيمة None، فيجب ...

تعيد الدالة كائن قراءة مهمّته هي المرور على جميع الأسطر في ملف csv المعطى. البنية العامة csv.reader(csvfile, dialect='excel', **fmtparams) ‎المعاملات csvfile ملف csv المراد قراءة محتوياته، ويمكن أن تكون قيمة هذا المعامل أيّ كائن يدعم بروتوكول المكرِّر iterator protocol ويعيد سلسلة نصية في كلّ مرة يجري فيها استدعاء التابع ‎__next__()‎، وعادة ما تكون كائنات الملفات وكائنات القوائم ملائمة لهذا الغرض. إن كانت قيمة هذا المعامل كائن ملف، فيجب أن يكون مفتوحًا مع المعامل ''newline=‎. ملاحظة: إن لم تحدد القيمة ''newline=‎ ...

هذا التابع من التوابع غير المعيارية والذي يسهل عملية تنفيذ جمل SQL متعددة دفعة واحدة. ينفّذ هذا التابع جملة COMMIT في البداية، ثم ينفّذ بعدها شيفرة SQL المعطاة في المعاملات. البنية العامة executescript(sql_script) ‎المعاملات sql_script يمكن لهذا المعامل أن يكون نسخة من الكائن str. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 con = sqlite3.connect(":memory:") cur = con.cursor() cur.executescript(""" create table person( firstname, lastname, ...

تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎. البنية العامة marshal.dumps(value[, version]) ‎المعاملات value القيمة المطلوبة. version يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت marshal.version). القيمة المعادة تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎. يجب أن تكون القيمة المعطاة مدعومة، وتطلق اللغة الاستثناء ValueError إن كانت القيمة غير مدعومة أو تتضمّن كائنًا غير مدعوم. أمثلة يبين المثال التالي آلية عمل الدالة: >>> ...

تقدّم كائنات الاتصال Connection عددًا من الخصائص والتوابع التي تساعد المستخدم في التعامل مع قواعد بيانات SQLite، كالاتصال بقاعدة البيانات وتحميل الملحقات وإنشاء النسخ الاحتياطية وغيرها. تنشأ كائنات الاتصال كنتيجة لاستدعاء الدالة sqlite3.connect()‎. خصائص كائنات الاتصال تمتلك كائنات الاتصال بقواعد البيانات SQLite الخصائص التالية: الخاصية isolation_level يمكن استخدام هذه الخاصية لمعرفة مستوى العزل الافتراضي الحالي أو تعيينه. تأخذ الخاصية القيمة None لنمط الحفظ التلقائي autocommit أو إحدى القيم "DEFERRED" أو "IMMEDIATE" أو "EXCLUSIVE". راجع قسم التحكم بالإجراءات للمزيد من المعلومات. ...

تتيح وحدة pprint إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات كمدخلات في مفسّر بايثون. وإن تضمنت البنى المنسّقة كائنات ليست من أنواع بايثون الأساسية، فمن الممكن أن يكون تمثيل ذلك الكائن غير قابل للتحميل. تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو الأصناف، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون. يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ...

حذف جميع العناصر من كائن deque ويصبح طول الكائن 0. البنية العامة d.‎clear() أمثلة يبين المثال التالي آلية عمل التابع: >>> from collections import deque >>> d = deque('abcdef') >>> d deque(['a', 'b', 'c', 'd', 'e', 'f']) >>> d.clear() >>> d deque([]) >>> len(d) 0 انظر أيضًا التابع pop()‎:  :يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيمن في الكائن deque. التابع popleft()‎:  :يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيسر في الكائن deque. التابع remove()‎:  :يحذف التابع أوّل عنصر يحمل القيمة المعطاة. مصادر قسم deque Objects في صفحة ...

يحمل هذا التابع إحدى ملحقات SQlite من المكتبة المشتركة. يجب تفعيل خاصية تحميل الملحقات بواسطة التابع enable_load_extension()‎ قبل استخدام هذا التابع. يجدر التنبيه إلى أنّ الملحقات القابلة للتحميل معطّلة بصورة افتراضية، وذلك لأنّ بعض المنصّات (وبالخصوص Mac OS X) تمتلك مكتبات SQLite مصرّفة دون تضمين هذه الميزة. لتفعيل ميزة الملحقات القابلة للتحميل يجب تمرير ‎-enable-loadable-sqlite-extensions إلى الإعدادات. ملاحظة: هذا التابع جديد في الإصدار 3.2. البنية العامة load_extension(path) المعاملات path المسار المؤدي إلى الملحقة المطلوب تحميلها. أمثلة يبين المثال التالي طريقة ...

تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%xx. البنية العامة urllib.parse.quote(string, safe='/', encoding=None, errors=None) ‎المعاملات safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. يحمل هذا المعامل القيمة الافتراضية '/'. string يمكن أن يكون سلسلة نصية أو كائن bytes. ملاحظة: اعتُمد المعيار RFC 3986 عوضًا عن المعيار RFC 2396 لاقتباس سلاسل URL النصية في الإصدار 3.7 من بايثون، وقد أضيف الرمز "~" إلى مجموعة المحارف المحجوزة. encoding و errors ...

تتحقق الدالة ممّا إذا كان ملف ZIP المعطى صالحًا للاستخدام أم لا وذلك بالاستناد إلى العدد السحري magic number الخاص بالملف. البنية العامة zipfile.is_zipfile(filename) ‎ المعاملات filename اسم ملف ZIP المراد التحقّق من صلاحيته للاستخدام. القيمة المعادة تعيد الدالة القيمة True إن كان الملف المعطى ملف ZIP صالحًا للاستخدام وذلك بالاستناد إلى العدد السحري magic number الخاص بالملف، وتعيد الدالة القيمة False إن لم يكن الملف صالحًا للاستخدام. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import zipfile >>> zipfile.is_zipfile('files.zip') True مصادر ...

يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع datetime.isoformat()‎. البنية العامة ‎datetime.fromisoformat(date_string) المعاملات date_string سلسلة نصية تتضمّن التاريخ والوقت المطلوب تحويلهما إلى كائن datetime، وتتبع السلسلة النصية الصيغة: ‎DD[*HH[:MM[:SS[.mmm[mmm]]]][+HH:MM[:SS[.ffffff]]]]‎ ويمكن للرمز * أن يطابق أيّ حرف مفرد. القيمة المعادة كائن datetime يكون التاريخ والوقت فيه موافقين للتاريخ والوقت المعطيين في السلسلة النصية date_string. تنبيه: لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع datetime.isoformat()‎. ملاحظة: ...

يجلب التابع محتويات عنوان URL المعطى ويضعها في الملف المعطى. البنية العامة URLopener.retrieve(url, filename=None, reporthook=None, data=None) ‎المعاملات ‎reporthook معامل اختياري، يجب أن يكون دالة تستقبل ثلاثة معاملات عددية هي: عدد قطعة البيانات chunk، أقصى حجم لقطع البيانات، والحجم الكلي لعملية التحميل (‎-1 إن كان الحجم مجهولًا). تستدعى هذه الدالة مرة واحدة عند بدء عملية قراءة قطعة البيانات وبعد قراءة كلّ قطعة بيانات من الشبكة. يتجاهل التابع المعامل reporthook عند استخدام عناوين URL محلية. ‎data إن استخدم المعامل url المخطط http:‎ ...

تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. البنية العامة copyreg.constructor(object) ‎ المعاملات object الكائن الذي ستصرح الدالة بأنّه دالة بانية صحيحة. القيمة المعادة تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. إن كان الكائن المعطى غير قابل للاستدعاء (وهكذا يكون غير صالح لأن يصبح دالة بانية) فإنّ الدالة تطلق الاستثناء TypeError. انظر أيضًا الدالة copyreg.pickle: تصرّح الدالة عن وجوب استخدام الدالة المعطاة كدالة اختزال reduction function للكائنات من النوع المعطى. مصادر صفحة Register pickle support ...

ملاحظة: هذا التابع مهمل منذ الإصدار 3.2 من بايثون، استخدم التابع read_file()‎ عوضًا عنه. ملاحظة: يمرّ التابع readfp()‎ على عناصر fp عوضًا عن استدعاء التابع fp.readline()‎. البنية العامة readfp(fp, filename=None) إن تضمنت الشيفرة استدعاءات للتابع readfp()‎ مع معاملات لا تدعم التكرار، فيمكن استخدام المولّد التالي لتغليف الكائن الشبيه بالملف: def readline_generator(fp): line = fp.readline() while line: yield line line = ...

تطبع الدالة تقويم الشهر الذي تعيده الدالة month()‎. البنية العامة calendar.prmonth(theyear, themonth, w=0, l=0) المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب (من 1 إلى 12). w معامل اختياري، يأخذ القيمة الافتراضية 0، ويحدّد عرض التقويم الذي ستطبعه الدالة. l معامل اختياري، يأخذ القيمة الافتراضية 0، ويحدّد مقدار الفاصل بين الأسطر في التقويم الذي ستطبعه الدالة. القيمة المعادة تعيد الدالة تقويم الشهر المعطى في السنة المعطاة. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.prmonth(2018, 8, 1, 1) ...

تفكّ الدالة الضغط عن البايتات في البيانات المعطاة، وتعيد كائن bytes يحتوي على البيانات التي أزيل الضغط عنها. البنية العامة zlib.decompress(data, wbits=MAX_WBITS, bufsize=DEF_BUF_SIZE) ‎ المعاملات wbits يعتمد هذا المعامل على صيغة البيانات المعطاة، وسنتحدث عنه بتفصيل أكبر أدناه. يتحكّم المعامل wbits بحجم ذاكرة تخزين التاريخ history buffer (أو ما يطلق عليه "حجم النافذة window size") المستخدمة في ضغط البيانات، ويتحكّم كذلك فيما إذا كانت مخرجات الدالة تتضمّن ترويسة وتذييلًا. هذا المعامل يشبه نظيره في الدالة compressobj()‎ ولكنّه يأخذ نطاقات أكثر ...

يحدّد التابع المهلة المسموحة للاتصالات بالثواني. البنية العامة CacheFTPHandler.setTimeout(t) المعاملات t عدد الثواني التي تمثّل المهلة المسموح بها للاتصالات. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تفتح الدالة العنوان المعطى في نافذة جديدة في المتصفّح الافتراضي، إن كان ذلك ممكنًا، وإلا فإنّها ستفتح العنوان المعطى في النافذة الموجودة فقط. البنية العامة webbrowser.open_new(url) المعاملات ‎url العنوان المراد فتحه في المتصفّح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> webbrowser.open_new("http://wiki.hsoub.com") انظر أيضًا الدالة webbrowser.open()‎: تعرض الدالة العنوان المعطى في المتصفّح الافتراضي. الدالة webbrowser.open_new_tab()‎: تفتح الدالة العنوان المعطى في تبويب جديد (tab) في المتصفّح الافتراضي، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون ...

يحذف التابع القسم المحدّد من ملف الإعدادات. البنية العامة remove_section(section) ‎المعاملات ‎section القسم المراد حذفه من ملف الإعدادات. القيمة المعادة يعيد التابع القيمة True إن كان القسم موجودًا، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.remove_section('bitbucket.org') True >>> config.remove_section('github.com') False انظر أيضًا التابع remove_option()‎: يحذف التابع الخيار المعطى من القسم المحدّد من ملف الإعدادات. مصادر صفحة Configuration file parser في توثيق بايثون الرسمي.

تعدّ هذه الكائنات المفسّر الرئيسي لملفات الإعدادات. البنية العامة configparser.ConfigParser(defaults=None, dict_type=dict, allow_no_value=False, delimiters=('=', ':'), comment_prefixes=('#', ';'), inline_comment_prefixes=None, strict=True, empty_lines_in_values=True, default_section=configparser.DEFAULTSECT, interpolation=BasicInterpolation(), converters={}) المعاملات ‎defaults معامل اختياري، تهيّئ قيمته إلى القاموس الذي يحتوي على القيم الافتراضية الداخلية. dict_type معامل اختياري، يُستخدم في إنشاء كائنات القاموس لقائمة الأقسام، وللخيارات التي ينطوي عليها القسم، وللقيم الافتراضية. delimiters معامل اختياري يُستخدم كمجموعة السلاسل النصية الفرعية التي تقسم المفاتيح عن القيم. comment_prefixes معامل اختياري، يُستخدم كمجموعة السلاسل النصية الفرعية التي تسبق التعليقات التي تكتب في ...

تقدّم وحدة webbrowser واجهة متطوّرة تسمح بعرض مستندات الويب على المستخدمين. في أغلب الحالات يكفي استدعاء الدالة open()‎ ببساطة للقيام بكلّ شيء على نحو سليم. تكون متصفّحات الويب الرسومية graphical browser مفضّلة مع محرّك العرض X11، ولكنّ تستخدم الوحدة المتصفّحات النصية text-mode browsers إن كانت المتصفّحات الرسومية غير متوفّرة، أو كان محرّك العرض X11 غير متاح لاستخدام. وعند استخدام المتصفّحات النصية تتوقّف عملية الاستدعاء إلى حين خروج المستخدم من المتصفّح. إن كان متغيّر البيئة BROWSER موجودًا، فإنّه سيفسّر كقائمة os.pathsep ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ورقم اليوم في الشهر، ورقم اليوم في الأسبوع. البنية العامة monthdatescalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع قائمة بالأسابيع في الشهر month في السنة year كأسابيع كاملة. الأسابيع هي قوائم تتضمّن سبعة كائنات datetime.date. أمثلة يبين المثال التالي آلية عمل التابع: >>> for c in cal.monthdatescalendar(2018, ...

تعرّف هذه الوحدة واجهة معيارية لتقسيم سلاسل محدّد موقع الموارد المحدّد Uniform Resource Locator (‏URL اختصارًا) إلى مكوّنات (نظام العنونة addressing scheme، موقع الشبكة network location، المسار path ... الخ)، ولدمج هذه المكونات مرّة أخرى في سلسلة URL، ولتحويل "URL نسبي" إلى URL مطلق بالاعتماد على "URL أساسي". صمّمت هذه الوحدة لتطابق معايير RFC للإنترنت الخاصّة بالمحدّدات النسبية لمواقع الموارد المحدّدة Relative Uniform Resource Locators. وتدعم الوحدة الأنواع التالية من مخطّطات URL: file, ftp, gopher, hdl, http, https, imap, mailto, ...

تقدّم هذه الوحدة صنفًا مفردًا هو RobotFileParser والذي يحدّد ما إذا كان بإمكان وكيل المستخدم user agent جلب عنوان URL من الموقع الإلكتروني الذي نشر ملف robots.txt. للاطلاع على المزيد من التفاصيل حول بنية ملفات robots.txt يمكن الرجوع إلى http://www.robotstxt.org/orig.html. الصنف urllib.robotparser.RobotFileParser‎ يقدّم هذا الصنف توابع لقراءة الأسئلة عن ملف robots.txt وتحليلها والإجابة عن الأسئلة المتعلّقة بها في عنوان URL المعطى. مصادر صفحة Parser for robots.txt في توثيق بايثون الرسمي.

تضغط الدالة البيانات المعطاة (كائن bytes) وتعيد البيانات المضغوطة على هيئة كائن bytes. البنية العامة lzma.compress(data, format=FORMAT_XZ, check=-1, preset=None, filters=None) المعاملات ‎data البيانات المراد ضغطها. راجع الكائن LZMACompressor للاطلاع على وصف مفصّل للمعاملات format و check و preset و filters. القيمة المعادة تعيد الدالة كائن bytes يتضمّن البيانات المضغوطة. أمثلة يبين المثال التالي طريقة ضغط البيانات في الذاكرة: import lzma data_in = b"Insert Data Here" data_out = lzma.compress(data_in) انظر أيضًا الدالة lzma.decompress()‎: تفكّ الدالة الضغط عن البيانات المعطاة (كائن bytes) وتعيد البيانات ...

يطرح التابع العناصر من الكائن المكرِّر أو من كائن mapping آخر (أو عداد آخر). البنية العامة c.subtract([iterable-or-mapping]) المعاملات iterable أو mapping الكائن المكرِّر أو كائن mapping آخر (أو عداد آخر) الذي ستُطرح منه العناصر. n إن لم يأخذ هذا المعامل أي قيمة أو أخذ القيمة None، فإنّ التابع يعيد جميع العناصر في العداد. وجدير بالذكر أنّه لا يوجد ترتيب معيّن للعناصر التي تمتلك تعدادًا متساويًا. القيمة المعادة يطرح التابع العناصر من الكائن المكرِّر أو من كائن mapping آخر (أو عداد ...

يحدّد التابع ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا recursive. البنية العامة PrettyPrinter.isrecursive(object) القيمة المعادة يعمل هذا التابع كخطّاف hook يسمح للأصناف الفرعية بتعديل طريقة تحويل الكائنات إلى سلاسل نصية، ويعتمد في عمله بصورة افتراضية على الدالة saferepr()‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff) >>> pp = pprint.PrettyPrinter(indent=4) >>> pp.pprint(stuff) [ <Recursion on list with id=140108600272328>, 'spam', 'eggs', ...

يعيد التابع التوجيه إلى عنوان Location:‎ أو URI:‎. يُستدعى هذا التابع بواسطة كائن OpenerDirector الأب عند الحصول على الاستجابة (moved permanently). البنية العامة HTTPRedirectHandler.http_error_301(req, fp, code, msg, hdrs) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تُنشئ هذه الدالة البانية معالج HTTP للطلب المعطى. لا حاجة لإنشاء نسخ من هذا الصنف بصورة مباشرة إذ أنّها تنشأ تلقائيًا حسب حاجة كائنات WSGIServer. ولكن يمكن إنشاء أصناف فرعية من هذا الصنف وتزويدها على هيئة أصناف معالجة handler_class إلى الدالة make_server()‎. البنية العامة wsgiref.simple_server.WSGIRequestHandler(request, client_address, server) ‎المعاملات request الطلب المراد إنشاء معالج HTTP له. client_address عنوان العميل، وهو عبارة عن صفّ بالصيغة (host, port). server نسخة من الصنف WSGIServer. توابع لإعادة تعريف القيم في الأصناف الفرعية get_environ()‎ يعيد التابع ...

لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. البنية العامة persistent_id(obj) إن أعاد هذا التابع القيمة None، فإنّ الكائن يُسلسَل كالمعتاد، أما القيم الأخرى فتسبّب في إطلاق المسلسل Pickler القيمة المعادة كمعرّف مستمر للكائن المعطى. يجب تحديد معنى هذه المعرّف المستمر بواسطة التابع Unpickler.persistent_load()‎. لاحظ أنّه لا يمكن للقيمة التي يعيدها التابع persistent_id()‎ أن تمتلك معرّفًا مستمرًا. راجع قسم "استمرارية الكائنات الخارجية" للاطلاع على المزيد من التفاصيل والأمثلة حول هذا ...

يعرض التابع العنوان المعطى باستخدام المتصفّح الذي يتحكّم فيه هذا المتحكّم. البنية العامة controller.open_new_tab(url) المعاملات url العنوان المراد فتحه بواسطة التابع. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> firefox = webbrowser.get('firefox') >>> firefox.open_new_tab("https://wiki.hsoub.com") انظر أيضًا التابع controller.open()‎: يعرض التابع العنوان المعطى باستخدام المتصفّح الذي يتحكّم فيه هذا المتحكّم. التابع controller.open_new()‎: يفتح التابع العنوان المعطى في نافذة جديدة في المتصفّح الذي يتحكّم به هذا المتحكّم، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون الرسمي.

يعيد التابع البيانات المخزنة في الذاكرة دون التحرّك في موقع الملف. يعيد التابع ما لا يقل عن بايت واحد من البيانات (إلا إذا وصل التابع إلى نهاية الملف)، ويكون عدد البياتات المعادة غير محدّد. البنية العامة peek([n]) المعاملات ‎n معامل اختياري يحدّد عدد البايتات المراد قرائتها. ملاحظات: صحيح أن استدعاء التابع peek()‎‎ لا يؤدي إلى تغيير موقع الملف في كائن BZ2File، إلا أنّه قد يغيّر الموقع في كائن الملف الداخلي (مثال: عند بناء الصنف BZ2File عن طريق تمرير كائن ملف ...

ينفّذ التابع أمر SQL على جميع تسلسلات المعاملات parameter sequences أو الروابط mappings الموجودة في تسلسل المعاملات المعطى. البنية العامة executemany(sql, seq_of_parameters) ‎المعاملات sql سلسلة نصية تتضمن جمل SQL المراد تنفيذها. seq_of_parameters ينفّذ التابع أمر SQL على جميع تسلسلات المعاملات parameter sequences أو الروابط mappings الموجودة في التسلسل seq_of_parameters. تسمح وحدة sqlite3 كذلك باستخدام مكرِّر ينتج معاملات بدلًا عن إنتاج تسلسل. أمثلة يبين المثال التالي طريقة استخدام التابع: import sqlite3 class IterChars: def __init__(self): ...

يحفظ التابع التعديلات التي أجريت على قاعدة البيانات. البنية العامة commit() ‎في حال عدم استدعاء هذا التابع ستكون جميع التعديلات التي أجريت بعد آخر استدعاء للتابع commit()‎ غير مرئية بالنسبة إلى الاتصالات الأخرى المفتوحة مع قاعدة البيانات؛ لذا إن لم تتمكن من رؤية البيانات التي أضفتها إلى قاعدة البيانات، فتأكّد من أنّك لم تنس استدعاء هذا التابع. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c.execute('''CREATE TABLE stocks ...

‎ تفتح الدالة الملف المعطى وتعيد كائنًا موافقًا له. البنية العامة dbm.open(file, flag='r', mode=0o666) المعاملات file إن كان ملف قاعدة البيانات موجودًا أصلًا، فستستخدم الدالة whichdb()‎ لتحديد نوعه والوحدة المناسبة للاستخدام، أما إن لم يكن الملف موجودًا فستستخدم الدالة أول وحدة قابلة للاستيراد من الوحدات dbm.gnu أو dbm.ndbm أو dbm.dumb. flag يأخذ المعامل الاختياري flag إحدى القيم التالية: القيمة الوصف 'r' فتح قاعدة البيانات للقراءة فقط (القيمة الافتراضية). 'w' فتح قاعدة البيانات للكتابة والقراءة. 'c' فتح قاعدة البيانات للكتابة والقراءة، ...

تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. البنية العامة ‎calendar.firstweekday() القيمة المعادة تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.firstweekday() 1 انظر أيضًا الدالة setfirstweekday()‎: تعيّن الدالة اليوم الذي يبدأ به الأسبوع. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

هذا التابع مشابه للتابع dict.update()‎ ولكنّه يضيف التعدادات بدلًا من استبدالها. البنية العامة c.update([iterable-or-mapping]) المعاملات iterable أو mapping الكائن المكرِّر أو كائن mapping آخر (أو عداد آخر) الذي ستُضاف منه العناصر. n إن لم يأخذ هذا المعامل أي قيمة أو أخذ القيمة None، فإنّ التابع يعيد جميع العناصر في العداد. وجدير بالذكر أنّه لا يوجد ترتيب معيّن للعناصر التي تمتلك تعدادًا متساويًا. القيمة المعادة عند استخدام هذا التابع يجري حساب العناصر من كائن مكرِّر أو تضاف من كائن ربط آخر ...

سكربت اختبار CGI، يمكن استخدامه كبرنامج رئيسي. تكتب الدالة ترويسة HTTP مصغّرة وتنسّق جميع المعلومات المقدّمة إلى السكربت في نموذج HTML. البنية العامة cgi.test() مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.

تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر. البنية العامة calendar.monthcalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 1 إلى 12). القيمة المعادة تعيد الدالة قائمة تتضمّن مصفوفة matrix تمثّل تقويم الشهر، ويعبّر كل صفّ row في هذه المصفوفة عن أسبوع واحد، أما الأيام التي تكون خارج نطاق الشهر المحدّد فتأخذ القيمة 0. يبدأ كل أسبوع بيوم الإثنين ما لم تحدّد بداية الأسبوع بواسطة الدالة setfirstweekday()‎. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.monthcalendar(2018, 8) [[0, 1, ...

يمكن الوصول إلى البيانات المرسلة إلى المخدّم عن طريق الصنف FieldStorage، وإن كان النموذج يتضمّن حروفًا بترميز غير ترميز ASCII فيمكن استخدام المعامل المفتاحي encoding لتعيين قيمة الترميز المستخدم في الملف الحاوي على النموذج، ويمكن الوصول إلى الترميز المستخدم عادة في الوسم META في قسم HEAD من ملف HTML أو عن طريق الترويسة Content-Type). يقرأ الصنف محتويات النموذج من المدخلات القياسية أو من البيئة (بالاعتماد على قيمة عدد من متغيرات البيئة والمعيّنة حسب معايير CGI). قد يستهلك الصنف المدخلات القياسية؛ ...

تحوّل الدالة الحروف '&' و '>' و '<' في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف. ملاحظة: هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape()‎ عوضًا عنها. البنية العامة cgi.escape(s, quote=False) المعاملات s السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في HTML. ‎quote معامل اختياري، إن أخذ قيمة صحيحة ...

يحدّد التابع ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا recursive. البنية العامة PrettyPrinter.format(object, context, maxlevels, level) المعاملات object الكائن المراد تمثيله. context قاموس يحتوي على معرّف id()‎ الكائنات التي تمثّل جزءًا من سياق التمثيل الحالي (حاويات مباشرة أو غير مباشرة للكائن المعطى والتي تؤثّر على عملية التمثيل) كمفاتيح في القاموس. إن احتاج كائن معيّن إلى التنسيق وهو ممثّل ضمن السياق، فإنّ القيمة االثالثة المعادة من هذا التابع تكون True. يجب أن تضيف الاستدعاءات التعاودية للتابع format()‎ عناصر الحاويات الإضافية ...

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، بالاعتماد على تقويم ISO. البنية العامة ‎datetime.isoweekday() القيمة المعادة يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 1 ويوم الأحد الرقم 7، وذلك بالاعتماد على تقويم ISO. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 26, 20, 50) >>> dt.isoweekday() 2 انظر أيضًا التابع datetime.datetime.isocalendar()‎: يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). ...

يعيد التابع الحالة الحالية لراية is_authenticated لعنوان URI المعطى. البنية العامة HTTPPasswordMgrWithPriorAuth.update_authenticated(self, uri, is_authenticated=False) القيمة المعادة يعيد التابع الحالة الحالية لراية is_authenticated لعنوان URI المعطى. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

توفر هذه الوحدة آلية محمولة لاستخدام الوظائف والأدوات التي تعتمد على نوع نظام التشغيل. ‎‎>>> import os >>> os.getcwd() '/home/username' ملاحظات تستخدم وظائِف جميع الوحدات المبنيّة في بايثون، والمعتمدة على نوع نظام التشغيل، في جميع الأنظمة المتوافرة فيها نفس الواجهة (interface). فعلى سبيل المثال، تُعيد الدالة os.stat(path)‎‎ معلومات حول المسار المُدخَل بنفس التنسيق على جميع الأنظمة التي تتوافر فيها الدالة (الواجهة المُستخدمة هنا مماثلة لتلك المُستخدمة في واجهة POSIX). تتوفر أيضًا إمكانيّة إضافة إضافات خاصة لنظام تشغيل مُعين عبر الوحدة os، ولكن ...

يعيد التابع الختم الزمني (بصيغة POSIX) الموافق لنسخة الصنف datetime. البنية العامة ‎datetime.timestamp() القيمة المعادة يعيد التابع الختم الزمني (بصيغة POSIX) الموافق لنسخة الصنف datetime. تكون النتيجة المعادة عددًا ذا فاصلة عائمة يشبه ذلك المعاد من التابع time.time()‎. يُفترض بكائنات datetime البسيطة أن تمثّل الوقت حسب التوقيت المحلّي، ويعتمد هذا التابع على دالة mktime()‎ في لغة C لإجراء عملية التحويل. ولمّا كان كائن datetime يدعم نطاقًا أوسع من القيم مقارنة بالدالة maktime()‎ في عدد من المنصّات، فإنّ هذا التابع يطلق ...

يرسل التابع طلب HTTP، والذي يمكن أن يكون من نوع GET أو POST، بالاعتماد على التابع req.has_data()‎. البنية العامة HTTPHandler.http_open(req) المعاملات req طلب HTTP المراد إرساله. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تعيد الدالة قائمة تضمّ العدد المحدّد من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى. البنية العامة heapq.nlargest(n, iterable, key=None) المعاملات n عدد العناصر المطلوبة. iterable كائن التكرار المراد البحث فيه عن العناصر. key يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower. القيمة المعادة تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار. هذه الدالة مكافئة للدالة ...

يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. البنية العامة cursor(factory=Cursor) ‎المعاملات factory يأخذ هذا التابع معاملًا اختياريًا واحدًا، وعند تعيينه يجب أن يكون كائنًا قابلًا للاستدعاء callable يعيد نسخة من صنف Cursor أو أحد أصنافه الفرعية. القيمة المعادة يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها. لا تستخدم هذا الصنف مباشرة، بل استخدم الدالة tarfile.open()‎ عوضًا عنه. يقدّم كائن TarFile واجهة لملفات الأرشيف من نوع tar. يتكوّن أرشيف tar من تسلسل من الكتل، ويتكوّن عضو الأرشيف (الملفّ المخزّن) من كتلة الترويسة header block متبوعة بكتل البيانات. يمكن تخزين ملف معيّن في أرشيف tar عدّة مرات، ويُمثّل كل عضو في الأرشيف بواسطة كائن TarInfo (راجع قسم كائنات TarInfo للمزيد من التفاصيل). يمكن استخدام كائن TarFile ...

تحلّل الدالة مدخلات (ترتيب تحليل التوابع MRO) بصورة ديناميكية وكما هو محدّد في PEP 560. ملاحظة: هذه الدالة جديدة في الإصدار 3.7 من اللغة. البنية العامة types.resolve_bases(bases) المعاملات bases الأصناف الأساسية المراد تحليلها. القيمة المعادة تبحث هذه الدالة عن العناصر في الأصناف المعطاة في المعامل bases والتي لا تكون نسخًا من الصنف type، وتعيد الدالة صفًّا يُستبدل فيه كل كائن مماثل ولا يملك التابع __mro_entries__ بنتيجة استدعاء هذا التابع بعد فكّ تحزيمها. أما إن كان الصنف المعطى في المعامل bases ...

يعيد التابع العدد الترتيبي للتاريخ الذي يمثّله كائن datetime حسب التقويم التنبّؤي الكريكوري. البنية العامة ‎datetime.toordinal() القيمة المعادة يعيد التابع العدد الترتيبي للتاريخ الذي يمثّله كائن datetime حسب التقويم التنبّؤي الكريكوري، حيث يحمل تاريخ الأول من كانون الثاني سنة 1 ميلادية العدد 1. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 26, 11, 42, 10) >>> dt.toordinal() 736871 انظر أيضًا التابع Python/datetime/datetime/fromordinal‎: يعيد التابع كائن datetime الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في ...

تعرض الدالة العنوان المعطى في المتصفّح الافتراضي. البنية العامة webbrowser.open(url, new=0, autoraise=True) ‎ المعاملات ‎url العنوان المراد فتحه في المتصفّح. new معامل اختياري، يمكن أن يأخذ القيمة 0 وحينئذٍ يُفتح العنوان المعطى في نفس نافذة المتصفّح إن كان ذلك ممكنًا. وإن أخذ القيمة 1، تفتح الدالة نافذة متصفّح جديدة إن كان ذلك ممكنًا، وإن أخذ المعامل القيمة 2 فإنّ الدالة تفتح صفحة متصفّح (tab) جديدة إن كان ذلك ممكنًا. autoraise إن أخذ هذا المعامل القيمة True، فإنّ نافذة المتصفّح ستُعرض ...

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح. البنية العامة ‎date.weekday() القيمة المعادة يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد الرقم 6. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 26) >>> d.weekday() 1 انظر أيضًا التابع date.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 1 ويوم الأحد الرقم 7. مصادر قسم date Objects في صفحة ...

تعيد الدالة معرّف URI الكامل في الطلب، -يمكن أن تتضمّن النتيجة المعادة سلسلة الطلب النصية- باستخدام الخوارزمية الموجودة في قسم "URL Reconstruction" في PEP 3333. البنية العامة wsgiref.util.request_uri(environ, include_query=True) المعاملات environ ‎environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. include_query لن تُضمّن سلسلة الطلب النصية في معرّف URI الناتج إن أخذ هذا المعامل قيمة خاطئة. القيمة المعادة تعيد الدالة معرّف URI الكامل في الطلب مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference ...

يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. البنية العامة cursor(factory=Cursor) ‎المعاملات factory يأخذ هذا التابع معاملًا اختياريًا واحدًا، وعند تعيينه يجب أن يكون كائنًا قابلًا للاستدعاء callable يعيد نسخة من صنف Cursor أو أحد أصنافه الفرعية. القيمة المعادة يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. البنية العامة yeardayscalendar(year, width=3) المعاملات year السنة المطلوبة. width يحدّد الحد الأقصى للشهور في كل صفّ، ويأخذ القيمة 3 كقيمة افتراضية. القيمة المعادة يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق (كما هو الحال مع التابع yeardatescalendar()‎). العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. وتأخذ الأيام التي تكون خارج نطاق هذا الشهر القيمة 0. ...

يحوّل التابع اسم الخيار المعطى وكما هو موجود في ملف الإعدادات أو كما هو ممرّر إلى التابع عن طريق الشيفرة التي يكتبها المستخدم إلى الصيغة التي يجب استخدامها في البنية الداخلية لملفات الإعدادات. البنية العامة optionxform(option) ‎المعاملات option المعامل الذي سيحوّله التابع إلى صيغة ملفات الإعدادات. القيمة المعادة تعيد طريقة التنفيذ الافتراضية لهذا التابع اسم الخيار بعد تحويل جميع الحروف إلى أحرف صغيرة، ويمكن إعادة تعريف هذا التابع باستخدام أصناف فرعية ويمكن للمبرمج أن يعين خاصية لهذا الاسم في نسخ ...

تعيد الدالة قائمة تضمّ العدد المحدّد من أصغر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى. البنية العامة heapq.nsmallest(n, iterable, key=None) المعاملات n عدد العناصر المطلوبة. iterable كائن التكرار المراد البحث فيه عن العناصر. key يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower. القيمة المعادة تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار. هذه الدالة مكافئة للدالة ...

هذا التابع خاص بالقواميس المرتّبة ويحذف ويعيد زوج (مفتاح، قيمة) من القاموس المرتب. البنية العامة od.‎popitem(last=True) المعاملات last قيمة منطقية، ويأخذ هذا المعامل القيمة الافتراضية True. إن أخذ المعامل قيمة True، فإنّ الأزواج تعاد بالترتيب (آخر الداخلين هو أول الخارجين last-in, first-out يعرف اختصارًا بـ LIFO)، وإن أخذ القيمة False، فإنّ الأزواج تعاد بالترتيب (أول الداخلين هو أول الخارجين first-in, first-out يعرف اختصارًا بـ FIFO). القيمة المعادة يعيد التابع زوج (مفتاح، قيمة) المحذوف من القاموس المرتب. أمثلة يبين المثال التالي ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. البنية العامة itermonthdays3(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. كون الأيام المعادة على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. ملاحظة: هذا التابع جديد في الإصدار ...

تقدم وحدة cgitb أداة خاصة للتعامل مع الاستثناءات في سكربتات بايثون. (قد يكون اسم الوحدة مضلّلًا. صمّمت هذه الوحدة في المقام الأوّل لعرض معلومات الأخطاء الخاصّة بسكربتات CGI بصيغة HTML، ولكنّها أصبحت تعرض المعلومات كنصوص صرفة في وقت لاحق). في حال حدوث استثناء لم تلتقطه بايثون، تعرض الوحدة تقريرًا مفصّلًا ومنسّقًا، ويتضمّن هذا التقرير الجزء المسؤول عن حدوث الخطأ في الشيفرة المصدرية، إضافة إلى قيم الوسائط والمتغيرات المحلية الخاصّة بالدالة الحالية. يمكن الاستفادة من هذا التقرير في تنقيح الشيفرة المصدرية ...

يعيد التابع تقويم السنة المعطاة على هيئة جدول HTML. البنية العامة formatyear(theyear, width=3) المعاملات theyear السنة المطلوبة. width يحدّد المعامل (والذي يأخذ القيمة الافتراضية 3) عدد الأشهر في كل صفّ من صفوف الجدول المعاد. القيمة المعادة سلسلة نصية تتضمّن تقويم السنة المطلوبة بهيئة جدول HTML. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import HTMLCalendar >>> cal = HTMLCalendar() >>> cal.formatyear(2018) '<table border="0" cellpadding="0" cellspacing="0" class="year">\n<tr><th colspan="3" class="year">2018</th></tr><tr><td><table border="0" cellpadding="0" cellspacing="0" class="month">\n<tr><th colspan="7" class="month">January</th></tr>\n<tr><th class="mon">Mon</th><th class="tue">Tue</th><th class="wed">Wed</th><th class="thu">Thu</th><th class="fri">Fri</th><th class="sat">Sat</th><th class="sun">Sun</th></tr>\n<tr><td ...

يعالج هذا التابع خطأً معيّنًا في البروتوكول المعطى. يستدعي التابع معالج الخطأ المسجّل للبروتوكول المعطى مستخدمًا الوسائط المعطاة (والتي تكون خاصّة بكل بروتوكول). بروتوكول HTTP هو حالة خاصة تستخدم شيفرة استجابات HTTP لتحديد معالج الخطأ المطلوب. راجع التوابع http_error_*()‎ الخاصّة بأصناف المعالجة. البنية العامة OpenerDirector.error(proto, *args) ‎المعاملات معاملات هذا التابع والقيمة المعادة والاستثناءات التي يُطلقها مشابهة لتلك الموجودة في الدالة urlopen()‎. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تتعامل هذه الدالة مع استثناء معيّن باستخدام الإعدادات الافتراضية (عرض التقرير في متصفّح الويب، ولكن عدم حفظه في ملف منفصل). يمكن استخدام هذه الدالة عندما يكون هناك استثناء لم تلتقطه بايثون وترغب في عرض تقرير عنه باستخدام الوحدة cgitb. البنية العامة cgitb.handler(info=None) ‎المعاملات info معامل اختياري، وهو عبارة عن صفٍّ tuple مكوّن من ثلاثة عناصر هي نوع الاستثناء، وقيمة الاستثناء وكائن traceback، وهذا الصفّ مشابه للصفّ الذي تعيده الدالة sys.exc_info()‎. في حال عدم تزويد الدالة بالمعامل info، يُؤخذ الاستثناء الحاليّ ...

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد كائن bytes يتضمّن ما تبقّى من مخرجات غير مضغوطة. البنية العامة Decompress.flush([length]) المعاملات length معامل اختياري يحدّد الحجم الابتدائي لذاكرة المخرجات output buffer. لا يمكن استدعاء التابع decompress()‎ مرة أخرى بعد استدعاء التابع flush()‎، وما يمكن فعله في هذه الحالة هو حذف الكائن فقط. القيمة المعادة يعيد التابع كائن bytes يتضمّن ما تبقّى من مخرجات غير مضغوطة. انظر أيضًا التابع Compress.flush()‎: يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ...

يضيف التابع الملف المعطى إلى ملف الأرشيف. البنية العامة ZipFile.write(filename, arcname=None, compress_type=None, compresslevel=None) ‎المعاملات ‎filename اسم الملف المراد إضافته إلى الأرشيف. arcname الاسم الذي يعطيه التابع للملف المضاف إلى الأرشيف. القيمة الافتراضية لهذا المعامل هي نفس قيمة المعامل filename ولكن مع حذف اسم محرّك الأقراص والفواصل الموجودة في بداية المسار compress_type معامل اختياري تعيد قيمته تعريف القيمة المحدّدة للمعامل compression في الدالة البانية لكائنات ZipFile. compresslevel معامل اختياري تعيد قيمته تعريف القيمة المقابلة لها في الدالة البانية. ملاحظات: يجب فتح ...

تحوّل هذه الدالة أوائل الكلمات في السلسلة النصية المعطاة إلى أحرف كبيرة. البنية العامة string.capwords(s, sep=None) المعاملات s السلسلة النصية المراد معالجتها. sep تعتمد الدالة قيمة المعامل الاختياري sep كفاصل تقسم بواسطة كلمات السلسلة النصية ثم تربطها بعضها ببعض. في حال لم يأخذ هذا المعامل أيّ قيمة، أو أخذ القيمة None، فإنّ المسافات البيضاء مهما كان عددها ستستبدل بمسافة بيضاء واحدة، وستُحذف المسافات البيضاء من بداية ونهاية السلسلة النصية أيضًا. القيمة المعادة تقسم الدالة السلسلة النصية المعطاة إلى كلمات باستخدام ...

يجري هذا التابع عملية تبادل بايتات byteswap لجميع عناصر المصفوفة. البنية العامة ‎array.byteswap() القيمة المعادة يعمل هذا التابع مع القيم التي تكون بحجم 1 أو 2 أو 4 أو 8 بايت، ويطلق الخطأ RuntimeError مع الأنواع الأخرى من القيم. تظهر فائدة هذا التابع عند قراءة بيانات من ملف كُتب على جهاز آخر ذي ترتيب بايتات مختلف. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1 array('l', [1, 2, 3, 4, 5]) >>> ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى قيمة منطقية (بوليانية). البنية العامة getboolean(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى قيمة منطقية (بوليانية). أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getboolean('topsecret.server.com', 'ForwardX11') False >>> config.getboolean('topsecret.server.com', 'Compression') True انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. التابع getint()‎: ...

يدرج التابع القيمة المعطاة في الكائن deque في الموقع المحدّد. البنية العامة d.insert(i, x) المعاملات x العنصر المراد إدراجه في كائن deque. i الموقع الذي يدرج فيه التابع القيمة x في الكائن deque. القيمة المعادة إن أدّت عملية الإضافة إلى تجاوز الحد الأقصى للكائن deque والمقرّر عن طريق الخاصية maxlen، فإنّ التابع يطلق الخطأ IndexError. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque([1, 3, 4, 5, 6]) >>> d.insert(1, 2) >>> d deque([1, 2, 3, 4, ...

يعالج التابع طلب الاستيثاق عن طريق الحصول على زوج اسم المستخدم/كلمة المرور، وإعادة الطلب مرة أخرى. البنية العامة AbstractBasicAuthHandler.http_error_auth_reqed(authreq, host, req, headers) المعاملات authreq يجب أن يكون اسم الترويسة حيث تكون المعلومات المتعلّقة بالحقل مضمّنة في الطلب. host يحدّد عنوان URL والمسار الذي ستُجرى فيه عملية الاستيثاق. إما أن يكون سُلطة authority (مثل: "python.org") أو عنوان URL يتضمّن مكوّن سُلطة (مثل "http://python.org/‎"). في كلا الحالتين يجب أن تتضمّن السُّلطة مكوّن معلومات المستخدم userinfo (لذا لا بأس باستخدام "python.org" و "python.org:80" ...

تعدّ ملفات ZIP من ملفات الأرشفة والضغط الأكثر شيوعًا. تقدّم هذه الوحدة أدواة لإنشاء ملفات ZIP والقراءة منها والكتابة فيها وإلحاق الملفات بها وعرض محتوياتها. يتطلّب الاستخدام المتقدّم لهذه الوحدة فهمًا جيّدًا لصيغة الملفات ZIP والمعرّفة في دليل التطبيق PKZIP. لا تتعامل هذه الوحدة في الوقت الحاضر مع ملفات ZIP متعددة الأقراص، ولكن يمكنها التعامل مع ملفات ZIP التي تستخدم الإضافة ZIP64 (أي ملفات ZIP التي يتجاوز حجمها ‎4 GiB). يمكن استخدام الوحدة كذلك لفكّ التعمية عن الملفات المعمّاة encrypted ...

تعيد الدالة كائن controller لنوع المتصفّح المعطى. البنية العامة webbrowser.get(using=None) المعاملات ‎using إن أخذ هذا المعامل القيمة None فإنّ الدالة ستعيد كائنًا للمتصفّح الافتراضي يكون ملائمًا لبيئة الاستدعاء. هناك عددٌ من أنواع المتصفّحات المعرّفة مسبقًا، ويبين الجدول التالي أسماء هذه الأنواع والتي يمكن تمريرها إلى الدالة get()‎ وإنشاء أصناف ذات أنواع مختلفة: اسم المتصفح الصنف ملاحظات 'mozilla' Mozilla('mozilla')‎   'firefox' Mozilla('mozilla')‎   'netscape' Mozilla('netscape')‎   'galeon' Galeon('galeon')‎   'epiphany' Galeon('epiphany')‎   'skipstone' BackgroundBrowser('skipstone')‎   'kfmclient' Konqueror()‎ (1) 'konqueror' Konqueror()‎ (1) ...

تحوّل الدالة المسار المعطى من الصيغة المستخدمة في المسارات المحلية إلى الصيغة المستخدمة في عناوين URL. لا تنتج الدالة عنوان URL كاملًا. تكون النتيجة المعادة محاطة بعلامات الاقتباس وذلك باستخدام الدالة quote()‎. البنية العامة urllib.request.pathname2url(path) المعاملات path المسار المراد تحويله. أمثلة يبين المثال التالي طريقة عمل الدالة: >>> import urllib.request >>> urllib.request.pathname2url('main/images/big_title.png') 'main/images/big_title.png' >>> urllib.request.pathname2url('main/images/big title.png') 'main/images/big%20title.png' مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

هذه الدالة مشابهة للدالة urlparse()‎ ولكنّها لا تقسم المعاملات من عنوان URL. يجب استخدام هذه الدالة بصورة عامة عوضًا عن الدالة urlparse()‎ إن كان المطلوب استخدام صيغة URL حديثة تتضمّن السماح بتطبيق المعاملات لكل جزء من أجزاء المسار في عنوان URL (راجع المعيار RFC 2396). يجب استخدام دالة أخرى لفصل أقسام المسار ومعاملاته. تعيد هذه الدالة صفًّا مؤلّفًا من 5 عناصر (نظام العنونة addressing scheme، موقع الشبكة، المسار، الاستعلام، محدّد القطعة fragment identifier). البنية العامة urllib.parse.urlsplit(urlstring, scheme='', allow_fragments=True) ‎المعاملات urlstring ...

يعيد التابع قيمة كائن datetime مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق. البنية العامة ‎timezone.fromutc(dt) المعاملات dt يجب أن يكون المعامل dt نسخة صنف datetime واعٍ، وأن يأخذ tzinfo القيمة self. القيمة المعادة يعيد التابع قيمة كائن datetime مضافًا إليها مقدار الإزاحة عن التوقيت العالمي المنسّق، بالصيغة dt + offset. أمثلة يبين المثال التالي آلية عمل التابع: >>> from datetime import datetime, timedelta, timezone >>> AST = timezone(timedelta(hours = 3)) >>> datetime(2018, 7, 11, 0, 21, 12, tzinfo=AST) >>> AST.fromutc(dt) datetime.datetime(2018, 7, 11, ...

يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. البنية العامة monthdays2calendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع قائمة بالأسابيع في الشهر month في السنة year كأسابيع كاملة. تكون الأسابيع على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import ...