開発ツール

The modules described in this chapter help you write software. For example, the pydoc module takes a module and generates documentation based on the module's contents. The doctest and unittest modules contains frameworks for writing unit tests that automatically exercise code and verify that the expected output is produced. 2to3 can translate Python 2.x source code into valid Python 3.x code.

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

• typing --- 型ヒントのサポート
  • Python 型システムの仕様
  • 型エイリアス
  • NewType
  • 呼び出し可能オブジェクトのアノテーション
  • ジェネリクス
  • タプルのアノテーション
  • クラスオブジェクトの型
  • Annotating generators and coroutines
  • ユーザー定義のジェネリック型
  • Any 型
  • 名前的部分型 vs 構造的部分型
  • モジュールの内容
    • 特殊型付けプリミティブ
      • 特殊型
        • Any
        • AnyStr
        • LiteralString
        • Never
        • NoReturn
        • Self
        • TypeAlias
      • 特殊形式
        • Union
        • Optional
        • Concatenate
        • Literal
        • ClassVar
        • Final
        • Required
        • NotRequired
        • Annotated
        • TypeGuard
        • Unpack
      • Building generic types and type aliases
        • Generic
        • TypeVar
          • __name__
          • __covariant__
          • __contravariant__
          • __infer_variance__
          • __bound__
          • __constraints__
        • TypeVarTuple
          • __name__
        • ParamSpec
          • args
          • kwargs
          • __name__
        • ParamSpecArgs
        • ParamSpecKwargs
        • TypeAliasType
          • __name__
          • __module__
          • __type_params__
          • __value__
      • Other special directives
        • NamedTuple
        • NewType
          • __module__
          • __name__
          • __supertype__
        • Protocol
        • runtime_checkable()
        • TypedDict
          • __total__
          • __required_keys__
          • __optional_keys__
    • プロトコル
      • SupportsAbs
      • SupportsBytes
      • SupportsComplex
      • SupportsFloat
      • SupportsIndex
      • SupportsInt
      • SupportsRound
    • ABCs for working with IO
      • IO
      • TextIO
      • BinaryIO
    • Functions and decorators
      • cast()
      • assert_type()
      • assert_never()
      • reveal_type()
      • dataclass_transform()
      • overload()
      • get_overloads()
      • clear_overloads()
      • final()
      • no_type_check()
      • no_type_check_decorator()
      • override()
      • type_check_only()
    • Introspection helpers
      • get_type_hints()
      • get_origin()
      • get_args()
      • is_typeddict()
      • ForwardRef
    • 定数
      • TYPE_CHECKING
    • 非推奨のエイリアス
      • Aliases to built-in types
        • Dict
        • List
        • Set
        • FrozenSet
        • Tuple
        • Type
      • Aliases to types in collections
        • DefaultDict
        • OrderedDict
        • ChainMap
        • Counter
        • Deque
      • Aliases to other concrete types
        • Pattern
        • Match
        • Text
      • Aliases to container ABCs in collections.abc
        • AbstractSet
        • ByteString
        • Collection
        • Container
        • ItemsView
        • KeysView
        • Mapping
        • MappingView
        • MutableMapping
        • MutableSequence
        • MutableSet
        • Sequence
        • ValuesView
      • Aliases to asynchronous ABCs in collections.abc
        • Coroutine
        • AsyncGenerator
        • AsyncIterable
        • AsyncIterator
        • Awaitable
      • Aliases to other ABCs in collections.abc
        • Iterable
        • Iterator
        • Callable
        • Generator
        • Hashable
        • Reversible
        • Sized
      • Aliases to contextlib ABCs
        • ContextManager
        • AsyncContextManager
  • メジャーな機能の非推奨時系列
• pydoc --- ドキュメント生成とオンラインヘルプシステム
• Python 開発モード
  • Effects of the Python Development Mode
  • ResourceWarning Example
  • Bad file descriptor error example
