app-json-settings 2.2.0

Tiny typed JSON settings persistence for Rust applications.
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

# Quick start

Add the crate and Serde derive support:

```toml
[dependencies]
serde = { version = "1", features = ["derive"] }
app-json-settings = "2"
```

Define a settings type:

```rust
#[derive(serde::Deserialize, serde::Serialize, Default)]
struct Settings {
    volume: u32,
    dark_mode: bool,
}
```

Load defaults on first run:

```rust
use app_json_settings::ConfigManager;

fn load_settings() -> app_json_settings::Result<Settings> {
    ConfigManager::<Settings>::for_app("my-app")?.load_or_default()
}
```

Update part of the settings value:

```rust
fn enable_dark_mode() -> app_json_settings::Result<()> {
    ConfigManager::<Settings>::for_app("my-app")?.update(|settings| {
        settings.dark_mode = true;
    })?;

    Ok(())
}
```

For tests, portable mode, and sandboxed hosts, pass an explicit root directory:

```rust
let manager = ConfigManager::<Settings>::new()
    .with_root_dir("./portable-config")
    .try_with_filename("settings.json")?;
```