Expand description
§Behavior Oriented Concurrency in Rust
For an introduction to the Behavior Oriented Concurrency model, see the OOPSLA 2023 Paper. This library aims to provide idiomatic Rust bindings to the Verona runtime, as introduced in that paper.
let string = Cown::new(String::new());
let vec = Cown::new(Vec::<i32>::new());
when(&string, |mut s| {
assert_eq!(&*s, "");
s.push_str("foo");
});
when(&vec, |mut v| {
assert_eq!(&*v, &[]);
v.push(101);
});
when((&string, &vec), |(mut s, mut v)| {
assert_eq!(&*s, "foo");
assert_eq!(&*v, &[101]);
s.push_str("bar");
v.push(666);
});
when(&string, |s| assert_eq!(&*s, "foobar"));
when(&vec, |v| assert_eq!(&*v, &[101, 666]));§Current Status
This is a research project. It is not ready for use outside of research.
§Restrictions:
Note: This list in non-exhaustive. If you do anything weird, you may well get a crash deep inside the gut of verona-rt. That’s not to say you shouldn’t, just a warning about how robust this is at the moment. In fact, if you do discover something not listed here, please let me know.
-
Don’t leak threads: When the main thread finishes, all other threads shut down. If you’ve accessed verona-rt resources in other threads, you’ll have a bad time.
-
Run everything inside a schedular: Use
with_schedulerto set up and tear down the global schedular state. -
Don’t panic: If you panic with the schedular, arbitrarily bad things happen.
-
Don’t make a load of schedulers: Everything should run with the same schedular. If you call `with_scheduler`` on a load of thread, your going to have a bad day (unless you like debugging non-reproducible segfaults :)).
-
Run thread local destructors: (Especially if using the leak-dececor), if you don’t ensure that
thread_localdestructors are run, you’ll end up with racy false-positives.Notably
std::thread::scope, doesn’t guarantee to run them if you don’t call.join()on the handles. Thanks to Mara Bos for pointing this out to me.
Structs§
- Acquired
Cown - Cown
- A piece of concurrently owned data.