rippling_api/
leave_types.rs

1use anyhow::Result;
2
3use crate::Client;
4#[derive(Clone, Debug)]
5pub struct LeaveTypes {
6    pub client: Client,
7}
8
9impl LeaveTypes {
10    #[doc(hidden)]
11    pub fn new(client: Client) -> Self {
12        Self { client }
13    }
14
15    #[doc = "List leave types\n\nA List of leave types\n- Requires: `API Tier 2`\n- Filterable \
16             fields: `name`\n- Sortable fields: `id`, `created_at`, \
17             `updated_at`\n\n**Parameters:**\n\n- `cursor: Option<String>`\n- `filter: \
18             Option<String>`\n- `order_by: Option<String>`\n\n```rust,no_run\nuse \
19             futures_util::TryStreamExt;\nasync fn example_leave_types_list_stream() -> \
20             anyhow::Result<()> {\n    let client = rippling_api::Client::new_from_env();\n    let \
21             mut leave_types = client.leave_types();\n    let mut stream = \
22             leave_types.list_stream(\n        Some(\"some-string\".to_string()),\n        \
23             Some(\"some-string\".to_string()),\n    );\n    loop {\n        match \
24             stream.try_next().await {\n            Ok(Some(item)) => {\n                \
25             println!(\"{:?}\", item);\n            }\n            Ok(None) => {\n                \
26             break;\n            }\n            Err(err) => {\n                return \
27             Err(err.into());\n            }\n        }\n    }\n\n    Ok(())\n}\n```"]
28    #[tracing::instrument]
29    pub async fn list<'a>(
30        &'a self,
31        cursor: Option<String>,
32        filter: Option<String>,
33        order_by: Option<String>,
34    ) -> Result<crate::types::ListLeaveTypesResponse, crate::types::error::Error> {
35        let mut req = self.client.client.request(
36            http::Method::GET,
37            format!("{}/{}", self.client.base_url, "leave-types"),
38        );
39        req = req.bearer_auth(&self.client.token);
40        let mut query_params = vec![];
41        if let Some(p) = cursor {
42            query_params.push(("cursor", p));
43        }
44
45        if let Some(p) = filter {
46            query_params.push(("filter", p));
47        }
48
49        if let Some(p) = order_by {
50            query_params.push(("order_by", p));
51        }
52
53        req = req.query(&query_params);
54        let resp = req.send().await?;
55        let status = resp.status();
56        if status.is_success() {
57            let text = resp.text().await.unwrap_or_default();
58            serde_json::from_str(&text).map_err(|err| {
59                crate::types::error::Error::from_serde_error(
60                    format_serde_error::SerdeError::new(text.to_string(), err),
61                    status,
62                )
63            })
64        } else {
65            let text = resp.text().await.unwrap_or_default();
66            Err(crate::types::error::Error::Server {
67                body: text.to_string(),
68                status,
69            })
70        }
71    }
72
73    #[doc = "List leave types\n\nA List of leave types\n- Requires: `API Tier 2`\n- Filterable \
74             fields: `name`\n- Sortable fields: `id`, `created_at`, \
75             `updated_at`\n\n**Parameters:**\n\n- `cursor: Option<String>`\n- `filter: \
76             Option<String>`\n- `order_by: Option<String>`\n\n```rust,no_run\nuse \
77             futures_util::TryStreamExt;\nasync fn example_leave_types_list_stream() -> \
78             anyhow::Result<()> {\n    let client = rippling_api::Client::new_from_env();\n    let \
79             mut leave_types = client.leave_types();\n    let mut stream = \
80             leave_types.list_stream(\n        Some(\"some-string\".to_string()),\n        \
81             Some(\"some-string\".to_string()),\n    );\n    loop {\n        match \
82             stream.try_next().await {\n            Ok(Some(item)) => {\n                \
83             println!(\"{:?}\", item);\n            }\n            Ok(None) => {\n                \
84             break;\n            }\n            Err(err) => {\n                return \
85             Err(err.into());\n            }\n        }\n    }\n\n    Ok(())\n}\n```"]
86    #[tracing::instrument]
87    #[cfg(not(feature = "js"))]
88    pub fn list_stream<'a>(
89        &'a self,
90        filter: Option<String>,
91        order_by: Option<String>,
92    ) -> impl futures::Stream<Item = Result<crate::types::LeaveType, crate::types::error::Error>>
93           + Unpin
94           + '_ {
95        use futures::{StreamExt, TryFutureExt, TryStreamExt};
96
97        use crate::types::paginate::Pagination;
98        self.list(None, filter, order_by)
99            .map_ok(move |result| {
100                let items = futures::stream::iter(result.items().into_iter().map(Ok));
101                let next_pages = futures::stream::try_unfold(
102                    (None, result),
103                    move |(prev_page_token, new_result)| async move {
104                        if new_result.has_more_pages()
105                            && !new_result.items().is_empty()
106                            && prev_page_token != new_result.next_page_token()
107                        {
108                            async {
109                                let mut req = self.client.client.request(
110                                    http::Method::GET,
111                                    format!("{}/{}", self.client.base_url, "leave-types"),
112                                );
113                                req = req.bearer_auth(&self.client.token);
114                                let mut request = req.build()?;
115                                request = new_result.next_page(request)?;
116                                let resp = self.client.client.execute(request).await?;
117                                let status = resp.status();
118                                if status.is_success() {
119                                    let text = resp.text().await.unwrap_or_default();
120                                    serde_json::from_str(&text).map_err(|err| {
121                                        crate::types::error::Error::from_serde_error(
122                                            format_serde_error::SerdeError::new(
123                                                text.to_string(),
124                                                err,
125                                            ),
126                                            status,
127                                        )
128                                    })
129                                } else {
130                                    let text = resp.text().await.unwrap_or_default();
131                                    Err(crate::types::error::Error::Server {
132                                        body: text.to_string(),
133                                        status,
134                                    })
135                                }
136                            }
137                            .map_ok(|result: crate::types::ListLeaveTypesResponse| {
138                                Some((
139                                    futures::stream::iter(result.items().into_iter().map(Ok)),
140                                    (new_result.next_page_token(), result),
141                                ))
142                            })
143                            .await
144                        } else {
145                            Ok(None)
146                        }
147                    },
148                )
149                .try_flatten();
150                items.chain(next_pages)
151            })
152            .try_flatten_stream()
153            .boxed()
154    }
155
156    #[doc = "Retrieve a specific leave type\n\nRetrieve a specific leave type\n\n**Parameters:**\n\n- `id: &'astr`: ID of the resource to return (required)\n\n```rust,no_run\nasync fn example_leave_types_get() -> anyhow::Result<()> {\n    let client = rippling_api::Client::new_from_env();\n    let result: rippling_api::types::GetLeaveTypesResponse = client\n        .leave_types()\n        .get(\"d9797f8d-9ad6-4e08-90d7-2ec17e13471c\")\n        .await?;\n    println!(\"{:?}\", result);\n    Ok(())\n}\n```"]
157    #[tracing::instrument]
158    pub async fn get<'a>(
159        &'a self,
160        id: &'a str,
161    ) -> Result<crate::types::GetLeaveTypesResponse, crate::types::error::Error> {
162        let mut req = self.client.client.request(
163            http::Method::GET,
164            format!(
165                "{}/{}",
166                self.client.base_url,
167                "leave-types/{id}".replace("{id}", id)
168            ),
169        );
170        req = req.bearer_auth(&self.client.token);
171        let resp = req.send().await?;
172        let status = resp.status();
173        if status.is_success() {
174            let text = resp.text().await.unwrap_or_default();
175            serde_json::from_str(&text).map_err(|err| {
176                crate::types::error::Error::from_serde_error(
177                    format_serde_error::SerdeError::new(text.to_string(), err),
178                    status,
179                )
180            })
181        } else {
182            let text = resp.text().await.unwrap_or_default();
183            Err(crate::types::error::Error::Server {
184                body: text.to_string(),
185                status,
186            })
187        }
188    }
189}