zccache 1.12.16

Local-first compiler cache for C/C++/Rust/Emscripten
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

//! Artifact pack format, atomic writes, hardlinking, cached output materialization.
//!
//! Originally a single 1K-LOC `persist.rs`; split per domain so each file
//! stays well under the 1,000 LOC cap. Submodules:
//!
//! - [`artifact_io`] — Atomic writes (`persist_artifact_output`,
//!   `persist_artifact_file`, `replace_artifact_cache_file`),
//!   `PersistArtifactFileStats`, error enrichment, and the Windows
//!   AV-scanner retry helper.
//! - [`pack`] — Experimental `.pack` artifact format (env-gated via
//!   `ZCCACHE_PACK_ARTIFACTS`): magic header, builder, parser, and
//!   per-payload extractor.
//! - [`write_cached`] — Materialize cached output to its target path
//!   (`write_cached_output`, `write_cached_file`, `write_cached_payload`,
//!   and the parallel batch entry points).
//! - [`hardlink`] — Cross-platform hardlink helpers
//!   (`break_output_hardlink_before_compile`, `hard_link_count`,
//!   `same_file`, Windows `get_file_id`).
//! - [`mtime`] — Mtime preservation + sibling-floor refinement
//!   (`touch_mtime`, `floor_materialized_outputs_to_input_max`).
//!
//! All `pub(super)` items are re-exported here so the parent `use
//! persist::*;` glob still sees the original surface.

use super::*;

mod artifact_io;
mod directory_bundle;
mod fs_caps;
mod hardlink;
mod link_registry;
mod mtime;
mod pack;
mod staged_multi;
mod staged_plan;
mod staged_store;
mod write_cached;

pub(in crate::daemon_core::daemon::server) use artifact_io::*;
pub(in crate::daemon_core::daemon::server) use directory_bundle::*;
pub(in crate::daemon_core::daemon::server) use fs_caps::*;
pub(in crate::daemon_core::daemon::server) use hardlink::*;
pub(in crate::daemon_core::daemon::server) use link_registry::*;
pub(in crate::daemon_core::daemon::server) use mtime::*;
pub(in crate::daemon_core::daemon::server) use pack::*;
pub(in crate::daemon_core::daemon::server) use staged_multi::*;
pub(in crate::daemon_core::daemon::server) use staged_plan::*;
pub(in crate::daemon_core::daemon::server) use staged_store::*;
pub(in crate::daemon_core::daemon::server) use write_cached::*;

pub(crate) type V2DiskArtifact = staged_store::StagedDiskArtifact;

pub(crate) fn scan_v2_disk_artifacts(artifact_dir: &Path) -> std::io::Result<Vec<V2DiskArtifact>> {
    staged_store::scan_staged_disk_artifacts(artifact_dir)
}

pub(crate) fn evict_v2_artifact_keys(
    artifact_dir: &Path,
    keys: &std::collections::HashSet<String>,
) -> std::io::Result<u64> {
    staged_store::evict_staged_artifact_keys(artifact_dir, keys)
}

#[cfg(test)]
mod tests;