Struct RestCatalogConfig 

pub struct RestCatalogConfig { /* private fields */ }

REST catalog configuration.

Construction validates the endpoint and all resource ceilings. Credentials are deliberately omitted from Debug.

Implementations

impl RestCatalogConfig

pub fn new(base_url: impl AsRef<str>) -> CatalogResult<Self>

Create a validated configuration for an Iceberg REST catalog.

pub fn with_warehouse(self, warehouse: impl Into<String>) -> CatalogResult<Self>

Select the warehouse passed to the mandatory /v1/config request.

pub fn with_catalog_prefix( self, prefix: impl Into<String>, ) -> CatalogResult<Self>

Supply a client-side catalog prefix.

Server defaults are applied first and server overrides are applied last, as required by the Iceberg REST configuration contract.

pub fn with_bearer_token(self, token: impl Into<String>) -> CatalogResult<Self>

Attach a bearer token to configuration and catalog requests.

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

Set the end-to-end request timeout.

pub fn with_page_size(self, page_size: u32) -> CatalogResult<Self>

Set the requested list page size.

pub fn with_max_response_bytes(self, limit: usize) -> CatalogResult<Self>

Set the maximum successful response body retained in memory.

pub fn base_url(&self) -> &Url

pub fn warehouse(&self) -> Option<&str>

pub fn catalog_prefix(&self) -> Option<&str>

pub fn timeout(&self) -> Duration

pub fn page_size(&self) -> u32

pub fn max_response_bytes(&self) -> usize

Trait Implementations

impl Clone for RestCatalogConfig

fn clone(&self) -> RestCatalogConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RestCatalogConfig

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

Formats the value using the given formatter.