diagnosticism 0.4.1

Miscellaneous discrete and simple diagnostics facilities (for Rust)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

macro_rules! declare_and_publish_impl_ {
    ($mod_name:ident; $($construct_name:ident),*; $vis:vis) => {
        mod $mod_name;

        $vis use $mod_name::{ $($construct_name),* };
    };
}

/// Declares a private submodule and re-exports selected items from it.
///
/// Use in a **`mod.rs` barrel file** when a directory contains sibling
/// `.rs` implementation files. Each invocation replaces:
///
/// ```rust,ignore
/// mod margin;
/// pub use margin::margin;
/// ```
///
/// with a single macro call. The first argument is the **module name**
/// (matching `name.rs` or `name/mod.rs`); remaining arguments are **item
/// names** (types, functions, constants) to re-export from that module.
///
/// # Setup
///
/// ```rust,ignore
/// use crate::macros::declare_and_publish;
/// ```
///
/// # Forms
///
/// * `declare_and_publish!(mod_name, Item)` — `pub use` (default);
/// * `declare_and_publish!(pub mod_name, Item)` — `pub use` (explicit);
/// * `declare_and_publish!(crate mod_name, Item)` — `pub(crate) use`;
/// * `declare_and_publish!(super mod_name, Item)` — `pub(super) use`;
/// * `declare_and_publish!(self mod_name, Item)` — `pub(self) use`;
/// * `declare_and_publish!(priv mod_name, Item)` — `pub(self) use`
///   (synonym);
/// * `declare_and_publish!($vis mod_name, Item)` — any Rust visibility
///   (e.g. `pub(crate)`, `pub(in crate::api)`).
///
/// Multiple items may be re-exported from one module:
///
/// ```rust,ignore
/// declare_and_publish!(doomgram, DoomGram, doom_scope);
/// ```
///
/// A parent module (including **`lib.rs`**) may aggregate a child barrel:
///
/// ```rust,ignore
/// declare_and_publish!(
///     api,
///     evaluate_scalar_eq_approx,
///     margin,
/// );
/// ```
///
/// # Examples
///
/// Public API surface:
///
/// ```rust,ignore
/// declare_and_publish!(password, Password);
/// declare_and_publish!(
///     time_format,
///     NanosecondsStr,
///     nanoseconds_to_string,
/// );
/// ```
///
/// Crate-internal wiring:
///
/// ```rust,ignore
/// declare_and_publish!(crate compare, compare_foo, compare_bar);
/// ```
///
/// Submodules that need no re-export remain ordinary private declarations:
///
/// ```rust,ignore
/// mod flf;
/// ```
macro_rules! declare_and_publish {
    (crate $mod_name:ident $(, $construct_name:ident)* $(,)?) => {
        $crate::macros::declare_and_publish_impl_!($mod_name; $($construct_name),*; pub(crate));
    };
    (pub $mod_name:ident $(, $construct_name:ident)* $(,)?) => {
        $crate::macros::declare_and_publish_impl_!($mod_name; $($construct_name),*; pub);
    };
    (priv $mod_name:ident $(, $construct_name:ident)* $(,)?) => {
        $crate::macros::declare_and_publish_impl_!($mod_name; $($construct_name),*; pub(self));
    };
    (self $mod_name:ident $(, $construct_name:ident)* $(,)?) => {
        $crate::macros::declare_and_publish_impl_!($mod_name; $($construct_name),*; pub(self));
    };
    (super $mod_name:ident $(, $construct_name:ident)* $(,)?) => {
        $crate::macros::declare_and_publish_impl_!($mod_name; $($construct_name),*; pub(super));
    };
    ($mod_name:ident $(, $construct_name:ident)* $(,)?) => {
        $crate::macros::declare_and_publish_impl_!($mod_name; $($construct_name),*; pub);
    };
    ($vis:vis $mod_name:ident $(, $construct_name:ident)* $(,)?) => {
        $crate::macros::declare_and_publish_impl_!($mod_name; $($construct_name),*; $vis);
    };
}

pub(crate) use declare_and_publish;
pub(crate) use declare_and_publish_impl_;


// ///////////////////////////// end of file //////////////////////////// //