Entwicklungswerkzeuge

Die in diesem Kapitel beschriebenen Module helfen Ihnen beim Schreiben von Software. Zum Beispiel generiert das Modul pydoc basierend auf dem Inhalt eines Moduls eine Dokumentation. Die Module doctest und unittest enthalten Frameworks zum Schreiben von Unit-Tests, die Code automatisch ausführen und überprüfen, ob die erwartete Ausgabe erzeugt wird.

Die Liste der in diesem Kapitel beschriebenen Module ist

• typing — Unterstützung für Typ-Hinweise
  • Spezifikation für das Python-Typsystem
  • Typ-Aliase
  • NewType
  • Beschriften von aufrufbaren Objekten
  • Generics
  • Beschriften von Tupeln
  • Der Typ von Klassenobjekten
  • Beschriften von Generatoren und Coroutinen
  • Benutzerdefinierte generische Typen
  • Der Typ Any
  • Nominale vs. strukturelle Subtypisierung
  • Modulinhalt
    • Spezielle Typ-Primitive
      • Spezielle Typen
      • Spezielle Formen
      • Erstellen generischer Typen und Typ-Aliase
      • Andere spezielle Direktiven
    • Protokolle
    • ABCs und Protokolle für die Arbeit mit I/O
    • Funktionen und Decorators
    • Introspektionshelfer
    • Konstante
    • Veraltete Aliase
      • Aliase zu integrierten Typen
      • Aliase zu Typen in collections
      • Aliase zu anderen konkreten Typen
      • Aliase zu Container-ABCs in collections.abc
      • Aliase zu asynchronen ABCs in collections.abc
      • Aliase zu anderen ABCs in collections.abc
      • Aliase zu contextlib ABCs
  • Deprecation-Zeitlinie wichtiger Funktionen
• pydoc — Dokumentationsgenerator und Online-Hilfesystem
• Python-Entwicklungsmodus
  • Auswirkungen des Python-Entwicklungsmodus
  • ResourceWarning Beispiel
  • Beispiel für „Bad file descriptor“-Fehler
• doctest — Tests für interaktive Python-Beispiele
  • Einfache Verwendung: Überprüfung von Beispielen in Docstrings
  • Einfache Verwendung: Überprüfung von Beispielen in einer Textdatei
  • Kommandozeilenverwendung
  • Wie es funktioniert
    • Welche Docstrings werden untersucht?
    • Wie werden Docstring-Beispiele erkannt?
    • Was ist der Ausführungskontext?
    • Was ist mit Ausnahmen?
    • Optionale Flags
    • Direktiven
    • Warnungen
  • Basis-API
  • Unittest-API
  • Erweiterte API
    • DocTest-Objekte
    • Beispiel-Objekte
    • DocTestFinder-Objekte
    • DocTestParser-Objekte
    • TestResults-Objekte
    • DocTestRunner-Objekte
    • OutputChecker-Objekte
  • Debugging
  • Soapbox
• unittest — Framework für Unit-Tests
  • Grundlegendes Beispiel
  • Kommandozeilenoberfläche
    • Kommandozeilenoptionen
  • Test-Erkennung
  • Testcode organisieren
  • Alten Testcode wiederverwenden
  • Tests und erwartete Fehler überspringen
  • Testiterationen mit Subtests unterscheiden
  • Klassen und Funktionen
    • Testfälle
    • Tests gruppieren
    • Tests laden und ausführen
      • load_tests-Protokoll
  • Klassen- und Modul-Fixtures
    • setUpClass und tearDownClass
    • setUpModule und tearDownModule
  • Signalbehandlung
• unittest.mock — Bibliothek für Mock-Objekte
  • Schneller Überblick
  • Die Mock-Klasse
    • Aufruf
    • Attribute löschen
    • Mock-Namen und das name-Attribut
    • Mocks als Attribute anhängen
  • Die Patchers
    • patch
    • patch.object
    • patch.dict
    • patch.multiple
    • patch-Methoden: start und stop
    • patch builtins
    • TEST_PREFIX
    • Verschachtelte Patch-Decorators
    • Wo patchen
    • Patchen von Deskriptoren und Proxy-Objekten
  • MagicMock und Unterstützung für magische Methoden
    • Magische Methoden mocken
    • Magic Mock
  • Helfer
    • sentinel
    • DEFAULT
    • call
    • create_autospec
    • ANY
    • FILTER_DIR
    • mock_open
    • Autospeccing
    • Mocks versiegeln
  • Reihenfolge der Priorität von side_effect, return_value und wraps
• unittest.mock — erste Schritte
  • Mock verwenden
    • Mock-Patching-Methoden
    • Mock für Methodenaufrufe auf einem Objekt
    • Klassen mocken
    • Mocks benennen
    • Alle Aufrufe verfolgen
    • Rückgabewerte und Attribute setzen
    • Ausnahmen mit Mocks auslösen
    • Side-Effect-Funktionen und Iterables
    • Asynchrone Iteratoren mocken
    • Asynchronen Context Manager mocken
    • Einen Mock aus einem vorhandenen Objekt erstellen
    • Side_effect verwenden, um pro Datei Inhalt zurückzugeben
  • Patch-Decorators
  • Weitere Beispiele
    • Chained Calls mocken
    • Partielles Mocking
    • Generator-Methode mocken
    • Denselben Patch auf jede Testmethode anwenden
    • Ungebundene Methoden mocken
    • Mehrere Aufrufe mit Mock überprüfen
    • Umgang mit veränderlichen Argumenten
    • Verschachtelte Patches
    • Dictionary mit MagicMock mocken
    • Mock-Unterklassen und ihre Attribute
    • Imports mit patch.dict mocken
    • Reihenfolge der Aufrufe verfolgen und weniger verbale Aufruf-Assertions
    • Komplexere Argumentenabgleichung
• test — Paket für Regressionstests für Python
  • Schreiben von Unit-Tests für das test-Paket
  • Tests über die Kommandozeilenschnittstelle ausführen
• test.support — Hilfsprogramme für die Python-Testsuite
• test.support.socket_helper — Hilfsprogramme für Socket-Tests
• test.support.script_helper — Hilfsprogramme für Python-Ausführungstests
• test.support.bytecode_helper — Unterstützungswerkzeuge für das Testen korrekter Bytecode-Generierung
• test.support.threading_helper — Hilfsprogramme für Threading-Tests
• test.support.os_helper — Hilfsprogramme für OS-Tests
• test.support.import_helper — Hilfsprogramme für Import-Tests
• test.support.warnings_helper — Hilfsprogramme für Warnungstests