Struct deltalake::storage::object_store::ClientOptions

pub struct ClientOptions { /* private fields */ }

HTTP client configuration for remote object stores

Implementations

impl ClientOptions

pub fn new() -> ClientOptions

Create a new ClientOptions with default values

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

Set an option by key

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

Get an option by key

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

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

Default is based on the version of this crate

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

Set the default CONTENT_TYPE for uploads

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

Set the CONTENT_TYPE for a given file extension

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

Sets the default headers for every request

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

Sets what protocol is allowed. If allow_http is :

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

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

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

pub fn with_http1_only(self) -> ClientOptions

Only use http1 connections

This is on by default, since http2 is known to be significantly slower than http1.

pub fn with_http2_only(self) -> ClientOptions

Only use http2 connections

pub fn with_allow_http2(self) -> ClientOptions

Use http2 if supported, otherwise use http1.

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

Set a proxy URL to use for requests

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

Set a trusted proxy CA certificate

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

Set a list of hosts to exclude from proxy connections

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

Set a request timeout

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

Default is 5 seconds

pub fn with_timeout_disabled(self) -> ClientOptions

Disables the request timeout

See Self::with_timeout

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

Set a timeout for only the connect phase of a Client

Default is 5 seconds

pub fn with_connect_timeout_disabled(self) -> ClientOptions

Disables the connection timeout

See Self::with_connect_timeout

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

Set the pool max idle timeout

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

Default is 90 seconds

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

Set the maximum number of idle connections per host

Default is no limit

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

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

Default is disabled

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

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

pub fn with_http2_keep_alive_while_idle(self) -> ClientOptions

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

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

impl Clone for ClientOptions

fn clone(&self) -> ClientOptions

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ClientOptions

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

Formats the value using the given formatter.

impl Default for ClientOptions

fn default() -> ClientOptions

Returns the “default value” for a type.