3 releases
0.1.2 | Nov 29, 2023 |
---|---|
0.1.1 | Nov 27, 2023 |
0.1.0 | Nov 27, 2023 |
#224 in #tiny
23 downloads per month
Used in tiny-json-rs
6KB
110 lines
tiny-json-rs
A minimalistic Rust library for encoding and decoding JSON, offering a lower memory footprint alternative to serde.
Introduction
tiny-json-rs
is an open-source library designed for efficiently handling JSON in Rust applications. It aims to provide functionality similar to the serde library but focuses on reducing memory usage, making it an ideal choice for resource-constrained environments or applications where performance is critical.
Features
- Efficient JSON Encoding/Decoding: Optimized for lower memory usage.
- Easy Integration: Simple API, compatible with standard Rust structs.
- Customizable: Extendable to support various data types.
Usage
Add tiny-json-rs
to your Cargo.toml:
[dependencies]
tiny-json-rs = "0.2.5"
Basic Examples
Struct Definition
Define your structs and derive Deserialize
and Serialize
:
use tiny_json_rs::{Deserialize, Serialize};
#[derive(Debug, PartialEq, Deserialize, Serialize)]
pub struct A {
pub a: i32,
pub b: String,
}
#[derive(Debug, PartialEq, Deserialize, Serialize)]
pub struct B {
pub a: i32,
pub b: Vec<String>,
}
Can also derive custom names
#[derive(Debug, PartialEq, Deserialize, Serialize)]
pub struct C {
#[Rename = "CustomName"]
pub a: i32,
pub b: String,
}
Deserializing JSON
Convert a JSON string to a Rust struct:
let json = r#"{"a": 1, "b": "Hello"}"#;
let parsed: A = tiny_json_rs::decode(json.to_string()).unwrap();
assert_eq!(parsed.a, 1);
assert_eq!(parsed.b, "Hello");
Serializing to JSON
Convert a Rust struct to a JSON string:
let obj = C {
a: 1,
b: "Hello".to_string(),
};
let json = tiny_json_rs::encode(obj);
assert_eq!(json, r#"{"CustomName":1,"b":"Hello"}"#);
Testing
tiny-json-rs
comes with a suite of tests to ensure functionality:
#[test]
fn test_deserialize() {
// ...
}
#[test]
fn test_deserialize_vec() {
// ...
}
#[test]
fn test_encode_json() {
// ...
}
License
tiny-json-rs
is licensed under MIT.
Issues?
This is an experimental project, not production ready yet. If you find any issues, please report them here
Dependencies
~1.5MB
~37K SLoC