abol_codegen/

lib.rs

use abol_parser::dictionary::{
    AttributeType, Dictionary, DictionaryAttribute, DictionaryValue, SizeFlag,
};
use heck::{ToPascalCase, ToShoutySnakeCase, ToSnakeCase, ToUpperCamelCase};
use proc_macro2::TokenStream;
use quote::{format_ident, quote};
use std::collections::{HashMap, HashSet};
use std::io::Write;
use std::process::{Command, Stdio};
pub mod aruba;
pub mod microsoft;
pub mod rfc2865;
pub mod rfc2866;
pub mod rfc2869;
pub mod rfc3576;
pub mod rfc6911;
pub mod wispr;

/// A code generator that transforms RADIUS dictionary definitions into type-safe Rust traits.
///
/// This generator produces a trait (e.g., `Rfc2865Ext`) that extends the base `Packet` struct
/// with getter and setter methods for every attribute defined in the dictionary.
pub struct Generator {
    /// The name of the trait to be generated (e.g., "Rfc2865Ext").
    pub trait_name: String,
    /// Attributes that should be skipped during generation.
    pub ignored_attributes: Vec<String>,
    /// Maps attribute names to external crate/module paths if they are defined elsewhere.
    pub external_attributes: HashMap<String, String>,
}

impl Generator {
    /// Creates a new generator instance for the specified module name.
    ///
    /// # Arguments
    /// * `module_name` - The base name for the generated trait (will be converted to PascalCase).
    pub fn new(trait_name: &str) -> Self {
        Self {
            trait_name: trait_name.to_string(),
            ignored_attributes: Vec::new(),
            external_attributes: HashMap::new(),
        }
    }
    /// Validates an attribute against RADIUS protocol constraints and generator logic.
    ///
    /// This ensures that attributes follow standard OID limits, size constraints,
    /// and encryption requirements.
    fn validate_attr(&self, attr: &DictionaryAttribute) -> Result<(), String> {
        // OID Check: Standard attributes must fit in 1 byte
        if attr.oid.vendor.is_none() && attr.oid.code > 255 {
            return Err(format!(
                "Standard attribute {} OID must be <= 255",
                attr.name
            ));
        }

        // Size Check: Only String/Octets support size constraints
        if attr.size.is_constrained()
            && !matches!(
                attr.attr_type,
                AttributeType::String | AttributeType::Octets
            )
        {
            return Err(format!(
                "Size constraint invalid for non-binary type in {}",
                attr.name
            ));
        }

        // Encryption: Only specific flags (User-Password/Tunnel) supported
        if let Some(enc) = attr.encrypt
            && enc != 1
            && enc != 2
        {
            return Err(format!(
                "Unsupported encryption type {} on {}",
                enc, attr.name
            ));
        }

        // Concat: Strict rules (no encryption/tag/size allowed with concat)
        if attr.concat.unwrap_or(false) {
            let is_binary = matches!(
                attr.attr_type,
                AttributeType::String | AttributeType::Octets
            );
            let flags_present =
                attr.encrypt.is_some() || attr.has_tag.is_some() || attr.size.is_constrained();
            if !is_binary || flags_present {
                return Err(format!("Invalid Concat configuration for {}", attr.name));
            }
        }

        Ok(())
    }
    fn format_code(&self, content: &str) -> String {
        let child = Command::new("rustfmt")
            .stdin(Stdio::piped())
            .stdout(Stdio::piped())
            .stderr(Stdio::null())
            .spawn()
            .ok()
            .and_then(|mut child| {
                let mut stdin = child.stdin.take()?;
                stdin.write_all(content.as_bytes()).ok()?;
                drop(stdin);
                let output = child.wait_with_output().ok()?;
                if output.status.success() {
                    Some(String::from_utf8_lossy(&output.stdout).to_string())
                } else {
                    None
                }
            });

        child.unwrap_or_else(|| content.to_string())
    }
    /// Generates the Rust source code for the given dictionary.
    ///
    /// # Errors
    /// Returns an error if the generation process fails or if there are severe inconsistencies
    /// in the dictionary structure.
    pub fn generate(&self, dict: &Dictionary) -> Result<String, Box<dyn std::error::Error>> {
        let mut tokens = TokenStream::new();
        let mut trait_signatures = TokenStream::new();
        let mut trait_impl_bodies = TokenStream::new();

        let trait_ident = format_ident!("{}Ext", self.trait_name.to_pascal_case());
        let ignored: HashSet<_> = self.ignored_attributes.iter().collect();

        // 1. Group Values by Attribute Name for easier lookup
        let mut value_map: HashMap<String, Vec<&DictionaryValue>> = HashMap::new();
        for val in &dict.values {
            value_map
                .entry(val.attribute_name.clone())
                .or_default()
                .push(val);
        }

        // 2. Base Imports
        tokens.extend(quote! {
            use std::net::{Ipv4Addr, Ipv6Addr};
          use abol_core::{packet::Packet, attribute::FromRadiusAttribute, attribute::ToRadiusAttribute};
            use std::time::SystemTime;
        });

        // 3. Process Standard Attributes
        for attr in &dict.attributes {
            self.process_attribute(
                attr,
                &ignored,
                &value_map,
                &mut tokens,
                &mut trait_signatures,
                &mut trait_impl_bodies,
            );
        }

        // 4. Process Vendors and their specific Attributes/Values
        for vendor in &dict.vendors {
            let vendor_id = vendor.code;
            let vendor_const = format_ident!("VENDOR_{}", vendor.name.to_shouty_snake_case());

            tokens.extend(quote! { pub const #vendor_const: u32 = #vendor_id; });

            // Create a specific value map for this vendor
            let mut vendor_val_map: HashMap<String, Vec<&DictionaryValue>> = HashMap::new();
            for val in &vendor.values {
                vendor_val_map
                    .entry(val.attribute_name.clone())
                    .or_default()
                    .push(val);
            }

            for attr in &vendor.attributes {
                self.process_attribute(
                    attr,
                    &ignored,
                    &vendor_val_map,
                    &mut tokens,
                    &mut trait_signatures,
                    &mut trait_impl_bodies,
                );
            }
        }

        // 5. Wrap in Trait
        tokens.extend(quote! {
            pub trait #trait_ident {
                #trait_signatures
            }
            impl #trait_ident for Packet {
                #trait_impl_bodies
            }
        });
        let raw_code = tokens.to_string();

        Ok(self.format_code(&raw_code))
    }
    /// Internal helper to process a single attribute and generate its types, constants, and methods.
    fn process_attribute(
        &self,
        attr: &DictionaryAttribute,
        ignored: &HashSet<&String>,
        value_map: &HashMap<String, Vec<&DictionaryValue>>,
        tokens: &mut TokenStream,
        signatures: &mut TokenStream,
        bodies: &mut TokenStream,
    ) {
        if ignored.contains(&attr.name) {
            return;
        }
        if let Err(e) = self.validate_attr(attr) {
            eprintln!("Skipping {}: {}", attr.name, e);
            return;
        }

        // 1. Map Dictionary Type to Rust "Wire" Types
        let (wire_type, user_get_type, user_set_type, needs_into) = match attr.attr_type {
            AttributeType::String => (
                quote! { String },
                quote! { String },
                quote! { impl Into<String> },
                true,
            ),
            AttributeType::Integer => (quote! { u32 }, quote! { u32 }, quote! { u32 }, false),
            AttributeType::IpAddr => (
                quote! { Ipv4Addr },
                quote! { Ipv4Addr },
                quote! { Ipv4Addr },
                false,
            ),
            AttributeType::Ipv6Addr => (
                quote! { Ipv6Addr },
                quote! { Ipv6Addr },
                quote! { Ipv6Addr },
                false,
            ),
            AttributeType::Octets
            | AttributeType::Ether
            | AttributeType::ABinary
            | AttributeType::Vsa => (
                quote! { Vec<u8> },
                quote! { Vec<u8> },
                quote! { impl Into<Vec<u8>> },
                true, // Needs .into()
            ),
            AttributeType::Date => (
                quote! { SystemTime },
                quote! { SystemTime },
                quote! { SystemTime },
                false,
            ),
            AttributeType::Byte => (quote! { u8 }, quote! { u8 }, quote! { u8 }, false),
            AttributeType::Short => (quote! { u16 }, quote! { u16 }, quote! { u16 }, false),
            AttributeType::Signed => (quote! { i32 }, quote! { i32 }, quote! { i32 }, false),
            AttributeType::Tlv => (quote! { Tlv }, quote! { Tlv }, quote! { Tlv }, false),
            AttributeType::Ipv4Prefix | AttributeType::Ipv6Prefix => (
                quote! { Vec<u8> },
                quote! { Vec<u8> },
                quote! { Vec<u8> },
                false,
            ),
            AttributeType::Ifid | AttributeType::InterfaceId => {
                (quote! { u64 }, quote! { u64 }, quote! { u64 }, false)
            }
            _ => return,
        };

        let has_values = value_map.contains_key(&attr.name);
        let normalized_name = attr.name.replace("-", "_").to_lowercase();
        let enum_name = format_ident!("{}", normalized_name.to_upper_camel_case());
        let is_external = self.external_attributes.contains_key(&attr.name);
        let const_type_ident = format_ident!("{}_TYPE", normalized_name.to_shouty_snake_case());
        // 2. Determine Final Method Types (Override if Enum exists)
        let (final_get_type, final_set_type, final_needs_into) = if has_values {
            (quote! { #enum_name }, quote! { #enum_name }, true)
        } else {
            (user_get_type, user_set_type, needs_into)
        };

        // 3. Generate Type Constants (Always generated)
        if !is_external {
            let code = attr.oid.code as u8;
            tokens.extend(quote! { pub const #const_type_ident: u8 = #code; });
        }

        // 4. Generate the Enum definition if values exist
        if let Some(values) = value_map.get(&attr.name) {
            let mut variants = Vec::new();
            let mut from_arms = Vec::new();
            let mut to_arms = Vec::new();
            let mut seen_values = HashSet::new();
            for val in values {
                let variant_ident = format_ident!("{}", val.name.to_upper_camel_case());
                let val_lit = val.value as u32;

                variants.push(quote! { #variant_ident });
                if seen_values.insert(val_lit) {
                    from_arms.push(quote! { #val_lit => Self::#variant_ident });
                }
                to_arms.push(quote! { #enum_name::#variant_ident => #val_lit });
            }

            tokens.extend(quote! {
                #[derive(Debug, Clone, Copy, PartialEq, Eq)]
                #[repr(u32)]
                pub enum #enum_name {
                    #(#variants),*,
                    Unknown(u32),
                }

                impl From<u32> for #enum_name {
                    fn from(v: u32) -> Self {
                        match v {
                            #(#from_arms),*,
                            other => Self::Unknown(other),
                        }
                    }
                }

                impl From<#enum_name> for u32 {
                    fn from(e: #enum_name) -> Self {
                        match e {
                            #(#to_arms),*,
                            #enum_name::Unknown(v) => v,
                        }
                    }
                }
            });
        }

        let get_ident = format_ident!("get_{}", normalized_name.to_snake_case());
        let set_ident = format_ident!("set_{}", normalized_name.to_snake_case());

        // 5. Generate Trait Signatures
        signatures.extend(quote! {
            fn #get_ident(&self) -> Option<#final_get_type>;
            fn #set_ident(&mut self, value: #final_set_type);
        });

        // 6. Generate Validation Logic
        let size_validation = match attr.size {
            SizeFlag::Exact(n) => quote! {
                if ToRadiusAttribute::to_bytes(&wire_val).len() != #n as usize {
                    return;
                }
            },
            SizeFlag::Range(min, max) => quote! {
                let len = ToRadiusAttribute::to_bytes(&wire_val).len();
                if len < #min as usize || len > #max as usize {
                    return;
                }
            },
            SizeFlag::Any => quote! {},
        };

        // 7. Generate Method Bodies
        let is_vsa = attr.oid.vendor.is_some();
        let v_const = if let Some(vid) = attr.oid.vendor {
            format_ident!("VENDOR_{}", vid)
        } else {
            format_ident!("UNUSED")
        };

        let (method, args) = if is_vsa {
            (
                quote!(get_vsa_attribute_as),
                quote!(#v_const, #const_type_ident),
            )
        } else {
            (quote!(get_attribute_as), quote!(#const_type_ident))
        };

        let (target_type, map_clause) = if has_values {
            (quote!(u32), quote!(.map(#enum_name::from)))
        } else {
            (quote!(#wire_type), quote!())
        };

        let body_get = quote! {
            self.#method::<#target_type>(#args) #map_clause
        };

        let (set_method, set_args) = if is_vsa {
            (
                quote!(set_vsa_attribute_as),
                quote!(#v_const, #const_type_ident),
            )
        } else {
            (quote!(set_attribute_as), quote!(#const_type_ident))
        };

        let value_type = if has_values {
            quote!(u32)
        } else {
            quote!(#wire_type)
        };

        let body_set = if final_needs_into {
            quote! {
                let wire_val: #value_type = value.into();
                #size_validation
                self.#set_method::<#value_type>(#set_args, wire_val);
            }
        } else {
            quote! {
                let wire_val = value; // Direct assignment, no .into()
                #size_validation
                self.#set_method::<#value_type>(#set_args, wire_val);
            }
        };

        bodies.extend(quote! {
            fn #get_ident(&self) -> Option<#final_get_type> { #body_get }
            fn #set_ident(&mut self, value: #final_set_type) { #body_set }
        });
    }
}
#[cfg(test)]
mod tests {
    use abol_parser::dictionary;

    use super::*;

    #[test]
    fn test_generator_new() {
        let generator = Generator::new("Rfc2865Ext");
        assert_eq!(generator.trait_name, "Rfc2865Ext");
        assert!(generator.ignored_attributes.is_empty());
    }

    #[test]
    fn test_validate_attr_oid_overflow() {
        let generator = Generator::new("test");
        let attr = DictionaryAttribute {
            name: "Test-Attr".to_string(),
            oid: dictionary::Oid {
                vendor: None,
                code: 256,
            },
            attr_type: AttributeType::String,
            size: dictionary::SizeFlag::Any,
            encrypt: None,
            has_tag: None,
            concat: None,
        };
        // Standard RADIUS OID is 1 byte (0-255)

        assert!(generator.validate_attr(&attr).is_err());
    }

    #[test]
    fn test_validate_attr_size_constraint_type() {
        let generator = Generator::new("test");
        let mut attr = DictionaryAttribute {
            name: "Test-Attr".to_string(),
            oid: dictionary::Oid {
                vendor: None,
                code: 100,
            },
            attr_type: AttributeType::Integer,
            size: dictionary::SizeFlag::Range(1, 10),
            encrypt: None,
            has_tag: None,
            concat: None,
        };

        // Integer types cannot have size constraints in RADIUS
        assert!(generator.validate_attr(&attr).is_err());

        attr.attr_type = AttributeType::String;
        assert!(generator.validate_attr(&attr).is_ok());
    }

    #[test]
    fn test_process_attribute_generation() {
        let generator = Generator::new("Rfc2865");
        let mut tokens = TokenStream::new();
        let mut signatures = TokenStream::new();
        let mut bodies = TokenStream::new();

        let attr = DictionaryAttribute {
            name: "User-Name".to_string(),
            oid: dictionary::Oid {
                vendor: None,
                code: 1,
            },
            attr_type: AttributeType::String,
            size: dictionary::SizeFlag::Any,
            encrypt: None,
            has_tag: None,
            concat: None,
        };

        generator.process_attribute(
            &attr,
            &HashSet::new(),
            &HashMap::new(),
            &mut tokens,
            &mut signatures,
            &mut bodies,
        );

        let sig_str = signatures.to_string();
        assert!(sig_str.contains("get_user_name"));
        assert!(sig_str.contains("set_user_name"));
    }

    #[test]
    fn test_ignored_attributes() {
        let mut generator = Generator::new("test");
        generator.ignored_attributes.push("Password".to_string());

        let ignored: HashSet<_> = generator.ignored_attributes.iter().collect();
        let mut tokens = TokenStream::new();
        let mut signatures = TokenStream::new();
        let mut bodies = TokenStream::new();

        let attr = DictionaryAttribute {
            name: "Password".to_string(),
            oid: dictionary::Oid {
                vendor: None,
                code: 2,
            },
            attr_type: AttributeType::String,
            size: dictionary::SizeFlag::Any,
            encrypt: None,
            has_tag: None,
            concat: None,
        };

        generator.process_attribute(
            &attr,
            &ignored,
            &HashMap::new(),
            &mut tokens,
            &mut signatures,
            &mut bodies,
        );

        assert!(signatures.is_empty());
    }
}