abpl 0.1.3

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
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

use std::path::PathBuf;

use super::{ParseTomlFileErrorKind, parse_external_toml_file, parse_toml_file};

#[derive(Debug, serde::Deserialize, PartialEq)]
struct Sample {
	name: String,
	count: u32,
}

#[test]
fn path_not_specified_when_none_given() {
	let err = parse_toml_file::<Sample, PathBuf>(None).unwrap_err();
	assert!(matches!(err.kind(), ParseTomlFileErrorKind::PathNotSpecified));
}

#[test]
fn io_error_when_the_path_does_not_exist() {
	let dir = tempfile::tempdir().unwrap();
	let missing = dir.path().join("does-not-exist.toml");
	let err = parse_toml_file::<Sample, _>(Some(missing.clone())).unwrap_err();
	assert!(matches!(err.kind(), ParseTomlFileErrorKind::Io { path } if *path == missing));
}

#[test]
fn invalid_utf8_when_file_contents_are_not_utf8() {
	let dir = tempfile::tempdir().unwrap();
	let path = dir.path().join("bad-utf8.toml");
	std::fs::write(&path, [0xFF, 0xFE, 0xFD]).unwrap();
	let err = parse_toml_file::<Sample, _>(Some(path.clone())).unwrap_err();
	assert!(matches!(err.kind(), ParseTomlFileErrorKind::InvalidUtf8 { path: p } if *p == path));
}

#[test]
fn invalid_schema_when_toml_does_not_match_the_target_type() {
	let dir = tempfile::tempdir().unwrap();
	let path = dir.path().join("bad-schema.toml");
	// Missing the required `name` field.
	std::fs::write(&path, "count = 3\n").unwrap();
	let err = parse_toml_file::<Sample, _>(Some(path.clone())).unwrap_err();
	assert!(matches!(err.kind(), ParseTomlFileErrorKind::InvalidSchema { path: p } if *p == path));
}

#[test]
fn parses_successfully_when_everything_lines_up() {
	let dir = tempfile::tempdir().unwrap();
	let path = dir.path().join("good.toml");
	std::fs::write(&path, "name = \"abc\"\ncount = 3\n").unwrap();
	let parsed: Sample = parse_toml_file(Some(path)).unwrap();
	assert_eq!(
		parsed,
		Sample {
			name: "abc".to_string(),
			count: 3
		}
	);
}

#[derive(Debug, serde::Deserialize)]
struct Wrapper {
	#[serde(deserialize_with = "parse_external_toml_file")]
	secrets: Sample,
}

#[test]
fn external_toml_file_accepts_an_inline_value() {
	let wrapper: Wrapper = toml::from_str("[secrets]\nname = \"inline\"\ncount = 1\n").unwrap();
	assert_eq!(wrapper.secrets.name, "inline");
	assert_eq!(wrapper.secrets.count, 1);
}

#[test]
fn external_toml_file_follows_a_path_to_another_file() {
	let dir = tempfile::tempdir().unwrap();
	let secrets_path = dir.path().join("secrets.toml");
	std::fs::write(&secrets_path, "name = \"external\"\ncount = 2\n").unwrap();

	let document = format!("secrets = {:?}\n", secrets_path.display().to_string());
	let wrapper: Wrapper = toml::from_str(&document).unwrap();
	assert_eq!(wrapper.secrets.name, "external");
	assert_eq!(wrapper.secrets.count, 2);
}

#[test]
fn external_toml_file_reports_a_missing_referenced_file() {
	let dir = tempfile::tempdir().unwrap();
	let missing = dir.path().join("does-not-exist.toml");
	let document = format!("secrets = {:?}\n", missing.display().to_string());
	let err = toml::from_str::<Wrapper>(&document).unwrap_err();
	// The io error's own message (path + reason) surfaces directly in the custom serde error.
	assert!(
		err.to_string().contains(&missing.display().to_string()) || err.to_string().to_lowercase().contains("os error")
	);
}

#[test]
fn external_toml_file_reports_invalid_utf8_in_the_referenced_file() {
	let dir = tempfile::tempdir().unwrap();
	let secrets_path = dir.path().join("bad-utf8.toml");
	std::fs::write(&secrets_path, [0xFF, 0xFE, 0xFD]).unwrap();
	let document = format!("secrets = {:?}\n", secrets_path.display().to_string());
	let err = toml::from_str::<Wrapper>(&document).unwrap_err();
	assert!(err.to_string().contains("file referenced has"));
}

#[test]
fn external_toml_file_reports_an_invalid_schema_in_the_referenced_file() {
	let dir = tempfile::tempdir().unwrap();
	let secrets_path = dir.path().join("bad-schema.toml");
	// Missing the required `name` field.
	std::fs::write(&secrets_path, "count = 3\n").unwrap();
	let document = format!("secrets = {:?}\n", secrets_path.display().to_string());
	let err = toml::from_str::<Wrapper>(&document).unwrap_err();
	assert!(err.to_string().to_lowercase().contains("missing field"));
}