feat: complete core Rust project structure with full functionality

Co-authored-by: unclesp1d3r <251112+unclesp1d3r@users.noreply.github.com>

Author: Copilot

Cargo.lock

@@ -0,0 +1,88 @@
+[package]
+name = "opnsense-config-faker"
+version = "0.1.0"
+edition = "2021"
+authors = ["EvilBit Labs <contact@evilbitlabs.com>"]
+license = "MIT"
+description = "A flexible tool for generating realistic network configuration test data for OPNsense"
+repository = "https://github.com/EvilBit-Labs/OPNsense-config-faker"
+keywords = ["networking", "testing", "configuration", "data-generation", "opnsense"]
+categories = ["command-line-utilities", "development-tools::testing", "network-programming"]
+readme = "README.md"
+rust-version = "1.70"
+
+[[bin]]
+name = "opnsense-config-faker"
+path = "src/main.rs"
+
+[dependencies]
+# CLI framework with derive macros
+clap = { version = "4.5", features = ["derive", "color", "suggestions"] }
+
+# Serialization framework 
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+
+# CSV handling
+csv = "1.3"
+
+# XML processing
+quick-xml = { version = "0.36", features = ["serialize"] }
+
+# Networking utilities
+ipnet = "2.9"
+
+# Random data generation
+rand = { version = "0.8", features = ["small_rng"] }
+uuid = { version = "1.10", features = ["v4", "serde"] }
+
+# Error handling
+thiserror = "1.0"
+anyhow = "1.0"
+
+# Date/time utilities
+chrono = { version = "0.4", features = ["serde"] }
+
+# Progress indicators for CLI
+indicatif = "0.17"
+
+# Terminal styling
+console = "0.15"
+
+[dev-dependencies]
+# Testing framework
+rstest = "0.21"
+
+# Temporary files for testing
+tempfile = "3.8"
+
+# CLI testing
+assert_cmd = "2.0"
+
+# Property-based testing
+proptest = "1.4"
+
+# Benchmarking
+criterion = { version = "0.5", features = ["html_reports"] }
+
+# Test utilities
+pretty_assertions = "1.4"
+
+[[bench]]
+name = "vlan_generation"
+harness = false
+
+[[bench]]
+name = "xml_generation"
+harness = false
+
+[profile.release]
+lto = true
+codegen-units = 1
+panic = "abort"
+
+[profile.dev]
+debug = true
+
+[profile.test]
+debug = true

Cargo.toml

@@ -0,0 +1,28 @@
+use criterion::{black_box, criterion_group, criterion_main, Criterion};
+use opnsense_config_faker::generator::vlan::generate_vlan_configurations;
+
+fn bench_vlan_generation(c: &mut Criterion) {
+    c.bench_function("generate_10_vlans", |b| {
+        b.iter(|| {
+            let configs = generate_vlan_configurations(black_box(10), Some(42), None).unwrap();
+            black_box(configs)
+        })
+    });
+
+    c.bench_function("generate_100_vlans", |b| {
+        b.iter(|| {
+            let configs = generate_vlan_configurations(black_box(100), Some(42), None).unwrap();
+            black_box(configs)
+        })
+    });
+
+    c.bench_function("generate_1000_vlans", |b| {
+        b.iter(|| {
+            let configs = generate_vlan_configurations(black_box(1000), Some(42), None).unwrap();
+            black_box(configs)
+        })
+    });
+}
+
+criterion_group!(benches, bench_vlan_generation);
+criterion_main!(benches);

benches/vlan_generation.rs

@@ -0,0 +1,40 @@
+use criterion::{black_box, criterion_group, criterion_main, Criterion};
+use opnsense_config_faker::generator::vlan::generate_vlan_configurations;
+use opnsense_config_faker::xml::template::XmlTemplate;
+
+fn bench_xml_generation(c: &mut Criterion) {
+    let base_xml = r#"<?xml version="1.0"?>
+<opnsense>
+    <vlan id="{{VLAN_ID}}">{{DESCRIPTION}}</vlan>
+    <network>{{IP_NETWORK}}</network>
+    <gateway>{{GATEWAY_IP}}</gateway>
+</opnsense>"#;
+
+    c.bench_function("xml_template_apply_single", |b| {
+        let configs = generate_vlan_configurations(1, Some(42), None).unwrap();
+        let config = &configs[0];
+        
+        b.iter(|| {
+            let mut template = XmlTemplate::new(base_xml.to_string()).unwrap();
+            let result = template.apply_configuration(black_box(config), 1, 6).unwrap();
+            black_box(result)
+        })
+    });
+
+    c.bench_function("xml_template_apply_100", |b| {
+        let configs = generate_vlan_configurations(100, Some(42), None).unwrap();
+        
+        b.iter(|| {
+            let mut results = Vec::new();
+            for config in &configs {
+                let mut template = XmlTemplate::new(base_xml.to_string()).unwrap();
+                let result = template.apply_configuration(black_box(config), 1, 6).unwrap();
+                results.push(result);
+            }
+            black_box(results)
+        })
+    });
+}
+
+criterion_group!(benches, bench_xml_generation);
+criterion_main!(benches);

benches/xml_generation.rs

