Crate override_macro

This crate provides attribute-like macros to override trait methods with other traits for a structs or another trait.

Install

In Cargo.toml, write this crate as a dependency.

[dependencies]
override_macro = "0.1.0"

Usage

First, by using overridable attribute macro, collects trait informations whose methods override methods of other trait and are overridden with methods of other traits.

The argument of this attribute macro is to specify the module path. This argument is optional but it is better to specify it because the trait name may be conflict to other traits.

use override_macro::overridable;

#[overridable(mod = crate::module::path01)]
trait Trait1 {
    fn method1(&self, b: bool) -> u64;
}

use override_macro::overridable;

#[overridable(mod = crate::module::path02)]
trait Trait2 {
    fn method1(&self, b: bool) -> u64 {
        ...
    }
}

Next, by using override_with attribute macro, adds overridiing methods of the target trait for a struct or a trait.

The arguments of this attribute-macro are paths of traits having overriding methods. This attribute-macro searches for methods with the same sigunature to the methods in the target trait from the traits passed as the arguments, and then adds these method callings to the target trait.

use override_macro::override_with;

struct StructA;
impl Trait02 for StructA {}

#[override_with(crate::module::path02::Trait2)]
impl Trait01 for StructA {}

Attribute Macros

overridable

Collects trait informations whose methods can override other trait methods, or can be overriden with other trait methods.

override_with

Adds methods overridden methods with methods of other traits to the trait implementation.