2 releases

0.1.1 Sep 23, 2024
0.1.0 Sep 23, 2024

#191 in Procedural macros

Download history 1925/week @ 2024-09-20 6586/week @ 2024-09-27 6823/week @ 2024-10-04 4368/week @ 2024-10-11 3436/week @ 2024-10-18 3765/week @ 2024-10-25 3726/week @ 2024-11-01

15,812 downloads per month

MIT/Apache

31KB
636 lines

assert_type_match

Crates.io Docs License

A niche utility macro to statically assert that a type matches another type.

Purpose

The primary purpose of this crate is to make copying and pasting types from other crates into your own more future-proof by statically asserting that the types match.

This situation happens sometimes when you want to add your own methods or documentation on a foreign type.

By using this crate, you can ensure that changes made upstream will be caught by the compiler, so you can update your code accordingly.

Usage

// Pretend this type comes from a foreign crate:
mod foreign_crate {
    pub enum ColorSpace {
        Rgb,
        Rgba,
        Cmyk,
    }
}

mod my_crate {
    use assert_type_match::assert_type_match;

    // We can add our own trait implementations and documentation:
    #[derive(Default)]
    #[assert_type_match(foreign_crate::ColorSpace)]
    pub enum ColorSpace {
        #[default]
        Rgb,
        Rgba,
        Cmyk,
    }
}

If foreign_crate::ColorSpace ever changes, the compiler will catch it.

For example, if foreign_crate::ColorSpace adds a new variant Hsla, we'll get the following error:

error[E0004]: non-exhaustive patterns: `foreign_crate::ColorSpace::Hsla` not covered

Configuration

The behavior of the macro can be configured.

One common pattern is implementing From to convert between the types. This can be automatically generated by setting the from attribute:

#[assert_type_match(foreign_crate::ColorSpace, from)]
pub enum ColorSpace {
    Rgb,
    Rgba,
    Cmyk,
}

let my_space: my_crate::ColorSpace = my_crate::ColorSpace::Rgb;
// Convert to the foreign type:
let foreign_space: foreign_crate::ColorSpace = my_space.into();
// And back again:
let my_space: my_crate::ColorSpace = foreign_space.into();

There are other attributes available, such as test_only and skip_name, as well as attributes to control the behavior of specific fields and variants.

See the docs for more information.

Dependencies

~255–710KB
~17K SLoC