9 releases (2 stable)

1.1.0 Sep 25, 2024
1.0.0 Jul 29, 2024
0.9.1 Aug 19, 2019
0.9.0 Dec 19, 2018
0.0.1 Jun 24, 2016

#65 in Encoding

Download history 20117/week @ 2024-10-24 20581/week @ 2024-10-31 16433/week @ 2024-11-07 18710/week @ 2024-11-14 14079/week @ 2024-11-21 14048/week @ 2024-11-28 15480/week @ 2024-12-05 17529/week @ 2024-12-12 9028/week @ 2024-12-19 5507/week @ 2024-12-26 8809/week @ 2025-01-02 12949/week @ 2025-01-09 12511/week @ 2025-01-16 12642/week @ 2025-01-23 17119/week @ 2025-01-30 22105/week @ 2025-02-06

67,455 downloads per month
Used in 16 crates (12 directly)

MIT license

115KB
3K SLoC

hjson-rust for serde

Build Status crate

Hjson Intro

{
  # specify rate in requests/second (because comments are helpful!)
  rate: 1000

  // prefer c-style comments?
  /* feeling old fashioned? */

  # did you notice that rate doesn't need quotes?
  hey: look ma, no quotes for strings either!

  # best of all
  notice: []
  anything: ?

  # yes, commas are optional!
}

The Rust implementation of Hjson is based on the Serde JSON Serialization Library. For other platforms see hjson.github.io.

This crate is a Rust library for parsing and generating Human JSON Hjson. It is built upon Serde, a high performance generic serialization framework.

Install

This crate works with Cargo and can be found on crates.io with a Cargo.toml like:

[dependencies]
serde = "*"
serde-hjson = "*"

From the Commandline

Install with cargo install hjson

Hjson, the Human JSON.

Usage:
  hjson [options]
  hjson [options] <input>
  hjson (-h | --help)
  hjson (-V | --version)

Options:
  -h --help     Show this screen.
  -j            Output as formatted JSON.
  -c            Output as JSON.
  -V --version  Show version.

Sample:

  • run hjson test.json > test.hjson to convert to Hjson
  • run hjson -j test.hjson > test.json to convert to JSON

Usage

extern crate serde;
extern crate serde_hjson;

use serde_hjson::{Map,Value};

fn main() {

    // Now let's look at decoding Hjson data

    let sample_text=r#"
    {
        // specify rate in requests/second
        rate: 1000
        array:
        [
            foo
            bar
        ]
    }"#;

    // Decode and unwrap.
    let mut sample: Map<String, Value> = serde_hjson::from_str(&sample_text).unwrap();

    // scope to control lifetime of borrow
    {
        // Extract the rate
        let rate = sample.get("rate").unwrap().as_f64().unwrap();
        println!("rate: {}", rate);

        // Extract the array
        let array : &mut Vec<Value> = sample.get_mut("array").unwrap().as_array_mut().unwrap();
        println!("first: {}", array.get(0).unwrap());

        // Add a value
        array.push(Value::String("tak".to_string()));
    }

    // Encode to Hjson
    let sample2 = serde_hjson::to_string(&sample).unwrap();
    println!("Hjson:\n{}", sample2);
}

API

see Rust doc

History

see history.md

Dependencies

~2.3–3.5MB
~63K SLoC