Enum BatchCommands 

pub enum BatchCommands {
    BatchValidate {
        files: Vec<String>,
        strict: bool,
        parallel: bool,
        verbose: bool,
        streaming: bool,
        auto_streaming: bool,
        max_files: Option<usize>,
    },
    BatchFormat {
        files: Vec<String>,
        output_dir: Option<String>,
        check: bool,
        ditto: bool,
        with_counts: bool,
        parallel: bool,
        verbose: bool,
        max_files: Option<usize>,
    },
    BatchLint {
        files: Vec<String>,
        warn_error: bool,
        parallel: bool,
        verbose: bool,
        max_files: Option<usize>,
    },
}

Batch processing commands.

These commands operate on multiple HEDL files simultaneously, with automatic parallelization for improved performance. All batch commands support glob patterns for file selection.

Performance

Batch commands automatically use parallel processing when beneficial:

• CPU-bound operations scale with available cores
• I/O-bound operations use async parallelization
• Progress reporting shows real-time status

Design

All batch commands follow consistent patterns:

• Multiple file inputs (with glob support)
• Optional parallel processing flag
• Verbose mode for detailed progress

Variants

BatchValidate

Batch validate multiple HEDL files

Validates multiple HEDL files in parallel. Supports glob patterns for file selection and provides aggregated results.

Fields

files: Vec<String>

Input file paths (supports glob patterns)

strict: bool

Strict mode (fail on any error)

parallel: bool

Force parallel processing

verbose: bool

Show verbose progress

streaming: bool

Use streaming mode for memory-efficient processing

Streaming mode uses constant memory regardless of file size, making it ideal for files > 100MB or memory-constrained environments.

auto_streaming: bool

Automatically use streaming for files > 100MB

Enables hybrid mode where large files use streaming and small files use standard processing for optimal performance and memory usage.

max_files: Option<usize>

Maximum number of files to process (unlimited if not specified)

BatchFormat

Batch format multiple HEDL files

Formats multiple HEDL files to canonical form in parallel. Can either modify files in-place or write to an output directory.

Fields

files: Vec<String>

Input file paths (supports glob patterns)

output_dir: Option<String>

Output directory for formatted files

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

parallel: bool

Force parallel processing

verbose: bool

Show verbose progress

max_files: Option<usize>

Maximum number of files to process (unlimited if not specified)

BatchLint

Batch lint multiple HEDL files

Lints multiple HEDL files in parallel, checking for best practices and style issues. Provides aggregated results across all files.

Fields

files: Vec<String>

Input file paths (supports glob patterns)

warn_error: bool

Treat warnings as errors

parallel: bool

Force parallel processing

verbose: bool

Show verbose progress

max_files: Option<usize>

Maximum number of files to process (unlimited if not specified)

Implementations

impl BatchCommands

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

Execute the batch command.

Returns

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

Errors

Returns Err if:

• No files match the provided patterns
• Any file operation fails
• Processing fails for any file

Performance

Batch commands automatically parallelize when beneficial. The parallel flag forces parallelization even for small file sets.

Trait Implementations

impl FromArgMatches for BatchCommands

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 BatchCommands

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