Musterlösung zu LU09.A01 - Code mit Linter verbessern.
Analysiert wurden die Python-Dateien im Repository m450-lu09-a01 (ohne das Hilfsskript _run_pylint.py) mit drei verbreiteten Lintern.
Die Zahlen gelten für den Stand des Repositorys im November 2026 und die genannten Einstellungen. Andere Versionen oder Einstellungen ergeben andere Zahlen. Bewertet wird, ob die Gruppe ihre Einstellungen begründet und die Meldungen kritisch einordnet.
Die BZZ Codingstandards basieren auf PEP 8, weichen aber in einigen Punkten davon ab. Diese Punkte müssen in jedem Linter angepasst werden:
| Codingstandard | pylint | flake8 | ruff |
|---|---|---|---|
| Zeilen maximal 120 Zeichen (PEP 8: 79) | max-line-length=120 | max-line-length = 120 | line-length = 120 |
| Docstrings für Klassen und Methoden zwingend | Standard (C0115, C0116) | nur mit Plugin flake8-docstrings | Regelgruppe D aktivieren |
Docstring-Format :param: / :return: | Erweiterung docparams | – | – |
Ausrichten von = untereinander ist erlaubt | wird nicht gemeldet | E221 ausschalten (extend-ignore = E221) | E221 ist standardmässig aus |
| snake_case, PascalCase, Konstanten gross | Standard (C0103) | nur mit Plugin pep8-naming | Regelgruppe N |
Wo wird konfiguriert?
| Linter | Konfigurationsdatei | Kommandozeile |
|---|---|---|
| pylint | .pylintrc oder pyproject.toml ([tool.pylint]) | pylint –max-line-length=120 *.py |
| flake8 | .flake8, setup.cfg oder tox.ini ([flake8]) | flake8 –max-line-length=120 *.py |
| ruff | ruff.toml oder pyproject.toml ([tool.ruff]) | ruff check –line-length 120 –select E,W,F,N,D *.py |
Beispiel .flake8:
[flake8] max-line-length = 120 extend-ignore = E221
Beispiel ruff.toml:
line-length = 120 [lint] select = ["E", "W", "F", "N", "D", "B", "PL"] ignore = ["D300", "D212", "D205", "D400", "D415", "D208", "D200"] # Docstring-Formatierung nach PEP 257, nicht Teil der BZZ-Standards [lint.per-file-ignores] "test_*.py" = ["PLR2004"] # feste Werte in Tests sind erwünscht
| Linter (Einstellung) | Meldungen | Arten von Meldungen | false positive |
|---|---|---|---|
| pylint 4.0 (Zeilenlänge 120) | 63 | Convention (C): 41, Warning (W): 22 | 0 |
| flake8 (Zeilenlänge 120) | 50 | E (pycodestyle): 43, W (Whitespace): 7 | 4 (E221) |
| ruff (E, W, F, N, D, B, PL, Zeilenlänge 120) | 169 | D (Docstrings): 156, PL (Pylint-Regeln): 6, E/W (pycodestyle): 7 | 131 (Docstring-Formatierung, PLR2004) |
| Anzahl | Code | Meldung | Bedeutung |
|---|---|---|---|
| 21 | W0311 | bad-indentation | Einrückung nicht 4 Leerzeichen |
| 18 | C0116 | missing-function-docstring | Testfunktionen ohne Docstring |
| 9 | C0114 | missing-module-docstring | Modul ohne Docstring |
| 4 | C0304 | missing-final-newline | letzte Zeile ohne Zeilenumbruch |
| 4 | C0115 | missing-class-docstring | Klasse ohne Docstring |
| 3 | C0305 | trailing-newlines | zu viele Leerzeilen am Dateiende |
| 3 | C0301 | line-too-long | Zeile länger als 120 Zeichen |
| 1 | W0246 | useless-parent-delegation | Methode ruft nur die Oberklasse auf |
Bewertung: 6.50/10. Alle Meldungen entsprechen einem Verstoss gegen die Codingstandards.
Mit der Erweiterung –load-plugins=pylint.extensions.docparams findet pylint zusätzlich, dass im Docstring von Person.address der Parameter adresse statt address beschrieben ist. Das findet kein anderer Linter.
| Anzahl | Code | Bedeutung |
|---|---|---|
| 21 | E111 | Einrückung kein Vielfaches von 4 |
| 7 | E302 | erwartet 2 Leerzeilen vor Klasse oder Funktion |
| 4 | W292 | kein Zeilenumbruch am Dateiende |
| 4 | E221 | mehrere Leerzeichen vor Operator (false positive, Ausrichten ist laut Standard erlaubt) |
| 3 | W391 | Leerzeile am Dateiende |
| 3 | E501 | Zeile zu lang |
| 3 | E305 | erwartet 2 Leerzeilen nach Klasse oder Funktion |
| 3 | E265 | Blockkommentar muss mit ''# '' beginnen |
| 2 | E303 | zu viele Leerzeilen |
flake8 findet ohne Plugins keine fehlenden Docstrings, dafür die fehlenden Leerzeilen, die pylint nicht meldet.
| Anzahl | Code | Bedeutung | false positive? |
|---|---|---|---|
| 26 | D300 | Docstring mit „“„ statt mit einfachen Anführungszeichen | ja |
| 26 | D212 | Zusammenfassung muss auf der ersten Zeile stehen | ja |
| 25 | D205 | Leerzeile nach der Zusammenfassung | ja |
| 21 | D415 / D400 | Zusammenfassung endet nicht mit Punkt | ja (je 21) |
| 18 | D102 | Methode ohne Docstring | nein |
| 9 | D100 | Modul ohne Docstring | nein |
| 6 | PLR2004 | feste Zahl im Vergleich (in Tests) | ja |
| 5 | D208 | Docstring zu weit eingerückt | ja |
| 4 | D101 | Klasse ohne Docstring | nein |
| 4 | W292 | kein Zeilenumbruch am Dateiende | nein |
| 3 | E501 | Zeile zu lang | nein |
| 1 | D200 | einzeiliger Docstring auf mehreren Zeilen | ja |
Die meisten Meldungen betreffen die Formatierung von Docstrings nach PEP 257. Diese Regeln stehen nicht in den BZZ-Standards und sind deshalb false positive. Übrig bleiben die fehlenden Docstrings, der Zeilenumbruch am Dateiende und zu lange Zeilen.
Employee._salary wird erst im Setter angelegt. Wer print() vor dem Setzen des Lohns aufruft, erhält einen AttributeError.# nur für Test (Standard: Bezeichner in Englisch).p oder m im __main__-Block.Ein Linter ersetzt also kein Code-Review (siehe LU09c - Codereview).
| Kriterium | pylint | flake8 | ruff |
|---|---|---|---|
| Konfiguration | sehr viele Optionen, eigene rcfile | einfach, wenige Optionen | einfach, Regeln nach Gruppen wählbar |
| Docstrings | ja | nur mit Plugin | ja, sehr streng (PEP 257) |
| Formatierung | Einrückung, Zeilenlänge | sehr genau (Leerzeilen, Abstände) | wie flake8 |
| Logikfehler | einige (z. B. unnötige Methoden) | nur mit pyflakes (unbenutzte Imports) | viele, mit Gruppen B und PL |
| Geschwindigkeit | langsam | mittel | sehr schnell |
| Automatisch korrigieren | nein | nein | ja (–fix, 61 Meldungen) |
| false positive bei BZZ-Standards | kaum | wenige | viele, wenn alle Regeln aktiv sind |
Fazit: Für die BZZ-Standards passt pylint am besten, weil Docstrings ohne Zusatz geprüft werden und kaum false positive auftreten. ruff ist schnell und kann vieles automatisch korrigieren, muss aber sorgfältig konfiguriert werden. flake8 ergänzt pylint gut bei Leerzeilen und Abständen.