relay-knowledge 1.0.7

Graph-database-based knowledge graph project.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use super::{source_declarations_for_identity, tests::fixtures::TempGitRepo};

#[test]
fn source_declaration_fallback_reads_exact_committed_typedef() {
    let repo = TempGitRepo::create("source-declaration-typedef");
    repo.write(
        "include/driver_ops.h",
        "struct rk_device;\n\
         typedef int (*rk_read_fn)(struct rk_device *dev);\n\
         struct rk_driver_ops {\n\
             rk_read_fn read;\n\
         };\n",
    );
    repo.git(["add", "."]);
    repo.git(["commit", "-m", "base"]);
    let commit = repo.git_text(["rev-parse", "HEAD"]);
    repo.write("include/driver_ops.h", "typedef int (*rk_read_fn)(void);\n");

    let matches = source_declarations_for_identity(
        &repo.registration(),
        &commit,
        vec!["include/driver_ops.h".to_owned()],
        "rk_read_fn",
    )
    .expect("source declaration fallback should read committed blob");

    assert_eq!(matches.len(), 1);
    assert_eq!(
        matches[0].excerpt,
        "typedef int (*rk_read_fn)(struct rk_device *dev);"
    );
    assert_eq!(matches[0].line_range.start, 2);
}

#[test]
fn source_declaration_fallback_skips_call_like_uses_before_declaration() {
    let repo = TempGitRepo::create("source-declaration-calls");
    repo.write(
        "src/callback.c",
        "void register_all(void) { register_callback(api_fn()); }\n\
         int api_fn(void);\n",
    );
    repo.git(["add", "."]);
    repo.git(["commit", "-m", "base"]);
    let commit = repo.git_text(["rev-parse", "HEAD"]);

    let matches = source_declarations_for_identity(
        &repo.registration(),
        &commit,
        vec!["src/callback.c".to_owned()],
        "api_fn",
    )
    .expect("source declaration fallback should skip call-like use");

    assert_eq!(matches.len(), 1);
    assert_eq!(matches[0].excerpt, "int api_fn(void);");
    assert_eq!(matches[0].line_range.start, 2);
}

#[test]
fn source_declaration_fallback_ignores_unsafe_paths_and_non_identities() {
    let repo = TempGitRepo::create("source-declaration-paths");
    repo.write("include/api.h", "typedef int api_fn(void);\n");
    repo.git(["add", "."]);
    repo.git(["commit", "-m", "base"]);
    let commit = repo.git_text(["rev-parse", "HEAD"]);

    let matches = source_declarations_for_identity(
        &repo.registration(),
        &commit,
        vec![
            "../include/api.h".to_owned(),
            "/include/api.h".to_owned(),
            "include/api.h".to_owned(),
        ],
        "api_fn",
    )
    .expect("safe path should still be read");

    assert_eq!(matches.len(), 1);
    assert_eq!(matches[0].path, "include/api.h");
    assert!(
        source_declarations_for_identity(
            &repo.registration(),
            &commit,
            vec!["include/api.h".to_owned()],
            "api_fn()",
        )
        .expect("invalid identity should not fail")
        .is_empty()
    );
}