Инструменты разработки

Модули, описанные в этой главе, помогут вам создавать программное обеспечение. Например, модуль pydoc принимает модуль и генерирует документацию на основе его содержимого. Модули doctest и unittest содержат фреймворки для написания модульных тестов, которые автоматически запускают код и проверяют, что полученный результат соответствует ожидаемому.

Список модулей, описанных в этой главе:

• typing — Поддержка типов
  • Спецификация системы типов Python
  • Псевдонимы типов
  • NewType
  • Аннотирование вызываемых объектов
  • Обобщения
  • Аннотирование кортежей
  • Тип объектов класса
  • Аннотирование генераторов и корутин
  • Пользовательские обобщенные типы
  • Тип Any
  • Номинальное и структурное подтипирование

• • Содержание модуля
    • Специальные примитивы типизации
      • Специальные типы
        • Any
        • AnyStr
        • LiteralString
        • Never
        • NoReturn
        • Self
        • TypeAlias
      • Специальные формы
        • Union
        • Optional
        • Concatenate
        • Literal
        • ClassVar
        • Final
        • Required
        • NotRequired
        • ReadOnly
        • Annotated
        • TypeIs
        • TypeGuard
        • Unpack
      • Создание обобщенных типов и псевдонимов типов
        • Generic
        • TypeVar
          • __name__
          • __covariant__
          • __contravariant__
          • __infer_variance__
          • __bound__
          • __constraints__
          • __default__
          • has_default()
        • TypeVarTuple
          • __name__
          • __default__
          • has_default()
        • ParamSpec
          • args
          • kwargs
          • __name__
          • __default__
          • has_default()
        • ParamSpecArgs
        • ParamSpecKwargs
        • TypeAliasType
          • __name__
          • __module__
          • __type_params__
          • __value__
      • Другие специальные директивы
        • NamedTuple
        • NewType
          • __module__
          • __name__
          • __supertype__
        • Protocol
        • runtime_checkable()
        • TypedDict
          • __total__
          • __required_keys__
          • __optional_keys__
          • __readonly_keys__
          • __mutable_keys__
    • Протоколы
      • SupportsAbs
      • SupportsBytes
      • SupportsComplex
      • SupportsFloat
      • SupportsIndex
      • SupportsInt
      • SupportsRound
    • ABC для работы с IO
      • IO
      • TextIO
      • BinaryIO
    • Функции и декораторы
      • 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()

• • • Справочные инструменты интроспекции
      • get_type_hints()
      • get_origin()
      • get_args()
      • get_protocol_members()
      • is_protocol()
      • is_typeddict()
      • ForwardRef
      • NoDefault
    • Константа
      • TYPE_CHECKING
    • Устаревшие псевдонимы
      • Псевдонимы встроенных типов
        • Dict
        • List
        • Set
        • FrozenSet
        • Tuple
        • Type
      • Псевдонимы типов из collections
        • DefaultDict
        • OrderedDict
        • ChainMap
        • Counter
        • Deque
      • Псевдонимы других конкретных типов
        • Pattern
        • Match
        • Text
      • Псевдонимы контейнерных ABC в collections.abc
        • AbstractSet
        • ByteString
        • Collection
        • Container
        • ItemsView
        • KeysView
        • Mapping
        • MappingView
        • MutableMapping
        • MutableSequence
        • MutableSet
        • Sequence
        • ValuesView
      • Псевдонимы асинхронных ABC в collections.abc
        • Coroutine
        • AsyncGenerator
        • AsyncIterable
        • AsyncIterator
        • Awaitable
      • Псевдонимы других ABC в collections.abc
        • Iterable
        • Iterator
        • Callable
        • Generator
        • Hashable
        • Reversible
        • Sized
      • Псевдонимы contextlib ABC
        • ContextManager
        • AsyncContextManager
  • График устаревания основных функций
• pydoc — Генератор документации и система онлайн-справочной информации
• Режим разработки Python
  • Эффекты режима разработки Python
  • Пример ResourceWarning
  • Пример ошибки bad file descriptor

