開発ツール
**********

この章で紹介されるモジュールはソフトウェアを書くことを支援します。たと
えば、 "pydoc" モジュールはモジュールの内容からドキュメントを生成しま
す。 "doctest" と "unittest" モジュールでは、自動的に実行して予想通り
の出力が生成されるか確認するユニットテストを書くことができます。

この章で解説されるモジュールのリスト:

* "typing" --- 型ヒントのサポート

  * Python 型システムの仕様

  * 型エイリアス

  * NewType

  * 呼び出し可能オブジェクトのアノテーション

  * ジェネリクス

  * タプルのアノテーション

  * クラスオブジェクトの型

  * Annotating generators and coroutines

  * ユーザー定義のジェネリック型

  * "Any" 型

  * 名前的部分型 vs 構造的部分型

  * モジュールの内容

    * 特殊型付けプリミティブ

      * 特殊型

      * 特殊形式

      * Building generic types and type aliases

      * Other special directives

    * プロトコル

    * ABCs and Protocols for working with I/O

    * Functions and decorators

    * Introspection helpers

    * 定数

    * 非推奨のエイリアス

      * Aliases to built-in types

      * Aliases to types in "collections"

      * Aliases to other concrete types

      * Aliases to container ABCs in "collections.abc"

      * Aliases to asynchronous ABCs in "collections.abc"

      * Aliases to other ABCs in "collections.abc"

      * Aliases to "contextlib" ABCs

  * メジャーな機能の非推奨時系列

* "pydoc" --- ドキュメント生成とオンラインヘルプシステム

* Python 開発モード

  * Python 開発モードの影響

  * ResourceWarning の例

  * Bad file descriptor error example

* "doctest" --- 対話型の Python の例をテストする

  * 簡単な利用法: docstring 中の実行例をチェックする

  * 簡単な利用法: テキストファイル中の実行例をチェックする

  * コマンドラインでの使用

  * doctest のからくり

    * どの docstring が検証されるのか?

    * docstring 内の実行例をどのように認識するのか?

    * 実行コンテキストとは何か?

    * 例外はどう扱えばよいか?

    * オプションフラグ

    * ディレクティブ (Directives)

    * 警告

  * 基本 API

  * 単体テスト API

  * 拡張 API

    * DocTest オブジェクト

    * Example オブジェクト

    * DocTestFinder オブジェクト

    * DocTestParser オブジェクト

    * TestResults objects

    * DocTestRunner オブジェクト

    * OutputChecker オブジェクト

  * デバッグ

  * アドバイス

* "unittest" --- ユニットテストフレームワーク

  * 基本的な例

  * コマンドラインインターフェイス

    * コマンドラインオプション

  * テストディスカバリ

  * テストコードの構成

  * 既存テストコードの再利用

  * テストのスキップと予期された失敗

  * サブテストを利用して繰り返しテストの区別を付ける

  * クラスと関数

    * テストクラス

    * テストのグループ化

    * テストのロードと起動

      * load_tests プロトコル

  * クラスとモジュールのフィクスチャ

    * setUpClass と tearDownClass

    * setUpModule と tearDownModule

  * シグナルハンドリング

* "unittest.mock" --- モックオブジェクトライブラリ

  * クイックガイド

  * Mock クラス

    * 呼び出し

    * 属性の削除

    * Mock の名前と name 属性

    * 属性として設定されるモック

  * patcher

    * patch

    * patch.object

    * patch.dict

    * patch.multiple

    * patch のメソッド: start と stop

    * ビルトインをパッチする

    * TEST_PREFIX

    * patch デコレータをネストする

    * どこにパッチするか

    * デスクリプタやプロキシオブジェクトにパッチする

  * MagicMock と magic method のサポート

    * Magic Method をモックする

    * Magic Mock

  * ヘルパー

    * sentinel

    * DEFAULT

    * call

    * create_autospec

    * ANY

    * FILTER_DIR

    * mock_open

    * autospec を使う

    * Sealing mocks

  * Order of precedence of "side_effect", "return_value" and *wraps*

* "unittest.mock" --- 入門

  * Mock を使う

    * Mock patching methods

    * Mock for method calls on an object

    * Mocking classes

    * モックに名前をつける

    * Tracking all calls

    * Setting return values and attributes

    * モックから例外を発生させる

    * side_effect の関数と iterable

    * 非同期イテレータをモックする

    * 非同期コンテキストマネージャをモックする

    * Creating a mock from an existing object

    * Using side_effect to return per file content

  * Patch decorators

  * Further examples

    * chained call をモックする

    * 部分的なモック

    * Mocking a generator method

    * 同じパッチを全てのメソッドに適用する

    * Mocking unbound methods

    * モックで複数回の呼び出しをチェックする

    * ミュータブルな引数に対処する

    * Nesting patches

    * MagicMock で辞書をモックする

    * Mock のサブクラスと属性

    * patch.dict で import をモックする

    * Tracking order of calls and less verbose call assertions

    * More complex argument matching

* "test" --- Regression tests package for Python

  * Writing Unit Tests for the "test" package

  * コマンドラインインターフェースを利用してテストを実行する

* "test.support" --- Utilities for the Python test suite

* "test.support.socket_helper" --- Utilities for socket tests

* "test.support.script_helper" --- Utilities for the Python execution
  tests

* "test.support.bytecode_helper" --- Support tools for testing correct
  bytecode generation

* "test.support.threading_helper" --- Utilities for threading tests

* "test.support.os_helper" --- Utilities for os tests

* "test.support.import_helper" --- Utilities for import tests

* "test.support.warnings_helper" --- Utilities for warnings tests
