bonsai-ninja-lang-python 0.2.15

Python language adapter.
//! Python reflection remains exact runtime evidence. A literal attribute name
//! does not prove that `getattr` or `hasattr` invokes that attribute, and a
//! `setattr` call is a write rather than a method dispatch.

use bonsai_db::AnalyzerDb;
use bonsai_lang_api::{FlowEvent, LanguageRegistry};
use bonsai_vfs::Vfs;
use std::sync::Arc;

fn db_with(source: &str) -> AnalyzerDb {
    let vfs = Arc::new(Vfs::new());
    vfs.write("a.py".to_string(), Arc::<str>::from(source));
    let registry = Arc::new(LanguageRegistry::new());
    registry.register(Arc::new(bonsai_lang_python::PythonAdapter::new()));
    let db = AnalyzerDb::new(vfs, registry);
    for f in db.vfs().all_files() {
        let _ = db.decl_index(f);
    }
    db
}

fn calls_in(db: &AnalyzerDb, fn_name: &str) -> Vec<(String, Option<String>)> {
    let g = db.global_index();
    let mut out = Vec::new();
    for f in g.all_files() {
        for decl in g.decls_in(f) {
            if decl.name != fn_name {
                continue;
            }
            walk(&decl.flow_events, &mut out);
        }
    }
    out
}

fn walk(events: &[FlowEvent], out: &mut Vec<(String, Option<String>)>) {
    for e in events {
        match e {
            FlowEvent::Call { name, receiver, .. } => out.push((name.clone(), receiver.clone())),
            FlowEvent::Branch {
                then_events,
                else_events,
                ..
            } => {
                walk(then_events, out);
                walk(else_events, out);
            }
            FlowEvent::Loop { body, .. } => walk(body, out),
            _ => {}
        }
    }
}

#[test]
fn constant_getattr_stays_reflective() {
    let src = r#"
def main(obj, x):
    getattr(obj, "process")(x)
"#;
    let db = db_with(src);
    let calls = calls_in(&db, "main");
    let has_raw_getattr = calls.iter().any(|(name, _)| name == "getattr");
    assert!(
        has_raw_getattr,
        "the exact getattr call must remain visible, got {calls:?}"
    );
    assert!(
        !calls.iter().any(|(name, _)| name == "obj.process"),
        "getattr must not create an invented obj.process call, got {calls:?}"
    );
}

#[test]
fn dynamic_getattr_stays_unrewritten() {
    let src = r#"
def main(obj, name):
    getattr(obj, name)()
"#;
    let db = db_with(src);
    let calls = calls_in(&db, "main");
    let has_raw_getattr = calls.iter().any(|(name, _)| name == "getattr");
    assert!(
        has_raw_getattr,
        "dynamic getattr (non-literal second arg) must stay as `getattr` for the engine to gate; \
         got {calls:?}"
    );
}

#[test]
fn constant_setattr_stays_a_runtime_write_call() {
    let src = r#"
def main(obj, value):
    setattr(obj, "prop", value)
"#;
    let db = db_with(src);
    let calls = calls_in(&db, "main");
    assert!(
        calls.iter().any(|(name, _)| name == "setattr") && !calls.iter().any(|(name, _)| name == "obj.prop"),
        "setattr must remain exact and must not become an invented dispatch: {calls:?}"
    );
}

#[test]
fn constant_hasattr_stays_a_runtime_test_call() {
    let src = r#"
def main(obj):
    if hasattr(obj, "feature"):
        pass
"#;
    let db = db_with(src);
    let calls = calls_in(&db, "main");
    assert!(
        calls.iter().any(|(name, _)| name == "hasattr")
            && !calls.iter().any(|(name, _)| name == "obj.feature"),
        "hasattr must remain exact and must not become an invented dispatch: {calls:?}"
    );
}

#[test]
fn single_quoted_literal_does_not_change_the_reflection_contract() {
    let src = r#"
def main(obj, value):
    setattr(obj, 'prop', value)
"#;
    let db = db_with(src);
    let calls = calls_in(&db, "main");
    assert!(
        calls.iter().any(|(name, _)| name == "setattr") && !calls.iter().any(|(name, _)| name == "obj.prop"),
        "quote style must not authorize a guessed edge, got {calls:?}"
    );
}