• doctest — Тестирование интерактивных примеров Python
  • Простое использование: проверка примеров в строках документации
  • Простое использование: проверка примеров в текстовом файле
  • Как это работает
    • Какие строки документации проверяются?
    • Как распознаются примеры в строках документации?
    • Каков контекст выполнения?
    • Что делать с исключениями?
    • Флаги опций
      • 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()
    • Директивы
    • Предупреждения
  • Основной API
    • testfile()
    • testmod()
    • run_docstring_examples()
  • API модуля unittest
    • DocFileSuite()
    • DocTestSuite()
    • failureException
    • set_unittest_reportflags()
  • Расширенный API
    • Объекты DocTest
      • DocTest
        • examples
        • globs
        • name
        • filename
        • lineno
        • docstring
    • Объекты примеров
      • Example
        • source
        • want
        • exc_msg
        • lineno
        • indent
        • options
    • Объекты DocTestFinder
      • DocTestFinder
        • find()
    • Объекты DocTestParser
      • DocTestParser
        • get_doctest()
        • get_examples()
        • parse()
    • Объекты TestResults
      • TestResults
        • failed
        • attempted
        • skipped
    • Объекты DocTestRunner
      • DocTestRunner
        • report_start()
        • report_success()
        • report_failure()
        • report_unexpected_exception()
        • run()
        • summarize()
        • tries
        • failures
        • skips
    • Объекты 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
        • loop_factory
        • 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
    • ThreadingMock
      • wait_until_called()
      • wait_until_any_call_with()
      • DEFAULT_TIMEOUT
    • Вызов
    • Удаление атрибутов
    • Имена моков и атрибут имени
    • Присоединение моков в качестве атрибутов
  • Декораторы patch
    • patch
      • patch()
    • patch.object
      • object()
    • patch.dict
      • dict()
    • patch.multiple
      • multiple()
    • Декораторы patch: start и stop
      • stopall()
    • patch для встроенных функций
    • TEST_PREFIX
    • Вложенные декораторы patch
    • Где использовать patch
    • Мокирование дескрипторов и прокси-объектов
  • MagicMock и поддержка магических методов
    • Мокирование магических методов
    • Magic Mock
      • MagicMock
      • NonCallableMagicMock
  • Вспомогательные функции
    • sentinel
      • sentinel
    • DEFAULT
      • DEFAULT
    • call
      • call()
      • call_list()
    • create_autospec
      • create_autospec()
    • ЛЮБОЕ
      • ANY
    • FILTER_DIR
      • FILTER_DIR
    • mock_open
      • mock_open()
    • Автоспецификация
    • Запечатывание моков
      • seal()

• • Порядок приоритета side_effect, return_value и wraps
• unittest.mock — начало работы
  • Использование Mock
    • Моделирование методов
    • Использование Mock для вызовов методов объекта
    • Моделирование классов
    • Наименование созданных Mock
    • Отслеживание всех вызовов
    • Установление возвращаемых значений и атрибутов
    • Вызов исключений с помощью Mock
    • Функции и итерируемые объекты для side_effect
    • Моделирование асинхронных итераторов
    • Моделирование асинхронного менеджера контекста
    • Создание Mock из существующего объекта
    • Использование side_effect для возвращения содержимого файлов
  • Декораторы patch
  • Дополнительные примеры
    • Моделирование цепочек вызовов
    • Частичное моделирование
    • Моделирование метода-генератора
    • Применение одной и той же подмены к каждому методу теста
    • Моделирование несвязанных методов
    • Проверка нескольких вызовов с помощью Mock
    • Обработка изменяемых аргументов
    • Вложенные подмены
    • Моделирование словаря с помощью MagicMock
    • Подклассы Mock и их атрибуты
    • Моделирование импортов с помощью patch.dict
    • Отслеживание порядка вызовов и менее подробные проверки вызовов
    • Более сложные соответствия аргументов
• test — пакет регрессионных тестов для Python
  • Написание модульных тестов для пакета test
  • Запуск тестов с помощью командной строки
• test.support — утилиты для набора тестов Python

• • 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_gil_enabled()
  • 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 — Инструменты для тестирования сокетов
  • IPV6_ENABLED
  • find_unused_port()
  • bind_port()
  • bind_unix_socket()
  • skip_unless_bind_unix_socket()
  • transient_internet()
• test.support.script_helper — Инструменты для тестирования выполнения Python-скриптов
  • 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 — Инструменты для тестирования генерации байткода
  • BytecodeTestCase
  • get_disassembly_as_string()
  • assertInBytecode()
  • assertNotInBytecode()
• test.support.threading_helper — Инструменты для тестирования потоков
  • join_thread()
  • reap_threads()
  • start_threads()
  • threading_cleanup()
  • threading_setup()
  • wait_threads_exit()
  • catch_threading_exception()
• test.support.os_helper — Инструменты для тестирования os
  • 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 — Инструменты для тестирования импорта
  • forget()
  • import_fresh_module()
  • import_module()
  • modules_setup()
  • modules_cleanup()
  • unload()
  • make_legacy_pyc()
  • CleanImport
  • DirsOnSysPath

• test.support.warnings_helper — Утилиты для тестов предупреждений
  • ignore_warnings()
  • check_no_resource_warning()
  • check_syntax_warning()
  • check_warnings()
  • WarningsRecorder