Struct ParseOptionsBuilder 

pub struct ParseOptionsBuilder { /* private fields */ }

Builder for ergonomic construction of ParseOptions.

Provides a fluent API for configuring parser options with sensible defaults.

Examples

// Using builder with custom limits
let opts = ParseOptions::builder()
    .max_depth(200)
    .max_array_length(5000)
    .strict(false)
    .build();

// Using builder with defaults
let opts = ParseOptions::builder().build();

Implementations

impl ParseOptionsBuilder

pub fn new() -> Self

Create a new builder with default options.

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

Set the maximum nesting depth (indent depth).

Parameters

• depth: Maximum nesting level (default: 50)

Examples

ParseOptions::builder().max_depth(100)

pub fn max_array_length(self, length: usize) -> Self

Set the maximum array length (nodes in matrix lists).

Parameters

• length: Maximum number of nodes (default: 10M)

Examples

ParseOptions::builder().max_array_length(5000)

pub fn reference_mode(self, mode: ReferenceMode) -> Self

Set reference resolution mode.

Arguments

• mode: The reference resolution mode to use

Examples

use hedl_core::{ParseOptionsBuilder, ReferenceMode};

let opts = ParseOptionsBuilder::new()
    .reference_mode(ReferenceMode::Lenient)
    .build();

pub fn strict_refs(self) -> Self

Enable strict reference resolution (error on unresolved).

Shorthand for .reference_mode(ReferenceMode::Strict).

Examples

let opts = ParseOptions::builder()
    .strict_refs()
    .build();

pub fn lenient_refs(self) -> Self

Enable lenient reference resolution (ignore unresolved).

Shorthand for .reference_mode(ReferenceMode::Lenient).

Examples

let opts = ParseOptions::builder()
    .lenient_refs()
    .build();

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

Set strict reference resolution mode (legacy compatibility).

pub fn max_file_size(self, size: usize) -> Self

Set the maximum file size in bytes.

Parameters

• size: Maximum file size in bytes (default: 1GB)

Examples

ParseOptions::builder().max_file_size(500 * 1024 * 1024)

pub fn max_line_length(self, length: usize) -> Self

Set the maximum line length in bytes.

Parameters

• length: Maximum line length in bytes (default: 1MB)

Examples

ParseOptions::builder().max_line_length(512 * 1024)

pub fn max_aliases(self, count: usize) -> Self

Set the maximum number of aliases.

Parameters

• count: Maximum number of aliases (default: 10k)

Examples

ParseOptions::builder().max_aliases(5000)

pub fn max_columns(self, count: usize) -> Self

Set the maximum columns per schema.

Parameters

• count: Maximum columns (default: 100)

Examples

ParseOptions::builder().max_columns(50)

pub fn max_nest_depth(self, depth: usize) -> Self

Set the maximum NEST hierarchy depth.

Parameters

• depth: Maximum nesting depth (default: 100)

Examples

ParseOptions::builder().max_nest_depth(50)

pub fn max_block_string_size(self, size: usize) -> Self

Set the maximum block string size in bytes.

Parameters

• size: Maximum block string size (default: 10MB)

Examples

ParseOptions::builder().max_block_string_size(5 * 1024 * 1024)

pub fn max_object_keys(self, count: usize) -> Self

Set the maximum keys per object.

Parameters

• count: Maximum keys per object (default: 10k)

Examples

ParseOptions::builder().max_object_keys(5000)

pub fn max_total_keys(self, count: usize) -> Self

Set the maximum total keys across all objects.

This provides defense-in-depth against memory exhaustion attacks.

Parameters

• count: Maximum total keys (default: 10M)

Examples

ParseOptions::builder().max_total_keys(5_000_000)

pub fn build(self) -> ParseOptions

Build the ParseOptions.

Trait Implementations

impl Clone for ParseOptionsBuilder

fn clone(&self) -> ParseOptionsBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParseOptionsBuilder

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

Formats the value using the given formatter.

impl Default for ParseOptionsBuilder

fn default() -> Self

Returns the “default value” for a type.