Python Typing Generator

Formål & brugerintention: Værktøjet analyserer Python-kildekoden og docstrings for at generere præcise typing-hints. Det henvender sig til udviklere, biblioteksvedligeholdere, dataingeniører og teams der migrerer til typing og har brug for konsekvente type-kontrakter i store kodebaser. Brug ved refactoring, API-udformning eller onboarding for at standardisere typing.

Kernelogik & funktioner: Obligatoriske funktioner inkluderer AST-baseret inferens fra funktionsdefinitioner, parametre, returtyper og docstrings; understøttelse af PEP 484 typing-konstruktioner (List, Dict, Optional, Union, Callable); eksportformater til inline-annoteringer eller standalone .pyi-stubfiler; grundlæggende TypeVar og generics-støtte; krydssumodulos-dolution for at reducere uafklarede imports. Valgfri funktioner: konfigurerbar inferenstæthed, integration med eksisterende type hints og generering af en type-oversigt. Logikken foretrækker eksplicitte annoteringer, hvis til stede; ellers udledes sandsynlige typer og falder tilbage til Any eller Optional for ubestemte tilfælde. Outputs kan injiceres i koden eller leveres som patch-klare stubs. En valideringsrunde kontrollerer type-konsistens og rapporterer konflikter.

Input & Output: Inddata er et Python-kodesnippet eller filsti, en modesudvælgelse (inline vs Stub) og valgfri angivelser om inferenstæthed. Output inkluderer annoterede kodeblokke eller .pyi-filer, formatteret efter PEP 8 og typing-standarden. Værktøjet producerer også et kort type-resumé, en liste over udledte typer og advarsler for umiddelbare import- eller dynamiske konstruktioner.

Algoritmer & beregninger: Værktøjet解析erer AST, indsamler symboldefinitioner og udleder parametre og returtyper fra signaturer og docstrings. Docstring-typer oversættes til typing-konstruktioner, imports løses og udledte typer propagers gennem moduler. Slutoutput er enten direkte ændringer i koden eller separate stub-erklæringer. Kanttilfælde inkluderer dynamiske attributter, reflection eller højgradig metaprogrammering hvor typing er usikkert; i sådanne tilfælde signalerer værktøjet konservativ typing og anbefaler eksplicitte annotationer.

Industri/Region & Lokalisering; Antagelser & Udeladelser: Følger standard Python-typing-konventioner (PEP 484) og US/EU kodningsnormer; lokal-specifik formatering ikke påkrævet. Forudsætter gyldig Python-inddata, kører ikke koden og udelukker runtime refactoring eller fuld statisk analyse udover typing-vejledning.