JSON a Python

Relacionats

Sobre JSON a Python: Convertir dades JSON en models dataclass executables

Casos d'ús

• Integració REST API
• Models petició/resposta FastAPI
• Serialitzadors Django Ninja / DRF
• Modelatge de dades Scraper
• Definició de features ML
• Deserialització de fitxers de configuració
• Estructura temporal Jupyter Notebook
• Definició d'interfície de microserveis
• Desenvolupament d'eines CLI
• Construcció de dades de prova
• Anàlisi de logs estructurats
• Migració de centre de configuració
• Col·laboració cross-language
• Migració de bases de dades
• Blockchain/Web3
• ETL Data Science
• Validació d'esquema OpenAPI
• Exemples didàctics
• Conversió de noms de camp

Com usar-ho

1. Enganxa el contingut JSON a l'editor de l'esquerra o carrega un fitxer
2. Espera 400ms per a la conversió automàtica
3. Si el JSON està mal format fes clic a «Repara JSON»
4. Fes clic a «Copiar» o «Descarrega» per guardar model.py

Característiques

• Conversió local al navegador
• Sortida amb anotacions dataclass
• Reconeixement automàtic de tipus
• Divisió automàtica d'objectes anidats
• Resolució automàtica de genèrics List
• Camps Optional opcionals
• Conversió automàtica amb debounce de 400ms
• Correcció d'errors JSON en un clic
• Copiar i descarregar
• Historial d'entrada localStorage
• Panells responsius redimensionables
• Suporta postprocessament Pydantic/attrs/TypedDict

Exemples de codi

# requirements.txt
# requests>=2.31

from dataclasses import dataclass
from typing import Any, List, Optional
import json
import requests


@dataclass
class Address:
    city: str
    zip: str


@dataclass
class User:
    id: int
    name: str
    active: bool
    address: Address
    tags: List[str]
    label: Optional[Any] = None


def main() -> None:
    resp = requests.get("https://api.example.com/users/1", timeout=10)
    resp.raise_for_status()
    user: User = User(**resp.json())
    print(f"{user.name} lives in {user.address.city}")


if __name__ == "__main__":
    main()

# pip install fastapi 'pydantic>=2'

from typing import List, Optional
from fastapi import FastAPI
from pydantic import BaseModel


class Address(BaseModel):
    city: str
    zip: str


class User(BaseModel):
    id: int
    name: str
    email: str
    active: bool = True
    address: Address
    tags: List[str] = []
    label: Optional[str] = None


app = FastAPI()


@app.post("/users")
async def create_user(user: User) -> dict:
    return {"id": user.id, "name": user.name}

Best Practices

Preguntes freqients

Solució de problemes

Glossari

dataclass

Decorador de la biblioteca estàndard Python 3.7+ (@dataclass) per generar automàticament màgics.

Mòdul typing

Biblioteca estàndard Python per a anotacions de tipus.

Optional[T]

Tipus opcional del mòdul typing.

List[T]

Tipus de llista genèrica de Python.

Any

Tipus especial que accepta qualsevol tipus.

Pydantic BaseModel

Classe base per a models de dades de la biblioteca Pydantic.

FastAPI

Framework web Python modern basat en Pydantic.

PEP 557

Proposta que defineix la sintaxi del decorador dataclass.

Anotació de tipus (Type Hint)

Indicació de tipus anotada després de paràmetres i variables.

PEP 484

Proposta d'estàndard per a anotacions de tipus a Python.

from __future__ import annotations

Instrucció per avaluació retardada d'anotacions (PEP 563).

model.py

Nom de fitxer per defecte descarregat per aquesta eina.

Taula de referència ràpida tipus JSON → tipus Python

L'eina dedueix automàticament el tipus Python corresponent:

Privacy & Security

Totes les operacions d'aquesta eina JSON a Python passen completament de forma local al navegador: el parsing JSON, la generació de codi Python i la descàrrega de fitxers s'executen totes al costat del client mitjançant JavaScript, cap contingut JSON, fitxers carregats o codi generat s'envia per la xarxa a servidors.

Authoritative References

• PythonDocumentació oficial Python - dataclasses
• PydanticDocumentació oficial Pydantic
• FastAPIDocumentació oficial FastAPI