benri 0.1.12

Convenient macros wrapping the standard library
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

//---------------------------------------------------------------------------------------------------- Panic
#[macro_export]
/// Terminate _all_ threads.
///
/// If the `log` feature flag is enabled, this emits a
/// message with [`log::error`] before exiting.
macro_rules! mass_panic {
	// Single argument.
	($tts:tt) => {{
		// Log.
		#[cfg(feature = "log")]
		{
			::log::error!("----- MASS PANIC: {} @ {} -----", file!(), line!());
			::log::error!("{}", $tts);
			::log::error!("----- EXITING ALL THREADS -----");
		}
		#[cfg(not(feature = "log"))]
		{
			::std::eprintln!("----- MASS PANIC: {} @ {} -----", file!(), line!());
			::std::eprintln!("{}", $tts);
			::std::eprintln!("----- EXITING ALL THREADS -----");
		}

		// Exit all threads.
		::std::process::exit(111)
	}};

	// Multiple arguments.
	($($tts:tt)*) => {{
		#[cfg(feature = "log")]
		{
			::log::error!("----- MASS PANIC: {} @ {} -----", file!(), line!());
			::log::error!("{}", ::std::format_args!($($tts)*));
			::log::error!("----- EXITING ALL THREADS -----");
		}
		#[cfg(not(feature = "log"))]
		{
			::std::eprintln!("----- MASS PANIC: {} @ {} -----", file!(), line!());
			::std::eprintln!("{}", ::std::format_args!($($tts)*));
			::std::eprintln!("----- EXITING ALL THREADS -----");
		}
		::std::process::exit(111)
	}}
}
pub use mass_panic;

#[macro_export]
/// `match` a [`Result`], [`mass_panic!`] on [`Result::Err`]
macro_rules! unwrap_or_mass {
	($var:expr) => {
		match $var {
			::std::result::Result::Ok(o)  => o,
			::std::result::Result::Err(e) => $crate::panic::mass_panic!(e),
		}
	}
}
pub use unwrap_or_mass;

#[macro_export]
/// `panic!()`, but only in debug mode.
macro_rules! debug_panic {
	($tts:tt) => {
		if ::std::cfg!(debug_assertions) {
			::std::panic!("{}", ::std::format_args!($tts));
		}
	};

	($($tts:tt)*) => {
		if ::std::cfg!(debug_assertions) {
			::std::panic!("{}", ::std::format_args!($($tts)*));
		}
	};
}