salsa 0.26.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

#![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>(db: &'db dyn salsa::Database) -> Interned<'db> {
    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>(db: &'db dyn Database) -> Interned<'db> {
    let interned = query_a(db);
    query_x(db, interned);
    interned
}

#[salsa::tracked]
fn query_x<'db>(_db: &'db dyn Database, _i: Interned<'db>) {}

fn cycle_initial(db: &dyn Database, _id: Id) -> Interned<'_> {
    Interned::new(db, 0)
}

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

#[test_log::test]
fn the_test() {
    let mut db = ExecuteValidateLoggerDatabase::default();

    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: query_b::interned_arguments(Id(400)), revision: R2 })",
            "salsa_event(DidValidateInternedValue { key: query_a::interned_arguments(Id(0)), revision: R2 })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(800)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(800)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(801)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(801)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(802)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(802)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(803)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(803)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(804)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(804)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(805)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(805)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(806)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(806)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(807)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(807)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(808)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(808)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(809)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(809)) })",
            "salsa_event(DidValidateInternedValue { key: Interned(Id(80a)), revision: R2 })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_x(Id(80a)) })",
            "salsa_event(DidValidateMemoizedValue { database_key: query_a(Id(0)) })",
        ]"#]]);
}