Struct ToonSerializer 

pub struct ToonSerializer { /* private fields */ }

TOON-LD Serializer

Converts JSON/JSON-LD values to TOON-LD format. The serializer handles:

• Tabular arrays (arrays of objects with union-of-keys)
• Primitive arrays (inline or multi-line)
• JSON-LD keywords and context-based URI compaction
• Value nodes with language tags and datatypes (using standard TOON object syntax)

Example

use toon_core::{ToonSerializer, JsonLdContext};
use serde_json::json;

let serializer = ToonSerializer::new();
let value = json!({
    "name": "Alice",
    "age": 30
});

let toon = serializer.serialize(&value).unwrap();
assert!(toon.contains("name: Alice"));
assert!(toon.contains("age: 30"));

Implementations

impl ToonSerializer

pub fn new() -> ToonSerializer

Create a new serializer with default settings.

Example

use toon_core::ToonSerializer;

let serializer = ToonSerializer::new();

pub fn with_context(self, context: JsonLdContext) -> ToonSerializer

Set the JSON-LD context for URI compaction.

Arguments

• context - The JSON-LD context to use

Example

use toon_core::{ToonSerializer, JsonLdContext};

let mut ctx = JsonLdContext::new();
ctx.add_prefix("foaf", "http://xmlns.com/foaf/0.1/");

let serializer = ToonSerializer::new().with_context(ctx);

pub fn with_indent_size(self, size: usize) -> ToonSerializer

Set the indentation size.

Arguments

• size - Number of spaces per indentation level

Example

use toon_core::ToonSerializer;

let serializer = ToonSerializer::new().with_indent_size(4);

pub fn context(&self) -> &JsonLdContext

Get a reference to the current context.

pub fn indent_size(&self) -> usize

Get the current indentation size.

pub fn with_shape_partitioning(self, enable: bool) -> ToonSerializer

Enable or disable shape-based partitioning for sparse arrays.

When enabled, arrays with high sparsity (> 30% null values) will be automatically partitioned by entity shape to reduce null delimiter overhead.

Arguments

• enable - Whether to enable shape-based partitioning

Example

use toon_core::ToonSerializer;

let serializer = ToonSerializer::new().with_shape_partitioning(true);

pub fn serialize(&self, value: &Value) -> Result<String, ToonError>

Serialize a JSON value to TOON-LD format.

Arguments

• value - The JSON value to serialize

Returns

A Result containing the TOON-LD string or an error.

Example

use toon_core::ToonSerializer;
use serde_json::json;

let serializer = ToonSerializer::new();
let value = json!({"name": "Alice", "age": 30});
let toon = serializer.serialize(&value).unwrap();

pub fn serialize_json(&self, json: &str) -> Result<String, ToonError>

Serialize a JSON string to TOON-LD string.

Arguments

• json - A JSON string to parse and serialize

Returns

A Result containing the TOON-LD string or an error.

Example

use toon_core::ToonSerializer;

let serializer = ToonSerializer::new();
let toon = serializer.serialize_json(r#"{"name": "Alice"}"#).unwrap();

pub fn serialize_keyed_array( &self, key: &str, arr: &[Value], depth: usize, output: &mut String, ) -> Result<(), ToonError>

Serialize a keyed array (array with a key prefix).

Trait Implementations

impl Clone for ToonSerializer

fn clone(&self) -> ToonSerializer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToonSerializer

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for ToonSerializer

fn default() -> ToonSerializer

Returns the “default value” for a type.