xml_schema_generator 0.6.23

//! defines the command line arguments that can be passed to xml_schema_generator
use clap::Parser;
use xml_schema_generator::{Options, SortBy};

/// Command-line arguments for the XML schema generator
#[derive(Parser, Debug)]
#[command(author, version, about, long_about = None)]
pub struct Args {
    /// define the parser that is used to parse the resulting struct
    #[clap(short, long, default_value_t, value_enum)]
    pub parser: ParserArg,
    /// define the #derive attribute to be added to each resulting struct
    #[clap(short, long, default_value = "Serialize, Deserialize")]
    pub derive: String,
    /// sorting order for attributes and children
    #[clap(short, long, default_value_t, value_enum)]
    pub sort: SortByArg,
    /// xml file that shall be parsed
    pub input_path: String,
    /// rust file to store the result, or none to print to stdout
    pub output_path: Option<String>,
}

/// Sorting options for command-line interface
#[derive(clap::ValueEnum, Clone, Default, Debug)]
pub enum SortByArg {
    /// the order remains as found in document
    #[default]
    Unsorted,
    /// sort attributes and children by name (as given in XML). attributes and children are not merged
    Name,
}

/// Converts command-line sort argument to internal `SortBy` enum
impl From<SortByArg> for SortBy {
    /// Converts a `SortByArg` to `SortBy`
    ///
    /// # Arguments
    ///
    /// * `val` - The command-line sort argument
    ///
    /// # Returns
    ///
    /// The corresponding `SortBy` variant
    fn from(val: SortByArg) -> Self {
        match val {
            SortByArg::Unsorted => SortBy::Unsorted,
            SortByArg::Name => SortBy::XmlName,
        }
    }
}

/// Supported XML parser libraries for code generation
#[derive(clap::ValueEnum, Clone, Default, Debug)]
pub enum ParserArg {
    #[default]
    QuickXmlDe,
    SerdeXmlRs,
}

/// Converts command-line parser argument to `Options` configuration
impl From<ParserArg> for Options {
    /// Converts a `ParserArg` to `Options`
    ///
    /// # Arguments
    ///
    /// * `val` - The command-line parser argument
    ///
    /// # Returns
    ///
    /// `Options` configured for the selected parser
    fn from(val: ParserArg) -> Self {
        match val {
            ParserArg::QuickXmlDe => Options::quick_xml_de(),
            ParserArg::SerdeXmlRs => Options::serde_xml_rs(),
        }
    }
}