pub struct ClientOptions { /* private fields */ }
Expand description

HTTP client configuration for remote object stores

Implementations§

source§

impl ClientOptions

source

pub fn new() -> Self

Create a new ClientOptions with default values

source

pub fn with_config(self, key: ClientConfigKey, value: impl Into<String>) -> Self

Set an option by key

source

pub fn get_config_value(&self, key: &ClientConfigKey) -> Option<String>

Get an option by key

source

pub fn with_user_agent(self, agent: HeaderValue) -> Self

Sets the User-Agent header to be used by this client

Default is based on the version of this crate

source

pub fn with_default_content_type(self, mime: impl Into<String>) -> Self

Set the default CONTENT_TYPE for uploads

source

pub fn with_content_type_for_suffix( self, extension: impl Into<String>, mime: impl Into<String> ) -> Self

Set the CONTENT_TYPE for a given file extension

source

pub fn with_default_headers(self, headers: HeaderMap) -> Self

Sets the default headers for every request

source

pub fn with_allow_http(self, allow_http: bool) -> Self

Sets what protocol is allowed. If allow_http is :

  • false (default): Only HTTPS are allowed
  • true: HTTP and HTTPS are allowed
source

pub fn with_allow_invalid_certificates(self, allow_insecure: bool) -> Self

Allows connections to invalid SSL certificates

  • false (default): Only valid HTTPS certificates are allowed
  • true: All HTTPS certificates are allowed
Warning

You should think very carefully before using this method. If invalid certificates are trusted, any certificate for any site will be trusted for use. This includes expired certificates. This introduces significant vulnerabilities, and should only be used as a last resort or for testing

source

pub fn with_http1_only(self) -> Self

Only use http1 connections

source

pub fn with_http2_only(self) -> Self

Only use http2 connections

source

pub fn with_proxy_url(self, proxy_url: impl Into<String>) -> Self

Set a proxy URL to use for requests

source

pub fn with_proxy_ca_certificate( self, proxy_ca_certificate: impl Into<String> ) -> Self

Set a trusted proxy CA certificate

source

pub fn with_proxy_excludes(self, proxy_excludes: impl Into<String>) -> Self

Set a list of hosts to exclude from proxy connections

source

pub fn with_timeout(self, timeout: Duration) -> Self

Set a request timeout

The timeout is applied from when the request starts connecting until the response body has finished

source

pub fn with_connect_timeout(self, timeout: Duration) -> Self

Set a timeout for only the connect phase of a Client

source

pub fn with_pool_idle_timeout(self, timeout: Duration) -> Self

Set the pool max idle timeout

This is the length of time an idle connection will be kept alive

Default is 90 seconds

source

pub fn with_pool_max_idle_per_host(self, max: usize) -> Self

Set the maximum number of idle connections per host

Default is no limit

source

pub fn with_http2_keep_alive_interval(self, interval: Duration) -> Self

Sets an interval for HTTP2 Ping frames should be sent to keep a connection alive.

Default is disabled

source

pub fn with_http2_keep_alive_timeout(self, interval: Duration) -> Self

Sets a timeout for receiving an acknowledgement of the keep-alive ping.

If the ping is not acknowledged within the timeout, the connection will be closed. Does nothing if http2_keep_alive_interval is disabled.

Default is disabled

source

pub fn with_http2_keep_alive_while_idle(self) -> Self

Enable HTTP2 keep alive pings for idle connections

If disabled, keep-alive pings are only sent while there are open request/response streams. If enabled, pings are also sent when no streams are active

Default is disabled

source

pub fn get_content_type(&self, path: &Path) -> Option<&str>

Get the mime type for the file in path to be uploaded

Gets the file extension from path, and returns the mime type if it was defined initially through ClientOptions::with_content_type_for_suffix

Otherwise returns the default mime type if it was defined earlier through ClientOptions::with_default_content_type

Trait Implementations§

source§

impl Clone for ClientOptions

source§

fn clone(&self) -> ClientOptions

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for ClientOptions

source§

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

Formats the value using the given formatter. Read more
source§

impl Default for ClientOptions

source§

fn default() -> ClientOptions

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

Auto Trait Implementations§

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.

source§

impl<T> Instrument for T

source§

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

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

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> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

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

§

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>,

§

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<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

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

fn with_current_subscriber(self) -> WithDispatch<Self>

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