Struct debian_packaging::repository::http::HttpRepositoryClient

pub struct HttpRepositoryClient { /* private fields */ }

Client for a Debian repository served via HTTP.

Instances are bound to a base URL, which represents the base directory.

Distributions (typically) exist in a dists/<distribution> directory. Distributions have an InRelease and/or Release file under it.

Implementations

impl HttpRepositoryClient

pub fn new(url: impl IntoUrl) -> Result<Self>

Construct an instance bound to the specified URL.

pub fn new_client(client: Client, url: impl IntoUrl) -> Result<Self>

Construct an instance using the given Client and URL.

The given URL should be the value that follows the deb line in apt sources files. e.g. for deb https://deb.debian.org/debian stable main, the value would be https://deb.debian.org/debian. The URL typically has a dists/ directory underneath.

Trait Implementations

impl DataResolver for HttpRepositoryClient

fn get_path<'life0, 'life1, 'async_trait>(
    &'life0 self,
    path: &'life1 str
) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn AsyncRead + Send>>>> + Send + 'async_trait>> where
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait, 

Get the content of a relative path as an async reader.

fn get_path_with_digest_verification<'life0, 'life1, 'async_trait>(
    &'life0 self,
    path: &'life1 str,
    expected_size: u64,
    expected_digest: ContentDigest
) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn AsyncRead + Send>>>> + Send + 'async_trait>> where
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait, 

Obtain a reader that performs content integrity checking.

fn get_path_decoded<'life0, 'life1, 'async_trait>(
    &'life0 self,
    path: &'life1 str,
    compression: Compression
) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn AsyncRead + Send>>>> + Send + 'async_trait>> where
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait, 

Get the content of a relative path with decompression transparently applied.

fn get_path_decoded_with_digest_verification<'life0, 'life1, 'async_trait>(
    &'life0 self,
    path: &'life1 str,
    compression: Compression,
    expected_size: u64,
    expected_digest: ContentDigest
) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn AsyncRead + Send>>>> + Send + 'async_trait>> where
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait, 

Like Self::get_path_decoded() but also perform content integrity verification.

impl Debug for HttpRepositoryClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl RepositoryRootReader for HttpRepositoryClient

fn url(&self) -> Result<Url>

Obtain the URL to which this reader is bound.

fn release_reader_with_distribution_path<'life0, 'life1, 'async_trait>(
    &'life0 self,
    path: &'life1 str
) -> Pin<Box<dyn Future<Output = Result<Box<dyn ReleaseReader>>> + Send + 'async_trait>> where
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait, 

Obtain a ReleaseReader given a distribution path.

fn release_reader<'life0, 'life1, 'async_trait>(
    &'life0 self,
    distribution: &'life1 str
) -> Pin<Box<dyn Future<Output = Result<Box<dyn ReleaseReader>>> + Send + 'async_trait>> where
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait, 

Obtain a ReleaseReader for a given distribution.

fn fetch_inrelease<'life0, 'life1, 'async_trait>(
    &'life0 self,
    path: &'life1 str
) -> Pin<Box<dyn Future<Output = Result<ReleaseFile<'static>>> + Send + 'async_trait>> where
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait, 

Fetch and parse an InRelease file at the relative path specified.

fn fetch_binary_package_generic<'fetch, 'life0, 'async_trait>(
    &'life0 self,
    fetch: BinaryPackageFetch<'fetch>
) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn AsyncRead + Send>>>> + Send + 'async_trait>> where
    'fetch: 'async_trait,
    'life0: 'async_trait,
    Self: 'async_trait, 

Fetch a binary package given a BinaryPackageFetch instruction.

fn fetch_binary_package_deb_reader<'fetch, 'life0, 'async_trait>(
    &'life0 self,
    fetch: BinaryPackageFetch<'fetch>
) -> Pin<Box<dyn Future<Output = Result<BinaryPackageReader<Cursor<Vec<u8>>>>> + Send + 'async_trait>> where
    'fetch: 'async_trait,
    'life0: 'async_trait,
    Self: 'async_trait, 

Fetch a binary package given a BinaryPackageFetch instruction.

fn fetch_source_package_generic<'fetch, 'life0, 'async_trait>(
    &'life0 self,
    fetch: SourcePackageFetch<'fetch>
) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn AsyncRead + Send>>>> + Send + 'async_trait>> where
    'fetch: 'async_trait,
    'life0: 'async_trait,
    Self: 'async_trait, 

Fetch a source package file given a SourcePackageFetch instruction.