Struct InstallContext 

pub struct InstallContext<'a> {

    pub project_dir: &'a Path,
    pub cache: &'a Cache,
    pub force_refresh: bool,
    pub verbose: bool,
    pub manifest: Option<&'a Manifest>,
    pub lockfile: Option<&'a Arc<LockFile>>,
    pub old_lockfile: Option<&'a LockFile>,
    pub project_patches: Option<&'a ManifestPatches>,
    pub private_patches: Option<&'a ManifestPatches>,
    pub max_content_file_size: Option<u64>,
    pub template_context_builder: Arc<TemplateContextBuilder>,
    pub trust_lockfile_checksums: bool,
    pub token_warning_threshold: Option<u64>,
}

Installation context containing common parameters for resource installation.

This struct bundles frequently-used installation parameters to reduce function parameter counts and improve code readability. It’s used throughout the installation pipeline to pass configuration and context information.

Fields

• project_dir - Root directory of the project where resources will be installed
• cache - Cache instance for managing Git repositories and worktrees
• force_refresh - Whether to force refresh of cached worktrees
• manifest - Optional reference to the project manifest for template context
• lockfile - Optional reference to the lockfile for template context
• old_lockfile - Optional reference to the previous lockfile for early-exit optimization
• project_patches - Optional project-level patches from agpm.toml
• private_patches - Optional user-level patches from agpm.private.toml

Fields

project_dir: &'a Path

cache: &'a Cache

force_refresh: bool

verbose: bool

manifest: Option<&'a Manifest>

lockfile: Option<&'a Arc<LockFile>>

old_lockfile: Option<&'a LockFile>

project_patches: Option<&'a ManifestPatches>

private_patches: Option<&'a ManifestPatches>

max_content_file_size: Option<u64>

template_context_builder: Arc<TemplateContextBuilder>

Shared template context builder for all resources

trust_lockfile_checksums: bool

Trust lockfile checksums without recomputing (ultra-fast path optimization).

When enabled and all inputs match the old lockfile entry, skip file I/O and return the stored checksum. Safe for immutable dependencies (tags/SHAs).

See module-level docs in crate::cli::install for optimization tier details.

token_warning_threshold: Option<u64>

Token count warning threshold.

When set, resources exceeding this threshold will emit a warning during installation.

Implementations

impl<'a> InstallContext<'a>

pub fn builder( project_dir: &'a Path, cache: &'a Cache, ) -> InstallContextBuilder<'a>

Create a new builder for InstallContext.

pub fn with_common_options( project_dir: &'a Path, cache: &'a Cache, manifest: Option<&'a Manifest>, lockfile: Option<&'a Arc<LockFile>>, force_refresh: bool, verbose: bool, old_lockfile: Option<&'a LockFile>, ) -> Self

Create an InstallContext with common options for parallel installation.

This helper function reduces code duplication by handling the common pattern of setting up InstallContext with frequently used options.

Arguments

• project_dir - Root directory of the project
• cache - Cache instance for managing Git repositories
• manifest - Optional project manifest
• lockfile - Lockfile for template context
• force_refresh - Whether to force refresh cached worktrees
• verbose - Whether to enable verbose output
• old_lockfile - Optional previous lockfile for early-exit optimization

pub fn with_common_options_and_trust( project_dir: &'a Path, cache: &'a Cache, manifest: Option<&'a Manifest>, lockfile: Option<&'a Arc<LockFile>>, force_refresh: bool, verbose: bool, old_lockfile: Option<&'a LockFile>, trust_lockfile_checksums: bool, token_warning_threshold: Option<u64>, ) -> Self

Create an InstallContext with common options including trust flag.

This is the full version that allows specifying trust_lockfile_checksums and token_warning_threshold.