oci-image 0.1.0

OCI container images on disk: image references, sha256 digests, one-pass layer unpack (whiteouts and opaque directories), gzip (parallel via lgz when the stream allows it, streaming zlib-rs otherwise) and zstd layers, a content-addressed store of blobs and per-layer directories in overlayfs format (each layer unpacked once, shared between images, refcounted, collected), overlay snapshot prep, and an optional anonymous registry pull.
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

//! OCI container images on disk.
//!
//! - [`ImageRef`] and [`Digest`]: references with Docker's defaults, strict
//!   `sha256:` digests that are safe as file names.
//! - [`apply_layer_file`] / [`apply_layer`]: one-pass layer unpack with OCI
//!   whiteout and opaque-directory rules, a decoder thread ahead of the tar
//!   reader and a pool of file writers. Gzip layers with full-flush points
//!   (`pigz --independent`, BGZF) decode in parallel with [`lgz`], streaming;
//!   ordinary gzip streams decode with zlib-rs; zstd layers with libzstd.
//! - [`changes`] and [`decoder`]: the same whiteout rules as events over an
//!   in-memory blob, for scanners that keep their own view of the files.
//! - [`LayerStore`]: verified blobs by digest and one flattened rootfs per
//!   layer chain.
//! - [`Overlay`]: upper/work/merged directories and overlayfs mount data for
//!   a container on top of a rootfs.
//! - `pull` (feature `pull`): anonymous registry pull into the store.

mod decode;
mod digest;
mod error;
mod layer;
mod pgz;
#[cfg(feature = "pull")]
pub mod pull;
mod reference;
mod snapshot;
mod store;

pub use decode::{decoder, Compression, Decoder};
pub use digest::{Digest, Hasher};
pub use error::{Error, Result};
pub use layer::{
    apply_layer, apply_layer_file, changes, entry_path, Change, Layout, OverlayXattr,
    UnpackOptions, UnpackStats, IN_FLIGHT, SMALL_FILE,
};
pub use reference::ImageRef;
pub use snapshot::Overlay;
pub use store::{chain_id, BlobWriter, GcStats, ImageLayer, LayerStore};