58 releases (27 stable)

2.13.0 Mar 28, 2024
2.11.1 Jan 31, 2024
2.10.2 Oct 19, 2023
2.6.1 Jun 27, 2023
0.0.4 Dec 6, 2018

#173 in Encoding

Download history 97931/week @ 2024-02-24 93089/week @ 2024-03-02 86161/week @ 2024-03-09 88864/week @ 2024-03-16 93545/week @ 2024-03-23 112773/week @ 2024-03-30 114921/week @ 2024-04-06 110531/week @ 2024-04-13 107156/week @ 2024-04-20 105485/week @ 2024-04-27 102167/week @ 2024-05-04 126227/week @ 2024-05-11 118943/week @ 2024-05-18 126247/week @ 2024-05-25 138094/week @ 2024-06-01 113684/week @ 2024-06-08

519,163 downloads per month
Used in 23 crates (17 directly)

Apache-2.0 OR MIT

120KB
3K SLoC

sval: Streaming, structured values

Rust Latest version Documentation Latest

sval is a lightweight serialization-only framework that treats values like a flat stream of tokens. It's well suited to self-describing text formats like JSON.

How is this different from serde?

serde is the de-facto serialization framework for Rust and is well suited to the majority of use cases. sval is like a light blend of serde::ser and serde::de that is smaller in scope. It makes a few key different design decisions than serde that make it effective for working with self-describing formats:

  1. The API is flat rather than using recursion to stream nested datastructures.
  2. All values with dynamic sizes, including text strings, can be streamed in multiple calls.
  3. Borrowing is an optional optimization.
  4. The core data model is small, with tags for extensibility.

Data-model

  • Values:
    • null: the absence of any other meaningful value.
    • Booleans: true and false.
    • Text strings: stream of UTF8-encoded bytes.
    • Binary strings: stream of arbtirary bytes.
    • Numbers:
      • Integers: u8-u128, i8-i128.
      • Binary floating point: f32-f64.
    • Maps: heterogeneous collection of key-value pairs.
    • Sequences: heterogeneous collection of values.
    • Tags: out-of-band type hints.
    • Tagged values: a tag associated with a value.
    • Records: tagged maps where keys are well-known labels.
    • Tuples: tagged sequences.
    • Enums: tagged variants, where variants are enums, tags, tagged values, records, or tuples.

sval includes built-in tags that extend its data-model with some common datatypes:

  • Rust primitives:
    • ().
    • Option<T>.
  • Arbitrary-precision decimal floating point numbers.

Other built-in tags may be added in the future. Libraries may also define their own tags.

Current status

This project has a complete and stable API, but isn't well documented yet.

Dependencies

~105KB