mf2-catalog 3.0.0

The .mf2b binary catalog: a no_std client reader and (features) the writer, the model-rebuilding decoder and the manifest file.
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

//! The load number: what a catalog is given when it is loaded, so that a cache
//! can tell one catalog from another without comparing their bytes.
//!
//! It exists only where this build's side asked for it — `std-load-id` off
//! the browser, `web-load-id` on `wasm32-unknown-unknown` — and is nothing at
//! all otherwise: [`Load`] is then zero-sized and [`Load::next`] does nothing,
//! so the reader names it without a `cfg` of its own.

/// Whether this build numbers its catalogs: its own side's feature is on.
#[doc(hidden)]
pub const LOAD_ID: bool = cfg!(any(
    all(
        feature = "std-load-id",
        not(all(target_arch = "wasm32", target_os = "unknown"))
    ),
    all(
        feature = "web-load-id",
        target_arch = "wasm32",
        target_os = "unknown"
    )
));

#[cfg(any(
    all(
        feature = "std-load-id",
        not(all(target_arch = "wasm32", target_os = "unknown"))
    ),
    all(feature = "web-load-id", target_arch = "wasm32", target_os = "unknown")
))]
mod numbered {
    use core::sync::atomic::{AtomicU64, Ordering};

    /// The next load number: process-wide, from 1, never handed out twice (a
    /// `u64` does not wrap in a process's life).
    static LOADS: AtomicU64 = AtomicU64::new(1);

    /// A catalog's load number.
    #[derive(Clone, Copy)]
    pub(crate) struct Load(u64);

    impl Load {
        /// A number not given before.
        pub(crate) fn next() -> Load {
            Load(LOADS.fetch_add(1, Ordering::Relaxed))
        }

        /// The number.
        pub(crate) fn id(self) -> u64 {
            self.0
        }
    }
}

#[cfg(not(any(
    all(
        feature = "std-load-id",
        not(all(target_arch = "wasm32", target_os = "unknown"))
    ),
    all(feature = "web-load-id", target_arch = "wasm32", target_os = "unknown")
)))]
mod numbered {
    /// No load number in this build.
    #[derive(Clone, Copy)]
    pub(crate) struct Load;

    impl Load {
        /// Nothing.
        pub(crate) fn next() -> Load {
            Load
        }
    }
}

pub(crate) use numbered::Load;