## Obligatory warning
Very much a WORK IN PROGRESS at this point.
## Credits
This system is heavily inspired by [adapton](http://adapton.org/), [glimmer](https://github.com/glimmerjs/glimmer-vm), and rustc's query
system. So credit goes to Eduard-Mihai Burtescu, Matthew Hammer,
Yehuda Katz, and Michael Woerister.
## Key idea
The key idea of `salsa` is that you define your program as a set of
**queries**. Every query is used like function `K -> V` that maps from
some key of type `K` to a value of type `V`. Queries come in two basic
varieties:
- **Inputs**: the base inputs to your system. You can change these
whenever you like.
- **Functions**: pure functions (no side effects) that transform your
inputs into other values. The results of queries are memoized to
avoid recomputing them a lot. When you make changes to the inputs,
we'll figure out (fairly intelligently) when we can re-use these
memoized values and when we have to recompute them.
## Want to learn more?
To learn more about Salsa, try one of the following:
- read the [heavily commented examples](https://github.com/salsa-rs/salsa/tree/master/examples);
- check out the [Salsa book](https://salsa-rs.github.io/salsa);
- [ä¸æ–‡ç‰ˆ](https://rust-chinese-translation.github.io/salsa-book)
- watch one of our [videos](https://salsa-rs.github.io/salsa/videos.html).
## Getting in touch
The bulk of the discussion happens in the [issues](https://github.com/salsa-rs/salsa/issues)
and [pull requests](https://github.com/salsa-rs/salsa/pulls),
but we have a [zulip chat](https://salsa.zulipchat.com/) as well.
## Contributing
To create a release and publish to crates.io, update the `version` field in Cargo.toml.
After pushed, GitHub Actions will publish the crates to crates.io automatically.
salsa-0.23.0/RELEASES.md 0000644 0000000 0000000 00000001213 10461020230 0012533 0 ustar 0000000 0000000 # 0.13.0
- **Breaking change:** adopt the new `Durability` API proposed in [RFC #6]
- this replaces and generalizes the existing concepts of constants
- **Breaking change:** remove "volatile" queries
- instead, create a normal query which invokes the
`report_untracked_read` method on the salsa runtime
- introduce "slots", an optimization to salsa's internal workings
- document `#[salsa::requires]` attribute, which permits private dependencies
- Adopt `AtomicU64` for `runtimeId` (#182)
- use `ptr::eq` and `ptr::hash` for readability
- upgrade parking lot, rand dependencies
[RFC #6]: https://github.com/salsa-rs/salsa-rfcs/pull/6
salsa-0.23.0/benches/accumulator.rs 0000644 0000000 0000000 00000003672 10461020230 0015315 0 ustar 0000000 0000000 use std::hint::black_box;
use codspeed_criterion_compat::{criterion_group, criterion_main, BatchSize, Criterion};
use salsa::Accumulator;
include!("shims/global_alloc_overwrite.rs");
#[salsa::input]
struct Input {
expressions: usize,
}
#[allow(dead_code)]
#[salsa::accumulator]
struct Diagnostic(String);
#[salsa::interned]
struct Expression<'db> {
number: usize,
}
#[salsa::tracked]
#[inline(never)]
fn root<'db>(db: &'db dyn salsa::Database, input: Input) -> Vec