Crate native_json

source ·
Expand description

Native JSON for Rust

This crate provides native JSON syntax for Rust, it brings with a powerful way of parsing JSON syntax into native Rust structs. You can declare the JSON object natively as you do with JavaScript, JSON in Rust was made easy!


Add dependencies to your Cargo.toml.

native-json = "1.2"
serde = {version = "1.0", features = ["derive"] }
serde_json = "1.0"

Example of using native JSON object

use native_json::json;
use std::collections::HashMap;
use serde::{Deserialize, Serialize};

fn main()
    let mut json = json!{
        name: "native json",
        style: {
            color: "red",
            size: 12,
            bold: true,
            range: null
        array: [5,4,3,2,1],
        vector: vec![1,2,3,4,5],
        hashmap: HashMap::from([ ("a", 1), ("b", 2), ("c", 3) ]);,
        students: [
            {name: "John", age: 18},
            {name: "Jack", age: 21},

    // Native access += 1;
    json.students[0].age += 2;

    // Debug
    println!("{:#?}", t);

    // Stringify
    let text = json.stringify(4);
    println!("{}", text);

Declare a named JSON struct

With JSON declare syntax, you can declare nested native JSON object in place.

JSON Declare Syntax

    state: i32?,    // optional field
    type_: String,  // suffix underscore will be removed when serialize & deserialize
    name : type,
    array: [type],
    object: {
        name: type,

The native-json will generate native Rust structs for you, each object is named by object hierarchy path, concatenated with underscore.

  1. JSON_OBJECT_NAME.object was converted to JSON_OBJECT_NAME_object
  2. JSON_OBJECT_NAME.array's item was converted to JSON_OBJECT_NAME_array_item

Example of using named JSON object

use native_json::json;
use serde::{Deserialize, Serialize};
use std::collections::HashMap;

json!{ School {
    name: String,
    students: [
        { name: String, age: u16 },
    map: HashMap<String, String>,
    nullable: Option<String>

fn main()
    let mut school = School::new(); = "MIT".to_string();"Tom".to_owned(), "Profile".to_owned());

    // using initializer
    let mut john = School_students_item::new(); = "John".to_owned();
    john.age = 18;

    // using struct
    let jack = School_students_item { name: "Jack".to_string(), age: 21 };

    // show
    println!("{:#?}", school);


  • Declare or instantiate a native JSON object, please refere to module json


  • This type represents all possible errors that can occur when serializing or deserializing JSON data.


  • A data structure that can be deserialized from any data format supported by Serde.
  • A data structure that can be deserialized without borrowing any data from the deserializer.
  • A data structure that can be serialized into any data format supported by Serde.


  • Deserialize an instance of type T from a string of JSON text.
  • Deserialize from file
  • Serialize into file
  • Build a file writer

Derive Macros