Enum CoreCommands 

pub enum CoreCommands {
    Validate {
        file: String,
        strict: bool,
        lenient: bool,
    },
    Format {
        file: String,
        output: Option<String>,
        check: bool,
        ditto: bool,
        with_counts: bool,
    },
    Lint {
        file: String,
        format: String,
        warn_error: bool,
    },
    Inspect {
        file: String,
        verbose: bool,
    },
    Stats {
        file: String,
        tokens: bool,
    },
}

Core HEDL commands.

These commands provide the essential functionality for working with HEDL files: validation, formatting, linting, inspection, and statistics.

Commands

• Validate: Check HEDL syntax and semantic correctness
• Format: Convert to canonical form with optional optimizations
• Lint: Check for best practices and style issues
• Inspect: Visualize internal structure
• Stats: Analyze size and token efficiency

Variants

Validate

Validate a HEDL file

Checks the syntax and semantic correctness of a HEDL file. In strict mode, all references must resolve to existing entities.

Fields

file: String

Input file path

strict: bool

Strict reference validation (all references must resolve)

lenient: bool

Use lenient parsing mode (constraint violations become null)

Format

Format a HEDL file to canonical form

Reformats a HEDL file to its canonical representation. Supports various formatting options including ditto optimization and automatic count hints.

Fields

file: String

Input file path

output: Option<String>

Output file path (defaults to stdout)

check: bool

Check only (exit 1 if not canonical)

ditto: bool

Use ditto optimization

with_counts: bool

Automatically add count hints to all matrix lists

Lint

Lint a HEDL file for best practices

Analyzes a HEDL file for style issues, best practices violations, and potential problems. Can output results in text or JSON format.

Fields

file: String

Input file path

format: String

Output format (text, json)

warn_error: bool

Treat warnings as errors

Inspect

Print parsed structure (debug)

Displays the internal structure of a HEDL file as a tree, useful for debugging and understanding how HEDL parses the file.

Fields

file: String

Input file path

verbose: bool

Show detailed internal structure

Stats

Show size/token savings vs other formats

Analyzes a HEDL file and compares its size and token count against equivalent representations in JSON, YAML, XML, CSV, and Parquet.

Fields

file: String

Input HEDL file

tokens: bool

Show estimated token counts for LLM context

Implementations

impl CoreCommands

pub fn execute(self) -> Result<(), CliError>

Execute the core command.

Returns

Returns Ok(()) on success, or an error message on failure.

Errors

Returns Err if the command execution fails.

Trait Implementations

impl FromArgMatches for CoreCommands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for CoreCommands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand