Struct TarUrl 

pub struct TarUrl {
    pub archive_url: Arc<UrlRef>,
    pub path: RelativePathBuf,
    pub compression: Option<TarCompression>,
    /* private fields */
}

Available on crate feature tar only.

A URL for an entry in a tarball (tar archive).

Supports bare as well as compressed tarballs.

The URL scheme is “tar:”, followed by full archive URL, a !, and then the entry path within the archive. The fragment of the archive URL is used to explicitly set the compression algorithm. If the compression is not explicitly set, will attempt to determine it according to the format of the archive URL.

Fields

archive_url: Arc<UrlRef>

The archive URL.

path: RelativePathBuf

The entry path.

compression: Option<TarCompression>

Compression.

Implementations

impl TarUrl

pub fn parse(url_representation: &str) -> Result<(String, String), UrlError>

Parse.

pub fn compression_from( archive_url: &UrlRef, ) -> Result<Option<TarCompression>, UrlError>

Compression from archive URL fragment.

pub fn new( context: &UrlContextRef, archive_url: Arc<UrlRef>, path: RelativePathBuf, compression: Option<TarCompression>, ) -> Self

Constructor.

pub fn new_with(&self, path: RelativePathBuf) -> TarUrl

Constructor.

Trait Implementations

impl Clone for TarUrl

fn clone(&self) -> TarUrl

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TarUrl

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

Formats the value using the given formatter.

impl Display for TarUrl

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

Formats the value using the given formatter.

impl Into<Box<dyn URL + Send + Sync>> for TarUrl

fn into(self) -> UrlRef

Converts this type into the (usually inferred) input type.

impl URL for TarUrl

fn context(&self) -> &UrlContext

The UrlContext used to create this URL.

fn query(&self) -> Option<UrlQuery>

The optional query.

fn fragment(&self) -> Option<String>

The optional fragment.

fn format(&self) -> Option<String>

Format of the URL content’s canonical representation.

fn base(&self) -> Option<UrlRef>

Returns a URL that is the equivalent of a “base directory” for the URL.

fn relative(&self, path: &str) -> UrlRef

Parses the argument as a path relative to the URL. That means that this URL is treated as a “base directory” (see base). The argument supports “..” and “.”, with the returned URL path always being absolute.

fn conform(&mut self) -> Result<(), UrlError>

Available on crate feature blocking only.

Ensures that the URL conforms with the expectations of its functions. If successful, this function may change the URL appropriately, e.g. a relative path would be turned into an absolute path.

fn conform_async(&self) -> Result<ConformFuture, UrlError>

Available on crate feature async only.

Async version of URL::conform.

fn open(&self) -> Result<ReadRef, UrlError>

Available on crate feature blocking only.

Opens the URL for reading by providing a dyn Read.

fn open_async(&self) -> Result<OpenFuture, UrlError>

Available on crate feature async only.

Async version of URL::open. Provides a dyn AsyncRead.

fn key(&self) -> String

Returns a string that uniquely identifies the URL.

fn local(&self) -> Option<PathBuf>

If this URL points to a local path, returns it.