abpl 0.1.0

A collection of Rust boilerplate: a reloadable-systemd-service lifecycle helper, a hot-reloading axum wrapper, a serializable/typed error derive macro, and small utility newtypes.
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

// `ProvidesExitCode`/`ProvidesHttpStatus` for `std::io::Error` are big lookup tables mapping
// `ErrorKind` -> a constant. Exhaustively asserting every arm here would just be restating the
// same table a second time (identical code, no real coverage value) -- these spot-check a
// representative sample from each category in the match instead.

#[cfg(all(feature = "app", feature = "std"))]
#[test]
fn io_error_exit_code() {
	use super::ProvidesExitCode;

	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::NotFound).exit_code(),
		crate::app::consts::EX_NOINPUT.into()
	);
	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::PermissionDenied).exit_code(),
		crate::app::consts::EX_NOPERM.into()
	);
	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::ConnectionRefused).exit_code(),
		crate::app::consts::EX_UNAVAILABLE.into()
	);
	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::InvalidData).exit_code(),
		crate::app::consts::EX_DATAERR.into()
	);
	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::OutOfMemory).exit_code(),
		crate::app::consts::EX_OSERR.into()
	);
	// Anything not explicitly matched falls back to `EX_IOERR`.
	assert_eq!(
		std::io::Error::other("something unmapped").exit_code(),
		crate::app::consts::EX_IOERR.into()
	);
}

#[cfg(all(feature = "http", feature = "std"))]
#[test]
fn io_error_http_status() {
	use super::ProvidesHttpStatus;

	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::NotFound).http_status(),
		http::StatusCode::NOT_FOUND
	);
	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::TimedOut).http_status(),
		http::StatusCode::SERVICE_UNAVAILABLE
	);
	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::StorageFull).http_status(),
		http::StatusCode::INSUFFICIENT_STORAGE
	);
	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::Unsupported).http_status(),
		http::StatusCode::NOT_IMPLEMENTED
	);
	assert_eq!(
		std::io::Error::from(std::io::ErrorKind::OutOfMemory).http_status(),
		http::StatusCode::INTERNAL_SERVER_ERROR
	);
}