Crate rskit_codec 

Pluggable structured-text codecs over a shared value tree.

rskit-codec provides a small, object-safe Codec contract for encoding and decoding structured text formats (TOML, JSON, …) through one canonical value model — serde_json::Value. Any crate that reads or writes a config file, manifest, or document reuses these codecs instead of re-implementing “bounded read → parse → typed error” per format.

Value model

serde_json::Value is the canonical in-memory tree. It is format-neutral and the de-facto Rust interchange type, so TOML and JSON both decode into it and the value merge operates on it. One consequence: types without a JSON equivalent (notably TOML datetimes) are not part of the model — represent such values as strings.

Object safety

Codec is object-safe (Arc<dyn Codec>) so a codec can be selected at runtime (e.g. by file extension via select). The generic, type-driven conveniences encode and decode are free functions taking &dyn Codec, keeping the trait object-safe while still supporting #[derive(Serialize, Deserialize)] types. decode::<T> honors #[serde(deny_unknown_fields)].

Quick start

use rskit_codec::{JsonCodec, decode, encode};
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize, PartialEq, Debug)]
struct Settings {
    name: String,
    retries: u8,
}

let codec = JsonCodec::default();
let parsed: Settings = decode(&codec, r#"{ "name": "svc", "retries": 3 }"#).unwrap();
assert_eq!(parsed, Settings { name: "svc".into(), retries: 3 });

let text = encode(&codec, &parsed).unwrap();
assert!(text.contains("\"name\""));

Modules

framing

Bounded length-delimited framing for streaming structured-text payloads.

select

Runtime codec selection by file extension or name.

value

Value-tree operations over the canonical serde_json::Value model.

Structs

JsonCodec

Built-in JSON codec.

TomlCodec

Built-in TOML codec.

Enums

JsonStyle

JSON output layout for JsonCodec.

Value

Re-export of the canonical value model. Represents any valid JSON value.

Traits

Codec

Object-safe contract for a structured-text codec over the Value model.

Functions

decode

Decode text into any DeserializeOwned type using codec.

encode

Encode any Serialize value using codec.