Struct AcquiredSource 

#[non_exhaustive]
pub struct AcquiredSource {
    pub source_dir: PathBuf,
    pub cache_key: String,
    pub version: Option<String>,
    pub kernel_source: KernelSource,
    pub is_temp: bool,
    pub is_dirty: bool,
    pub is_git: bool,
}

Downloaded/cloned kernel source ready for building.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

source_dir: PathBuf

Path to the kernel source directory.

cache_key: String

Cache key for this source (e.g. “6.14.2-tarball-x86_64-kc{kconfig_hash}”).

version: Option<String>

Version string if known (e.g. “6.14.2”, “6.15-rc3”).

kernel_source: KernelSource

How the source was acquired, with per-variant payload (git hash/ref for Git, source tree path and git hash for Local).

is_temp: bool

Whether the source is a temporary directory that should be cleaned up after building.

is_dirty: bool

For local sources: whether the working tree is dirty. Dirty trees must not be cached.

is_git: bool

For local sources: whether the source is an actual git repository. true when gix::discover succeeded and the crate could compute index + worktree dirty state; false for non-git source trees (tarball-extracted, rsync’d, hand-assembled) where dirty detection is impossible and the source is always cache-skipped pessimistically. Lets the cache-skip hint branch on whether commit / stash are actionable remediations (they aren’t for non-git sources).

For non-local sources (tarball, git clone) the field is set to true by convention — these paths are always is_dirty = false, so the cache-skip branch that reads is_git is never reached and the value is inert. Pinning to true (rather than leaving the field meaningless) keeps the invariant “is_git is meaningful only when is_dirty is true, but always set” so a future code path that reaches is_git outside the cache-skip context does not trip on an is_git = false under a known-good source.