Средства разработки

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

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

• typing — поддержка аннотаций типов
  • Спецификация системы типов Python
  • Псевдонимы типов
  • NewType
  • Аннотирование вызываемых объектов
  • Обобщенные типы
  • Аннотирование кортежей
  • Тип объектов классов
  • Аннотирование генераторов и сопрограмм
  • Пользовательские обобщенные типы
  • Тип Any
  • Номинальная и структурная подтипизация
  • Содержимое модуля
    • Специальные примитивы типизации
      • Специальные типы
      • Специальные формы
      • Создание обобщенных типов и псевдонимов типов
      • Другие специальные директивы
    • Протоколы
    • Абстрактные базовые классы для работы с вводом-выводом
    • Функции и декораторы
    • Вспомогательные средства интроспекции
    • Константа
    • Устаревшие псевдонимы
      • Псевдонимы встроенных типов
      • Псевдонимы типов в collections
      • Псевдонимы других конкретных типов
      • Псевдонимы абстрактных базовых классов-контейнеров в collections.abc
      • Псевдонимы асинхронных абстрактных базовых классов в collections.abc
      • Псевдонимы других абстрактных базовых классов в collections.abc
      • Псевдонимы абстрактных базовых классов contextlib
  • Сроки устаревания основных возможностей
• pydoc — генератор документации и система интерактивной справки
• Режим разработки Python
  • Эффекты режима разработки Python
  • Пример ResourceWarning
  • Пример ошибки неверного файлового дескриптора
• doctest — проверка интерактивных примеров Python
  • Простое использование: проверка примеров в строках документации
  • Простое использование: проверка примеров в текстовом файле
  • Использование командной строки
  • Как это работает
    • Какие строки документации проверяются?
    • Как распознаются примеры в строках документации?
    • Что такое контекст выполнения?
    • А как насчет исключений?
    • Флаги параметров
    • Директивы
    • Предупреждения
  • Базовый API
  • API unittest
  • Расширенный API
    • Объекты DocTest
    • Объекты Example
    • Объекты DocTestFinder
    • Объекты DocTestParser
    • Объекты TestResults
    • Объекты DocTestRunner
    • Объекты OutputChecker
  • Отладка
  • Мнение автора
• unittest — инфраструктура модульного тестирования
  • Простой пример
  • Интерфейс командной строки
    • Параметры командной строки
  • Поиск тестов
  • Организация тестового кода
  • Повторное использование старого тестового кода
  • Пропуск тестов и ожидаемые сбои
  • Разделение итераций теста с помощью под-тестов
  • Классы и функции
    • Тестовые случаи
    • Группировка тестов
    • Загрузка и запуск тестов
      • Протокол load_tests
  • Фикстуры классов и модулей
    • setUpClass и tearDownClass
    • setUpModule и tearDownModule
  • Обработка сигналов
• unittest.mock — библиотека объектов-заглушек
  • Краткое руководство
  • Класс Mock
    • Вызов
    • Удаление атрибутов
    • Имена объектов Mock и атрибут name
    • Добавление объектов Mock в качестве атрибутов
  • Средства подмены
    • patch
    • patch.object
    • patch.dict
    • patch.multiple
    • Методы patch: start и stop
    • Подмена встроенных объектов
    • TEST_PREFIX
    • Вложенные декораторы patch
    • Где выполнять подмену
    • Подмена дескрипторов и прокси-объектов
  • Поддержка MagicMock и магических методов
    • Имитация магических методов
    • Magic Mock
  • Вспомогательные средства
    • sentinel
    • DEFAULT
    • call
    • create_autospec
    • ANY
    • FILTER_DIR
    • mock_open
    • Автоматическое создание спецификаций
    • Запечатывание объектов Mock
  • Приоритет side_effect, return_value и wraps
• unittest.mock — начало работы
  • Использование Mock
    • Подмена методов с помощью Mock
    • Mock для вызовов методов объекта
    • Имитация классов
    • Именование объектов Mock
    • Отслеживание всех вызовов
    • Задание возвращаемых значений и атрибутов
    • Генерация исключений с помощью объектов Mock
    • Функции побочных эффектов и итерируемые объекты
    • Имитация асинхронных итераторов
    • Имитация асинхронного менеджера контекста
    • Создание Mock на основе существующего объекта
    • Использование side_effect для возврата содержимого каждого файла
  • Декораторы Patch
  • Дополнительные примеры
    • Имитация цепочек вызовов
    • Частичная имитация
    • Имитация метода-генератора
    • Применение одной и той же подмены ко всем методам тестирования
    • Имитация несвязанных методов
    • Проверка нескольких вызовов с помощью mock
    • Работа с изменяемыми аргументами
    • Вложенные подмены
    • Имитация словаря с помощью MagicMock
    • Подклассы Mock и их атрибуты
    • Имитация импортов с помощью patch.dict
    • Отслеживание порядка вызовов и краткие проверки вызовов
    • Более сложное сопоставление аргументов
• test — пакет регрессионных тестов Python
  • Написание модульных тестов для пакета test
  • Запуск тестов через интерфейс командной строки
• test.support — утилиты для набора тестов Python
• test.support.socket_helper — утилиты для тестирования сокетов
• test.support.script_helper — утилиты для тестирования выполнения Python
• test.support.bytecode_helper — средства проверки правильности генерации байт-кода
• test.support.threading_helper — утилиты для тестирования потоков
• test.support.os_helper — утилиты для тестирования os
• test.support.import_helper — утилиты для тестирования импорта
• test.support.warnings_helper — утилиты для тестирования предупреждений