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 :

• typing — Prise en charge des annotations de type
  • PEPs pertinentes
  • Alias de type
  • NewType
  • Appelable
  • Génériques
  • Types génériques définis par l'utilisateur
  • Le type Any
  • Sous-typage nominal et sous-typage structurel
  • Classe de données
    • Special typing primitives
      • Special types
      • Special forms
      • Building generic types
      • Other special directives
    • Generic concrete collections
      • Corresponding to built-in types
      • Corresponding to types in collections
      • Other concrete types
    • Abstract Base Classes
      • Correspond aux collections au sein de collections.abc
      • Correspond aux autres types au sein de collections.abc.
      • Programmation asynchrone
      • Types associés aux gestionnaires de contexte
    • Protocoles
    • Functions and decorators
    • Utilitaires d'introspection
    • Constante
• pydoc — Générateur de documentation et système d’aide en ligne
• Python Development Mode
• Effects of the Python Development Mode
• ResourceWarning Example
• Bad file descriptor error example
• doctest — Exemples de tests interactifs en Python
  • Utilisation simple : vérifier des exemples dans des docstrings
  • Utilisation simple : vérifier des exemples dans un fichier texte
  • Comment ça marche
    • Quelles docstrings sont considérées ?
    • Comment les exemples docstring sont-ils identifiés ?
    • Quel est le contexte d'exécution ?
    • Qu'en est-il des exceptions ?
    • Options de ligne de commande
    • Instructions
    • Avertissements
  • API de base
  • API de tests unitaires
  • API avancé
    • Objets doctest
    • Exemples d'objets
    • Objets DocTestFinder
    • Objets DocTestParser
    • Objets DocTestRunner
    • Objets OutputChecker
  • Débogage
  • Éditorial
• unittest — Framework de tests unitaires
  • Exemple basique
  • Interface en ligne de commande
    • Options de la ligne de commande
  • Découverte des tests
  • Organiser le code de test
  • Réutilisation d'ancien code de test
  • Ignorer des tests et des erreurs prévisibles
  • Distinguer les itérations de test à l'aide de sous-tests
  • Classes et fonctions
    • Scénarios de tests
      • Alias obsolètes
    • Regroupement des tests
    • Chargement et exécution des tests
      • Protocole de chargement des tests (load_tests Protocol)
  • Classes et modules d'aménagements des tests
    • Classes de mise en place (setUpClass) et de démantèlement des tests (tearDownClass)
    • Module de mise en place (setUpModule) et de démantèlement des tests (tearDownModule)
  • Traitement des signaux
• unittest.mock — Bibliothèque d'objets simulacres
  • Guide rapide
  • La classe Mock
    • Calling
    • Deleting Attributes
    • Mock names and the name attribute
    • Attaching Mocks as Attributes
  • The patchers
    • patch
    • patch.object
    • patch.dict
    • patch.multiple
    • patch methods: start and stop
    • patch builtins
    • TEST_PREFIX
    • Nesting Patch Decorators
    • Where to patch
    • Patching Descriptors and Proxy Objects
  • MagicMock and magic method support
    • Mocking Magic Methods
    • Magic Mock
  • Helpers
    • sentinel
    • DEFAULT
    • call
    • create_autospec
    • ANY
    • FILTER_DIR
    • mock_open
    • Autospeccing
    • Sealing mocks
• unittest.mock --- getting started
  • Utilisation de Mock ou l'art de singer
    • Simulation des méthodes
    • S'assurer de la bonne utilisation d'un objet
    • Simulation des classes
    • Naming your mocks
    • Tracking all Calls
    • Setting Return Values and Attributes
    • Raising exceptions with mocks
    • Side effect functions and iterables
    • Mocking asynchronous iterators
    • Mocking asynchronous context manager
    • Creating a Mock from an Existing Object
  • Patch Decorators
  • Further Examples
    • Mocking chained calls
    • Partial mocking
    • Mocking a Generator Method
    • Applying the same patch to every test method
    • Mocking Unbound Methods
    • Checking multiple calls with mock
    • Coping with mutable arguments
    • Nesting Patches
    • Mocking a dictionary with MagicMock
    • Mock subclasses and their attributes
    • Mocking imports with patch.dict
    • Tracking order of calls and less verbose call assertions
    • More complex argument matching
• 2to3 --- Automated Python 2 to 3 code translation
  • Utilisation de 2to3
  • Correcteurs
  • lib2to3 --- 2to3's library
• test --- Regression tests package for Python
  • Writing Unit Tests for the test package
  • Running tests using the command-line interface
• test.support --- Utilities for the Python test suite
• test.support.socket_helper --- Utilities for socket tests
• test.support.script_helper --- Utilities for the Python execution tests
• test.support.bytecode_helper --- Support tools for testing correct bytecode generation
• test.support.threading_helper --- Utilities for threading tests
• test.support.os_helper --- Utilities for os tests
• test.support.import_helper --- Utilities for import tests
• test.support.warnings_helper --- Utilities for warnings tests