jsode 0.1.0

Overview

Easy parsing JSON source and transform it into interaction Rust type.

Getting Started

1. Install

[dependencies]
jsode = { version = "0.1" }

2. Parsing AST

use jsode::prelude::*;

// `jsonde::Result` already imported via prelude mod, so you only need to write `-> Result<()>`.
// I just wrote down it's full path to make sure you don't value it as `std::result::Result`.
fn main() -> jsode::Result<()> {
    let mut src = JsonParser::new("{ 'hello': 'world' }");

    assert!(src.parse().is_ok());

    Ok(())
}

3. Index json key

use jsode::prelude::*;

fn main() -> jsode::Result<()> {
    let mut src = JsonParser::new("{ 'hello': 'world' }");
    let ast = src.parse()?;

    assert!(ast.index("hello").is_some());
    assert!(ast.index("none_exist_key").is_none());

    Ok(())
}

4. Getting/Deserialize json's property

use jsode::prelude::*;

fn main() -> jsode::Result<()> {
    let mut src = JsonParser::new("{ 'hello': 'world' }");
    let ast = src.parse()?;

    assert_eq!("world", ast.index("hello").unwrap().parse_into::<String>()?);

    Ok(())
}

5. Deserialize into Rust struct

use jsode::prelude::*;

#[derive(Deserialize, PartialEq, Debug)]
struct Color {
    #[prop = "r"]
    red: u8,
    #[prop = "b"]
    blue: u8,
    green: u8,
}

fn main() -> jsode::Result<()> {
    let mut src = JsonParser::new(r#"{
        'r': 255,
        'b': 96,
        'green': 0,
    }"#);
    let ast = src.parse()?;

    let expected = Color {
        red: 255,
        blue: 96,
        green: 0,
    };
    assert_eq!(expected, ast.parse_into::<Color>()?);

    Ok(())
}