Python Typing Generator

Zweck & Benutzerabsicht: Das Tool analysiert Python-Quellcode und Docstrings, um präzise Typing-Hinweise zu erzeugen. Es richtet sich an Entwickler, Bibliotheksverantwortliche, Dateningenieure und Teams, die zu Typing migrieren und konsistente Typverträge über große Codebasen benötigen. Verwenden Sie es während Refactoring, API-Oberflächendesign oder Onboarding, um das Typing zu standardisieren.

Kernlogik & Funktionen: Pflichtfunktionen umfassen AST-basierte Inferenz aus Funktionsdefinitionen, Parameter-Typen, Rückgabetypen und Docstrings; Unterstützung von PEP 484 Typing-Konstrukten (List, Dict, Optional, Union, Callable); Exportformate für Inline-Annotationen oder eigenständige .pyi-Stubs; Grundunterstützung für TypeVar und Generics; modulesübergreifende Auflösung zur Reduzierung uneingetragener Importe. Optionen umfassen konfigurierbare Inferenztiefe, Integration mit vorhandenen Typ-Hinweisen und die Generierung einer Typ-Zusammenfassung. Die Logik bevorzugt explizite Annotationen, falls vorhanden; andernfalls werden wahrscheinliche Typen abgeleitet und ungeklärte Fälle auf Any oder Optional gesetzt. Outputs können in Code injiziert oder als patchbereite Stubs bereitgestellt werden. Eine Validierung prüft Typenkonsistenz und meldet Konflikte.

Eingaben & Ausgaben: Eingaben sind ein Python-Code-Schnipsel oder Dateipfad, eine Modusauswahl (Inline vs. Stub) und optionale Vorgaben zur Inferenztiefe. Ausgaben umfassen annotierte Code-Blöcke oder .pyi-Dateien, formatiert nach PEP 8 und Typing-Standards. Das Tool erzeugt außerdem eine kompakte Typ-Zusammenfassung, eine Liste der abgeleiteten Typen und Warnungen bei ungelösten Importen oder dynamischen Konstrukten.

Algorithmen & Berechnungen: Das Tool parst den AST, sammelt Symboldefinitionen und leitet Parameter- und Rückgabetypen aus Signaturen und Docstrings ab. Docstring-Typen werden in Typing-Konstrukte übersetzt, Importe aufgelöst und abgeleitete Typen über Module hinweg propagiert. Die Endausgaben sind direkte Code-Edits oder separate Stub-Deklarationen. Randfälle umfassen dynamische Attribute, Reflection oder starkes Metaprogrammieren, bei denen Typing unsicher ist; in solchen Fällen meldet das Tool konservative Typisierungen und empfiehlt explizite Annotationen.

Industrie/Region & Lokalisierung; Annahmen & Ausschlüsse: Folgt den Standard-Python-Typing-Konventionen (PEP 484) und US/EU-Codiernormen; keine locale-spezifische Formatierung erforderlich. Setzt gültigen Python-Eingaben voraus, führt Code nicht aus und schließt Laufzeit-Refactoring oder vollständige statische Analyse über das Typing hinaus aus.