Skip to content

A rust library to hide types inside a diplomatic bag which can be sent between threads freely

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

Skepfyr/DiplomaticBag

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Diplomatic Bag

Crates.io API reference License Rust

Hide !Send and !Sync types inside a DiplomaticBag which can be sent between thread freely.

let one = DiplomaticBag::new(|| Rc::new(RefCell::new(1)));
let two = DiplomaticBag::new(|| Rc::new(RefCell::new(2)));
let three: u8 = std::thread::spawn(|| {
    one.as_ref()
        .zip(two.as_ref())
        .map(|(one, two)| *one.borrow() + *two.borrow())
        .into_inner()
}).join()?;

(I don't know why you'd want to do this ^, but I promise this comes in handy for !Send types not in std, for example, cpal's Stream type.)

How it works

All the operations on values inside DiplomaticBags are sent to a worker thread (the home country 😉). This means the values are only ever read on one thread, allowing the DiplomaticBag to be Send even if the type it contains is not. This model does have some drawbacks, see the docs for more information.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

A rust library to hide types inside a diplomatic bag which can be sent between threads freely

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Packages

No packages published

Languages