dias 0.2.0

Minimal cross-platform support for common platform specific things, intended for small games for web plus desktopy platforms.
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

//! Config file loading and saving.
//!
//! - Standard: uses TOML.
//! - Web: uses JSON.
//!
//! ```rust
//! use std::io::Cursor;
//! use serde::{Deserialize, Serialize};
//! use dias::config::{read_config, write_config};
//!
//! #[derive(Serialize, Deserialize)]
//! pub struct TestConfig {
//!     pub foo: i32,
//!     pub bar: String,
//! }
//! let config = TestConfig {
//!     foo: 12345,
//!     bar: "hello world".to_string(),
//! };
//! let mut buf = Cursor::new(Vec::new()); // probably you want a real file instead
//! write_config(&config, &mut buf).unwrap();
//! buf.set_position(0);
//! let _: TestConfig = read_config(&mut buf).unwrap();
//! ```

mod generic;

#[cfg(not(target_arch = "wasm32"))]
mod standard;
#[cfg(target_arch = "wasm32")]
mod web;

use serde::{Deserialize, Serialize};
use std::io::{Read, Write};

use generic::ConfigStringHandler as _;
#[cfg(not(target_arch = "wasm32"))]
use standard::ConfigStringHandler;
#[cfg(target_arch = "wasm32")]
use web::ConfigStringHandler;

pub fn write_config<T, W>(config: &T, write: &mut W) -> std::io::Result<()>
where
    T: Serialize,
    W: Write,
{
    let out = ConfigStringHandler::to_string(&config).map_err(std::io::Error::other)?;
    write!(write, "{}", out)?;
    Ok(())
}

pub fn read_config<T, R>(read: &mut R) -> std::io::Result<T>
where
    T: for<'a> Deserialize<'a>,
    R: Read,
{
    let input = std::io::read_to_string(read)?;
    let config = ConfigStringHandler::from_str(&input).map_err(std::io::Error::other)?;
    Ok(config)
}

#[cfg(feature = "storage")]
pub fn write_config_file<T>(
    config: &T,
    file: &mut impl crate::storage::WritableFile,
) -> std::io::Result<()>
where
    T: Serialize,
{
    write_config(config, &mut file.write_text()?)
}

#[cfg(feature = "storage")]
pub fn read_config_file<T>(file: &impl crate::storage::File) -> std::io::Result<T>
where
    T: for<'a> Deserialize<'a>,
{
    read_config(&mut file.read_text()?)
}