Struct TushareClientEx 

pub struct TushareClientEx { /* private fields */ }

Extended client wrapper that adds advanced behaviors on top of TushareClient.

Currently supported:

• Per-API minimum interval rate limiting (default: sleep) If an API is configured with a minimum interval (e.g. 10 seconds), repeated calls to the same API will be automatically delayed so that two calls are at least min_interval apart. Callers do not need to implement any sleep logic.

• Retry with exponential backoff (optional) When enabled via Self::with_retry_config, network/timeout failures will be retried with exponential backoff.

This wrapper is designed to keep the core client stable while allowing you to opt into additional behaviors.

Implementations

impl TushareClientEx

pub fn new(inner: TushareClient) -> Self

Create a new wrapper client.

By default, no per-API interval limit is applied and retry is disabled.

pub fn with_api_min_interval(self, api: Api, min_interval: Duration) -> Self

Configure a minimum interval between two calls of the same API.

If the interval is not met, the wrapper will sleep until it becomes eligible to call.

Example:

use std::time::Duration;
use tushare_api::{Api, TushareClient, TushareClientEx};

TushareClientEx::new(inner)
    .with_api_min_interval(Api::Daily, Duration::from_secs(10))

pub fn with_retry_config(self, config: RetryConfig) -> Self

Enable retry with exponential backoff.

Retryable errors:

• TushareError::HttpError
• TushareError::TimeoutError

Non-retryable errors (by design):

• TushareError::ApiError (business-level errors returned by Tushare)

pub fn inner(&self) -> &TushareClient

Borrow the underlying TushareClient.

pub fn into_inner(self) -> TushareClient

Consume the wrapper and return the underlying TushareClient.

pub async fn call_api<T>(&self, request: &T) -> TushareResult<TushareResponse>

where for<'a> &'a T: TryInto<TushareRequest>, for<'a> <&'a T as TryInto<TushareRequest>>::Error: Into<TushareError>,

Call API with configured rate limiting (sleep) and optional retry.

pub async fn call_api_as<T, R>( &self, request: &R, ) -> TushareResult<TushareEntityList<T>>

where T: FromTushareData, for<'a> &'a R: TryInto<TushareRequest>, for<'a> <&'a R as TryInto<TushareRequest>>::Error: Into<TushareError>,

Trait Implementations

impl Debug for TushareClientEx

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

Formats the value using the given formatter.