llmcc-rust 0.2.39

llmcc: llm context compiler
Documentation
use std::collections::HashMap;

use llmcc_rust::{
    build_llmcc_ir, collect_symbols, CompileCtxt, LangRust, TypeExpr, VariableDescriptor,
    VariableKind, VariableScope,
};

fn collect_variables(source: &str) -> HashMap<String, VariableDescriptor> {
    let sources = vec![source.as_bytes().to_vec()];
    let cc = CompileCtxt::from_sources::<LangRust>(&sources);
    let unit = cc.compile_unit(0);
    build_llmcc_ir::<LangRust>(&cc).unwrap();

    let globals = cc.create_globals();
    collect_symbols(unit, globals)
        .variables
        .into_iter()
        .map(|desc| (desc.fqn.clone(), desc))
        .collect()
}

#[test]
fn captures_global_const() {
    let map = collect_variables("const MAX: i32 = 10;\n");
    let desc = map.get("MAX").unwrap();
    assert_eq!(desc.kind, VariableKind::Const);
    assert_eq!(desc.scope, VariableScope::Global);
    assert!(!desc.is_mut);
    let ty = desc.ty.as_ref().unwrap();
    assert_path(ty, &["i32"]);
}

#[test]
fn captures_static_mut() {
    let map = collect_variables("static mut COUNTER: usize = 0;\n");
    let desc = map.get("COUNTER").unwrap();
    assert_eq!(desc.kind, VariableKind::Static);
    assert_eq!(desc.scope, VariableScope::Global);
    assert!(desc.is_mut);
    let ty = desc.ty.as_ref().unwrap();
    assert_path(ty, &["usize"]);
}

#[test]
fn captures_local_let_with_type() {
    let source = r#"
        fn wrapper() {
            let mut value: Option<Result<i32, &'static str>> = None;
        }
    "#;
    let map = collect_variables(source);
    let desc = map.get("wrapper::value").unwrap();
    assert_eq!(desc.kind, VariableKind::Let);
    assert_eq!(desc.scope, VariableScope::Local);
    assert!(desc.is_mut);

    let ty = desc.ty.as_ref().unwrap();
    let generics = assert_path(ty, &["Option"]);
    assert_eq!(generics.len(), 1);
    let inner = &generics[0];
    let result_generics = assert_path(inner, &["Result"]);
    assert_eq!(result_generics.len(), 2);
    assert_path(&result_generics[0], &["i32"]);
    if let TypeExpr::Reference {
        is_mut,
        lifetime,
        inner,
    } = &result_generics[1]
    {
        assert!(!is_mut);
        assert_eq!(lifetime.as_deref(), Some("'static"));
        assert_path(inner, &["str"]);
    } else {
        panic!();
    }
}

fn assert_path<'a>(expr: &'a TypeExpr, expected: &[&str]) -> &'a [TypeExpr] {
    if let TypeExpr::Path { segments, generics } = expr {
        let expected_vec: Vec<String> = expected.iter().map(|s| s.to_string()).collect();
        assert_eq!(segments, &expected_vec);
        generics
    } else {
        panic!();
    }
}