Python Typing Generator

Doel & Gebruikersintentie: De tool analyseert Python-broncode en docstrings om precieze typing-hints te genereren. Het richt zich op ontwikkelaars, bibliotheekbeheerders, data-ingenieurs en teams die overstappen op typing en behoefte hebben aan consistente type-contracten in grote codebases. Gebruik tijdens refactoring, API-ontwerp of onboarding om typing te standaardiseren.

Kernlogica & Functies: Verplichte functies omvatten AST-gebaseerde inferentie uit functie-definities, parameters, return-types en docstrings; ondersteuning voor PEP 484 typing-constructoren (List, Dict, Optional, Union, Callable); uitvoerformaten voor inline annotaties of standalone .pyi-stub-bestanden; basis TypeVar- en generics-ondersteuning; cross-module-resolutie om ongeopende imports te verminderen. Optionele functies: configureerbare inferentiediepte, integratie met bestaande type hints en generatier van een type-samenvatting. De logica geeft prioriteit aan expliciete annotaties en inferreert anders waarschijnlijkheden; onbepaalde gevallen krijgen Any of Optional. Uitvoer kan in code worden geïnjecteerd of als patch-waardige stubs worden geleverd. Een validatie-check controleert type-consistentie en meldt conflicten.

Ingangen & Uitgangen: Ingangen zijn een Python-codefragment of bestands-pad, een modos selectie (inline vs stub), en optionele aanwijzingen over inferentiediepte. Uitgangen omvatten geannoteerde codeblokken of .pyi-bestanden, geformatteerd volgens PEP 8 en typing-standaarden. Het hulpmiddel levert ook een beknopte type-samenvatting, een lijst van afgeleide typen en waarschuwingen voor niet opgelost imports of dynamische constructies.

Algoritmen & Berekeningen: Het hulpmiddel parseert de AST, verzamelt symbolische definities en leidt parameter- en return-types af uit definities en docstrings. Docstring-type vertaal naar typing-constructoren, imports worden opgelost en afgeleide typen worden door modules heen doorgegeven. De uiteindelijke outputs zijn directe code-aanpassingen of aparte stub-declaraties. Randgevallen omvatten dynamische attributen, reflectie of intensieve metaprogrammering waar typing onzeker is; in dergelijke gevallen geeft het hulpmiddel conservatieve typings en raadt expliciete annotaties aan.

Industrie/Regio & Lokalisatie; Aannames & Uitsluitingen: Volgt standaard Python-typing-conventies (PEP 484) en US/EU-codeerstandaarden; geen locale-specifieke opmaak vereist. Vóóruitgang: geldige Python-invoer wordt verondersteld, code wordt niet uitgevoerd, en runtime refactoring of volledige statische analyse buiten typing-gidsing uitgesloten.