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

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

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

• 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
    • Объекты DocTestRunner
    • Объекты OutputChecker
  • Отладка
  • Обсуждение
• unittest — платформа модульного тестирования
  • Простой пример
  • Интерфейс командной строки
    • Параметры командной строки
  • Обнаружение тестов
  • Организация кода тестов
  • Повторное использование старого кода тестов
  • Пропуск тестов и ожидаемые сбои
  • Разделение итераций тестов с помощью подтестов
  • Классы и функции
    • Тестовые случаи
    • Группировка тестов
    • Загрузка и запуск тестов
      • Протокол load_tests
  • Фикстуры класса и модуля
    • setUpClass и tearDownClass
    • setUpModule и tearDownModule
  • Обработка сигналов
• unittest.mock — библиотека объектов-заглушек
  • Краткое руководство
  • Класс Mock
    • Вызов
    • Удаление атрибутов
    • Имена Mock и атрибут name
    • Добавление Mock в качестве атрибутов
  • Средства patch
    • patch
    • patch.object
    • patch.dict
    • patch.multiple
    • Методы patch: запуск и остановка
    • Подмена встроенных объектов
    • TEST_PREFIX
    • Вложенные декораторы patch
    • Что подменять
    • Подмена дескрипторов и прокси-объектов
  • Поддержка MagicMock и магических методов
    • Имитация магических методов
    • Magic Mock
  • Вспомогательные средства
    • sentinel
    • DEFAULT
    • call
    • create_autospec
    • ANY
    • FILTER_DIR
    • mock_open
    • Автоматическая спецификация
    • Запечатывание заглушек
  • Порядок приоритета side_effect, return_value и wraps
• unittest.mock — начало работы
  • Использование Mock
    • Подмена методов с помощью Mock
    • Mock для вызовов методов объекта
    • Имитация классов
    • Именование заглушек
    • Отслеживание всех вызовов
    • Задание возвращаемых значений и атрибутов
    • Вызов исключений с помощью заглушек
    • Функции итерируемые объекты в качестве side effect
    • Имитация асинхронных итераторов
    • Имитация асинхронного менеджера контекста
    • Создание Mock на основе существующего объекта
    • Использование side_effect для возврата содержимого каждого файла
  • Декораторы patch
  • Дополнительные примеры
    • Имитация цепочек вызовов
    • Частичная имитация
    • Имитация метода-генератора
    • Применение одной подмены ко всем тестовым методам
    • Имитация несвязанных методов
    • Проверка нескольких вызовов с помощью mock
    • Работа с изменяемыми аргументами
    • Вложенные подмены
    • Имитация словаря с помощью MagicMock
    • Подклассы Mock и их атрибуты
    • Имитация импорта с помощью patch.dict
    • Отслеживание порядка вызовов и менее многословные проверки вызовов
    • Более сложное сопоставление аргументов
• 2to3 — автоматическое преобразование кода Python 2 в Python 3
  • Использование 2to3
  • Преобразователи
  • lib2to3 — библиотека 2to3
• 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 — вспомогательные средства для тестирования предупреждений