Enum ConversionCommands 

pub enum ConversionCommands {
    ToJson {
        file: String,
        output: Option<String>,
        metadata: bool,
        pretty: bool,
    },
    FromJson {
        file: String,
        output: Option<String>,
    },
    ToYaml {
        file: String,
        output: Option<String>,
    },
    FromYaml {
        file: String,
        output: Option<String>,
    },
    ToXml {
        file: String,
        output: Option<String>,
        pretty: bool,
    },
    FromXml {
        file: String,
        output: Option<String>,
    },
    ToCsv {
        file: String,
        output: Option<String>,
        headers: bool,
    },
    FromCsv {
        file: String,
        output: Option<String>,
        type_name: String,
    },
    ToParquet {
        file: String,
        output: String,
    },
    FromParquet {
        file: String,
        output: Option<String>,
    },
    ToToon {
        file: String,
        output: Option<String>,
    },
    FromToon {
        file: String,
        output: Option<String>,
    },
}

Format conversion commands.

These commands enable bidirectional conversion between HEDL and various data formats, making HEDL interoperable with existing tools and workflows.

Supported Formats

• JSON: Compact and pretty printing, optional metadata
• YAML: Standard YAML format
• XML: Compact and pretty printing
• CSV: Tabular data with optional headers
• Parquet: Apache Parquet columnar format

Design

All conversion commands follow a consistent pattern:

• to-<format>: Convert HEDL to target format
• from-<format>: Convert target format to HEDL

Variants

ToJson

Convert HEDL to JSON

Converts a HEDL file to JSON format with optional pretty printing and metadata inclusion.

Fields

file: String

Input HEDL file

output: Option<String>

Output file path (defaults to stdout)

metadata: bool

Include HEDL metadata in JSON

pretty: bool

Pretty print JSON

FromJson

Convert JSON to HEDL

Converts a JSON file to HEDL format. Foreign key relationships are automatically detected and converted to nested hierarchies.

Fields

file: String

Input JSON file

output: Option<String>

Output file path (defaults to stdout)

ToYaml

Convert HEDL to YAML

Converts a HEDL file to YAML format.

Fields

file: String

Input HEDL file

output: Option<String>

Output file path (defaults to stdout)

FromYaml

Convert YAML to HEDL

Converts a YAML file to HEDL format.

Fields

file: String

Input YAML file

output: Option<String>

Output file path (defaults to stdout)

ToXml

Convert HEDL to XML

Converts a HEDL file to XML format with optional pretty printing.

Fields

file: String

Input HEDL file

output: Option<String>

Output file path (defaults to stdout)

pretty: bool

Pretty print XML

FromXml

Convert XML to HEDL

Converts an XML file to HEDL format.

Fields

file: String

Input XML file

output: Option<String>

Output file path (defaults to stdout)

ToCsv

Convert HEDL to CSV

Converts a HEDL file containing tabular data to CSV format. Works best with HEDL matrix lists.

Fields

file: String

Input HEDL file

output: Option<String>

Output file path (defaults to stdout)

headers: bool

Include header row

FromCsv

Convert CSV to HEDL

Converts a CSV file to HEDL matrix list format.

Fields

file: String

Input CSV file

output: Option<String>

Output file path (defaults to stdout)

type_name: String

Type name for the matrix list

ToParquet

Convert HEDL to Parquet

Converts a HEDL file to Apache Parquet columnar format. Requires an output file path (Parquet cannot write to stdout).

Fields

file: String

Input HEDL file

output: String

Output Parquet file path (required)

FromParquet

Convert Parquet to HEDL

Converts an Apache Parquet file to HEDL format.

Fields

file: String

Input Parquet file

output: Option<String>

Output file path (defaults to stdout)

ToToon

Convert HEDL to TOON

Converts a HEDL file to TOON format.

Fields

file: String

Input HEDL file

output: Option<String>

Output file path (defaults to stdout)

FromToon

Convert TOON to HEDL

Converts a TOON file to HEDL format.

Fields

file: String

Input TOON file

output: Option<String>

Output file path (defaults to stdout)

Implementations

impl ConversionCommands

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

Execute the conversion command.

Returns

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

Errors

Returns Err if:

• File I/O fails
• Parsing fails
• Conversion fails
• Output writing fails

Trait Implementations

impl FromArgMatches for ConversionCommands

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 ConversionCommands

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