#extension #trait #macros #attribute

macro no-std easy-ext

An attribute macro for easily writing extension trait pattern

18 releases (2 stable)

1.0.1 Sep 29, 2022
1.0.0 Aug 24, 2021
0.2.9 Jul 3, 2021
0.2.7 Mar 25, 2021
0.1.4 Mar 10, 2019

#1216 in Rust patterns

Download history 16096/week @ 2023-11-02 13323/week @ 2023-11-09 14713/week @ 2023-11-16 15359/week @ 2023-11-23 12998/week @ 2023-11-30 11651/week @ 2023-12-07 11965/week @ 2023-12-14 12746/week @ 2023-12-21 10486/week @ 2023-12-28 13592/week @ 2024-01-04 14961/week @ 2024-01-11 17508/week @ 2024-01-18 16409/week @ 2024-01-25 15350/week @ 2024-02-01 11075/week @ 2024-02-08 8576/week @ 2024-02-15

55,024 downloads per month
Used in 66 crates (21 directly)

Apache-2.0 OR MIT

90KB
2K SLoC

easy-ext

crates.io docs.rs license rustc build status

An attribute macro for easily writing extension trait pattern.

[dependencies]
easy-ext = "1"

Compiler support: requires rustc 1.31+

Examples

use easy_ext::ext;

#[ext(ResultExt)]
pub impl<T, E> Result<T, E> {
    fn err_into<U>(self) -> Result<T, U>
    where
        E: Into<U>,
    {
        self.map_err(Into::into)
    }
}

Code like this will be generated:

pub trait ResultExt<T, E> {
    fn err_into<U>(self) -> Result<T, U>
    where
        E: Into<U>;
}

impl<T, E> ResultExt<T, E> for Result<T, E> {
    fn err_into<U>(self) -> Result<T, U>
    where
        E: Into<U>,
    {
        self.map_err(Into::into)
    }
}

You can elide the trait name.

use easy_ext::ext;

#[ext]
impl<T, E> Result<T, E> {
    fn err_into<U>(self) -> Result<T, U>
    where
        E: Into<U>,
    {
        self.map_err(Into::into)
    }
}

Note that in this case, #[ext] assigns a random name, so you cannot import/export the generated trait.

Visibility

There are two ways to specify visibility.

Impl-level visibility

The first way is to specify visibility at the impl level. For example:

use easy_ext::ext;

// unnamed
#[ext]
pub impl str {
    fn foo(&self) {}
}

// named
#[ext(StrExt)]
pub impl str {
    fn bar(&self) {}
}

Associated-item-level visibility

Another way is to specify visibility at the associated item level.

For example, if the method is pub then the trait will also be pub:

use easy_ext::ext;

#[ext(ResultExt)] // generate `pub trait ResultExt`
impl<T, E> Result<T, E> {
    pub fn err_into<U>(self) -> Result<T, U>
    where
        E: Into<U>,
    {
        self.map_err(Into::into)
    }
}

This is useful when migrate from an inherent impl to an extension trait.

Note that the visibility of all the associated items in the impl must be identical.

Note that you cannot specify impl-level visibility and associated-item-level visibility at the same time.

Supertraits

If you want the extension trait to be a subtrait of another trait, add Self: SubTrait bound to the where clause.

use easy_ext::ext;

#[ext(Ext)]
impl<T> T
where
    Self: Default,
{
    fn method(&self) {}
}

Supported items

Associated functions (methods)

use easy_ext::ext;

#[ext]
impl<T> T {
    fn method(&self) {}
}

Associated constants

use easy_ext::ext;

#[ext]
impl<T> T {
    const MSG: &'static str = "Hello!";
}

Associated types

use easy_ext::ext;

#[ext]
impl str {
    type Owned = String;

    fn method(&self) -> Self::Owned {
        self.to_owned()
    }
}

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

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.

No runtime deps