financial_api/a_share/
auction.rs1use crate::endpoints;
2use crate::endpoints::join_a_share_codes;
3use crate::{
4 AShareCode, AuctionBenchmarkData, AuctionSnapshotData, AuctionStage, Client, Error,
5 NaturalDate, OptionalInput, Response, ValidationError,
6};
7
8impl Client {
9 #[doc = concat!(
13 "```no_run\n",
14 include_str!("../../examples/a_share_auction_snapshot.rs"),
15 "\n```"
16 )]
17 pub async fn a_share_auction_snapshot(
18 &self,
19 thscodes: impl IntoIterator<Item = impl TryInto<AShareCode, Error: Into<ValidationError>>>,
20 stage: AuctionStage,
21 ) -> Result<Response<AuctionSnapshotData>, Error> {
22 let query = [
23 ("thscodes", join_a_share_codes(thscodes, None)?),
24 ("stage", stage.to_string()),
25 ];
26 self.get(endpoints::AUCTION_SNAPSHOT, &query).await
27 }
28
29 #[doc = concat!(
33 "```no_run\n",
34 include_str!("../../examples/a_share_auction_short_term_benchmark.rs"),
35 "\n```"
36 )]
37 pub async fn a_share_auction_short_term_benchmark(
38 &self,
39 date: impl TryInto<OptionalInput<NaturalDate>, Error: Into<ValidationError>>,
40 ) -> Result<Response<AuctionBenchmarkData>, Error> {
41 let date: OptionalInput<NaturalDate> = date.try_into().map_err(Into::into)?;
42 let query = date
43 .into_inner()
44 .map(|date| vec![("date", date.to_string())])
45 .unwrap_or_default();
46 self.get(endpoints::AUCTION_BENCHMARK, &query).await
47 }
48}
49
50#[cfg(test)]
51mod tests {
52 use super::*;
53 use crate::ApiKey;
54
55 #[tokio::test]
56 async fn snapshot_requires_at_least_one_target_before_transport() {
57 let client = Client::builder(ApiKey::new("test-api-key").unwrap())
58 .base_url("http://127.0.0.1:9")
59 .build()
60 .unwrap();
61
62 let error = client
63 .a_share_auction_snapshot([] as [&str; 0], AuctionStage::Final)
64 .await
65 .unwrap_err();
66
67 assert!(matches!(error, Error::InvalidInput(_)));
68 }
69}