#ipfix #netflow #bindings-generator #parser #code #generator

netgauze-ipfix-code-generator

Generate Rust code bindings for IPFIX Information Elements

8 releases (5 breaking)

new 0.6.0 Mar 18, 2025
0.5.0 Nov 5, 2024
0.4.1 Aug 8, 2024
0.3.1 Oct 10, 2024
0.1.0 Mar 5, 2023

#2 in #netflow

Download history 2/week @ 2024-11-28 15/week @ 2024-12-05 13/week @ 2024-12-12 2/week @ 2025-01-02 6/week @ 2025-01-09 7/week @ 2025-01-16 24/week @ 2025-01-23 3/week @ 2025-02-13 20/week @ 2025-02-20 9/week @ 2025-02-27 10/week @ 2025-03-06 76/week @ 2025-03-13

118 downloads per month
Used in 3 crates (via netgauze-flow-pkt)

Apache-2.0

190KB
3.5K SLoC

Generate Rust code bindings for IPFIX Information Elements

Example:

To include the generated IANA and custom registry Information elements, in build.rs add the following code

use std::env;

use netgauze_ipfix_code_generator::{Config, generate, RegistrySource, RegistryType, SourceConfig};

const IPFIX_URL: &str = "https://www.iana.org/assignments/ipfix/ipfix.xml";

fn main() {
    let out_dir = env::var_os("OUT_DIR").expect("Couldn't find OUT_DIR in OS env variables");
    let manifest_dir = env!("CARGO_MANIFEST_DIR");
    let registry_path = std::path::Path::new(&manifest_dir).join("registry");
    // Add custom registry, the xml file must follow the IANA schema
    let nokia_path = registry_path
        .join("nokia.xml")
        .into_os_string()
        .into_string()
        .expect("Couldn't load nokia registry file");
    let nokia_source = SourceConfig::new(
        RegistrySource::File(nokia_path),
        RegistryType::IanaXML,
        637,
        "nokia".to_string(),
        "Nokia".to_string(),
    );
    let iana_source = SourceConfig::new(
        RegistrySource::Http(IPFIX_URL.to_string()),
        RegistryType::IanaXML,
        0,
        "iana".to_string(),
        "IANA".to_string(),
    );
    let configs = Config::new(iana_source, vec![nokia_source]);
    generate(&out_dir, &configs).unwrap();

    println!("cargo:rerun-if-changed=build.rs");
}

Dependencies

~6–19MB
~251K SLoC