This document is for an old version of Python that is no longer supported. You should upgrade and read the documentação do Python para versão estável atual.

# 25. Ferramentas de Desenvolvimento

Os módulos descritos neste capítulo ajudam você a escrever softwares. Por exemplo, o módulo `pydoc` recebe um módulo e gera documentação com base no conteúdo do módulo. Os módulos `doctest` e `unittest` contêm frameworks para escrever testes unitários que automaticamente exercitam código e verificam se a saída esperada é produzida. 2to3 pode traduzir o código-fonte do Python 2.x para um código válido do Python 3.x.

A lista de módulos descritos neste capítulo é:

- 25.1. `pydoc` — Documentation generator and online help system
- 25.2. `doctest` — Teste exemplos interativos de Python
  - 25.2.1. Uso simples: verificando exemplos em Docstrings
  - 25.2.2. Utilização comum: Verificando exemplos em um arquivo de texto
  - 25.2.3. Como funciona
    - 25.2.3.1. 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. Flags opcionais
    - 25.2.3.6. Directives
    - 25.2.3.7. Warnings
  - 25.2.4. Basic API
  - 25.2.5. Unittest API
  - 25.2.6. Advanced API
    - 25.2.6.1. DocTest Objects
    - 25.2.6.2. Example Objects
    - 25.2.6.3. DocTestFinder objects
    - 25.2.6.4. DocTestParser objects
    - 25.2.6.5. DocTestRunner objects
    - 25.2.6.6. OutputChecker objects
  - 25.2.7. Debugging
  - 25.2.8. Soapbox
- 25.3. `unittest` — Framework de Testes Unitários
  - 25.3.1. Exemplo Básico
  - 25.3.2. Interface de Linha de Comando
    - 25.3.2.1. Opções de linha de comando
  - 25.3.3. Test Discovery
  - 25.3.4. Organizando código teste
  - 25.3.5. Re-using old test code
  - 25.3.6. Skipping tests and expected failures
  - 25.3.7. Classes e funções
    - 25.3.7.1. Test cases
      - 25.3.7.1.1. Deprecated aliases
    - 25.3.7.2. Grouping tests
    - 25.3.7.3. Loading and running tests
      - 25.3.7.3.1. load_tests Protocol
  - 25.3.8. Class and Module Fixtures
    - 25.3.8.1. setUpClass and tearDownClass
    - 25.3.8.2. setUpModule and tearDownModule
  - 25.3.9. Tratamento de sinal
- 25.4. 2to3 - Tradução Automatizada de Código Python 2 para 3
  - 25.4.1. Usando o 2to3
  - 25.4.2. Fixers
  - 25.4.3. `lib2to3` - biblioteca 2to3’s
- 25.5. `test` — Pacote de Testes de Regressão do Python
  - 25.5.1. Escrever testes unitários para o pacote `test`
  - 25.5.2. Running tests using the command-line interface
- 25.6. `test.support` — Utility functions for tests