#trait #hidden #proc-macro

macro hidden-trait

Proc macro for exposing a trait implementation

3 releases

0.1.2 Dec 11, 2022
0.1.1 Dec 11, 2022
0.1.0 Dec 10, 2022
Download history 22/week @ 2023-07-26 13/week @ 2023-08-02 20/week @ 2023-08-09 28/week @ 2023-08-16 18/week @ 2023-08-23 11/week @ 2023-08-30 38/week @ 2023-09-06 17/week @ 2023-09-13 14/week @ 2023-09-20 25/week @ 2023-09-27 19/week @ 2023-10-04 19/week @ 2023-10-11 71/week @ 2023-10-18 84/week @ 2023-10-25 78/week @ 2023-11-01 50/week @ 2023-11-08

287 downloads per month
Used in 5 crates (via blade-graphics)

MIT license

5KB
66 lines

hidden-trait

Build Status Docs Crates.io

This library is a proc macro to expose a trait implementation.

The case we are trying to solve here: a library exposes some concrete structure for people to use. There can be multiple of them (e.g. Vector2, Vector3, Vector4 in a math library), or maybe it's one per platform (Vulkan vs Metal). Important part is - internally the library would like to have a trait implemented by this public type, but it doesn't want to expose the trait itself because of ergonomic reasons. Hence, "hidden-trait" to rescue.

mod hidden {
    trait Foo {
        fn foo(&self) -> u32;
    }

    pub struct Bar;

    #[hidden_trait::expose]
    impl Foo for Bar {
        fn foo(&self) -> u32 {
            42
        }
    }
}

fn main() {
    let bar = hidden::Bar;
    // calling the trait method as if it's ours
    bar.foo();
}

Dependencies

~1MB
~31K SLoC