25. Инструменты разработки¶Development Tools

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

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

• 25.1. pydoc – Генератор документации и справочная системаpydoc – Documentation generator and online help system
• 25.2. doctest – Тестирование интерактивных примеров Pythondoctest – Test interactive Python examples
  • 25.2.1. Простое использование: проверка примеров в docstringsSimple Usage: Checking Examples in Docstrings
  • 25.2.2. Простое использование: проверка примеров в текстовом файлеSimple Usage: Checking Examples in a Text File
  • 25.2.3. Как это работаетHow It Works
    • 25.2.3.1. Какие docstrings проверяются?Which Docstrings Are Examined?
    • 25.2.3.2. Как распознаются примеры в строках документации?How are Docstring Examples Recognized?
    • 25.2.3.3. Каков контекст выполнения?What’s the Execution Context?
    • 25.2.3.4. А что насчёт исключений?What About Exceptions?
    • 25.2.3.5. Флаги опций и директивыOption Flags and Directives
    • 25.2.3.6. ПредупрежденияWarnings
  • 25.2.4. Базовый APIBasic API
  • 25.2.5. Unittest API
  • 25.2.6. Продвинутый APIAdvanced API
    • 25.2.6.1. Объекты DocTestDocTest Objects
    • 25.2.6.2. Объекты ExampleExample Objects
    • 25.2.6.3. Объекты DocTestFinderDocTestFinder objects
    • 25.2.6.4. Объекты DocTestParserDocTestParser objects
    • 25.2.6.5. Объекты DocTestRunnerDocTestRunner objects
    • 25.2.6.6. Объекты OutputCheckerOutputChecker objects
  • 25.2.7. ОтладкаDebugging
  • 25.2.8. РазноеSoapbox
• 25.3. unittest – фреймворк для модульного тестированияunittest – Unit testing framework
  • 25.3.1. Простой примерBasic example
  • 25.3.2. Интерфейс командной строкиCommand-Line Interface
  • 25.3.3. Организация тестового кодаOrganizing test code
  • 25.3.4. Повторное использование старого тестового кодаRe-using old test code
  • 25.3.5. Пропуск тестов и ожидаемые сбоиSkipping tests and expected failures
  • 25.3.6. Классы и функцииClasses and functions
    • 25.3.6.1. Тестовые случаиTest cases
      • 25.3.6.1.1. Устаревшие псевдонимыDeprecated aliases
    • 25.3.6.2. Группировка тестовGrouping tests
    • 25.3.6.3. Загрузка и запуск тестовLoading and running tests
• 25.4. 2to3 – автоматическое преобразование кода Python 2 в 32to3 - Automated Python 2 to 3 code translation
  • 25.4.1. Использование 2to3Using 2to3
  • 25.4.2. ИсправителиFixers
  • 25.4.3. lib2to3 – библиотека 2to3lib2to3 - 2to3’s library
• 25.5. test – пакет регрессионных тестов для Pythontest – Regression tests package for Python
  • 25.5.1. Написание модульных тестов для пакета testWriting Unit Tests for the test package
  • 25.5.2. Запуск тестов с помощью интерфейса командной строкиRunning tests using the command-line interface
• 25.6. test.support – Утилиты для тестированияtest.support – Utility functions for tests