9 stable releases

1.5.0 Mar 29, 2023
1.4.2 Jan 18, 2023
1.3.0 Nov 8, 2022
1.1.0 Sep 10, 2021
1.0.0 Aug 27, 2021

#168 in Memory management

Download history 9332/week @ 2024-04-23 9094/week @ 2024-04-30 6800/week @ 2024-05-07 13119/week @ 2024-05-14 9263/week @ 2024-05-21 7762/week @ 2024-05-28 8713/week @ 2024-06-04 8874/week @ 2024-06-11 9488/week @ 2024-06-18 9626/week @ 2024-06-25 8278/week @ 2024-07-02 8797/week @ 2024-07-09 8451/week @ 2024-07-16 9246/week @ 2024-07-23 8947/week @ 2024-07-30 9489/week @ 2024-08-06

37,991 downloads per month
Used in 65 crates (via zenoh-keyexpr)

EPL-2.0 license

20KB
456 lines

This library provides an alternative to ghost-cell which uses concrete types instead of lifetimes for branding.

This allows a more convenient usage, where cells and tokens can be constructed independently, with the same compile-time guarantees as ghost-cell. The trade-off for this arguably more convenient usage and arguably easier to understand branding method is that tokens, while zero-sized if made correctly, must be guaranteed to be constructable only if no other instance exists.

To this end, this crate provides the generate_token macro, which will create a ZST which can only be constructed using TokenTrait::new.


lib.rs:

This library provides an alternative to ghost-cell which uses concrete types instead of lifetimes for branding.

This allows a more convenient usage, where cells and tokens can be constructed independently, with the same compile-time guarantees as ghost-cell. The trade-off for this arguably more convenient usage and arguably easier to understand branding method is that tokens, while zero-sized if made correctly, must be guaranteed to be constructable only if no other instance exists.

To this end, this crate provides the generate_token macro, which will create a ZST which can only be constructed using TokenTrait::aquire, which is generated to guarantee no other token exists before returning the token. This is done by checking a static AtomicBool flag, which is the only runtime cost of these tokens.

Dependencies