This crate provides an attribute macro for making the visibility of the macro_rules! macro the same as other items.
The visibility of declarative macros is not consistent with the behavior of other items in rust, necessitating the use of #[macro_use] and #[macro_export] instead of pub or pub(...), such inconsistencies make the mental burden and cognitive cost significant. Now with this crate, you are allowed to use #[macro_v] or #[macro_v(pub)] or #[macro_v(pub(...))] on any macro_rules! macro, giving declarative macros the same visibility as other items, no more writing confusing #[macro_use] and #[macro_export].
Inspired by macro-vis and even named after a part of it, but there are two problems of macro-vis:
you have to add #![allow(uncommon_codepoints)].
the modified macro is shown in the documentation as a function instead of a macro.
To solve these two problems, I've reimplemented an attribute macro.
It's very simple, see the code:
```rust
macrorules! examplemacro { () => {}; } ```
... will expand to this:
```rust
macrorules! _examplemacro2228885075611141983 { () => {}; }
pub(crate) use _examplemacro2228885075611141983 as examplemacro; ```
If you are using #[macro_v(pub)], then the expanded code will then have #[macro_export] added to it:
```rust
macrorules! _examplemacro2228885075611141983 { () => {}; }
pub use _examplemacro2228885075611141983 as examplemacro; ```
But because of using #[doc(hidden)], you must use #[doc(inline)] attribute when re-exporting, otherwise re-exported macro won't be visible in the document. When using #[macro_v], #[doc(inline)] will be added automatically, but if you want to re-export manually, you must remember to add #[doc(inline)], which is the only problem.