Hconfig 2.0.2

Json configuration file manager
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

use std::fmt;
use tinyjson::JsonValue;
use crate::Errors;
use crate::IO::IOwrapper;

#[derive(Debug)]
pub struct HConfig
{
	name: String,
	constructed_fullpath: String,
	wrapper: Box<dyn IOwrapper + 'static>,
}

impl HConfig
{
	/// create a new instance and autoload content
	pub fn new<T: IOwrapper + 'static>(name: String, mut path: String) -> Result<HConfig, Errors>
	{
		if(path.ends_with("/"))
		{
			path.pop();
		}

		let fullpath = format!("{}/{}", path, name);
		let wrapper = T::init(&name, &fullpath)?;

		return Ok(HConfig{
			name,
			constructed_fullpath: fullpath,
			wrapper: Box::new(wrapper),
		});
	}

	/// reload content from the file
	pub fn file_load(&mut self) -> Result<(), Errors>
	{
		return self.wrapper.file_load();
	}

	/// save content into the file
	pub fn file_save(&self) -> Result<(), Errors>
	{
		return self.wrapper.file_save();
	}

	/// Get config extension
	pub fn file_ext<'a>(&self) -> &'a str
	{
		return self.wrapper.file_ext();
	}

	/// get file path
	pub fn file_path(&self) -> &String {
		return &self.wrapper.file_path();
	}

	/// get root node
	pub fn root_get(&self) -> &JsonValue
	{
		return self.wrapper.root_get();
	}

	/// get mutable root node
	pub fn root_get_mut(&mut self) -> &JsonValue
	{
		return self.wrapper.root_get_mut();
	}

	/// get content from a path (use an unsigned int for an array)
	pub fn value_get(&self, path: &str) -> Option<JsonValue>
	{
		return self.wrapper.value_get(path.into());
	}

	/// get content from a path (use an unsigned int for an array), or SET default and return it instead
	pub fn value_get_or_set(&mut self, path: &str, default: impl Into<JsonValue>) -> JsonValue
	{
		return self.wrapper.value_get_or_set(path.into(),default.into());
	}

	/// set content to a path (use an unsigned int for an array)
	pub fn value_get_mut<'a,'b>(&'b mut self, path: impl Into<String>) -> Option<&'a mut JsonValue>
	where 'b: 'a
	{
		return self.wrapper.value_get_mut(path.into());
	}

	/// remove content from a path (use an unsigned int for an array)
	pub fn value_remove(&mut self, path: &str) -> bool
	{
		return self.wrapper.value_remove(path.into());
	}

	/// set content to a path (use an unsigned int for an array)
	pub fn value_set(&mut self, path: &str, newval: impl Into<JsonValue>)
	{
		return self.wrapper.value_set(path.into(),newval.into());
	}
}

impl fmt::Display for HConfig {
	fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result
	{
		return write!(f, "{}", self.wrapper);
	}
}