mc-repack-core 0.27.1

A library for repacking Minecraft mods and resource packs to optimize size and loading speed.
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
101
102

use std::sync::{Arc, RwLock};

use state::TypeMap;

/// A configuration map.
pub struct ConfigMap(Arc<RwLock<TypeMap![Sync + Send]>>);
impl ConfigMap {
    /// Fetches a configuration holder for a type that accepts stored config.
    /// # Panics
    /// Panics if the read-write lock is poisoned.
    #[must_use]
    pub fn fetch<AC: AcceptsConfig>(&self) -> ConfigHolder<AC> {
        let ch = self.0.read().unwrap().try_get::<ConfigHolder<AC>>().cloned();
        ch.map_or_else(move || {
            let cfg = ConfigHolder(Arc::new(AC::Cfg::default()));
            self.0.write().unwrap().set::<ConfigHolder<AC>>(ConfigHolder::clone(&cfg));
            cfg
        }, |cfg| cfg)
    }

    /// Sets a config for a type that accepts it. It should be used before any configurable operation.
    /// # Panics
    /// Panics if the read-write lock is poisoned.
    pub fn set<AC: AcceptsConfig>(&self, cfg: AC::Cfg) {
        self.0.write().unwrap().set::<ConfigHolder<AC>>(ConfigHolder(Arc::new(cfg)));
    }
}
impl Clone for ConfigMap {
    fn clone(&self) -> Self {
        Self(self.0.clone())
    }
}
impl Default for ConfigMap {
    fn default() -> Self {
        Self(Arc::new(RwLock::new(<TypeMap![Sync + Send]>::new())))
    }
}

/// A type that accepts a stored config. It usually is an empty enum.
pub trait AcceptsConfig: 'static {
    /// A configuration type.
    type Cfg: 'static + Send + Sync + Default;
}

/// A configuration holder. Any type that wants to use the config must implement methods for config holder.
pub struct ConfigHolder<AC: AcceptsConfig>(Arc<AC::Cfg>);
impl<AC: AcceptsConfig> Clone for ConfigHolder<AC> {
    fn clone(&self) -> Self {
        Self(self.0.clone())
    }
}
impl<AC: AcceptsConfig> std::ops::Deref for ConfigHolder<AC> {
    type Target = AC::Cfg;
    fn deref(&self) -> &Self::Target {
        &self.0
    }
}

macro_rules! acfg {
    ($(#[doc = $doc:expr])? $ac:ident : $cfg:ty) => {
        $(#[doc = $doc])?
        /// This empty enum type should not be used without [`ConfigHolder`].
        pub enum $ac {}
        impl crate::cfg::AcceptsConfig for $ac {
            type Cfg = $cfg;
        }
    };
}
pub(crate) use acfg;

#[cfg(feature = "_any-zopfli")]
/// Universal configuration for Zopfli.
/// It determines if Zopfli will be enabled and how many iterations will be used.
#[cfg_attr(feature = "serde-cfg", derive(serde::Serialize, serde::Deserialize), serde(untagged))]
pub enum CfgZopfli {
    /// A switch value (`true` or `false`).
    /// If it is enabled then Zopfli will be enabled with 10 iterations by default.
    Switch(bool),
    /// An iteration count. If it is 0 then Zopfli will be disabled.
    Iter(u8)
}
#[cfg(feature = "_any-zopfli")]
impl Default for CfgZopfli {
    fn default() -> Self {
        Self::Switch(false)
    }
}

#[cfg(feature = "_any-zopfli")]
impl CfgZopfli {
    /// Returns the iteration count based on its state.
    #[inline]
    #[must_use]
    pub const fn iter_count(&self) -> Option<std::num::NonZeroU8> {
        match self {
            Self::Switch(false) => None,
            Self::Iter(x) => std::num::NonZeroU8::new(*x),
            Self::Switch(true) => std::num::NonZeroU8::new(10)
        }
    }
}