• doctest --- 対話型の Python の例をテストする
  • 簡単な利用法: docstring 中の実行例をチェックする
  • 簡単な利用法: テキストファイル中の実行例をチェックする
  • doctest のからくり
    • どの docstring が検証されるのか?
    • docstring 内の実行例をどのように認識するのか?
    • 実行コンテキストとは何か?
    • 例外はどう扱えばよいか?
    • オプションフラグ
      • DONT_ACCEPT_TRUE_FOR_1
      • DONT_ACCEPT_BLANKLINE
      • NORMALIZE_WHITESPACE
      • ELLIPSIS
      • IGNORE_EXCEPTION_DETAIL
      • SKIP
      • COMPARISON_FLAGS
      • REPORT_UDIFF
      • REPORT_CDIFF
      • REPORT_NDIFF
      • REPORT_ONLY_FIRST_FAILURE
      • FAIL_FAST
      • REPORTING_FLAGS
      • register_optionflag()
    • ディレクティブ (Directives)
    • 警告
  • 基本 API
    • testfile()
    • testmod()
    • run_docstring_examples()
  • 単体テスト API
    • DocFileSuite()
    • DocTestSuite()
    • failureException
    • set_unittest_reportflags()
  • 拡張 API
    • DocTest オブジェクト
      • DocTest
        • examples
        • globs
        • name
        • filename
        • lineno
        • docstring
    • Example オブジェクト
      • Example
        • source
        • want
        • exc_msg
        • lineno
        • indent
        • options
    • DocTestFinder オブジェクト
      • DocTestFinder
        • find()
    • DocTestParser オブジェクト
      • DocTestParser
        • get_doctest()
        • get_examples()
        • parse()
    • DocTestRunner オブジェクト
      • DocTestRunner
        • report_start()
        • report_success()
        • report_failure()
        • report_unexpected_exception()
        • run()
        • summarize()
    • OutputChecker オブジェクト
      • OutputChecker
        • check_output()
        • output_difference()
  • デバッグ
    • script_from_examples()
    • testsource()
    • debug()
    • debug_src()
    • DebugRunner
    • DocTestFailure
    • test
    • example
    • got
    • UnexpectedException
    • test
    • example
    • exc_info
  • アドバイス
• unittest --- ユニットテストフレームワーク
  • 基本的な例
  • コマンドラインインターフェイス
    • コマンドラインオプション
  • テストディスカバリ
  • テストコードの構成
  • 既存テストコードの再利用
  • テストのスキップと予期された失敗
    • skip()
    • skipIf()
    • skipUnless()
    • expectedFailure()
    • SkipTest
  • サブテストを利用して繰り返しテストの区別を付ける
  • クラスと関数
    • テストクラス
      • TestCase
        • setUp()
        • tearDown()
        • setUpClass()
        • tearDownClass()
        • run()
        • skipTest()
        • subTest()
        • debug()
        • assertEqual()
        • assertNotEqual()
        • assertTrue()
        • assertFalse()
        • assertIs()
        • assertIsNot()
        • assertIsNone()
        • assertIsNotNone()
        • assertIn()
        • assertNotIn()
        • assertIsInstance()
        • assertNotIsInstance()
        • assertRaises()
        • assertRaisesRegex()
        • assertWarns()
        • assertWarnsRegex()
        • assertLogs()
          • records
          • output
        • assertNoLogs()
        • assertAlmostEqual()
        • assertNotAlmostEqual()
        • assertGreater()
        • assertGreaterEqual()
        • assertLess()
        • assertLessEqual()
        • assertRegex()
        • assertNotRegex()
        • assertCountEqual()
        • addTypeEqualityFunc()
        • assertMultiLineEqual()
        • assertSequenceEqual()
        • assertListEqual()
        • assertTupleEqual()
        • assertSetEqual()
        • assertDictEqual()
        • fail()
        • failureException
        • longMessage
        • maxDiff
        • countTestCases()
        • defaultTestResult()
        • id()
        • shortDescription()
        • addCleanup()
        • enterContext()
        • doCleanups()
        • addClassCleanup()
        • enterClassContext()
        • doClassCleanups()
      • IsolatedAsyncioTestCase
        • asyncSetUp()
        • asyncTearDown()
        • addAsyncCleanup()
        • enterAsyncContext()
        • run()
      • FunctionTestCase
    • テストのグループ化
      • TestSuite
        • addTest()
        • addTests()
        • run()
        • debug()
        • countTestCases()
        • __iter__()
    • テストのロードと起動
      • TestLoader
        • errors
        • loadTestsFromTestCase()
        • loadTestsFromModule()
        • loadTestsFromName()
        • loadTestsFromNames()
        • getTestCaseNames()
        • discover()
        • testMethodPrefix
        • sortTestMethodsUsing
        • suiteClass
        • testNamePatterns
      • TestResult
        • errors
        • failures
        • skipped
        • expectedFailures
        • unexpectedSuccesses
        • collectedDurations
        • shouldStop
        • testsRun
        • buffer
        • failfast
        • tb_locals
        • wasSuccessful()
        • stop()
        • startTest()
        • stopTest()
        • startTestRun()
        • stopTestRun()
        • addError()
        • addFailure()
        • addSuccess()
        • addSkip()
        • addExpectedFailure()
        • addUnexpectedSuccess()
        • addSubTest()
        • addDuration()
      • TextTestResult
      • defaultTestLoader
      • TextTestRunner
        • _makeResult()
        • run()
      • main()
      • load_tests プロトコル
  • クラスとモジュールのフィクスチャ
    • setUpClass と tearDownClass
    • setUpModule と tearDownModule
      • addModuleCleanup()
      • enterModuleContext()
      • doModuleCleanups()
  • シグナルハンドリング
    • installHandler()
    • registerResult()
    • removeResult()
    • removeHandler()
