goods 0.5.3

Asset manager for good assets
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

#[allow(unused)]
use {
    crate::{
        asset::{Asset, Format},
        ready, Cache, PhantomContext, Ready,
    },
    alloc::vec::Vec,
    core::convert::Infallible,
};

#[cfg(feature = "serde")]
use serde::de::DeserializeOwned;

#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct PassthroughFormat;

impl<A, K> Format<A, K> for PassthroughFormat
where
    A: Asset,
    A::Repr: From<Vec<u8>>,
{
    type Error = Infallible;
    type DecodeFuture = Ready<Result<A::Repr, Infallible>>;

    fn decode(self, bytes: Vec<u8>, _cache: &Cache<K>) -> Ready<Result<A::Repr, Infallible>> {
        ready(Ok(bytes.into()))
    }
}

/// Format that treats bytes as JSON document and deserializes asset representation with `serde`.
#[cfg(feature = "json-format")]
#[derive(Copy, Clone, Debug, Default, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(all(doc, feature = "unstable-doc"), doc(cfg(feature = "json-format")))]
pub struct JsonFormat;

#[cfg(feature = "json-format")]
impl<A, K> Format<A, K> for JsonFormat
where
    A: Asset,
    A::Repr: DeserializeOwned,
{
    type Error = serde_json::Error;
    type DecodeFuture = Ready<Result<A::Repr, Self::Error>>;

    fn decode(
        self,
        bytes: Vec<u8>,
        _cache: &Cache<K>,
    ) -> Ready<Result<A::Repr, serde_json::Error>> {
        ready(serde_json::from_slice(&bytes).map_err(Into::into))
    }
}

/// Format that treats bytes as YAML document and deserializes asset representation with `serde`.
#[cfg(feature = "yaml-format")]
#[derive(Copy, Clone, Debug, Default, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(all(doc, feature = "unstable-doc"), doc(cfg(feature = "yaml-format")))]
pub struct YamlFormat;

#[cfg(feature = "yaml-format")]
impl<A, K> Format<A, K> for YamlFormat
where
    A: Asset,
    A::Repr: DeserializeOwned,
{
    type Error = serde_yaml::Error;
    type DecodeFuture = Ready<Result<A::Repr, Self::Error>>;

    fn decode(
        self,
        bytes: Vec<u8>,
        _cache: &Cache<K>,
    ) -> Ready<Result<A::Repr, serde_yaml::Error>> {
        ready(serde_yaml::from_slice(&bytes).map_err(Into::into))
    }
}

/// Format that treats bytes as RON document and deserializes asset representation with `serde`.
#[cfg(feature = "ron-format")]
#[derive(Copy, Clone, Debug, Default, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(all(doc, feature = "unstable-doc"), doc(cfg(feature = "ron-format")))]
pub struct RonFormat;

#[cfg(feature = "ron-format")]
impl<A, K> Format<A, K> for RonFormat
where
    A: Asset,
    A::Repr: DeserializeOwned,
{
    type Error = ron::de::Error;
    type DecodeFuture = Ready<Result<A::Repr, Self::Error>>;

    fn decode(self, bytes: Vec<u8>, _cache: &Cache<K>) -> Ready<Result<A::Repr, ron::de::Error>> {
        ready(ron::de::from_bytes(&bytes).map_err(Into::into))
    }
}