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

netgauze-ipfix-code-generator

Generate Rust code bindings for IPFIX Information Elements

7 releases (4 breaking)

0.5.0 Nov 5, 2024
0.4.1 Aug 8, 2024
0.3.1 Oct 10, 2024
0.3.0 Jan 31, 2024
0.1.0 Mar 5, 2023

#647 in Network programming

Download history 21/week @ 2024-08-13 15/week @ 2024-08-20 8/week @ 2024-08-27 29/week @ 2024-09-10 35/week @ 2024-09-17 73/week @ 2024-09-24 48/week @ 2024-10-01 127/week @ 2024-10-08 15/week @ 2024-10-15 4/week @ 2024-10-22 2/week @ 2024-10-29 134/week @ 2024-11-05 9/week @ 2024-11-12 7/week @ 2024-11-19 8/week @ 2024-11-26

158 downloads per month
Used in 2 crates (via netgauze-flow-pkt)

Apache-2.0

155KB
3K 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

~7–19MB
~254K SLoC