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

//---------------------------------------------------------------------------------------------------- Use
use anyhow::{anyhow,bail,ensure};
use std::path::PathBuf;
use crate::common;

//---------------------------------------------------------------------------------------------------- Ron
crate::common::impl_macro!(Ron, "ron");

/// [`RON`](https://docs.rs/ron) file format
///
/// The encoding options used is:
/// ```rust
/// ron::ser::PrettyConfig::new();
/// ```
///
/// File extension is `.ron`.
///
/// ## Safety
/// When manually implementing, you are **promising** that the `PATH`'s manually specified are correct.
pub unsafe trait Ron: serde::Serialize + serde::de::DeserializeOwned {
	// Common functions.
	common::impl_string!("ron");

	// Required functions for generic-ness.
	#[inline(always)]
	/// Convert a `struct/enum` to bytes.
	///
	/// This uses [`ron::ser::to_writer_pretty`];
	fn to_bytes(&self) -> Result<Vec<u8>, anyhow::Error> {
		let mut vec = vec![];
		ron::ser::to_writer_pretty(&mut vec, self, ron::ser::PrettyConfig::new())?;
		Ok(vec)
	}
	#[inline(always)]
	/// Create a `struct/enum` from bytes.
	fn from_bytes(bytes: &[u8]) -> Result<Self, anyhow::Error> {
		common::convert_error(ron::de::from_bytes(bytes))
	}

	// JSON operations.
	#[inline(always)]
	/// Convert a `struct/enum` to a [`String`].
	///
	/// This uses [`ron::ser::to_string_pretty`];
	fn to_string(&self) -> Result<String, anyhow::Error> {
		common::convert_error(ron::ser::to_string_pretty(self, ron::ser::PrettyConfig::new()))
	}
	#[inline(always)]
	/// Create a `struct/enum` from a [`String`].
	fn from_string(string: &str) -> Result<Self, anyhow::Error> {
		common::convert_error(ron::de::from_str(string))
	}
}

//---------------------------------------------------------------------------------------------------- TESTS
//#[cfg(test)]
//mod tests {
//}