Beta
Freemium
Developer Tooling

Type Hints

Python-Typannotatiounen dobäisetzen a validéieren, fir d statesch Analyse ze verbesseren.

Type Hints maachen mgpy-Reports méi präzis, well ëffentlech API-Grenzen, Return-Wäerter an Date-Modeller méi kloer validéiert kënne ginn.

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 ....
  • Als éischt ëffentlech Funktiounen, Date-Modeller a Return-Objekter annotéieren.
  • Type Hints mat kloeren Docstrings kombinéieren amplaz duebel an widderspréchlech Informatioun ze pflegen.
  • Wann e Package als typéiert Code konsuméiert soll ginn, gehéieren py.typed a stabil Imports zur kompletter Léisung.

Recommandeierte mgpy-Workflow

  1. Mat den Haapt-Entrée- an Austrëttspunkten vun der Bibliothéik ufänken.
  2. No all Annotatiouns-Ronn MyPy oder eng gläichwäerteg Typprüfung géint reell Usage-Pfade lafen loossen.
  3. Duerno mgpy ausféieren, fir Packaging an API-Kontrakter openeen ofzestëmmen.

Schnellstart

python -m mypy src
py -3.12 -m manifestguard check --extended
py -3.12 -m manifestguard schema --output openapi.json