salsa 0.27.1

A generic framework for on-demand, incrementalized computation (experimental)
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
93
94

#![cfg(all(feature = "inventory", feature = "accumulator"))]

use crate::common::{ExecuteValidateLoggerDatabase, LogDatabase};
use expect_test::expect;
use salsa::{Database, Durability, Id};

mod common;

#[salsa::tracked(cycle_initial=cycle_initial)]
fn query_a(db: &dyn salsa::Database) -> Interned<'_> {
    let interned = query_b(db);
    let value = interned.value(db);

    if value < 10 {
        Interned::new(db, value + 1)
    } else {
        interned
    }
}

#[salsa::tracked]
fn query_b(db: &dyn Database) -> Interned<'_> {
    let interned = query_a(db);
    query_x(db, interned);
    interned
}

#[salsa::tracked]
fn query_x<'db>(db: &'db dyn Database, _i: Interned<'db>) {
    StableInput::get(db).value(db);
}

fn cycle_initial(db: &dyn Database, _id: Id) -> Interned<'_> {
    // Keep cycle-created values reusable so the test still covers validation ordering.
    db.report_untracked_read();
    Interned::new(db, 0)
}

#[salsa::interned]
struct Interned {
    value: u32,
}

#[salsa::input(singleton)]
struct StableInput {
    value: (),
}

#[test_log::test]
fn the_test() {
    let mut db = ExecuteValidateLoggerDatabase::default();
    let _ = StableInput::builder(())
        .durability(Durability::HIGH)
        .new(&db);

    let result = query_a(&db);

    assert_eq!(result.value(&db), 10);

    db.clear_logs();
    db.synthetic_write(Durability::HIGH);

    let result = query_a(&db);

    assert_eq!(result.value(&db), 10);

    // What this test captures is that the interned values **must** be validated before validating their corresponding `query_x` call.
    db.assert_logs(expect![[r#"
        [
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c00)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c00)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c01)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c01)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c02)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c02)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c03)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c03)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c04)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c04)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c05)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c05)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c06)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c06)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c07)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c07)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c08)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c08)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c09)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c09)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(c0a)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(c0a)) })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_a(Id(400)) })",
        ]"#]]);
}