shipyard 0.11.2

Entity Component System
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

use crate::entity_id::EntityId;
use crate::views::EntitiesViewMut;
use core::fmt;
use serde::de::{DeserializeSeed, Visitor};
use serde::{Deserialize, Deserializer};

/// Builder to customize [`EntitiesViewMut`]'s deserialization format.
///
/// Make sure to match the configuration used when serializing.
pub struct EntitiesViewMutDeserializer<'tmp, 'view> {
    entities: &'tmp mut EntitiesViewMut<'view>,
}

impl<'tmp, 'view> EntitiesViewMutDeserializer<'tmp, 'view> {
    #[allow(missing_docs)]
    pub fn new(
        entities: &'tmp mut EntitiesViewMut<'view>,
    ) -> EntitiesViewMutDeserializer<'tmp, 'view> {
        EntitiesViewMutDeserializer { entities }
    }
}

impl<'tmp, 'view, 'de: 'view> DeserializeSeed<'de> for EntitiesViewMutDeserializer<'tmp, 'view> {
    type Value = ();

    fn deserialize<D>(self, deserializer: D) -> Result<(), D::Error>
    where
        D: Deserializer<'de>,
    {
        struct SeqVisitor<'tmp, 'view> {
            place: EntitiesViewMutDeserializer<'tmp, 'view>,
        }

        impl<'tmp2, 'tmp, 'view, 'de: 'view> Visitor<'de> for SeqVisitor<'tmp, 'view> {
            type Value = ();

            fn expecting(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
                formatter.write_str("a sequence of entity_id-component pairs")
            }

            fn visit_seq<A>(self, mut seq: A) -> Result<Self::Value, A::Error>
            where
                A: serde::de::SeqAccess<'de>,
            {
                while let Some(eid) = seq.next_element::<EntityId>()? {
                    self.place.entities.spawn(eid);
                }

                Ok(())
            }
        }

        deserializer.deserialize_seq(SeqVisitor { place: self })
    }
}

impl<'view, 'de: 'view> Deserialize<'de> for EntitiesViewMut<'view> {
    fn deserialize<D>(_deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        panic!("EntitiesViewMut cannot be directly deserialized. Use deserialize_in_place instead.")
    }

    fn deserialize_in_place<D>(deserializer: D, place: &mut Self) -> Result<(), D::Error>
    where
        D: Deserializer<'de>,
    {
        let entities_view_mut_deserializer = EntitiesViewMutDeserializer::new(place);
        DeserializeSeed::deserialize(entities_view_mut_deserializer, deserializer)
    }
}