hotspots-core 1.23.0

//! Language-agnostic CFG builder traits

use crate::ast::FunctionNode;
use crate::cfg::Cfg;

/// Language-agnostic CFG builder interface
///
/// Each supported language must implement this trait to build control flow graphs
/// from function bodies.
pub trait CfgBuilder {
    /// Build a control flow graph from a function
    ///
    /// # Arguments
    ///
    /// * `function` - The function node containing the body to analyze
    ///
    /// # Returns
    ///
    /// A CFG representing the control flow of the function
    fn build(&self, function: &FunctionNode) -> Cfg;
}

/// Get the appropriate CFG builder for a function based on its language
///
/// Dispatches to the appropriate CFG builder based on the function body type.
pub fn get_builder_for_function(function: &FunctionNode) -> Box<dyn CfgBuilder> {
    use crate::language::FunctionBody;

    match &function.body {
        FunctionBody::ECMAScript(_) => Box::new(super::ecmascript::ECMAScriptCfgBuilder),
        FunctionBody::Go { .. } => Box::new(super::go::GoCfgBuilder),
        FunctionBody::Java { .. } => Box::new(super::java::JavaCfgBuilder),
        FunctionBody::Python { .. } => Box::new(super::python::PythonCfgBuilder),
        FunctionBody::Rust { .. } => Box::new(super::rust::RustCfgBuilder),
        FunctionBody::CSharp { .. } => Box::new(super::csharp::CSharpCfgBuilder),
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::ast::FunctionId;
    use crate::language::{FunctionBody, SourceSpan};

    fn make_test_function() -> FunctionNode {
        FunctionNode {
            id: FunctionId {
                file_index: 0,
                local_index: 0,
            },
            name: Some("test".to_string()),
            span: SourceSpan::new(0, 10, 1, 1, 0),
            body: FunctionBody::ecmascript(swc_ecma_ast::BlockStmt {
                span: swc_common::DUMMY_SP,
                ctxt: Default::default(),
                stmts: vec![],
            }),
            suppression_reason: None,
        }
    }

    #[test]
    fn test_get_builder_for_ecmascript() {
        let function = make_test_function();
        let builder = get_builder_for_function(&function);
        let cfg = builder.build(&function);

        // Basic CFG should have entry and exit nodes
        assert!(
            cfg.node_count() >= 2,
            "CFG should have at least entry and exit nodes"
        );
    }

    #[test]
    fn test_builder_trait() {
        use super::super::ecmascript::ECMAScriptCfgBuilder;

        let function = make_test_function();
        let builder = ECMAScriptCfgBuilder;
        let cfg = builder.build(&function);

        // Empty function should have simple CFG: entry -> exit
        assert_eq!(cfg.node_count(), 2);
        assert_eq!(cfg.edge_count(), 1);
    }
}