Struct TushareRequest 

pub struct TushareRequest {
    pub api_name: Api,
    pub params: HashMap<String, String>,
    pub fields: Vec<String>,
}

Tushare API request structure

Supports flexible string type usage, allowing direct use of string literals and String variables

Fields

api_name: Api

params: HashMap<String, String>

fields: Vec<String>

Implementations

impl TushareRequest

pub fn new<K, V, F, P, Fs>(api_name: Api, params: P, fields: Fs) -> Self

where K: Into<String>, V: Into<String>, F: Into<String>, P: IntoIterator<Item = (K, V)>, Fs: IntoIterator<Item = F>,

Create a new TushareRequest

Examples found in repository

examples/custom_type_example.rs (lines 119-129)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Set up logging
    env_logger::init();
    
    // Create client from environment variable
    let client = TushareClient::from_env()?;
    
    // Create request for daily stock data
    let request = TushareRequest::new(
        Api::Daily,
        params![
            "ts_code" => "000001.SZ",
            "start_date" => "20240101",
            "end_date" => "20240131"
        ],
        fields![
            "ts_code", "trade_date", "open", "high", "low", "close", "vol", "amount"
        ]
    );
    
    println!("Fetching daily stock data with custom Decimal types...");
    
    // Call API and get typed response with automatic conversion
    let stock_prices: TushareEntityList<StockPrice> = client.call_api_as(request).await?;
    
    println!("Retrieved {} stock price records", stock_prices.len());
    println!("Has more data: {}", stock_prices.has_more());
    println!("Total count: {}", stock_prices.count());
    
    // Display first few records
    for (i, price) in stock_prices.iter().take(5).enumerate() {
        println!("\nRecord {}:", i + 1);
        println!("  Stock Code: {}", price.ts_code);
        println!("  Trade Date: {}", price.trade_date);
        println!("  Open Price: {}", price.open_price);
        println!("  High Price: {}", price.high_price);
        println!("  Low Price: {}", price.low_price);
        println!("  Close Price: {}", price.close_price);
        
        if let Some(vol) = &price.volume {
            println!("  Volume: {}", vol);
        }
        
        if let Some(amount) = &price.amount {
            println!("  Amount: {}", amount);
        }
    }
    
    Ok(())
}

pub fn with_str_params<const N: usize>( api_name: Api, params: [(&str, &str); N], fields: &[&str], ) -> Self

Create parameters from string literals

pub fn add_param<K: Into<String>, V: Into<String>>( self, key: K, value: V, ) -> Self

Add parameter

pub fn add_field<F: Into<String>>(self, field: F) -> Self

Add field

Trait Implementations

impl Clone for TushareRequest

fn clone(&self) -> TushareRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TushareRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TushareRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TushareRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&&str> for TushareRequest

type Error = TushareError

The type returned in the event of a conversion error.

fn try_from(value: &&str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&String> for TushareRequest

type Error = TushareError

The type returned in the event of a conversion error.

fn try_from(value: &String) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&TushareRequest> for TushareRequest

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: &TushareRequest) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&str> for TushareRequest

type Error = TushareError

The type returned in the event of a conversion error.

fn try_from(value: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for TushareRequest

type Error = TushareError

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, Self::Error>

Performs the conversion.