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
//! Split the definition of a simple enum-like [`State`](crate::state::State) between
//! the modules of your crate.
//!
//! Enable the `split` feature flag to use this module.
//!
//! Newtype [`SplitState`] to define a new split state type, and use
//! [`add_to_split_state!`](crate::add_to_split_state!) to extend it.
//!
//! This can be a useful organizational tool for cross-cutting states in a plugin-based
//! codebase.
/// The internal value of a split state type.
///
/// # Example
///
/// Define your own split state type as a newtype:
///
/// ```
/// # use pyri_state::prelude::*;
/// #
/// #[derive(State, Clone, PartialEq, Eq)]
/// pub struct MyState(pub SplitState);
/// ```
pub type SplitState = &'static str;
/// A macro for extending [`SplitState`] newtypes.
///
/// # Example
///
/// ```
/// # use pyri_state::prelude::*;
/// #
/// # #[derive(State, Clone, PartialEq, Eq)]
/// # pub struct MyState(pub SplitState);
/// #
/// add_to_split_state!(MyState, Foo, Bar);
/// add_to_split_state!(MyState, Quux);
/// ```