Convertir JSON en Rust — Générateur de structs serde

Des structs Rust pour serde, générées à partir de JSON

Serde rend le JSON rapide et sûr en Rust, mais seulement une fois que vous avez écrit des structs qui correspondent exactement aux données. Ce convertisseur JSON vers Rust les écrit pour vous. Collez un exemple et chaque objet devient une struct dérivant Serialize et Deserialize, les clés deviennent des noms de champs snake_case idiomatiques avec des attributs #[serde(rename)] si nécessaire, les objets imbriqués deviennent des structs distinctes, les tableaux deviennent Vec<T>, et les valeurs absentes ou nulles quelque part dans l'exemple sont enveloppées dans Option<T>. Les entiers et les flottants sont distingués en i64 et f64.

Le générateur repose sur quicktype, qui fusionne tous les éléments de chaque tableau avant de choisir un type. En Rust, cela compte plus que dans la plupart des langages : une seule clé inattendue ou un seul null fait échouer la désérialisation, et capturer d'emblée les champs optionnels fait gagner du temps de débogage.

Visibilité et derives

Choisissez la visibilité des champs selon l'usage des types : pub pour un crate de modèles partagé, pub(crate) pour des modules internes, ou des champs privés si vous voulez ajouter vos propres constructeurs. Les derives Debug et Clone sont activés par défaut car presque tous les modèles en ont besoin ; désactivez-les pour une sortie plus légère. Activez Skip serializing None pour ajouter skip_serializing_if, afin que les champs None disparaissent du JSON sortant au lieu d'être écrits en null. N'oubliez pas d'ajouter serde avec la fonctionnalité derive ainsi que serde_json à votre Cargo.toml.

Obtenir des types précis

Utilisez un exemple avec plusieurs éléments de tableau et des champs optionnels renseignés. Les tableaux vides et les valeurs nulles ne donnent aucune information de type et retombent sur serde_json::Value, que vous voudrez généralement remplacer. Après la génération, lancez rustfmt, vérifiez la largeur des entiers (un identifiant tient peut-être dans un u32) et transformez les champs de type chaîne à ensemble de valeurs fixe en énumérations avec #[serde(rename_all)]. Tout s'exécute en local dans votre navigateur : les charges utiles privées ne sont jamais envoyées.