Python Package

PEP 8-Stil

PEP-8-Formatierungs- und Stilregeln mit ManifestGuard-Qualitaetspruefungen anwenden.

Früher Zugriff: Bis 2026-12-31

PEP 8 ist fuer mgpy die lesbare Basislinie. Gute Stilregeln beschleunigen Debugging, senken kognitive Last und halten Review-Diskussionen kurz.

Kernpunkte

  • CLI: Unter Windows zeigen die Beispiele den empfohlenen Aufruf via py -3.12 -m <modul> ... (z.B. py -3.12 -m manifestguard ...). Auf Linux/macOS entspricht das in der Regel python3.12 -m ....
  • Nutze automatische Formatierung konsequent statt manuellem Nachpolieren.
  • Halte Import-Gruppierung, Zeilenlaengen und Benennung ueber das ganze Repo stabil.
  • Behandle Stilregeln als Voraussetzung fuer hochwertige Extended-Checks, nicht als Nacharbeit.

Empfohlener MG-Python-Workflow

  1. Ruff-Regeln im Projekt festziehen und lokal automatisch fixen lassen.
  2. Vor jedem groesseren Refactoring erst Stilabweichungen bereinigen, damit Fachaenderungen isoliert reviewbar bleiben.
  3. Nach der Formatierung mgpy erneut ausfuehren und nur noch echte Qualitaetssignale bearbeiten.

Schnellstart

py -3.12 -m ruff check . --fix
py -3.12 -m ruff format .
py -3.12 -m manifestguard check

Voraussetzungen

Spalten
Installation interpreter
Python 3.12 + pip
Recommended default path for installation and CLI calls.
Project target versions
Python 3.8 to 3.12
These are the project/runtime targets mgpy can analyze.
mgpy runtime
Validated on Python 3.10 to 3.13
The tool runtime itself is covered for this range.
CLI invocation
Windows: py -3.12 -m manifestguard
Linux/macOS usually maps to python3.12 -m manifestguard.
Runtime packages
tomlkit, click, pydantic, packaging, watchdog, PyNaCl, rfc8785
tomli is only added for Python below 3.11.
Offline / wheel install
Optional via pip --no-index or wheel
Useful for air-gapped or approved bundle distribution paths.