Преобразуйте JSON в struct Rust!

Введите JSON, чтобы получить код struct на Rust, включая вложенные объекты! Поддержка: serde Serialize, Deserialize, #[serde(rename)].
JSON
Результат
 

Преобразуйте JSON в struct Rust!

Превращает пример JSON в struct на Rust, готовые для serde. Каждая структура выводит Debug, Clone, Serialize, Deserialize; имена полей следуют соглашению Rust о snake_case и, если отличаются, связываются с исходным ключом через #[serde(rename)].

Хорошая отправная точка, когда нужны типизированные ответы reqwest, тип запроса для экстрактора Json<T> в axum или actix-web или когда вы пишете CLI, разбирающий JSON логов или событий.

Как пользоваться

  1. Вставьте JSON. Массив из нескольких элементов помогает распознать необязательные поля.
  2. Введите имя структуры верхнего уровня в Имя типа (например, AccessLog).
  3. Вставьте вывод в файл .rs и добавьте serde (с фичей derive) и serde_json в Cargo.toml.
  4. Используйте через serde_json::from_str::<AccessLog>(&body)? или resp.json::<AccessLog>().await?.

Пример

Вход (JSON)
{
  "timestamp": 1714550400,
  "level": "warn",
  "type": "http_request",
  "status": 503,
  "latency_ms": 1250.7,
  "headers": [{ "name": "user-agent", "value": "curl/8.4" }],
  "trace_id": null
}
Результат (Rust · serde)
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AccessLog {
    pub timestamp: i64,
    pub level: String,
    #[serde(rename = "type")]
    pub type_: String,
    pub status: i64,
    pub latency_ms: f64,
    pub headers: Vec<Header>,
    pub trace_id: serde_json::Value,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Header {
    pub name: String,
    pub value: String,
}

type — ключевое слово Rust, поэтому поле называется type_ с #[serde(rename = "type")]. Целые — i64 независимо от величины, а latency_ms — f64. trace_id всегда null, так что его тип неизвестен и он остаётся serde_json::Value; замените его реальным типом, например Option<String>.

Возможности

  • #[derive(Debug, Clone, Serialize, Deserialize)] и поля pub на каждой структуре.
  • #[serde(rename = "originalKey")] на отдельных полях, когда ключ отличается от имени поля в snake_case.
  • Поля, отсутствующие в части элементов: Option<T> с #[serde(default, skip_serializing_if = "Option::is_none")].
  • Поля, присутствующие всегда, но иногда равные null: просто Option<T> без атрибутов.
  • Типы: i64 для целых, f64 для дробных, bool, String, Vec<T> и serde_json::Value для смешанных типов.
  • Ключи-ключевые слова вроде type, match или ref получают подчёркивание в конце (type_).
  • Массив верхнего уровня даёт pub type Root = Vec<RootItem>;.

Сценарии использования

Типизированные ответы reqwest

Замените обращения к serde_json::Value вроде ["status"].as_i64() на resp.json::<AccessLog>(), и опечатка в имени поля обнаружится на этапе компиляции.

Тела запросов в axum или actix-web

Сгенерируйте структуру по JSON, который присылает клиент, и принимайте её как Json(payload): Json<CreateOrder>; запросы с отсутствующими полями или полями не того типа фреймворк отклонит ещё до кода обработчика.

CLI для анализа логов в формате JSON Lines

Постройте структуру по одной строке лога, затем десериализуйте каждую строку из BufReader::lines() — и инструмент агрегации по полям готов в несколько строк.

Примечания и ограничения

  • Целые всегда i64, какими бы маленькими они ни были. Сузьте их сами там, где диапазон известен, например u16 для кодов статуса или u32 для счётчиков.
  • Метки времени и строки с датами остаются i64 или String. Переход на типы chrono или time требует включить serde-фичи этих крейтов.
  • Вывод с serde_json::Value пишет полный путь, так что дополнительный use не нужен, а вот зависимость serde_json нужна.
  • Переименования сделаны для каждого поля, а не через #[serde(rename_all = "camelCase")] на уровне структуры. Если ключи следуют одному соглашению, можете свернуть их сами.
  • Tagged enum не генерируются. Поля с фиксированным набором значений, как "level": "warn", — хорошие кандидаты на последующее превращение в enum.

Частые вопросы

Зачем необязательным полям ещё и #[serde(default)]?

serde и так заполняет отсутствующий Option значением None, но явный default продолжит принимать отсутствующие ключи, если вы позже поменяете тип, например на Vec<T>. skip_serializing_if опускает поля None при обратной записи JSON, сохраняя исходную форму.

Чем в выводе отличаются поля, допускающие null, и отсутствующие поля?

Оба становятся Option<T>, но атрибуты default и skip_serializing_if получают только поля, ключ которых может отсутствовать. Поле, которое присутствует всегда, но иногда равно null, записывается обратно как null.

Почему не заимствовать через поля &str и время жизни 'de?

Zero-copy поля (&'a str) не могут пережить входной буфер, что неудобно при обычной обработке ответов. По умолчанию используется владеющий String; если важна производительность, переведите «горячие» поля на Cow<'a, str>.

Можно ли добавить derive Default или PartialEq?

Вывод выводит только Debug, Clone, Serialize и Deserialize. Добавьте остальные в список derive сами, если все типы полей их поддерживают (serde_json::Value реализует PartialEq).