26. Outils de développement
***************************

Les modules décrits dans ce chapitre vous aident à écrire des
logiciels.  Par exemple, le module "pydoc" prend un module et génère
de la documentation basée sur son contenu.  Les modules "doctest" et
"unittest" contiennent des cades applicatifs pour écrire des tests
unitaires qui permettent de valider automatiquement le code en
vérifiant que chaque résultat attendu est produit. Le programme
**2to3** peut traduire du code Python 2.x en Python 3.x.

La liste des modules documentés dans ce chapitre est :

* 26.1. "typing" — Prise en charge des annotations de type

  * 26.1.1. Alias de type

  * 26.1.2. *NewType*

  * 26.1.3. Appelable

  * 26.1.4. Génériques

  * 26.1.5. Types génériques définis par l'utilisateur

  * 26.1.6. Le type "Any"

  * 26.1.7. Classes, functions, and decorators

* 26.2. "pydoc" — Générateur de documentation et système d’aide en
  ligne

* 26.3. "doctest" --- Test interactive Python examples

  * 26.3.1. Simple Usage: Checking Examples in Docstrings

  * 26.3.2. Simple Usage: Checking Examples in a Text File

  * 26.3.3. How It Works

    * 26.3.3.1. Which Docstrings Are Examined?

    * 26.3.3.2. How are Docstring Examples Recognized?

    * 26.3.3.3. What's the Execution Context?

    * 26.3.3.4. What About Exceptions?

    * 26.3.3.5. Option Flags

    * 26.3.3.6. Directives

    * 26.3.3.7. Avertissements

  * 26.3.4. Basic API

  * 26.3.5. Unittest API

  * 26.3.6. Advanced API

    * 26.3.6.1. DocTest Objects

    * 26.3.6.2. Example Objects

    * 26.3.6.3. DocTestFinder objects

    * 26.3.6.4. DocTestParser objects

    * 26.3.6.5. DocTestRunner objects

    * 26.3.6.6. OutputChecker objects

  * 26.3.7. Debugging

  * 26.3.8. Soapbox

* 26.4. "unittest" — *Framework* de tests unitaires

  * 26.4.1. Exemple basique

  * 26.4.2. Interface en ligne de commande

    * 26.4.2.1. Options de la ligne de commande

  * 26.4.3. Découverte des tests

  * 26.4.4. Organiser le code de test

  * 26.4.5. Réutilisation d'ancien code de test

  * 26.4.6. Ignorer des tests et des erreurs prévisibles

  * 26.4.7. Distinguer les itérations de test à l'aide de sous-tests

  * 26.4.8. Classes et fonctions

    * 26.4.8.1. Scénarios de tests

      * 26.4.8.1.1. Alias obsolètes

    * 26.4.8.2. Regroupement des tests

    * 26.4.8.3. Chargement et exécution des tests

      * 26.4.8.3.1. Protocole de chargement des tests (*load_tests
        Protocol*)

  * 26.4.9. Classes et modules d'aménagements des tests

    * 26.4.9.1. Classes de mise en place (*setUpClass*) et de
      démantèlement des tests (*tearDownClass*)

    * 26.4.9.2. Module de mise en place (*setUpModule*) et de
      démantèlement des tests (*tearDownModule*)

  * 26.4.10. Traitement des signaux

* 26.5. "unittest.mock" — Bibliothèque d'objets simulacres

  * 26.5.1. Guide rapide

  * 26.5.2. La classe *Mock*

    * 26.5.2.1. Calling

    * 26.5.2.2. Deleting Attributes

    * 26.5.2.3. Mock names and the name attribute

    * 26.5.2.4. Attaching Mocks as Attributes

  * 26.5.3. The patchers

    * 26.5.3.1. patch

    * 26.5.3.2. patch.object

    * 26.5.3.3. patch.dict

    * 26.5.3.4. patch.multiple

    * 26.5.3.5. patch methods: start and stop

    * 26.5.3.6. patch builtins

    * 26.5.3.7. TEST_PREFIX

    * 26.5.3.8. Nesting Patch Decorators

    * 26.5.3.9. Where to patch

    * 26.5.3.10. Patching Descriptors and Proxy Objects

  * 26.5.4. MagicMock and magic method support

    * 26.5.4.1. Mocking Magic Methods

    * 26.5.4.2. Magic Mock

  * 26.5.5. Helpers

    * 26.5.5.1. sentinel

    * 26.5.5.2. DEFAULT

    * 26.5.5.3. call

    * 26.5.5.4. create_autospec

    * 26.5.5.5. ANY

    * 26.5.5.6. FILTER_DIR

    * 26.5.5.7. mock_open

    * 26.5.5.8. Autospeccing

* 26.6. "unittest.mock" --- getting started

  * 26.6.1. Utilisation de Mock ou l'art de singer

    * 26.6.1.1. Simulation des méthodes

    * 26.6.1.2. S'assurer de la bonne utilisation d'un objet

    * 26.6.1.3. Simulation des classes

    * 26.6.1.4. Naming your mocks

    * 26.6.1.5. Tracking all Calls

    * 26.6.1.6. Setting Return Values and Attributes

    * 26.6.1.7. Raising exceptions with mocks

    * 26.6.1.8. Side effect functions and iterables

    * 26.6.1.9. Creating a Mock from an Existing Object

  * 26.6.2. Patch Decorators

  * 26.6.3. Further Examples

    * 26.6.3.1. Mocking chained calls

    * 26.6.3.2. Partial mocking

    * 26.6.3.3. Mocking a Generator Method

    * 26.6.3.4. Applying the same patch to every test method

    * 26.6.3.5. Mocking Unbound Methods

    * 26.6.3.6. Checking multiple calls with mock

    * 26.6.3.7. Coping with mutable arguments

    * 26.6.3.8. Nesting Patches

    * 26.6.3.9. Mocking a dictionary with MagicMock

    * 26.6.3.10. Mock subclasses and their attributes

    * 26.6.3.11. Mocking imports with patch.dict

    * 26.6.3.12. Tracking order of calls and less verbose call
      assertions

    * 26.6.3.13. More complex argument matching

* 26.7. *2to3* — Traduction automatique de code en Python 2 vers
  Python 3

  * 26.7.1. Utilisation de *2to3*

  * 26.7.2. Correcteurs

  * 26.7.3. "lib2to3" — la bibliothèque de *2to3*

* 26.8. "test" --- Regression tests package for Python

  * 26.8.1. Writing Unit Tests for the "test" package

  * 26.8.2. Running tests using the command-line interface

* 26.9. "test.support" --- Utilities for the Python test suite
