ابزارهای توسعه

ماژول‌های توصیف‌شده در این فصل به شما در نوشتن نرم‌افزار کمک می‌کنند. برای مثال، ماژول pydoc یک ماژول را می‌گیرد و مستنداتی بر اساس محتوای آن ماژول تولید می‌کند. ماژول‌های doctest و unittest شامل چارچوب‌هایی برای نوشتن آزمون واحد‌هایی هستند که به‌طور خودکار کد را اجرا می‌کنند و تأیید می‌کنند که خروجی مورد انتظار تولید می‌شود.

فهرست ماژول‌های توصیف‌شده در این فصل:

• typing --- پشتیبانی از راهنماهای نوع
  • مشخصات سیستم نوع پایتون
  • نام‌های مستعار نوع
  • NewType
  • حاشیه‌نویسی اشیاء فراخوانی‌پذیر
  • عام‌ها
  • حاشیه‌نویسی تاپل‌ها
  • نوع اشیای کلاس
  • حاشیه‌نویسی تولیدگرها و هم‌روال‌ها
  • انواع عام تعریف‌شده توسط کاربر
  • نوع Any
  • زیرنوع‌دهی اسمی در مقابل ساختاری
  • محتویات ماژول
    • اولیه‌های ویژه تایپ
      • انواع خاص
      • شکل‌های خاص
      • ساخت انواع عام و نام‌های مستعار نوع
      • سایر دایرکتیوهای خاص
    • پروتکل‌ها
    • ABCها و پروتکل‌ها برای کار با I/O
    • توابع و دکوراتورها
    • ابزارهای کمکی درون‌نگری
    • ثابت
    • نام‌های مستعار منسوخ
      • نام‌های مستعار برای انواع توکار
      • نام‌های مستعار برای نوع‌ها در collections
      • نام‌های مستعار برای سایر انواع مشخص
      • نام‌های مستعار برای ABCهای ظرف در collections.abc
      • نام‌های مستعار برای کلاس‌های پایه انتزاعی ناهمگام (ABC) در collections.abc
      • نام‌های مستعار برای سایر ABCها در collections.abc
      • نام‌های مستعار برای کلاس‌های پایه انتزاعی (ABC) در contextlib
  • خط زمانی از رده خارج شدن ویژگی‌های اصلی
• pydoc --- تولیدگر مستندات و سامانه‌ی راهنمای برخط
• حالت توسعه پایتون
  • اثرات حالت توسعه پایتون
  • مثال ResourceWarning
  • مثال خطای توصیف‌گر پرونده نامعتبر
• doctest --- آزمون مثال‌های تعاملی پایتون
  • استفاده ساده: بررسی مثال‌ها در رشته مستندات
  • استفاده ساده: بررسی مثال‌ها در یک پرونده متنی
  • استفاده از خط فرمان
  • چگونه کار می‌کند
    • کدام رشته مستندات بررسی می‌شوند؟
    • مثال‌های رشته‌ی مستندسازی چگونه شناسایی می‌شوند؟
    • زمینه اجرا (Execution Context) چیست؟
    • در مورد استثناها چطور؟
    • پرچم‌های گزینه
    • دایرکتیوها
    • هشدارها
  • API پایه
  • API آزمون واحد
  • API پیشرفته
    • اشیای DocTest
    • اشیای Example
    • اشیای DocTestFinder
    • اشیای DocTestParser
    • اشیاء TestResults
    • اشیای DocTestRunner
    • اشیای OutputChecker
  • اشکال‌زدایی
  • تریبون
• unittest --- چارچوب آزمون واحد
  • مثال ساده
  • رابط خط فرمان
    • گزینه‌های خط فرمان
  • کشف آزمون
  • سازمان‌دهی کد آزمون
  • استفاده مجدد از کد آزمون قدیمی
  • پرش از آزمون‌ها و شکست‌های مورد انتظار
  • تمایز تکرارهای آزمون با استفاده از زیرآزمون‌ها
  • کلاس‌ها و توابع
    • موارد آزمون
    • گروه‌بندی آزمون‌ها
    • بارگذاری و اجرای آزمون‌ها
      • پروتکل load_tests
  • ثابت‌های آزمایشی کلاس و ماژول (fixtures)
    • setUpClass و tearDownClass
    • setUpModule و tearDownModule
  • مدیریت سیگنال
