bevy_mod_config 0.7.1

A Bevy plugin for configuration management
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
107
108
109
110
111
112
113
114
115

use bevy_mod_config::{AppExt, Config, ReadConfig};

#[derive(Config)]
struct Settings {
    #[config(default = 3)]
    thickness: i32,
    color:     Color,
}

#[derive(Config)]
#[config(expose(read))]
enum Color {
    White,
    Rgb(f32, f32, f32),
    Rgba(Rgba),
    Named { code: String },
}

#[derive(Config)]
struct Rgba(f32, f32, f32, f32);

#[cfg(feature = "serde_json")]
type ManagerType =
    (bevy_mod_config::manager::serde::Json, bevy_mod_config::manager::serde::json::Pretty);
#[cfg(not(feature = "serde_json"))]
type ManagerType = ();

#[cfg(feature = "serde_json")]
fn manager_type_default() -> ManagerType {
    (
        bevy_mod_config::manager::serde::Json::new(),
        bevy_mod_config::manager::serde::json::Pretty::default(),
    )
}
#[cfg(not(feature = "serde_json"))]
fn manager_type_default() -> ManagerType {}

#[test]
fn test_run() {
    let mut app = bevy_app::App::new();
    app.init_config_with::<ManagerType, Settings>("ui", manager_type_default);
    app.add_systems(bevy_app::Update, |settings: ReadConfig<Settings>| {
        let settings = settings.read();
        assert_eq!(settings.thickness, 3);
        assert!(matches!(settings.color, ColorRead::White));
    });
    app.update();

    #[cfg(feature = "serde_json")]
    dump_json(&mut app);
    #[cfg(feature = "serde_json")]
    load_json(&mut app);
}

#[cfg(feature = "serde_json")]
fn dump_json(app: &mut bevy_app::App) {
    use bevy_mod_config::manager;

    let (json, pretty_json) =
        &app.world_mut().resource::<manager::Instance<ManagerType>>().instance.clone();

    let data = json.to_string(app.world_mut()).unwrap();
    assert_eq!(
        data,
        r#"{"ui.color.Named.code":"","ui.color.Rgb.0":0.0,"ui.color.Rgb.1":0.0,"ui.color.Rgb.2":0.0,"ui.color.Rgba.0.0":0.0,"ui.color.Rgba.0.1":0.0,"ui.color.Rgba.0.2":0.0,"ui.color.Rgba.0.3":0.0,"ui.color.discrim":"White","ui.thickness":3}"#
    );

    let data = pretty_json.to_string(app.world_mut()).unwrap();
    assert_eq!(
        data,
        r#"{
  "ui.color.Named.code": "",
  "ui.color.Rgb.0": 0.0,
  "ui.color.Rgb.1": 0.0,
  "ui.color.Rgb.2": 0.0,
  "ui.color.Rgba.0.0": 0.0,
  "ui.color.Rgba.0.1": 0.0,
  "ui.color.Rgba.0.2": 0.0,
  "ui.color.Rgba.0.3": 0.0,
  "ui.color.discrim": "White",
  "ui.thickness": 3
}"#
    );
}

#[cfg(feature = "serde_json")]
fn load_json(app: &mut bevy_app::App) {
    use std::io::Cursor;

    use bevy_ecs::system::RunSystemOnce;

    let input = String::from(
        r#"{
        "ui.thickness": 5,
        "ui.color.discrim": "Named",
        "ui.color.Named.code": "red"
    }"#,
    );

    // both json and pretty_json can handle the input in this case.
    let (json, _) = app
        .world_mut()
        .resource::<bevy_mod_config::manager::Instance<ManagerType>>()
        .instance
        .clone();
    json.from_reader(app.world_mut(), Cursor::new(input)).unwrap();

    app.world_mut()
        .run_system_once(|settings: ReadConfig<Settings>| {
            let settings = settings.read();
            assert_eq!(settings.thickness, 5);
            assert!(matches!(settings.color, ColorRead::Named { code: "red" }));
        })
        .unwrap();
}