@@ -0,0 +1,57 @@
+//! CSV generation command implementation
+
+use crate::cli::CsvArgs;
+use crate::generator::vlan::generate_vlan_configurations;
+use crate::io::csv::write_csv;
+use crate::Result;
+use console::style;
+use indicatif::{ProgressBar, ProgressStyle};
+
+/// Execute the CSV generation command
+pub fn execute(args: CsvArgs) -> Result<()> {
+    println!("{}", style("🔧 OPNsense Config Faker - CSV Generator").bold().blue());
+    println!();
+
+    // Check if output file exists and handle force flag
+    if args.output.exists() && !args.force {
+        return Err(crate::model::ConfigError::config(format!(
+            "Output file '{}' already exists. Use --force to overwrite.",
+            args.output.display()
+        )));
+    }
+
+    // Set up progress indicator
+    let pb = ProgressBar::new(args.count as u64);
+    pb.set_style(
+        ProgressStyle::default_bar()
+            .template("{spinner:.green} [{elapsed_precise}] [{bar:40.cyan/blue}] {pos}/{len} {msg}")
+            .unwrap()
+            .progress_chars("#>-"),
+    );
+    pb.set_message("Generating VLAN configurations...");
+
+    // Generate VLAN configurations
+    let configs = generate_vlan_configurations(args.count, args.seed, Some(&pb))?;
+    
+    pb.set_message("Writing CSV file...");
+    
+    // Write to CSV file
+    write_csv(&configs, &args.output)?;
+    
+    pb.finish_with_message(format!(
+        "✅ Generated {} VLAN configurations in '{}'",
+        configs.len(),
+        args.output.display()
+    ));
+
+    println!();
+    println!("{}", style("Summary:").bold());
+    println!("  📊 Configurations: {}", configs.len());
+    println!("  📁 Output file: {}", args.output.display());
+    println!("  🏷️  VLAN IDs: {} - {}", 
+        configs.iter().map(|c| c.vlan_id).min().unwrap_or(0),
+        configs.iter().map(|c| c.vlan_id).max().unwrap_or(0)
+    );
+
+    Ok(())
+}

src/cli/commands/csv.rs

@@ -0,0 +1,4 @@
+//! CLI command implementations
+
+pub mod csv;
+pub mod xml;

src/cli/commands/mod.rs

@@ -0,0 +1,109 @@
+//! XML generation command implementation
+
+use crate::cli::XmlArgs;
+use crate::generator::vlan::generate_vlan_configurations;
+use crate::io::csv::read_csv;
+use crate::xml::template::XmlTemplate;
+use crate::Result;
+use console::style;
+use indicatif::{ProgressBar, ProgressStyle};
+use std::fs;
+
+/// Execute the XML generation command
+pub fn execute(args: XmlArgs) -> Result<()> {
+    println!("{}", style("🔧 OPNsense Config Faker - XML Generator").bold().blue());
+    println!();
+
+    // Validate base configuration file exists
+    if !args.base_config.exists() {
+        return Err(crate::model::ConfigError::ConfigNotFound {
+            path: args.base_config.display().to_string(),
+        });
+    }
+
+    // Create output directory if it doesn't exist
+    if !args.output_dir.exists() {
+        fs::create_dir_all(&args.output_dir)?;
+    }
+
+    // Generate or load VLAN configurations
+    let configs = if let Some(csv_file) = &args.csv_file {
+        println!("📄 Loading configurations from CSV: {}", csv_file.display());
+        read_csv(csv_file)?
+    } else if let Some(count) = args.count {
+        println!("🔄 Generating {count} VLAN configurations...");
+        
+        let pb = ProgressBar::new(count as u64);
+        pb.set_style(
+            ProgressStyle::default_bar()
+                .template("{spinner:.green} [{elapsed_precise}] [{bar:40.cyan/blue}] {pos}/{len} {msg}")
+                .unwrap()
+                .progress_chars("#>-"),
+        );
+        pb.set_message("Generating configurations...");
+        
+        let configs = generate_vlan_configurations(count, args.seed, Some(&pb))?;
+        pb.finish_with_message("✅ Configurations generated");
+        configs
+    } else {
+        return Err(crate::model::ConfigError::invalid_parameter(
+            "count or csv_file",
+            "Either --count or --csv-file must be specified"
+        ));
+    };
+
+    println!("📝 Processing {} configurations...", configs.len());
+
+    // Load base XML template
+    let base_xml = fs::read_to_string(&args.base_config)?;
+    let mut template = XmlTemplate::new(base_xml)?;
+
+    // Set up progress for XML generation
+    let pb = ProgressBar::new(configs.len() as u64);
+    pb.set_style(
+        ProgressStyle::default_bar()
+            .template("{spinner:.green} [{elapsed_precise}] [{bar:40.cyan/blue}] {pos}/{len} {msg}")
+            .unwrap()
+            .progress_chars("#>-"),
+    );
+    pb.set_message("Generating XML configurations...");
+
+    // Generate XML configurations
+    for (index, config) in configs.iter().enumerate() {
+        pb.set_message(format!("Processing VLAN {}", config.vlan_id));
+        
+        // Generate XML for this configuration
+        let output_xml = template.apply_configuration(config, args.firewall_nr, args.opt_counter + index as u16)?;
+        
+        // Write output file
+        let output_file = args.output_dir.join(format!(
+            "firewall_{}_vlan_{}.xml",
+            args.firewall_nr,
+            config.vlan_id
+        ));
+        
+        if output_file.exists() && !args.force {
+            return Err(crate::model::ConfigError::config(format!(
+                "Output file '{}' already exists. Use --force to overwrite.",
+                output_file.display()
+            )));
+        }
+        
+        fs::write(&output_file, output_xml)?;
+        pb.inc(1);
+    }
+
+    pb.finish_with_message("✅ XML configurations generated");
+
+    println!();
+    println!("{}", style("Summary:").bold());
+    println!("  📊 Configurations: {}", configs.len());
+    println!("  📁 Output directory: {}", args.output_dir.display());
+    println!("  🏷️  VLAN IDs: {} - {}", 
+        configs.iter().map(|c| c.vlan_id).min().unwrap_or(0),
+        configs.iter().map(|c| c.vlan_id).max().unwrap_or(0)
+    );
+    println!("  🔧 Firewall number: {}", args.firewall_nr);
+
+    Ok(())
+}