use crate::endpoints;
use crate::{
Client, Error, FundDrawdownsData, FundIndicatorHistoryData, FundNavData, FundNavType,
FundRange, FundReturnsData, FundType, Response, Thscode, UnixMillis, ValidationError,
};
use super::{fund_target_query, validate_history_range};
impl Client {
#[doc = concat!(
"```no_run\n",
include_str!("../../examples/fund_performance_nav.rs"),
"\n```"
)]
pub async fn fund_performance_nav(
&self,
fund_type: FundType,
thscode: impl TryInto<Thscode, Error: Into<ValidationError>>,
range: Option<FundRange>,
nav_type: FundNavType,
) -> Result<Response<FundNavData>, Error> {
let mut query = fund_target_query(fund_type, thscode)?;
if let Some(range) = range {
query.push(("range", range.to_string()));
}
query.push(("nav_type", nav_type.to_string()));
self.get(endpoints::FUND_NAV, &query).await
}
#[doc = concat!(
"```no_run\n",
include_str!("../../examples/fund_performance_returns.rs"),
"\n```"
)]
pub async fn fund_performance_returns(
&self,
fund_type: FundType,
thscode: impl TryInto<Thscode, Error: Into<ValidationError>>,
) -> Result<Response<FundReturnsData>, Error> {
self.fund_detail(endpoints::FUND_RETURNS, fund_type, thscode)
.await
}
#[doc = concat!(
"```no_run\n",
include_str!("../../examples/fund_performance_indicators_historical.rs"),
"\n```"
)]
pub async fn fund_performance_indicators_historical(
&self,
fund_type: FundType,
thscode: impl TryInto<Thscode, Error: Into<ValidationError>>,
start: impl TryInto<UnixMillis, Error: Into<ValidationError>>,
end: impl TryInto<UnixMillis, Error: Into<ValidationError>>,
) -> Result<Response<FundIndicatorHistoryData>, Error> {
let mut query = fund_target_query(fund_type, thscode)?;
let start: UnixMillis = start.try_into().map_err(Into::into)?;
let end: UnixMillis = end.try_into().map_err(Into::into)?;
validate_history_range(start, end)?;
query.push(("start", start.to_string()));
query.push(("end", end.to_string()));
self.get(endpoints::FUND_INDICATORS_HISTORICAL, &query)
.await
}
#[doc = concat!(
"```no_run\n",
include_str!("../../examples/fund_performance_drawdowns.rs"),
"\n```"
)]
pub async fn fund_performance_drawdowns(
&self,
fund_type: FundType,
thscode: impl TryInto<Thscode, Error: Into<ValidationError>>,
) -> Result<Response<FundDrawdownsData>, Error> {
self.fund_detail(endpoints::FUND_DRAWDOWNS, fund_type, thscode)
.await
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::ApiKey;
#[tokio::test]
async fn historical_indicators_keeps_range_validation_on_its_call_edge() {
let client = Client::builder(ApiKey::new("test-api-key").unwrap())
.base_url("http://127.0.0.1:9")
.build()
.unwrap();
let error = client
.fund_performance_indicators_historical(
FundType::Otc,
"025480.OF",
1_577_836_800_000,
1_735_776_000_000,
)
.await
.unwrap_err();
assert!(matches!(error, Error::InvalidInput(_)));
}
}