slazy 0.1.0

A simple, small, no-std, macro-based lazy static library 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

#![no_std]
#![doc = include_str!("../README.md")]

/// The macro to create a lazy static.
///
/// # Usage
///
/// ```
/// use slazy::slazy;
///
/// slazy! {
///     pub public_var: String = String::from("Hello, world!");
///     non_public_example: u32 = 42;
/// }
/// ```
#[macro_export]
macro_rules! slazy {
    (pub $name:ident: $type:ty = $val:expr; $($rest:tt)*) => {
        pub struct $name;
        $crate::__internal_inner_slazy!($name, $type, $val);
        slazy!($($rest)*);
    };
    ($name:ident: $type:ty = $val:expr; $($rest:tt)*) => {
        struct $name;
        $crate::__internal_inner_slazy!($name, $type, $val);
        slazy!($($rest)*);
    };
    (pub $name:ident: $type:ty = $val:expr) => {
        pub struct $name;
        $crate::__internal_inner_slazy!($name, $type, $val);
    };
    ($name:ident: $type:ty = $val:expr) => {
        struct $name;
        $crate::__internal_inner_slazy!($name, $type, $val);
    };
	() => {};
}

#[macro_export]
#[doc(hidden)]
macro_rules! __internal_inner_slazy {
	($name:ident, $type:ty, $val:expr) => {
		impl ::core::ops::Deref for $name {
			type Target = $type;

			#[inline(always)]
			fn deref(&self) -> &'static Self::Target {
				static mut VAL: Option<$type> = None;
				unsafe { VAL.get_or_insert_with(|| $val) }
			}
		}
	};
}

/// This macro is used to initialize lazy statics, which
/// is required for them to be safe in multithreaded environments.
///
/// Equivalent to `_ = *(your lazy static);`;
#[macro_export]
macro_rules! init {
	($($lazy:ident)*) => {
		$(
			_ = *$lazy;
		)*
	};
}