7 releases (4 breaking)

0.5.0 May 9, 2024
0.4.0 Aug 23, 2023
0.3.0 Aug 21, 2023
0.2.0 Feb 10, 2023
0.1.1 Mar 25, 2022

#189 in Concurrency

Download history 343/week @ 2024-07-19 153/week @ 2024-07-26 145/week @ 2024-08-02 331/week @ 2024-08-09 417/week @ 2024-08-16 197/week @ 2024-08-23 204/week @ 2024-08-30 53/week @ 2024-09-06 31/week @ 2024-09-13 64/week @ 2024-09-20 46/week @ 2024-09-27 54/week @ 2024-10-04 51/week @ 2024-10-11 55/week @ 2024-10-18 27/week @ 2024-10-25 27/week @ 2024-11-01

165 downloads per month

MIT license

60KB
1.5K SLoC

STM

async-stm is an implementation of Software Transactional Memory. It was originally inspired by rust-stm, but does things sligly differently, in a more traditional fashion.

It was also extended in the following ways:

  • Made atomically asynchronous, so STM operations can be used with tokio without blocking a full thread.
  • Added the ability to abort a transaction with an error, which the caller has to handle.
  • The transaction is passed around in a thread-local variable, for a simplified TVar API.
  • Reading a TVar returns an Arc, so cloning can be delayed until we have to modify the result.
  • Added the option to pass in an auxiliary transaction that gets committed or rolled back together with the STM transaction, and can also cause a retry if it detects some conflict of its own. This is a potential way to have a hybrid persistent STM solution.
  • Added some optional queue implementations based on Simon Marlow's book, Parallel and Concurrent Programming in Haskell.

Please look at the tests for example usage.

Prerequisites

Install the following to be be able to build the project:

curl https://sh.rustup.rs -sSf | sh
rustup toolchain install nightly
rustup default stable
rustup update

Benchmarks

There are benchmarks included to help compare the tradeoffs between the different queue implementations.

cargo +nightly bench "bench" --all-features

See more

License

This project is licensed under the MIT license.

Dependencies

~2.4–8MB
~58K SLoC