Struct ClientConfig 

pub struct ClientConfig { /* private fields */ }

Configuration for Ollama HTTP client

This struct allows customization of the HTTP client behavior including base URL, timeout, and retry settings. All constructors validate that the base URL is well-formed and uses http or https scheme.

Examples

use ollama_oxide::ClientConfig;
use std::time::Duration;

// Use default configuration (http://localhost:11434)
let config = ClientConfig::default();

// Custom configuration
let config = ClientConfig::new(
    "http://example.com:8080".to_string(),
    Duration::from_secs(60),
    5,
)?;

// Just a custom URL
let config = ClientConfig::with_base_url("http://example.com:8080".to_string())?;

Implementations

impl ClientConfig

pub fn new( base_url: String, timeout: Duration, max_retries: u32, ) -> Result<Self>

Creates a new ClientConfig with all attributes specified.

Errors

Returns an error if the base URL is invalid or uses an unsupported scheme.

Examples

use ollama_oxide::ClientConfig;
use std::time::Duration;

let config = ClientConfig::new(
    "http://example.com:8080".to_string(),
    Duration::from_secs(60),
    5,
)?;

pub fn with_base_url(base_url: String) -> Result<Self>

Creates a new ClientConfig with only base_url, using defaults for timeout (30s) and max_retries (3).

Errors

Returns an error if the base URL is invalid or uses an unsupported scheme.

Examples

use ollama_oxide::ClientConfig;

let config = ClientConfig::with_base_url("http://example.com:8080".to_string())?;
assert_eq!(config.timeout(), std::time::Duration::from_secs(30));
assert_eq!(config.max_retries(), 3);

pub fn with_base_url_and_timeout( base_url: String, timeout: Duration, ) -> Result<Self>

Creates a new ClientConfig with base_url and timeout, using the default max_retries (3).

Errors

Returns an error if the base URL is invalid or uses an unsupported scheme.

Examples

use ollama_oxide::ClientConfig;
use std::time::Duration;

let config = ClientConfig::with_base_url_and_timeout(
    "http://example.com:8080".to_string(),
    Duration::from_secs(60),
)?;
assert_eq!(config.max_retries(), 3);

pub fn base_url(&self) -> &str

Returns the base URL

pub fn timeout(&self) -> Duration

Returns the request timeout duration

pub fn max_retries(&self) -> u32

Returns the maximum retry attempts

pub fn url(&self, endpoint: &str) -> String

Build full URL from base URL and endpoint path

Examples

use ollama_oxide::ClientConfig;

let config = ClientConfig::default();
let url = config.url("/api/version");
assert_eq!(url, "http://localhost:11434/api/version");

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfig

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

Formats the value using the given formatter.

impl Default for ClientConfig

fn default() -> Self

Returns the “default value” for a type.