Công cụ này biến cấu trúc JSON thành class BaseModel của Pydantic v2 hoặc code @dataclass của thư viện chuẩn. Tên field được viết lại sang snake_case đúng phong cách Python, và mỗi object lồng nhau có class riêng.
Hãy dùng nó khi định nghĩa schema request và response cho FastAPI, khi thêm type hint cho dữ liệu lấy về bằng requests hay httpx, hoặc khi dọn lại script ETL và scraping đang đào sâu vào dict bằng key chuỗi.
Tên kiểu (ví dụ Forecast).Kiểu, chọn Pydantic (v2) nếu cần validation và alias, hoặc dataclass cho model không phụ thuộc thư viện nào.models.py. Kiểu và tên kiểu được lưu trong URL.{
"city": "Seoul",
"updatedAt": "2024-05-01T09:00:00+09:00",
"current": { "temp": 18.5, "humidity": 40 },
"hourly": [
{ "hour": 10, "temp": 19, "rain_mm": 0 },
{ "hour": 11, "temp": 20.5, "rain_mm": 0.4, "alert": "shower" }
]
}from __future__ import annotations
from pydantic import BaseModel, ConfigDict, Field
class Hourly(BaseModel):
hour: int
temp: float
rain_mm: float
alert: str | None = None
class Current(BaseModel):
temp: float
humidity: int
class Forecast(BaseModel):
model_config = ConfigDict(populate_by_name=True)
city: str
updated_at: str = Field(alias="updatedAt")
current: Current
hourly: list[Hourly]
updatedAt thành field updated_at, gắn lại với key gốc bằng Field(alias="updatedAt"). Trong hourly, temp trộn số nguyên và số thập phân nên thành float, còn alert, chỉ có ở phần tử thứ hai, là str | None = None. Class con được xuất ra trước.
Field(alias=...), và model_config = ConfigDict(populate_by_name=True) cho phép điền giá trị bằng cả tên Python.= None để tránh TypeError: non-default argument follows default argument; key gốc được giữ dưới dạng comment # JSON: "updatedAt".str, int, float, bool, list[...], và Any cho giá trị có kiểu lẫn lộn.null thành X | None = None.class, from hay type được thêm gạch dưới ở cuối (class_).from __future__ import annotations được thêm vào để các class tham chiếu lẫn nhau bất kể thứ tự.Root = list[RootItem].Dựng BaseModel từ JSON đã thống nhất với frontend rồi dùng trong response_model= hoặc làm tham số endpoint; tài liệu OpenAPI tự động theo sau.
Bọc lời gọi trong Forecast.model_validate(resp.json()), khi nhà cung cấp đổi kiểu một field, ValidationError sẽ chỉ đúng đường dẫn field bị hỏng.
Đổi data["current"]["temp"] thành forecast.current.temp giúp có gợi ý code trong editor và cho mypy hay pyright kiểm tra code.
@dataclass không chuyển dict lồng nhau thành object. Sau Forecast(**data), current vẫn là dict; hãy dùng Pydantic hoặc helper như dacite nếu cần chuyển đổi lồng nhau.updatedAt) trong Pydantic, gọi model_dump(by_alias=True) hoặc model_dump_json(by_alias=True).str | None, nên model Pydantic giả định Python 3.10 trở lên.str. Với Pydantic, chỉ cần đổi annotation thành datetime là parse được giá trị ISO 8601.class Config, parse_obj).populate_by_name=True để làm gì?Mặc định field có alias chỉ nhận alias (updatedAt) làm đầu vào. Với thiết lập này bạn có thể viết cả Forecast(updated_at=...), tiện khi viết test.
Optional[str] cho field tùy chọn.str | None và Optional[str] có nghĩa như nhau. Nếu cần tương thích Python 3.9, hãy import Optional từ typing và đổi các annotation.
Các kiểu được hỗ trợ là Pydantic v2 và dataclass. Danh sách field của dataclass chuyển thẳng sang TypedDict hoặc class @attrs.define nếu bạn cần một trong hai.
Không. Khi tên Python trùng với key gốc, không có Field(alias=...) hay ConfigDict nào được xuất ra, nên bạn nhận được dòng đơn giản như rain_mm: float.