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 Self: 'async_trait, 'life0: 'async_trait, 'life1: '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 Self: 'async_trait, 'life0: 'async_trait, 'life1: '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 Self: 'async_trait, 'life0: 'async_trait, 'life1: '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 Self: 'async_trait, 'life0: 'async_trait, 'life1: '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 Self: 'async_trait, 'life0: 'async_trait, 'life1: '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 Self: 'async_trait, 'life0: 'async_trait, 'life1: '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 Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

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

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

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

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

fn fetch_inrelease_or_release<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, inrelease_path: &'life1 str, release_path: &'life2 str ) -> Pin<Box<dyn Future<Output = Result<ReleaseFile<'static>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Fetch and parse either an InRelease or Release 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 Self: 'async_trait, 'fetch: 'async_trait, 'life0: '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 Self: 'async_trait, 'fetch: 'async_trait, 'life0: '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 Self: 'async_trait, 'fetch: 'async_trait, 'life0: 'async_trait,

Fetch a source package file given a SourcePackageFetch instruction.