Skip to main content

twilight_http/request/sticker/
get_sticker_pack.rs

1use crate::{
2    client::Client,
3    error::Error,
4    request::{Request, TryIntoRequest},
5    response::{Response, ResponseFuture},
6    routing::Route,
7};
8use std::future::IntoFuture;
9use twilight_model::{
10    channel::message::sticker::StickerPack,
11    id::{Id, marker::StickerPackMarker},
12};
13
14/// Get a sticker pack by its ID.
15///
16/// # Examples
17///
18/// ```no_run
19/// use std::env;
20/// use twilight_http::Client;
21/// use twilight_model::id::Id;
22///
23/// # #[tokio::main]
24/// # async fn main() -> Result<(), Box<dyn std::error::Error>> {
25/// let client = Client::new(env::var("DISCORD_TOKEN")?);
26///
27/// let id = Id::new(123);
28/// let sticker_pack = client.sticker_pack(id).await?.model().await?;
29///
30/// println!("Sticker pack name: {}", sticker_pack.name);
31/// println!("Sticker pack item names:");
32///
33/// for sticker in sticker_pack.stickers {
34///     println!("- {}", sticker.name);
35/// }
36/// # Ok(()) }
37/// ```
38#[must_use = "requests must be configured and executed"]
39pub struct GetStickerPack<'a> {
40    http: &'a Client,
41    sticker_pack_id: Id<StickerPackMarker>,
42}
43
44impl<'a> GetStickerPack<'a> {
45    pub(crate) const fn new(http: &'a Client, sticker_pack_id: Id<StickerPackMarker>) -> Self {
46        Self {
47            http,
48            sticker_pack_id,
49        }
50    }
51}
52
53impl IntoFuture for GetStickerPack<'_> {
54    type Output = Result<Response<StickerPack>, Error>;
55
56    type IntoFuture = ResponseFuture<StickerPack>;
57
58    fn into_future(self) -> Self::IntoFuture {
59        let http = self.http;
60
61        match self.try_into_request() {
62            Ok(request) => http.request(request),
63            Err(source) => ResponseFuture::error(source),
64        }
65    }
66}
67
68impl TryIntoRequest for GetStickerPack<'_> {
69    fn try_into_request(self) -> Result<Request, Error> {
70        Ok(Request::from_route(&Route::GetStickerPack {
71            sticker_pack_id: self.sticker_pack_id.get(),
72        }))
73    }
74}