JSON till Python — Generera klasser

Från JSON till typade Python-klasser

Att arbeta med råa dictionaries går snabbt tills ett stavfel i ett nyckelnamn orsakar ett KeyError tre lager ner. Den här JSON till Python-konverteraren genererar typade klasser från ett JSON-exempel, så att din editor, typkontroll och dina kollegor vet exakt vad varje payload innehåller. Varje objekt blir en klass med annoterade attribut, nästlade objekt blir egna klasser, listor typas efter sin elementtyp och värden som ibland saknas typas som valfria. JSON-nycklar konverteras till attributnamn i snake_case, medan den genererade serialiseringskoden behåller de ursprungliga nycklarna i dataformatet.

Genereringen sköts av quicktype, som slår ihop alla element i varje array innan typerna infereras. Ett fält som bara förekommer i vissa objekt fångas därför ändå och markeras som valfritt i stället för att tyst försvinna.

Dataclasses, Pydantic och Python-versioner

Som standard använder resultatet @dataclass-klasser ur standardbiblioteket samt funktionerna from_dict och to_dict, som validerar och konverterar varje fält, så du behöver inget tredjepartsberoende. Om ditt projekt redan använder Pydantic — för FastAPI-request bodies, inställningar eller validering — markerar du Pydantic BaseModel, och klasserna ärver då från BaseModel. Väljaren för Python-version styr typsyntaxen: 3.10+ ger moderna annoteringar som list[int] och str | None, medan äldre mål faller tillbaka på modulen typing. Markera Classes only för att hoppa över konverteringshjälparna helt.

Praktiska tips

Använd ett exempel som tar med valfria fält och innehåller flera arrayelement, eftersom inferensen bara kan beskriva det den ser. Döp rotklassen efter din domän — Invoice läses bättre än Root — så använder nedladdningen det namnet. Efter genereringen kör du din formaterare och typkontroll (Black, Ruff, mypy eller Pyright) och skärper till sådant som exemplet inte kunde visa, till exempel strängar som egentligen är enums eller tal som borde vara Decimal. All tolkning och kodgenerering sker lokalt, så du kan tryggt klistra in svar som innehåller kunddata.