inlet 0.4.0

Input management with configurable bindings for Bevy game engine.
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

use std::{hash::Hash, marker::PhantomData};

use bevy::{
    app::{Plugin, PreUpdate},
    ecs::schedule::IntoScheduleConfigs,
    input::InputSystems,
};

use crate::{BindEvent, SimpleMessage, systems::gather_button_inputs};

/// [`InputManagementPlugin`] where the [`Message`](bevy::prelude::Message) type is already filled with a
/// placeholder for cases where the input manager will not be emitting input events for [`SimpleMessage`]
/// is good enough for you.
pub type InputManagementPluginSimple<K> = InputManagementPlugin<K, SimpleMessage>;

pub trait InputKey: Hash + Eq + Clone {}

impl<T> InputKey for T where T: Hash + Eq + Clone {}

/// Plugin required for [`InputBindings`](crate::InputBindings) to function.
pub struct InputManagementPlugin<K, I>(PhantomData<K>, PhantomData<I>);
impl<K, I> Plugin for InputManagementPlugin<K, I>
where
    K: InputKey + Sync + Send + 'static,
    I: BindEvent + Sync + Send + 'static,
{
    fn build(&self, app: &mut bevy::prelude::App) {
        app.add_systems(PreUpdate, gather_button_inputs::<K, I>.after(InputSystems))
            .add_message::<I>();
    }
}

impl<K, I> InputManagementPlugin<K, I>
where
    K: InputKey + Sync + Send + 'static,
    I: BindEvent + Sync + Send + 'static,
{
    #[must_use]
    pub fn new() -> Self {
        Self(PhantomData, PhantomData)
    }
}

impl<K, I> Default for InputManagementPlugin<K, I>
where
    K: InputKey + Sync + Send + 'static,
    I: BindEvent + Sync + Send + 'static,
{
    fn default() -> Self {
        InputManagementPlugin::<K, I>::new()
    }
}