Function derive_function_name

src/extraction/basic_common.rs:77–113

Derive a function name from REM comment text. Takes the first REM line text and converts it into a snake_case-like identifier. For example, "VALIDATE CONFIGURATION" becomes "`VALIDATE_CONFIGURATION`".

(rem_comments: &[String])

/// Takes the first REM line text and converts it into a snake_case-like
/// identifier. For example, "VALIDATE CONFIGURATION" becomes "`VALIDATE_CONFIGURATION`".
pub(crate) fn derive_function_name(rem_comments: &[String]) -> String {
    if rem_comments.is_empty() {
        return "UNNAMED_SUB".to_string();
    }
    let first = &rem_comments[0];
    // Replace spaces with underscores and keep alphanumeric + underscore.
    let name: String = first
        .chars()
        .map(|c| {
            if c.is_alphanumeric() || c == '_' {
                c
            } else {
                '_'
            }
        })
        .collect();
    // Collapse multiple underscores and trim.
    let mut collapsed = String::new();
    let mut prev_underscore = false;
    for c in name.chars() {
        if c == '_' {
            if !prev_underscore && !collapsed.is_empty() {
                collapsed.push('_');
            }
            prev_underscore = true;
        } else {
            collapsed.push(c);
            prev_underscore = false;
        }
    }
    let trimmed = collapsed.trim_end_matches('_').to_string();
    if trimmed.is_empty() {
        "UNNAMED_SUB".to_string()
    } else {
        trimmed
    }
}