PEP 8
Python Enhancement Proposal 8
Es ist ein Dokument, das die offizielle Stilrichtlinie für Python-Code definiert.
Es hilft Entwicklern, konsistenten und lesbaren Code zu schreiben, was besonders in Teams wichtig ist.
Die wichtigsten Punkte von PEP 8:
-
Einrückungen:
- Verwende 4 Leerzeichen pro Einrückungsebene, keine Tabs.
-
Maximale Zeilenlänge:
- Beschränke Zeilen auf 79 Zeichen (72 Zeichen für Kommentare und Docstrings).
-
Leerzeilen:
- Nutze Leerzeilen, um Funktionen, Klassen und große Abschnitte zu trennen.
-
Kommentare:
- Schreib sinnvolle, erklärende Kommentare.
- Für mehrzeilige Kommentare nutze
#
für jede Zeile.
-
Funktionen und Variablen:
- Funktionsnamen:
snake_case
(z. B.calculate_sum
). - Konstanten: Großbuchstaben mit Unterstrichen (z. B.
MAX_VALUE
).
- Funktionsnamen:
-
Imports:
- Schreibe je einen Import pro Zeile.
- Gruppiere sie in dieser Reihenfolge:
- Standardbibliotheken (
import os
). - Drittanbieter-Bibliotheken (
import requests
). - Eigene Module (
import my_module
).
- Standardbibliotheken (
-
Leerzeichen:
-
Setze keine Leerzeichen vor Klammern:
def example(a, b): return a + b
-
Vermeide mehrere Leerzeichen, außer für Ausrichtung:
x = 42 # richtig
-
-
Zeichenketten:
- Für Strings entweder einfache oder doppelte Anführungszeichen verwenden, aber konsistent bleiben.
Beispiel für PEP-8-konformen Code:
def add_numbers(a, b):
"""Add two numbers and return the result."""
result = a + b
return result
PEP 8 kannst du mit Tools wie flake8
oder pylint
überprüfen lassen!