salsa 0.28.0

A generic framework for on-demand, incrementalized computation (experimental)
Documentation
//! Benchmark for fixpoint iteration cycle resolution.
//!
//! This benchmark simulates a (very simplified) version of a real dataflow analysis using fixpoint
//! iteration.
use std::collections::BTreeSet;
use std::iter::IntoIterator;

use salsa::{Database as Db, Setter};

fn main() {
    divan::main();
}

/// A Use of a symbol.
#[salsa::input]
struct Use {
    #[returns(clone)]
    reaching_definitions: Vec<Definition>,
}

/// A Definition of a symbol, either of the form `base + increment` or `0 + increment`.
#[salsa::input]
struct Definition {
    #[returns(copy)]
    base: Option<Use>,
    #[returns(copy)]
    increment: usize,
}

#[derive(Eq, PartialEq, Clone, Debug)]
enum Type {
    Bottom,
    Values(Box<[usize]>),
    Top,
}

impl Type {
    fn join(tys: impl IntoIterator<Item = Type>) -> Type {
        let mut result = Type::Bottom;
        for ty in tys.into_iter() {
            result = match (result, ty) {
                (result, Type::Bottom) => result,
                (_, Type::Top) => Type::Top,
                (Type::Top, _) => Type::Top,
                (Type::Bottom, ty) => ty,
                (Type::Values(a_ints), Type::Values(b_ints)) => {
                    let mut set = BTreeSet::new();
                    set.extend(a_ints);
                    set.extend(b_ints);
                    Type::Values(set.into_iter().collect())
                }
            }
        }
        result
    }
}

#[salsa::tracked(returns(clone), cycle_fn=use_cycle_recover, cycle_initial=use_cycle_initial)]
fn infer_use(db: &dyn Db, u: Use) -> Type {
    let defs = u.reaching_definitions(db);
    match defs[..] {
        [] => Type::Bottom,
        [def] => infer_definition(db, def),
        _ => Type::join(defs.iter().map(|&def| infer_definition(db, def))),
    }
}

#[salsa::tracked(returns(clone), cycle_fn=def_cycle_recover, cycle_initial=def_cycle_initial)]
fn infer_definition(db: &dyn Db, def: Definition) -> Type {
    let increment_ty = Type::Values(Box::from([def.increment(db)]));
    if let Some(base) = def.base(db) {
        let base_ty = infer_use(db, base);
        add(&base_ty, &increment_ty)
    } else {
        increment_ty
    }
}

fn def_cycle_initial(_db: &dyn Db, _id: salsa::Id, _def: Definition) -> Type {
    Type::Bottom
}

fn def_cycle_recover(
    _db: &dyn Db,
    cycle: &salsa::Cycle,
    _last_provisional_value: &Type,
    value: Type,
    _def: Definition,
) -> Type {
    cycle_recover(value, cycle.iteration())
}

fn use_cycle_initial(_db: &dyn Db, _id: salsa::Id, _use: Use) -> Type {
    Type::Bottom
}

fn use_cycle_recover(
    _db: &dyn Db,
    cycle: &salsa::Cycle,
    _last_provisional_value: &Type,
    value: Type,
    _use: Use,
) -> Type {
    cycle_recover(value, cycle.iteration())
}

fn cycle_recover(value: Type, count: u32) -> Type {
    match &value {
        Type::Bottom => value,
        Type::Values(_) => {
            if count > 4 {
                Type::Top
            } else {
                value
            }
        }
        Type::Top => value,
    }
}

fn add(a: &Type, b: &Type) -> Type {
    match (a, b) {
        (Type::Bottom, _) | (_, Type::Bottom) => Type::Bottom,
        (Type::Top, _) | (_, Type::Top) => Type::Top,
        (Type::Values(a_ints), Type::Values(b_ints)) => {
            let mut set = BTreeSet::new();
            set.extend(
                a_ints
                    .into_iter()
                    .flat_map(|a| b_ints.into_iter().map(move |b| a + b)),
            );
            Type::Values(set.into_iter().collect())
        }
    }
}

#[divan::bench(name = "benches::dataflow::converge_diverge")]
fn converge_diverge(bencher: divan::Bencher) {
    bencher
        .with_inputs(|| {
            let mut db = salsa::DatabaseImpl::new();

            let defx0 = Definition::new(&db, None, 0);
            let defy0 = Definition::new(&db, None, 0);
            let defx1 = Definition::new(&db, None, 0);
            let defy1 = Definition::new(&db, None, 0);
            let use_x = Use::new(&db, vec![defx0, defx1]);
            let use_y = Use::new(&db, vec![defy0, defy1]);
            defx1.set_base(&mut db).to(Some(use_y));
            defy1.set_base(&mut db).to(Some(use_x));

            // prewarm cache
            let _ = infer_use(&db, use_x);
            let _ = infer_use(&db, use_y);

            (db, defx1, use_x, use_y)
        })
        .bench_local_refs(|(db, defx1, use_x, use_y)| {
            // Set the increment on x to 0.
            defx1.set_increment(db).to(0);

            // Both symbols converge on 0.
            assert_eq!(infer_use(db, *use_x), Type::Values(Box::from([0])));
            assert_eq!(infer_use(db, *use_y), Type::Values(Box::from([0])));

            // Set the increment on x to 1.
            defx1.set_increment(db).to(1);

            // Now the loop diverges and we fall back to Top.
            assert_eq!(infer_use(db, *use_x), Type::Top);
            assert_eq!(infer_use(db, *use_y), Type::Top);
        });
}

/// Emulates a data flow problem of the form:
/// ```py
/// self.x0 = self.x1 + self.x2 + self.x3 + self.x4
/// self.x1 = self.x0 + self.x2 + self.x3 + self.x4
/// self.x2 = self.x0 + self.x1 + self.x3 + self.x4
/// self.x3 = self.x0 + self.x1 + self.x2 + self.x4
/// self.x4 = 0
/// ```
#[divan::bench(name = "benches::nested::converge_diverge_nested")]
fn converge_diverge_nested(bencher: divan::Bencher) {
    bencher
        .with_inputs(|| {
            let mut db = salsa::DatabaseImpl::new();

            let def_x0 = Definition::new(&db, None, 0);
            let def_x1 = Definition::new(&db, None, 0);
            let def_x2 = Definition::new(&db, None, 0);
            let def_x3 = Definition::new(&db, None, 0);
            let def_x4 = Definition::new(&db, None, 0);

            let use_x0 = Use::new(&db, vec![def_x1, def_x2, def_x3, def_x4]);
            let use_x1 = Use::new(&db, vec![def_x0, def_x2, def_x3, def_x4]);
            let use_x2 = Use::new(&db, vec![def_x0, def_x1, def_x3, def_x4]);
            let use_x3 = Use::new(&db, vec![def_x0, def_x1, def_x3, def_x4]);

            def_x0.set_base(&mut db).to(Some(use_x0));
            def_x1.set_base(&mut db).to(Some(use_x1));
            def_x2.set_base(&mut db).to(Some(use_x2));
            def_x3.set_base(&mut db).to(Some(use_x3));

            (db, def_x0)
        })
        .bench_local_refs(|(db, def_x0)| {
            // All symbols converge on 0.
            assert_eq!(infer_definition(db, *def_x0), Type::Values(Box::from([0])));
        });
}