Skip to main content

HttpBackend

Struct HttpBackend 

Source
struct HttpBackend<'gctx> {
Show 14 fields index_cache_path: Filesystem, crate_cache_path: Filesystem, source_id: SourceId, gctx: &'gctx GlobalContext, url: Url, requested_update: Cell<bool>, progress: RefCell<Option<Progress<'gctx>>>, pending: Cell<usize>, fresh: RefCell<HashSet<String>>, fetch_started: Cell<bool>, auth_required: Cell<bool>, login_url: RefCell<Option<Url>>, auth_error_headers: RefCell<Vec<String>>, quiet: Cell<bool>,
}

Fields§

§index_cache_path: Filesystem

Path to the registry index ($CARGO_HOME/registry/index/$REG-HASH).

§crate_cache_path: Filesystem

Path to the cache of .crate files ($CARGO_HOME/registry/cache/$REG-HASH).

§source_id: SourceId

The unique identifier of this registry source.

§gctx: &'gctx GlobalContext§url: Url

Store the server URL without the protocol prefix (sparse+)

§requested_update: Cell<bool>

Has the client requested a cache update?

Only if they have do we double-check the freshness of each locally-stored index file.

§progress: RefCell<Option<Progress<'gctx>>>

Progress bar for transfers.

§pending: Cell<usize>

Number of in-flight requests.

§fresh: RefCell<HashSet<String>>

What paths have we already fetched since the last index update?

We do not need to double-check any of these index files since we have already done so.

§fetch_started: Cell<bool>

Have we started to download any index files?

§auth_required: Cell<bool>

Should we include the authorization header?

§login_url: RefCell<Option<Url>>

Url to get a token for the registry.

§auth_error_headers: RefCell<Vec<String>>

Headers received with an HTTP 401.

§quiet: Cell<bool>

Disables status messages.

Implementations§

Source§

impl<'gctx> HttpBackend<'gctx>

Source

pub fn new( source_id: SourceId, gctx: &'gctx GlobalContext, name: &str, ) -> CargoResult<HttpBackend<'gctx>>

Source

fn full_url(&self, path: &str) -> String

Constructs the full URL to download a index file.

Source

fn start_fetch(&self) -> CargoResult<()>

Setup the necessary works before the first fetch gets started.

This is a no-op if called more than one time.

Source

fn offline(&self) -> bool

Are we in offline mode?

Return NotFound in offline mode when the file doesn’t exist in the cache. If this results in resolution failure, the resolver will suggest removing the –offline flag.

Source

fn is_fresh(&self, path: &str) -> bool

Check if an index file of path is up-to-date.

Source

async fn fetch_uncached( &self, path: &str, extra_header: Option<(&HeaderName, &HeaderValue)>, ) -> CargoResult<LoadResponse>

Source

async fn fetch_uncached_no_retry( &self, path: &str, extra_header: Option<(&HeaderName, &HeaderValue)>, ) -> CargoResult<LoadResponse>

Source

fn tick(&self) -> CargoResult<()>

Updates the state of the progress bar for downloads.

Auto Trait Implementations§

§

impl<'gctx> !Freeze for HttpBackend<'gctx>

§

impl<'gctx> !RefUnwindSafe for HttpBackend<'gctx>

§

impl<'gctx> Send for HttpBackend<'gctx>

§

impl<'gctx> !Sync for HttpBackend<'gctx>

§

impl<'gctx> Unpin for HttpBackend<'gctx>

§

impl<'gctx> UnsafeUnpin for HttpBackend<'gctx>

§

impl<'gctx> !UnwindSafe for HttpBackend<'gctx>

Blanket Implementations§

Source§

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

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

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

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

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

Source§

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

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

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
Source§

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

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.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
Source§

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

Source§

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

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
§

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

Layout§

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 488 bytes