• unittest.mock --- モックオブジェクトライブラリ
  • クイックガイド
  • Mock クラス
    • Mock
      • assert_called()
      • assert_called_once()
      • assert_called_with()
      • assert_called_once_with()
      • assert_any_call()
      • assert_has_calls()
      • assert_not_called()
      • reset_mock()
      • mock_add_spec()
      • attach_mock()
      • configure_mock()
      • __dir__()
      • _get_child_mock()
      • called
      • call_count
      • return_value
      • side_effect
      • call_args
      • call_args_list
      • method_calls
      • mock_calls
      • __class__
    • NonCallableMock
    • PropertyMock
    • AsyncMock
      • assert_awaited()
      • assert_awaited_once()
      • assert_awaited_with()
      • assert_awaited_once_with()
      • assert_any_await()
      • assert_has_awaits()
      • assert_not_awaited()
      • reset_mock()
      • await_count
      • await_args
      • await_args_list
    • 呼び出し
    • 属性の削除
    • Mock の名前と name 属性
    • 属性として設定されるモック
  • patcher
    • patch
      • patch()
    • patch.object
      • object()
    • patch.dict
      • dict()
    • patch.multiple
      • multiple()
    • patch のメソッド: start と stop
      • stopall()
    • ビルトインをパッチする
    • TEST_PREFIX
    • patch デコレータをネストする
    • どこにパッチするか
    • デスクリプタやプロキシオブジェクトにパッチする
  • MagicMock と magic method のサポート
    • Magic Method をモックする
    • Magic Mock
      • MagicMock
      • NonCallableMagicMock
  • ヘルパー
    • sentinel
      • sentinel
    • DEFAULT
      • DEFAULT
    • call
      • call()
      • call_list()
    • create_autospec
      • create_autospec()
    • ANY
      • ANY
    • FILTER_DIR
      • FILTER_DIR
    • mock_open
      • mock_open()
    • autospec を使う
    • Sealing mocks
      • seal()
  • Order of precedence of side_effect, return_value and wraps
• unittest.mock --- 入門
  • Mock を使う
    • Mock のパッチ用メソッド
    • オブジェクトのメソッド呼び出しに対するモック
    • クラスをモックする
    • モックに名前をつける
    • 全ての呼び出しのトラッキング
    • 戻り値や属性を設定する
    • モックから例外を発生させる
    • side_effect の関数と iterable
    • 非同期イテレータをモックする
    • 非同期コンテキストマネージャをモックする
    • 既存のオブジェクトから Mock を作る
    • Using side_effect to return per file content
  • patch デコレータ
  • さらなる例
    • chained call をモックする
    • 部分的なモック
    • ジェネレータメソッドをモックする
    • 同じパッチを全てのメソッドに適用する
    • Unboundメソッドをモックする
    • モックで複数回の呼び出しをチェックする
    • ミュータブルな引数に対処する
    • patch をネストする
    • MagicMock で辞書をモックする
    • Mock のサブクラスと属性
    • patch.dict で import をモックする
    • Tracking order of calls and less verbose call assertions
    • More complex argument matching
• 2to3 --- Python 2 から 3 への自動コード変換
  • 2to3 の使用
  • 変換プログラム
  • lib2to3 --- 2to3's library
• test --- Regression tests package for Python
  • test パッケージのためのユニットテストを書く
  • コマンドラインインターフェースを利用してテストを実行する