• unittest.mock --- کتابخانه‌ی شیء ماک
  • راهنمای سریع
  • کلاس ماک
    • فراخوانی
    • حذف ویژگی‌ها
    • نام‌های ماک و ویژگی name
    • پیوست کردن ماک‌ها به‌عنوان ویژگی‌ها
  • وصله‌کننده‌ها
    • وصله
    • patch.object
    • patch.dict
    • patch.multiple
    • متدهای patch: start و stop
    • وصله کردن توکارها
    • TEST_PREFIX
    • تودرتو کردن دکوراتورهای Patch
    • محل وصله (patch)
    • وصله کردن توصیف‌گرها و اشیاء پراکسی
  • پشتیبانی از MagicMock و متدهای جادویی
    • ماک کردن متدهای جادویی
    • ماک جادویی
  • کمک‌کننده‌ها
    • نشانگر (sentinel)
    • پیش‌فرض
    • فراخوانی
    • create_autospec
    • هر
    • FILTER_DIR
    • mock_open
    • مشخصه‌دهی خودکار (Autospeccing)
    • مهر و موم کردن ماک‌ها
  • ترتیب اولویت side_effect، return_value و wraps
• unittest.mock --- شروع به کار
  • استفاده از ماک
    • متدهای وصله‌کردن ماک
    • ماک برای فراخوانی‌های متد روی یک شیء
    • ماک کردن کلاس‌ها
    • نام‌گذاری ماک‌های شما
    • پیگیری همه فراخوانی‌ها
    • تنظیم مقادیر بازگشتی و ویژگی‌ها
    • پرتاب استثناها با ماک‌ها
    • توابع دارای اثر جانبی و پیمایش‌پذیرها
    • ماک کردن پیمایش‌گرهای ناهمگام
    • ماک کردن مدیر زمینه ناهمگام
    • ایجاد یک ماک از یک شیء موجود
    • استفاده از side_effect برای برگرداندن محتوای هر پرونده
  • دکوراتورهای patch
  • مثال‌های بیشتر
    • ماک کردن فراخوانی‌های زنجیره‌ای
    • ماک جزئی
    • ماک‌کردن یک متد تولیدگر
    • اعمال وصله (patch) یکسان به همه متدهای آزمون
    • ماک کردن متدهای مقیدنشده
    • بررسی فراخوانی‌های متعدد با ماک
    • کنار آمدن با آرگومان‌های تغییرپذیر
    • تودرتو کردن وصله‌ها (patches)
    • ماک کردن یک دیکشنری با MagicMock
    • زیرکلاس‌های ماک و ویژگی‌های آن‌ها
    • ماک کردن ایمپورت‌ها با patch.dict
    • پیگیری ترتیب فراخوانی‌ها و ادعاهای فراخوانی مختصرتر
    • تطبیق پیچیده‌تر آرگومان‌ها
• test --- بسته آزمون‌های رگرسیون برای پایتون
  • نوشتن آزمون واحد‌ها برای بسته test
  • اجرای آزمون‌ها با استفاده از رابط خط فرمان
• test.support --- ابزارهایی برای بدنه‌ی آزمون پایتون
• test.support.socket_helper --- ابزارهایی برای آزمون‌های سوکت
• test.support.script_helper --- ابزارهایی برای آزمون‌های اجرای پایتون
• test.support.bytecode_helper --- ابزارهای پشتیبانی برای آزمون تولید صحیح بایت‌کد
• test.support.threading_helper --- ابزارهایی برای آزمون‌های نخ‌بندی
• test.support.os_helper --- ابزارهایی برای آزمون‌های os
• test.support.import_helper --- ابزارهای کمکی برای آزمون‌های ایمپورت
• test.support.warnings_helper --- ابزارهایی برای آزمون‌های هشدارها