financial_api/a_share/
corporate_actions.rs1use crate::endpoints;
2use crate::{AShareCode, AdjustmentFactorsData, Client, Error, NaturalDate, Response};
3
4use super::validate_date_order;
5
6impl Client {
7 #[doc = concat!(
11 "```no_run\n",
12 include_str!("../../examples/corp_actions_adjustment_factors.rs"),
13 "\n```"
14 )]
15 pub async fn corp_actions_adjustment_factors(
16 &self,
17 thscode: impl AsRef<str> + Send,
18 from: Option<&str>,
19 to: Option<&str>,
20 ) -> Result<Response<AdjustmentFactorsData>, Error> {
21 let thscode = AShareCode::new(thscode)?;
22 let from = from.map(NaturalDate::parse).transpose()?;
23 let to = to.map(NaturalDate::parse).transpose()?;
24 let mut query = vec![("thscode", thscode.into_string())];
25 if let (Some(from), Some(to)) = (from, to) {
26 validate_date_order(from, to, "to")?;
27 }
28 if let Some(from) = from {
29 query.push(("from", from.to_string()));
30 }
31 if let Some(to) = to {
32 query.push(("to", to.to_string()));
33 }
34 self.get(endpoints::ADJUSTMENT_FACTORS, &query).await
35 }
36}
37
38#[cfg(test)]
39mod tests {
40 use super::*;
41 use crate::ApiKey;
42
43 #[tokio::test]
44 async fn adjustment_factors_rejects_reversed_dates_before_transport() {
45 let client = Client::builder(ApiKey::new("test-api-key").unwrap())
46 .base_url("http://127.0.0.1:9")
47 .build()
48 .unwrap();
49 let stock = AShareCode::new("600519.SH").unwrap();
50
51 let error = client
52 .corp_actions_adjustment_factors(&stock, Some("2026-08-25"), Some("2026-08-24"))
53 .await
54 .unwrap_err();
55
56 let Error::InvalidInput(error) = error else {
57 panic!("expected an invalid corporate-action date range");
58 };
59 assert_eq!(error.field(), "to");
60 }
61}