Python Package

Modern Python

Python-Codebasen op modern Idiomen, Syntax an Standardbibliothéik-Muster ëmstellen.

Fréien Zougang: Bis 2026-12-31

Modern Python-Patterns maachen mgpy méi einfach ze pflegen: manner Legacy-Ausnamen, méi kloer CLI-Opriff a manner plattformspezifesch Spezialfäll.

Kaerpunkten

  • CLI: Ënner Windows weisen d'Beispiller de recommandéierte Start iwwer py -3.12 -m <modul> ... (z.B. py -3.12 -m manifestguard ...). Ënner Linux/macOS ass dat normalerweis python3.12 -m ....
  • Explizit Interpreter-Opriff benotzen (py -3.12 -m manifestguard ... ënner Windows, python3.12 -m manifestguard ... ënner Linux/macOS) amplaz fragiler PATH-ofhängeger Kommando-Opléisung.
  • pathlib, dataclasses, modern Typ-Syntax an ee zentrale pyproject.toml benotzen.
  • Al Ausféierungsweeër schrëttweis ofbauen an de neie Referenz-Workflow dokumentéieren.

Recommandeierte mgpy-Workflow

  1. Opruff-Weeër fir lokal Entwécklung, virtuell Ëmfeld an CI vereinheitlechen.
  2. Legacy-Hëllefsskripter nëmme behalen, wann se nach e reellen a dokumentéierte Zweck hunn.
  3. No der Moderniséierung mgpy nach eng Kéier lafen loossen, fir Packaging, Entry Points a Reports ze verifizéieren.

Schnellstart

py -3.12 -m manifestguard --version
py -3.12 -m manifestguard check
py -3.12 -m manifestguard export-metrics --output metrics.json

Viraussetzungen

Kolonnen
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.