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

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

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

• typing — Поддержка подсказок типов
  • Спецификация системы типов Python
  • Псевдонимы типов
  • NewType
  • Аннотирование вызываемых объектов
  • Обобщения
  • Аннотирование кортежей
  • Тип объектов класса
  • Пользовательские обобщенные типы
  • Тип Any
  • Номинальное против структурного подтипирования
  • Содержимое модуля
    • Специальные примитивы типизации
      • Специальные типы
      • Специальные формы
      • Создание обобщенных типов и псевдонимов типов
      • Другие специальные директивы
    • Протоколы
    • ABC для работы с вводом-выводом
    • Функции и декораторы
    • Инструменты интроспекции
    • Константа
    • Устаревшие псевдонимы
      • Псевдонимы встроенных типов
      • Псевдонимы типов в collections
      • Псевдонимы других конкретных типов
      • Псевдонимы ABC контейнеров в collections.abc
      • Псевдонимы асинхронных ABC в collections.abc
      • Псевдонимы других ABC в collections.abc
      • Псевдонимы ABC contextlib
  • График устаревания основных функций
• pydoc — Генератор документации и система онлайн-справки
• Режим разработки Python
  • Воздействие режима разработки Python
  • Пример ResourceWarning
  • Пример ошибки "Bad file descriptor"
• 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.object
    • patch.dict
    • patch.multiple
    • Методы patch: start и stop
    • patch builtins
    • 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 в 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 — утилиты для тестов предупреждений