Struct FromJsonConfigBuilder 

pub struct FromJsonConfigBuilder { /* private fields */ }

Builder for FromJsonConfig

Provides ergonomic configuration of JSON import limits and behavior.

Examples

use hedl_json::FromJsonConfig;

// Custom limits
let config = FromJsonConfig::builder()
    .max_depth(1_000)
    .max_array_size(100_000)
    .max_string_length(10 * 1024 * 1024)
    .build();

// Strict limits for untrusted input
let strict = FromJsonConfig::builder()
    .max_depth(50)
    .max_array_size(10_000)
    .max_string_length(1_000_000)
    .max_object_size(1_000)
    .build();

// Unlimited (use with caution!)
let unlimited = FromJsonConfig::builder()
    .unlimited()
    .build();

Implementations

impl FromJsonConfigBuilder

pub fn default_type_name(self, name: impl Into<String>) -> Self

Set the default type name for arrays without metadata

pub fn version(self, major: u32, minor: u32) -> Self

Set the HEDL version to use

pub fn max_depth(self, limit: usize) -> Self

Set the maximum recursion depth

Use None to disable the limit (not recommended for untrusted input).

pub fn max_array_size(self, limit: usize) -> Self

Set the maximum array size

Use None to disable the limit (not recommended for untrusted input).

pub fn max_string_length(self, limit: usize) -> Self

Set the maximum string length in bytes

Use None to disable the limit (not recommended for untrusted input).

pub fn max_object_size(self, limit: usize) -> Self

Set the maximum object size (number of keys)

Use None to disable the limit (not recommended for untrusted input).

pub fn surrogate_policy(self, policy: SurrogatePolicy) -> Self

Set the policy for handling unpaired UTF-16 surrogates

Options

• SurrogatePolicy::Reject (default): Error on invalid surrogates
• SurrogatePolicy::ReplaceWithFFFD: Replace with U+FFFD
• SurrogatePolicy::Skip: Remove invalid surrogates silently

Example

use hedl_json::{FromJsonConfig, SurrogatePolicy};

let config = FromJsonConfig::builder()
    .surrogate_policy(SurrogatePolicy::ReplaceWithFFFD)
    .build();

pub fn unlimited(self) -> Self

Disable all limits (use with caution - only for trusted input)

This removes all safety limits and can lead to memory exhaustion or stack overflow with malicious or malformed JSON.

pub fn lenient(self, lenient: bool) -> Self

Enable lenient JSON parsing (trailing commas, comments)

When enabled, the parser accepts:

• Trailing commas in arrays and objects
• Single-line (//) and multi-line (/* */) comments

Requires the lenient feature flag.

Examples

use hedl_json::FromJsonConfig;

let config = FromJsonConfig::builder()
    .lenient(true)
    .build();

// Now you can parse JSON with trailing commas
let json = r#"{"name": "Alice", "age": 30,}"#;

pub fn build(self) -> FromJsonConfig

Build the configuration

Trait Implementations

impl Clone for FromJsonConfigBuilder

fn clone(&self) -> FromJsonConfigBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FromJsonConfigBuilder

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

Formats the value using the given formatter.

impl Default for FromJsonConfigBuilder

fn default() -> Self

Returns the “default value” for a type.