تقنية

pydoc في بايثون: هل عرض الدالة يشغّل جسمها؟

نص own note موجود والخطأ داخل جسم الدالة لم يرفع
نتيجة مثال العرض. [1] [2]

عرض التوثيق ليس استدعاء دالتنا. [1] [2]

الخلاصة السريعة

نعرض توثيق دالة موجودة دون تنفيذ جسمها هنا. [1] [2]

  • كتبنا own note داخل سلسلة التوثيق. [1] [2]
  • جسم f يرفع RuntimeError عند استدعائه. [1] [2]
  • نمرر الكائن f إلى render_doc. [1] [2]
  • يطبع البحث عن النص True دون الخطأ. [1] [2]
  • اختبرنا 3.12.14؛ توثيق وحدة باستيرادها حالة مختلفة. [1] [2]

المثال

import pydoc as p
def f():
 """own note"""
 raise RuntimeError('ran')
s=p.plain(p.render_doc(f))
print('own note' in s)

[1] [2]

الناتج True؛ لم نستدعِ f(). [1] [2]

النص والجسم

يعالج مسار العرض توقيع الدالة وتوثيقها. ظهور النص لا يثبت نجاح جسم الدالة. [1] [2]

في اختبار عداد: 0 بعد العرض، ثم 1 بعد الاستدعاء. [1] [2]

عداد جسم دالتنا صفر بعد العرض وواحد بعد الاستدعاء الصريح
تحكم بعداد مستقل. [1] [2]

حدود النتيجة

دالتنا عادية وموجودة بالفعل. يوثق pydoc الوحدات باستيرادها، فينفذ كود مستوى الوحدة؛ لا نعمم غياب التنفيذ على كل استعمال. [1] [2]

المراجع

  1. Python: pydoc
  2. CPython 3.12.14: pydoc.py
  3. موضوع تك: لغة بايثون — مفردات
  4. موضوع تك: تطبيقات بايثون — مفردات

أُعدّ هذا المقال بمساعدة الذكاء الاصطناعي، وخضع لمراجعة ذاتية بالأداة نفسها. لا يُنسب إلى مراجع بشري أو خبير مستقل. منهجية المحتوى.