Struct Registry 

pub struct Registry { /* private fields */ }

OCI registry client with platform resolution, caching, and progress reporting.

Implementations

impl Registry

pub fn new(platform: Platform, cache: GlobalCache) -> ImageResult<Self>

Create a registry client with anonymous authentication.

pub fn with_auth( platform: Platform, cache: GlobalCache, auth: RegistryAuth, ) -> ImageResult<Self>

Create a registry client with explicit authentication.

pub fn pull_cached( cache: &GlobalCache, reference: &Reference, options: &PullOptions, ) -> ImageResult<Option<(PullResult, CachedImageMetadata)>>

Resolve a pull directly from the on-disk cache without building a registry client.

pub async fn pull( &self, reference: &Reference, options: &PullOptions, ) -> ImageResult<PullResult>

Pull an image. Downloads, extracts, and indexes layers concurrently.

pub fn pull_with_progress( &self, reference: &Reference, options: &PullOptions, ) -> (PullProgressHandle, JoinHandle<ImageResult<PullResult>>)

where Self: Send + Sync + 'static,

Pull with progress reporting.

Creates a progress channel internally and returns both the receiver handle and the spawned pull task.

pub fn pull_with_sender( &self, reference: &Reference, options: &PullOptions, sender: PullProgressSender, ) -> JoinHandle<ImageResult<PullResult>>

where Self: Send + Sync + 'static,

Pull with an externally-provided progress sender.

Use progress_channel() to create the channel, keep the PullProgressHandle receiver, and pass the PullProgressSender here.