netforge 0.1.5

High-performance raw packet I/O engine with AF_XDP, sendmmsg, and pnet backends
Documentation
use netforge::{auto_select, EngineConfig};
use std::net::Ipv4Addr;

#[test]
fn engine_config_defaults() {
    let config = EngineConfig::default();
    assert_eq!(config.source_ip, Ipv4Addr::UNSPECIFIED);
    assert_eq!(config.rate_pps, 1_000_000);
    assert_eq!(config.source_port_start, 49152);
    assert_eq!(config.source_port_end, 65535);
    assert!(config.interface.is_none());
    assert_eq!(config.tx_ring_size, 4096);
    assert_eq!(config.rx_ring_size, 4096);
}

#[test]
fn auto_select_fails_or_succeeds_gracefully_without_panic() {
    let config = EngineConfig {
        source_ip: Ipv4Addr::new(127, 0, 0, 1),
        rate_pps: 100,
        interface: Some("nonexistent_iface_999".into()),
        ..EngineConfig::default()
    };

    // On unprivileged systems or missing interfaces, auto_select returns PermissionDenied
    // or Io error without panicking.
    let result = auto_select(config);
    let _ = result;
}
#[test]
#[cfg(all(target_os = "linux", feature = "xdp-backend"))]
fn auto_select_fails_closed_on_invalid_config_instead_of_silent_fallback() {
    use netforge::engine::EngineError;

    let config = EngineConfig {
        source_ip: Ipv4Addr::new(127, 0, 0, 1),
        interface: Some("lo".into()),
        tx_ring_size: 100, // Invalid: not a power of two
        ..EngineConfig::default()
    };
    let result = auto_select(config);
    match result {
        Err(EngineError::InvalidConfig(msg)) => {
            assert!(
                msg.contains("not a power of two"),
                "Expected invalid config error message, got: {msg}"
            );
        }
        Ok(_) => panic!("Expected EngineError::InvalidConfig, but auto_select succeeded!"),
        Err(err) => panic!("Expected EngineError::InvalidConfig, got: {err}"),
    }
}