macro-v

此crate提供了一种属性宏，用于使macro_rules!宏的可见性与其他项相同。

声明宏的可见性与Rust中其他项目的行为不一致，这需要使用#[macro_use]和#[macro_export]而不是pub或pub(...)，这些不一致性使得心理负担和认知成本很大。现在有了这个crate，你可以使用#[macro_v]或#[macro_v(pub)]或#[macro_v(pub(...))]在任何macro_rules!宏上，使声明宏具有与其他项目相同的可见性，不再需要编写令人困惑的#[macro_use]和#[macro_export]。

灵感

受到macro-vis的启发，甚至以它的一部分命名，但macro-vis存在两个问题。

1. 你需要添加#![allow(uncommon_codepoints)]。

2. 修改后的宏在文档中显示为函数而不是宏。

为了解决这两个问题，我重新实现了一个属性宏。

它的工作原理

非常简单，请看代码

#[macro_v(pub(crate))]
macro_rules! example_macro { () => {}; }

... 将扩展为这个

#[doc(hidden)]
macro_rules! __example_macro_2228885075611141983 { () => {}; }

#[doc(inline)]
pub(crate) use __example_macro_2228885075611141983 as example_macro;

如果你使用#[macro_v(pub)]，那么扩展后的代码将添加#[macro_export]

#[doc(hidden)]
#[macro_export]
macro_rules! __example_macro_2228885075611141983 { () => {}; }

#[doc(inline)]
pub use __example_macro_2228885075611141983 as example_macro;