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

use std::fmt::{Debug, Display};
use tinyjson::JsonValue;
use crate::Errors;

pub mod json;

pub trait IOwrapper: Display + Debug + Sync + Send {

	/// init instance and autoload content
	fn init(name: &String, path: &String) -> Result<Self, Errors> where Self: Sized;

	/// reload content from a file (called one time by init if file exist)
	fn file_load(&mut self) -> Result<(), Errors>;

	/// save content into a file
	fn file_save(&self) -> Result<(), Errors>;

	/// Get config extension
	fn file_ext<'a>(&self) -> &'a str;

	/// get file path
	fn file_path(&self) -> &String;


	/// get root node
	fn root_get(&self) -> &JsonValue;

	/// get root node
	fn root_get_mut (&mut self) -> &mut JsonValue;


	/// get content from a path (use an unsigned int for an array)
	fn value_get(&self, path: String) -> Option<JsonValue>;

	/// get content from a path (use an unsigned int for an array), or SET the default value and return it instead
	fn value_get_or_set(&mut self, path: String, default: JsonValue) -> JsonValue;

	/// set content to a path (use an unsigned int for an array)
	fn value_get_mut<'a,'b>(&'b mut self, path: String) -> Option<&'a mut JsonValue>
		where 'b: 'a;
	
	/// remove content from a path (use an unsigned int for an array)
	fn value_remove(&mut self, path: &str) -> bool;

	/// set content to a path (use an unsigned int for an array)
	fn value_set(&mut self, path: String, newval: JsonValue);
}