Ergebnis dieses Guides
Ein kleiner Änderungsvorschlag mit überprüfbarem Verhalten
Arbeitsumgebung
Python mit festgehaltener Interpreterversion und isolierter Projektumgebung
Wann ist diese Entscheidung wichtig?
Qualität zeigt sich daran, wie leicht eine fachliche Änderung verstanden und geprüft werden kann. Zusätzliche Abstraktion ist nicht automatisch hilfreich.
Trennen Sie Datenverarbeitung von Datei-, Netzwerk- und Konsolenzugriffen. Behandeln Sie veränderliche Listen und Dictionaries bewusst; Typannotationen unterstützen Werkzeuge, erzwingen aber keine automatische Laufzeitvalidierung.
Codequalität: Schritt für Schritt.
- 01
Vorbereiten
Wählen Sie eine schwer verständliche Stelle und notieren Sie ihr beobachtbares Verhalten.
- 02
In Python umsetzen
Trennen Sie Verantwortlichkeiten, benennen Sie fachliche Begriffe und entfernen Sie echte Doppelarbeit. Prüfen Sie danach denselben Nutzerfall.
- 03
Im tatsächlichen Projekt prüfen
Starten Sie die Prüfung mit demselben Interpreter wie die Anwendung. Kontrollieren Sie fehlende Schlüssel, leere Sammlungen und erwartete Exceptions sowie die verwendeten Paketversionen.
Beispiel zur Überprüfung
So lässt sich das Ergebnis prüfen.
Als Projektkontext dient einen Dienst, der eingehende Dokumente verarbeitet. Der folgende Prüffall ist eine Vorlage für diese Aufgabe und kein Bericht über eine Kundenmessung.
- Eingabe / Auslöser
- Eine neue Variante einer bestehenden fachlichen Regel
- Erwartetes Ergebnis
- Die Änderung betrifft einen klaren Bereich und ihre Wirkung ist durch gezielte Prüfungen belegt.
- Fehler- oder Grenzfall
- Eine Umstrukturierung verändert weder Schnittstellen noch Fehlerverhalten unbeabsichtigt.
Abnahme und typische Fehler.
- Eine Änderung lässt sich ohne umfangreiche Seiteneffekte umsetzen.
- Eine Umstrukturierung verändert weder Schnittstellen noch Fehlerverhalten unbeabsichtigt.
- Abhängigkeiten und Laufzeitumgebung müssen reproduzierbar sein, besonders bei Datenjobs.
Typischer Fehler
Abstraktion um ihrer selbst willen macht einfachen Code schwer.
Quellen und Versionshinweis
Die Anleitung beschreibt das Vorgehen; konkrete APIs, Produktfunktionen und Laufzeitgrenzen müssen zur eingesetzten Version passen. Halten Sie Version, Konfiguration und Prüfergebnis im Projekt fest und vergleichen Sie die verlinkte Dokumentation bei Änderungen.
