Struct hua_core::cache::CacheBuilder

source · [−]

pub struct CacheBuilder { /* private fields */ }

Expand description

Builder to facilitate creating Cache objects.

Implementations

impl CacheBuilder

pub fn new() -> CacheBuilder

Construct a new CacheBuilder.

pub fn with_client_builder(client_builder: ClientBuilder) -> CacheBuilder

Construct a new CacheBuilder with a ClientBuilder.

pub fn dir(self, dir: PathBuf) -> CacheBuilder

Set the cache location. This can be set through the environment variable RUST_CACHED_PATH_ROOT. Otherwise it will default to a subdirectory named ‘cache’ of the default system temp directory.

pub fn client_builder(self, client_builder: ClientBuilder) -> CacheBuilder

Set the ClientBuilder.

pub fn timeout(self, timeout: Duration) -> CacheBuilder

Enable a request timeout.

pub fn connect_timeout(self, timeout: Duration) -> CacheBuilder

Enable a timeout for the connect phase of each HTTP request.

pub fn max_retries(self, max_retries: u32) -> CacheBuilder

Set maximum number of retries for HTTP requests.

pub fn max_backoff(self, max_backoff: u32) -> CacheBuilder

Set the maximum backoff delay in milliseconds for retrying HTTP requests.

pub fn freshness_lifetime(self, freshness_lifetime: u64) -> CacheBuilder

Set the default freshness lifetime, in seconds. The default is None, meaning the ETAG for an external resource will always be checked for a fresher value.

pub fn offline(self, offline: bool) -> CacheBuilder

Only use offline functionality.

If set to true, when the cached path of an HTTP resource is requested, the latest cached version is returned without checking for freshness. But if no cached versions exist, a NoCachedVersions error is returned.

pub fn progress_bar(self, progress_bar: Option<ProgressBar>) -> CacheBuilder

Set the type of progress bar to use.

The default is Some(ProgressBar::Full).

pub fn build(self) -> Result<Cache, Error>

Build the Cache object.

Trait Implementations

impl Debug for CacheBuilder

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

Formats the value using the given formatter. Read more

impl Default for CacheBuilder

fn default() -> CacheBuilder

Returns the “default value” for a type. Read more

Auto Trait Implementations

impl !RefUnwindSafe for CacheBuilder

impl Send for CacheBuilder

impl Sync for CacheBuilder

impl Unpin for CacheBuilder

impl !UnwindSafe for CacheBuilder

Blanket Implementations

impl<T> Any for T where
T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T, U> TryFrom<U> for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more