JSON para Python
Gere classes Python a partir de uma amostra JSON, como modelos Pydantic ou dataclasses da biblioteca padrão. Objetos aninhados viram classes próprias, declaradas antes de serem usadas; campos opcionais e anuláveis usam Optional com valor padrão None quando a chave pode estar ausente, e valores mistos usam Union. Os nomes dos campos se tornam snake_case.
Perguntas frequentes
Como os objetos aninhados são nomeados?
Cada objeto aninhado vira seu próprio tipo Python, nomeado com base na chave que o contém em PascalCase; assim, address vira Address. Objetos dentro de arrays recebem a forma singular da chave do array; por exemplo, users vira User. Objetos com campos exatamente iguais compartilham o mesmo tipo.
Quando um campo é opcional?
Quando um array contém vários objetos e uma chave está ausente em alguns deles, esse campo é opcional: seu tipo é envolvido em Optional e o valor padrão é None. Uma chave presente em todas as amostras é obrigatória. Um único objeto não tem outros com que ser comparado, então todas as suas chaves são obrigatórias.
Como os valores nulos são tratados?
Uma chave que é nula em algumas amostras e tem valor em outras vira Optional do tipo. Se uma chave for sempre nula, a ferramenta não consegue determinar seu tipo real, então ela vira Optional[Any]; cole uma amostra com um valor real para obter um tipo preciso.
Quais tipos numéricos são usados?
Números inteiros se tornam int, e números fracionários se tornam float. Um campo que contém ambos se torna float.
O que acontece com chaves que não são nomes válidos?
Os nomes dos campos são convertidos para snake_case. Os modelos Pydantic mantêm a chave original com Field(alias=...), então model_validate lê o JSON como ele é. Dataclasses não têm aliases, então renomeie as chaves por conta própria antes de criar uma dataclass a partir de JSON cujas chaves não sejam nomes válidos em Python. Palavras reservadas do Python, como class, recebem um sublinhado no final.
Meu JSON é enviado ou armazenado?
O JSON é enviado ao servidor apenas para gerar o código desta solicitação e não é armazenado. O gerador lê somente a estrutura e os tipos de valor da sua amostra; por isso, você pode substituir valores confidenciais por marcadores do mesmo tipo antes de colá-la.