• test.support --- テストのためのユーティリティ関数
  • TestFailed
  • ResourceDenied
  • verbose
  • is_jython
  • is_android
  • unix_shell
  • LOOPBACK_TIMEOUT
  • INTERNET_TIMEOUT
  • SHORT_TIMEOUT
  • LONG_TIMEOUT
  • PGO
  • PIPE_MAX_SIZE
  • Py_DEBUG
  • SOCK_MAX_SIZE
  • TEST_SUPPORT_DIR
  • TEST_HOME_DIR
  • TEST_DATA_DIR
  • MAX_Py_ssize_t
  • max_memuse
  • real_max_memuse
  • MISSING_C_DOCSTRINGS
  • HAVE_DOCSTRINGS
  • TEST_HTTP_URL
  • ALWAYS_EQ
  • NEVER_EQ
  • LARGEST
  • SMALLEST
  • busy_retry()
  • sleeping_retry()
  • is_resource_enabled()
  • python_is_optimized()
  • with_pymalloc()
  • requires()
  • sortdict()
  • findfile()
  • get_pagesize()
  • setswitchinterval()
  • check_impl_detail()
  • set_memlimit()
  • record_original_stdout()
  • get_original_stdout()
  • args_from_interpreter_flags()
  • optim_args_from_interpreter_flags()
  • captured_stdin()
  • captured_stdout()
  • captured_stderr()
  • disable_faulthandler()
  • gc_collect()
  • disable_gc()
  • swap_attr()
  • swap_item()
  • flush_std_streams()
  • print_warning()
  • wait_process()
  • calcobjsize()
  • calcvobjsize()
  • checksizeof()
  • anticipate_failure()
  • system_must_validate_cert()
  • run_with_locale()
  • run_with_tz()
  • requires_freebsd_version()
  • requires_linux_version()
  • requires_mac_version()
  • requires_IEEE_754()
  • requires_zlib()
  • requires_gzip()
  • requires_bz2()
  • requires_lzma()
  • requires_resource()
  • requires_docstrings()
  • requires_limited_api()
  • cpython_only()
  • impl_detail()
  • no_tracing()
  • refcount_test()
  • bigmemtest()
  • bigaddrspacetest()
  • check_syntax_error()
  • open_urlresource()
  • reap_children()
  • get_attribute()
  • catch_unraisable_exception()
  • load_package_tests()
  • detect_api_mismatch()
  • patch()
  • run_in_subinterp()
  • check_free_after_iterating()
  • missing_compiler_executable()
  • check__all__()
  • skip_if_broken_multiprocessing_synchronize()
  • check_disallow_instantiation()
  • adjust_int_max_str_digits()
  • SuppressCrashReport
  • SaveSignals
    • save()
    • restore()
  • Matcher
    • matches()
    • match_value()
• test.support.socket_helper --- Utilities for socket tests
  • IPV6_ENABLED
  • find_unused_port()
  • bind_port()
  • bind_unix_socket()
  • skip_unless_bind_unix_socket()
  • transient_internet()
• test.support.script_helper --- Utilities for the Python execution tests
  • interpreter_requires_environment()
  • run_python_until_end()
  • assert_python_ok()
  • assert_python_failure()
  • spawn_python()
  • kill_python()
  • make_script()
  • make_zip_script()
  • make_pkg()
  • make_zip_pkg()
• test.support.bytecode_helper --- Support tools for testing correct bytecode generation
  • BytecodeTestCase
  • get_disassembly_as_string()
  • assertInBytecode()
  • assertNotInBytecode()
• test.support.threading_helper --- Utilities for threading tests
  • join_thread()
  • reap_threads()
  • start_threads()
  • threading_cleanup()
  • threading_setup()
  • wait_threads_exit()
  • catch_threading_exception()
• test.support.os_helper --- Utilities for os tests
  • FS_NONASCII
  • SAVEDCWD
  • TESTFN
  • TESTFN_NONASCII
  • TESTFN_UNENCODABLE
  • TESTFN_UNDECODABLE
  • TESTFN_UNICODE
  • EnvironmentVarGuard
  • FakePath
  • set()
  • unset()
  • can_symlink()
  • can_xattr()
  • change_cwd()
  • create_empty_file()
  • fd_count()
  • fs_is_case_insensitive()
  • make_bad_fd()
  • rmdir()
  • rmtree()
  • skip_unless_symlink()
  • skip_unless_xattr()
  • temp_cwd()
  • temp_dir()
  • temp_umask()
  • unlink()
• test.support.import_helper --- Utilities for import tests
  • forget()
  • import_fresh_module()
  • import_module()
  • modules_setup()
  • modules_cleanup()
  • unload()
  • make_legacy_pyc()
  • CleanImport
  • DirsOnSysPath
• test.support.warnings_helper --- Utilities for warnings tests
  • ignore_warnings()
  • check_no_resource_warning()
  • check_syntax_warning()
  • check_warnings()
  • WarningsRecorder