開發工具

本章中介绍的模块可帮助你编写软件。 例如，pydoc 模块接受一个模块并根据该模块的内容来生成文档。 doctest 和 unittest 模块包含用于编写自动执行代码并验证是否产生预期的输出的单元测试的框架。

本章中描述的模块列表是：

• typing --- 支援型別提示
  • 有关 Python 类型系统的规范说明
  • 型別別名
  • NewType
  • 註釋 callable 物件
  • 泛型
  • 註釋元組 (tuple)
  • 類別物件的型別
  • 使用者定義泛型型別
  • Any 型別
  • 標稱 (nominal) 子型別 vs 結構子型別
  • 模組內容
    • 特別型別原語 (primitive)
      • 特別型別
      • 特殊形式
      • 构造泛型类型与类型别名
      • 其他特殊指令
    • 協定
    • 与 IO 相关的抽象基类
    • 函式與裝飾器
    • 内省辅助器
    • 常數
    • 棄用的別名
      • 內建型別的別名
      • collections 中型別的別名
      • 其他具体类型的别名
      • collections.abc 中容器 ABC 的別名
      • collections.abc 中异步 ABC 的别名
      • collections.abc 中其他 ABC 的别名
      • contextlib ABC 的別名
  • 主要特性的弃用时间线
• pydoc --- 文件產生器與線上幫助系統
• Python 開發模式
  • Python 開發模式的影響
  • ResourceWarning 範例
  • 檔案描述器的錯誤範例
• doctest --- 測試互動式 Python 範例
  • 简单用法：检查Docstrings中的示例
  • 简单的用法：检查文本文件中的例子
  • 它是如何工作的
    • 哪些文件串被检查了？
    • 文档串的例子是如何被识别的？
    • 什么是执行上下文？
    • 异常如何处理？
    • 选项标记
    • 指令
    • 警告
  • 基本API
  • Unittest API
  • 高级 API
    • DocTest 物件
    • Example 物件
    • DocTestFinder 物件
    • DocTestParser 物件
    • TestResults 对象
    • DocTestRunner 物件
    • OutputChecker 物件
  • 调试
  • 肥皂盒
• unittest --- 單元測試框架
  • 簡單範例
  • 命令執行列介面 (Command-Line Interface)
    • 命令列模式選項
  • Test Discovery（測試探索）
  • 组织你的测试代码
  • 复用已有的测试代码
  • 跳过测试与预计的失败
  • 使用子测试区分测试迭代
  • 类与函数
    • 测试用例
    • 分组测试
    • 加载和运行测试
      • load_tests 协议
  • 类与模块设定
    • setUpClass 和 tearDownClass
    • setUpModule 和 tearDownModule
  • 信号处理
• unittest.mock — mock 物件函式庫
  • 快速導引
  • Mock 類別
    • 呼叫
    • 刪除屬性
    • Mock 名稱與名稱屬性
    • 如同屬性一般附加 mock
  • Patchers
    • patch
    • patch.object
    • patch.dict
    • patch.multiple
    • patch 方法：啟動與停止
    • patch 內建函式
    • TEST_PREFIX
    • 巢狀使用 Patch 裝飾器
    • 該 patch 何處
    • Patch 描述器與代理物件 (Proxy Objects)
  • MagicMock 以及魔術方法支援
    • Mock 魔術方法
    • Magic Mock
  • 輔助函式
    • sentinel（哨兵）
    • DEFAULT
    • call
    • create_autospec
    • ANY
    • FILTER_DIR
    • mock_open
    • Autospeccing（自動規格）
    • 密封 mock
  • side_effect、return_value 和 wraps 的優先順序
• unittest.mock --- 入門指南
  • 使用 Mock 的方式
    • 使用 Mock 來 patching 方法
    • 對物件的方法呼叫使用 mock
    • Mock 類別
    • 命名你的 mock
    • 追蹤所有呼叫
    • 設定回傳值和屬性
    • 透過 mock 引發例外
    • Side effect 函式以及可疊代物件
    • Mock 非同步可疊代物件
    • Mock 非同步情境管理器
    • 從現有物件建立 mock
    • 使用 side_effect 回傳各別檔案內容
  • Patch 裝飾器
  • 更多範例
    • Mock 鍊接呼叫
    • 部分 mocking
    • Mock 產生器方法
    • 對每個測試方法應用相同的 patch
    • Mock Unbound Methods （未繫結方法）
    • 使用 mock 檢查多個呼叫
    • 應對可變引數
    • 巢狀使用 Patch
    • 使用 MagicMock 來 mock 字典
    • Mock 子類別及其屬性
    • 使用 patch.dict 來 mock import
    • 追蹤呼叫順序與更簡潔的呼叫斷言
    • 更複雜的引數匹配
• test --- Python 的回歸測試 (regression tests) 套件
  • 撰寫 test 套件的單元測試
  • 使用命令列介面執行測試
• test.support --- Python 測試套件的工具
• test.support.socket_helper --- 用於 socket 測試的工具
• test.support.script_helper --- 用於 Python 執行測試的工具
• test.support.bytecode_helper --- 用於測試位元組碼能正確產生的支援工具
• test.support.threading_helper --- 用于线程测试的工具
• test.support.os_helper --- 用於 os 測試的工具
• test.support.import_helper --- 用於 import 測試的工具
• test.support.warnings_helper --- 用於 warnings 測試的工具