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

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

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

• pydoc – генератор документации и справочная системаpydoc – Documentation generator and online help system
• doctest – тестирование интерактивных примеров Pythondoctest – Test interactive Python examples
  • Простое использование: проверка примеров в строках документацииSimple Usage: Checking Examples in Docstrings
  • Простое использование: проверка примеров в текстовом файлеSimple Usage: Checking Examples in a Text File
  • Как это работаетHow It Works
    • Какие строки документации проверяются?Which Docstrings Are Examined?
    • Как распознаются примеры в строках документации?How are Docstring Examples Recognized?
    • Каков контекст выполнения?What’s the Execution Context?
    • А как насчёт исключений?What About Exceptions?
    • Флаги и директивыOption Flags and Directives
    • ПредупрежденияWarnings
  • Базовый APIBasic API
  • API unittestUnittest API
  • Расширенный APIAdvanced API
    • Объекты DocTestDocTest Objects
    • Объекты ExampleExample Objects
    • Объекты DocTestFinderDocTestFinder objects
    • Объекты DocTestParserDocTestParser objects
    • Объекты DocTestRunnerDocTestRunner objects
    • Объекты OutputCheckerOutputChecker objects
  • ОтладкаDebugging
  • ТрибунаSoapbox
• unittest – фреймворк для модульного тестированияunittest – Unit testing framework
  • Простой примерBasic example
  • Организация тестового кодаOrganizing test code
  • Повторное использование старого тестового кодаRe-using old test code
  • Классы и функцииClasses and functions
  • Объекты TestCaseTestCase Objects
  • Объекты TestSuiteTestSuite Objects
  • Объекты TestResultTestResult Objects
  • Объекты TestLoaderTestLoader Objects
• 2to3 – автоматический перенос кода с Python 2 на Python 32to3 - Automated Python 2 to 3 code translation
  • Использование 2to3Using 2to3
  • lib2to3 – библиотека 2to3lib2to3 - 2to3’s library
• test – пакет регрессионных тестов для Pythontest – Regression tests package for Python
  • Написание модульных тестов для пакета testWriting Unit Tests for the test package
  • Запуск тестов с помощью test.regrtestRunning tests using test.regrtest
• test.support – вспомогательные функции для тестовtest.support – Utility functions for tests