facet-value

facet-value provides a memory-efficient dynamic value type for representing structured data similar to JSON, but with added support for binary data and datetime.

Features

• Pointer-sized Value type: The main Value type is exactly one pointer in size
• Eight value types: Null, Bool, Number, String, Bytes, Array, Object, DateTime
• no_std compatible: Works with just alloc, no standard library required
• Bytes support: First-class support for binary data (useful for MessagePack, CBOR, etc.)
• DateTime support: First-class support for temporal data (useful for TOML, YAML, etc.)

Design

Value uses a tagged pointer representation with 8-byte alignment, giving us 3 tag bits to distinguish between value types. Inline values (null, true, false) don’t require heap allocation.

facet-value

A memory-efficient dynamic value type for representing structured data, with support for bytes.

Features

• Pointer-sized: Value is exactly one pointer in size using tagged pointers
• Rich type support: Null, Bool, Number, String, Bytes, Array, Object, DateTime
• Typed extraction: Convert from Value into any type implementing Facet
• Companion serializer: Use facet-format to serialize typed values into Value

Example

use facet::Facet;
use facet_value::{Value, from_value};
use facet_format::to_value;

#[derive(Debug, Facet, PartialEq)]
struct Person {
    name: String,
    age: u32,
}

// Convert a typed value to a dynamic Value
let person = Person { name: "Alice".into(), age: 30 };
let value: Value = to_value(&person).unwrap();

// Inspect the value dynamically
let obj = value.as_object().unwrap();
assert_eq!(obj.get("name").unwrap().as_string().unwrap().as_str(), "Alice");

// Convert back to a typed value
let person2: Person = from_value(value).unwrap();
assert_eq!(person, person2);

Sponsors

Thanks to all individual sponsors:

...along with corporate sponsors:

...without whom this work could not exist.

Special thanks

The facet logo was drawn by Misiasart.

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.