mirrors/salsa
1
0
Fork 0
mirror of https://github.com/salsa-rs/salsa.git synced 2025-07-07 21:35:17 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
A generic framework for on-demand, incrementalized computation. Inspired by adapton, glimmer, and rustc's query system.
2059 commits 17 branches 60 tags 15 MiB
Find a file
Ibraheem Ahmed 0414d89327
Replace loom with shuttle (#876) 
* replace loom with shuttle

* inline `empty_cycle_heads`

* ignore failing shuttle test
2025-05-23 15:28:51 +00:00
.devcontainer devcontainer definition 2024-07-28 10:16:36 +00:00
.github Replace loom with shuttle (#876) 2025-05-23 15:28:51 +00:00
benches Changed return_ref syntax to returns(as_ref) and returns(cloned) (#772) 2025-05-09 07:28:54 +00:00
book chore: Remove jar mentions from book (#775) 2025-05-22 09:34:29 +02:00
components Replace loom with shuttle (#876) 2025-05-23 15:28:51 +00:00
examples Changed return_ref syntax to returns(as_ref) and returns(cloned) (#772) 2025-05-09 07:28:54 +00:00
src Replace loom with shuttle (#876) 2025-05-23 15:28:51 +00:00
tests Replace loom with shuttle (#876) 2025-05-23 15:28:51 +00:00
.dir-locals.el ask emacs to rustfmt on save 2018-09-28 11:26:57 -04:00
.gitignore Fix clippy issues 2022-08-24 18:45:53 +02:00
Cargo.toml Replace loom with shuttle (#876) 2025-05-23 15:28:51 +00:00
CHANGELOG.md chore: release v0.22.0 (#840) 2025-05-23 12:38:34 +02:00
FAQ.md Update New Mexico state question 2020-06-26 15:48:29 +01:00
justfile Replace loom with shuttle (#876) 2025-05-23 15:28:51 +00:00
LICENSE-APACHE add readme, license, etc 2018-09-28 11:01:27 -04:00
LICENSE-MIT add readme, license, etc 2018-09-28 11:01:27 -04:00
README.md docs: update release steps (#705) 2025-03-19 15:19:38 +01:00
release-plz.toml chore: Group versions of packages together for releases (#751) 2025-03-09 19:32:06 +01:00
RELEASES.md highlight breaking changes 2019-08-15 08:08:00 -04:00

README.md

salsa

Test Book Released API docs Crates.io

A generic framework for on-demand, incrementalized computation.

Salsa Logo

Obligatory warning

Very much a WORK IN PROGRESS at this point.

Credits

This system is heavily inspired by adapton, glimmer, 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:

Getting in touch

The bulk of the discussion happens in the issues and pull requests, but we have a zulip chat 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.