https://github.com/lbfalvy/bound
encapsulate the act of deriving a struct from a reference
https://github.com/lbfalvy/bound
crate memory-management rust rust-patterns
Last synced: about 1 month ago
JSON representation
encapsulate the act of deriving a struct from a reference
- Host: GitHub
- URL: https://github.com/lbfalvy/bound
- Owner: lbfalvy
- Created: 2022-10-11T16:00:32.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-02-14T18:14:36.000Z (12 months ago)
- Last Synced: 2025-10-22T20:46:52.400Z (4 months ago)
- Topics: crate, memory-management, rust, rust-patterns
- Language: Rust
- Homepage: https://crates.io/crates/bound
- Size: 18.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bound
A minimal crate to encapsulate the act of deriving a struct from a reference. Notably useful
for wrapping `LockGuard` instances obtained from `Arc>` for example, but essentially
works with anything that has a similar relation as the LockGuard does to the RwLock.
## Usage
This and all other examples are also available on [https:://docs.rs/bound][docs]
```rs
use std::sync::{Arc, RwLock};
use bound::Bound;
let shared = Arc::new(RwLock::new(1));
let mut writer = Bound::try_new(shared.clone(), |a| a.write()).expect("Failed to lock");
*writer = 2;
// writer now has the following type
type Writer = Bound, Arc>>
```
You can now safely pass `writer` around and put it in structs, something you couldn't do with an
`RwLockWriteGuard` by default because it's derived from the local reference to its lock.
## 1.0?
1.0 means robust, verified and ready for production use. This package is as robust as I can make
it, but it uses unsafe code, so I'd like at least 5 experienced Rust developers to approve of it.
If you're comfortable with unsafe code and you believe the code to be secure, please send me an
email.
As always, if you found a way to break it please open an issue with a reproducible example.
Authoritative Approvals: 1
[docs]: https://docs.rs/bound/0.2.1/bound/struct.Bound.html