commit	f8cedac7821ac7615eb7e5afbd3e953cb4cb2851	[log] [tgz]
author	Sadaf Ebrahimi <sadafebrahimi@google.com>	Mon Dec 04 19:49:26 2023 +0000
committer	Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>	Mon Dec 04 19:49:26 2023 +0000
tree	36b7860d168f0946cbec125ce85feec1522a02b5
parent	f033c7b68768ca3e04fce1ec46c3d66c25713bf9 [diff]
parent	a06f2430f94082f553b2ed1f64c418e686e31565 [diff]

tree: 36b7860d168f0946cbec125ce85feec1522a02b5

README.md

tinyjson

tinyjson is a library to parse/generate JSON format document.

Goals of this library are

Simplicity: This library uses standard containers like Vec or HashMap as its internal representation and exposes it to users. Users can operate JSON values via the standard APIs. And it keeps this crate as small as possible.
Explicit: This library does not hide memory allocation from users. You need to allocate memory like Vec, String, HashMap by yourself. It is good for readers of your source code to show where memory allocations happen. And you can have control of how memory is allocated (e.g. allocating memory in advance with with_capacity method).
No dependencies: This library is built on top of only standard libraries.
No unsafe code: This library is built with Safe Rust.
Well tested: This library is tested with famous test suites:

Documentation

Requirements

Rust stable toolchain.

Installation

Add this crate to dependencies section of your Cargo.toml

[dependencies] tinyjson = "2"

Example

use tinyjson::JsonValue; use std::collections::HashMap; use std::convert::TryInto; let s = r#" { "bool": true, "arr": [1, null, "test"], "nested": { "blah": false, "blahblah": 3.14 }, "unicode": "\u2764" } "#; // Parse from strings let parsed: JsonValue = s.parse().unwrap(); // Access to inner value represented with standard containers let object: &HashMap<_, _> = parsed.get().unwrap(); println!("Parsed HashMap: {:?}", object); // Generate JSON string println!("{}", parsed.stringify().unwrap()); // Generate formatted JSON string with indent println!("{}", parsed.format().unwrap()); // Convert to inner value represented with standard containers let object: HashMap<_, _> = parsed.try_into().unwrap(); println!("Converted into HashMap: {:?}", object); // Create JSON values from standard containers let mut m = HashMap::new(); m.insert("foo".to_string(), true.into()); let mut v = JsonValue::from(m); // Access with `Index` and `IndexMut` operators quickly println!("{:?}", v["foo"]); v["foo"] = JsonValue::from("hello".to_string()); println!("{:?}", v["foo"]);

See the document to know all APIs.

Repository

https://github.com/rhysd/tinyjson

License

the MIT License