cargo-hold 1.3.4

cargo-hold: A CI tool to ensure Cargo's incremental compilation is reliable by managing your caches intelligently
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

//! Anchor command implementation.

use std::path::Path;

use super::salvage::{SalvageReport, salvage_with_report};
use super::stow::stow;
use crate::error::Result;
use crate::logging::Logger;

/// Executes the anchor command - the main orchestrator.
///
/// This command anchors your build state by performing the complete workflow:
/// 1. Restores timestamps from the metadata
/// 2. Scans for changes and saves the new state
///
/// This is the recommended command for CI use.
pub fn anchor(metadata_path: &Path, verbose: u8, quiet: bool, working_dir: &Path) -> Result<()> {
    anchor_with_report(metadata_path, verbose, quiet, working_dir).map(|_| ())
}

pub(crate) fn anchor_with_report(
    metadata_path: &Path,
    verbose: u8,
    quiet: bool,
    working_dir: &Path,
) -> Result<SalvageReport> {
    let log = Logger::new(verbose, quiet);
    log.info("⚓ Anchoring build state...");

    let report = salvage_with_report(metadata_path, verbose, quiet, working_dir)?;
    stow(metadata_path, verbose, quiet, working_dir)?;

    log.info("⚓ Build state anchored successfully");

    Ok(report)
}