Build Status Latest Version Rust Documentation codecov

Kurt's Self Explanatory Rust Data.

See the rs docs. Look at progress and contribute on github.

Introduction

kserd provides a data structure to represent programmatic data (mainly for Rust). Data is held in enum variants covering the basic primitives along with nested structures such as tuples, containers, sequences, and maps. kserd tries to differentiate itself by providing the data structure as the in-memory intermediary between serialized format and a programming language's structure. The serialized format is inspired by TOML to make kserd as human-readable as possible.

Getting Started

With default features enabled, using kserd is a simple as importing the root which will contain all the important items.

```rust use kserd::*;

#[cfg(feature = "encode")] {

// Kserd and Value are the building blocks of the data. let mut kserd = Kserd::withid("greeting", Value::newstr("Hello")).unwrap();

// Kserd/Value are meant to be useable in their memory form // not just simple data holding structure! assert_eq!(kserd.str(), Some("Hello"));

// you can mutate in place as well kserd.strmut().map(|s| { s.pushstr(", world!"); }); assert_eq!(kserd.str(), Some("Hello, world!"));

// encode data structures that implement serde::Serialize let kserd = Kserd::enc(&vec![0, 1, 2, 4]).unwrap();

// can format the kserd into a human-readable string println!("{}", kserd.as_str()); // should print [0, 1, 2, 4]

}

```

It is recommended to consult the api documentation as there is extensive examples and explanations.

Features

The kserd library is feature gated, but all features are enabled by default.

| Feature | Description | Further reading | | -------- | ----------- | --------------- | | encode | Convert data structures to and from Kserd. Makes use of serde Serialize and Deserialize traits. | kserd::encode | | format | Format a Kserd to a human-readable string. | kserd::format | | parse | Parse a string into a Kserd. | kserd::parse |

To 1.0 Stabilistations