bevy-convars 0.2.1

An implementation of convars (config or console variables) for configuring your Bevy application.
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

use bevy_asset::{Asset, AssetLoader, Assets, AsyncReadExt as _, Handle};
use bevy_ecs::world::World;
use bevy_reflect::Reflect;
use std::error::Error;
use toml_edit::ImDocument;

use crate::CVarError;

use super::{ConfigLoader, DocumentContext};

impl ConfigLoader {
    /// Applies a given config to the world.
    pub fn apply_asset(
        &self,
        world: &mut World,
        asset: Handle<CVarConfig>,
    ) -> Result<(), CVarError> {
        let document = world
            .resource::<Assets<CVarConfig>>()
            .get(&asset)
            .unwrap()
            .clone()
            .0;

        self.apply(world, document)?;

        Ok(())
    }
}

/// A config as an asset, allowing you to use standard bevy asset loading.
#[derive(Asset, Reflect, Clone)]
pub struct CVarConfig(#[reflect(ignore)] pub(super) DocumentContext<String>);

/// Provides an asset loader for [CVarConfig].
#[derive(Default)]
pub struct ConfigAssetLoader {}

impl AssetLoader for ConfigAssetLoader {
    type Asset = CVarConfig;

    type Settings = ();

    type Error = Box<dyn Error + Send + Sync + 'static>;

    async fn load(
        &self,
        reader: &mut dyn bevy_asset::io::Reader,
        _: &Self::Settings,
        load_context: &mut bevy_asset::LoadContext<'_>,
    ) -> Result<Self::Asset, Self::Error> {
        let mut buf = String::new();

        reader.read_to_string(&mut buf).await?;

        Ok(CVarConfig(DocumentContext::new(
            ImDocument::parse(buf)?,
            load_context.path().to_str().unwrap().to_owned(),
        )))
    }
}