Struct FailoverManager 

pub struct FailoverManager { /* private fields */ }

Failover manager for multiple XAI endpoints.

Manages automatic failover between multiple XAI API endpoints, tracking health and rotating on failures.

Examples

use api_xai::{ FailoverManager, FailoverConfig };

let manager = FailoverManager::new(
  vec![
    "https://api.x.ai/v1/".to_string(),
    "https://api-backup.x.ai/v1/".to_string(),
  ],
  FailoverConfig::default()
);

// Get current endpoint
let endpoint = manager.current_endpoint();

Implementations

impl FailoverManager

pub fn new(endpoints: Vec<String>, config: FailoverConfig) -> Self

Creates a new failover manager with multiple endpoints.

Arguments

• endpoints - List of base URLs for XAI API endpoints
• config - Failover configuration

Panics

Panics if endpoints list is empty.

Examples

use api_xai::{ FailoverManager, FailoverConfig };

let manager = FailoverManager::new(
  vec![ "https://api.x.ai/v1/".to_string() ],
  FailoverConfig::default()
);

pub fn current_endpoint(&self) -> String

Returns the current endpoint URL.

Examples

use api_xai::{ FailoverManager, FailoverConfig };

let manager = FailoverManager::new(
  vec![ "https://api.x.ai/v1/".to_string() ],
  FailoverConfig::default()
);

let endpoint = manager.current_endpoint();

Panics

Panics if the internal mutex is poisoned.

pub fn record_success(&self)

Records a successful request to current endpoint.

Resets failure counter and marks endpoint as healthy.

Panics

Panics if the internal mutex is poisoned.

pub fn record_failure(&self) -> bool

Records a failed request to current endpoint.

Increments failure counter and may trigger rotation if configured.

Returns

true if endpoint was rotated, false otherwise.

Panics

Panics if the internal mutex is poisoned.

pub fn rotate(&self)

Manually rotates to next available endpoint.

Skips unhealthy endpoints unless all are unhealthy.

Examples

use api_xai::{ FailoverManager, FailoverConfig };

let manager = FailoverManager::new(
  vec![
    "https://api.x.ai/v1/".to_string(),
    "https://backup.x.ai/v1/".to_string(),
  ],
  FailoverConfig::default()
);

manager.rotate();

Panics

Panics if the internal mutex is poisoned.

pub fn endpoint_health(&self) -> Vec<(String, EndpointHealth)>

Returns health status of all endpoints.

Examples

use api_xai::{ FailoverManager, FailoverConfig };

let manager = FailoverManager::new(
  vec![ "https://api.x.ai/v1/".to_string() ],
  FailoverConfig::default()
);

let health = manager.endpoint_health();

Panics

Panics if the internal mutex is poisoned.

pub fn current_index(&self) -> usize

Returns index of current endpoint.

Panics

Panics if the internal mutex is poisoned.

pub fn endpoint_count(&self) -> usize

Returns total number of endpoints.

Panics

Panics if the internal mutex is poisoned.

pub fn reset(&self)

Resets all endpoints to healthy state.

Panics

Panics if the internal mutex is poisoned.

Trait Implementations

impl Clone for FailoverManager

fn clone(&self) -> FailoverManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FailoverManager

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

Formats the value using the given formatter.