devela 0.28.0

A development substrate of coherence.
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123

// devela::code::util
//
#![doc = crate::_DOC_CODE_UTIL!()] // public
#![doc = crate::_doc!(modules: crate::code; util)]
#![doc = crate::_doc!(flat:"code")]
#![doc = crate::_doc!(extends: hint)]
//
// # Implementation notes
// Several macros are defined hidden, suffixed with `·`, an publicly re-exported unsuffixed.
// This makes them able to be imported from the root. E.g.: capture_last!, enumset!, set!…
// See: https://github.com/rust-lang/rust/pull/52234#issuecomment-976702997
//
// # Warning regarding macro expansion
// Some attributes (#[doc = …], #[rustfmt::skip], and other tooling-related ones) cause the
// compiler to inspect or expand tokens earlier than normal, before the crate's macro resolution
// graph is fully fixed. At that point, macros that are only introduced indirectly (for example
// via helper macros, exported macros, or re-exports) may not yet be visible, even if they would
// exist after full expansion. Because macro_rules! resolution depends on phase ordering, this
// can lead to "resolution is stuck" errors where the compiler cannot prove which macro applies.
// Defining the macro directly in the crate root avoids this, because it is visible in all phases.
//
// # Documentation for declarative macros
// - [The Little Book of Rust Macros](https://veykril.github.io/tlborm/decl-macros.html)
// - [Macros By Example](https://doc.rust-lang.org/reference/macros-by-example.html)
// - [Specification](https://doc.rust-lang.org/reference/macro-ambiguity.html)

mod _reexport_core;

#[cfg(test)]
mod tests;

mod asserts; // (assertion macros)
mod capture; // capture_[first|last|tail_tuple]!
mod cdbg; // cdbg!
mod r#const; // CONST!
mod debug; // const_warn!, fn_name!
mod deprecate; // deprecate_feature!
mod derive; // macro_apply_alias!, macro_derive_alias!
mod doclink; // doclink!
mod dollar; // macro_dollar!
mod enumset; // enumset!
mod ident; // ident_const_index!
mod impl_trait; // impl_trait!
mod include; // include_from!, mod_from!, mod_path!
mod is; // is!
mod items; // items!, sf!
mod lets; // lets!
mod likely; // likely, unlikely
mod maybe; // maybe!, maybe_slot!
mod methods; // methods_as_fns!
mod read; // read_at!
mod structural; // structural_mods!
mod type_count; // type_count!
mod use_as; // use_as!
mod whilst; // whilst!
mod write; // write_at!

#[cfg(feature = "_unroll")]
mod unroll; // unroll!

structural::structural_mods! { // _mods, _reexports, _crate_internals
    _mods {
        #[doc(inline)]
        pub use super::{
            asserts::{assert_eq_all, assert_approx_eq_all, const_assert, test_size_of},
            capture::{capture_first, capture_last, capture_tail_tuple},
            cdbg::*,
            r#const::CONST,
            debug::{const_warn, fn_name},
            deprecate::deprecate_feature,
            derive::{macro_apply_alias, macro_derive_alias},
            doclink::doclink,
            dollar::macro_dollar,
            enumset::enumset,
            ident::ident_const_index,
            impl_trait::impl_trait,
            include::{include_from, mod_from, mod_path},
            is::is,
            items::{items, sf},
            lets::lets,
            likely::{likely, unlikely},
            maybe::{maybe, maybe_slot},
            methods::methods_as_fns,
            read::read_at,
            structural::structural_mods,
            type_count::type_count,
            use_as::use_as,
            whilst::whilst,
            write::write_at,
        };
        #[cfg(feature = "_unroll")]
        pub use super::unroll::_all::*;
    }
    _reexports {
        pub use super::_reexport_core::*;
        #[doc = crate::_tags!(code procedural_macro)]
        pub use super::derive::{
            macro_apply, macro_derive, macro_derive_with,
        };
        #[doc = crate::_tags!(code procedural_macro)]
        pub use devela_macros::{
            cif, compile, compile_attr, // compile_doc,
            ident_total, ident_total_unique, ident_unique,
            coalesce, field_of,
            paste,
            repeat,
        };
        #[doc = crate::_tags!(construction code niche procedural_macro)]
        pub use devela_macros::enumint;
    }
    _crate_internals {
        pub(crate) use super::{
            doclink::_DOCLINK_CUSTOM_DOMAIN,
        };
    }
    _hidden {
        #[doc(hidden)]
        pub use {
            super::asserts::_hidden::*,
            devela_macros::__macro_derive_helpers,
        };
    }
}