spru 0.1.0

Reusable components for the spru strategy and digital board game framework.
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

use tagset::tagset_meta;

use crate::{common, item};

/// A set of all the possible types an [Item](crate::Item) could contain for a game.
/// Implement [trait@State] using [tagset::tagset]:
/// ```rust,ignore
/// # use tagset::tagset;
///
/// #[derive(serde::Serialize, serde::Deserialize)]
/// struct Counter(i32);
/// #[derive(serde::Serialize, serde::Deserialize)]
/// struct Whiteboard(String);
///
/// #[tagset(impl tagset::proxy::serde::Serialize)]
/// #[tagset(impl<'de> tagset::serde::DeserializeFromDiscriminant<'de>)]
/// #[tagset(impl<'de> tagset::proxy::serde::Deserialize<'de>)]
/// #[tagset(impl spru::State)]
/// #[tagset(Counter)]
/// #[tagset(Whiteboard)]
/// struct MyState;
///
/// # fn main() { }
/// ```
/// Here `Counter` and `Whiteboard` are included in `MyState` and can be used as items tracked by spru.
/// For generic types, you must specify each monomorphized type you want to use, e.g. `Counter<u8>` and `Counter<i32>`.
#[telety::telety(crate::state, alias_traits = "always")]
#[tagset_meta]
#[meta(bounds(for<VAR> Self: tagset::TagSetDiscriminant<VAR>))]
pub trait State: tagset::TagSet<Repr: Clone + Eq + std::hash::Hash> + Sized {
    #[doc(hidden)]
    #[meta(default {
        match_by_discriminant!(index, T => item.cast::<Storage, T>(storage))
    })]
    fn apply_state<Storage>(
        index: Self::Repr,
        item: &item::Erased,
        storage: &mut Storage,
    ) -> Result<(), common::error::Load>
    where
        Storage: item::Storage<State = Self>;
}