1use crate::Client;
2use anyhow::Result;
3#[derive(Clone, Debug)]
4pub struct SavedViews {
5 pub client: Client,
6}
7
8impl SavedViews {
9 #[doc(hidden)]
10 pub fn new(client: Client) -> Self {
11 Self { client }
12 }
13
14 #[doc = "Perform a `GET` request to `/api/saved_views/`.\n\n**Parameters:**\n\n- `page: Option<i64>`: A page number within the paginated result set.\n- `page_size: Option<i64>`: Number of results to return per page.\n\n```rust,no_run\nuse futures_util::TryStreamExt;\nasync fn example_saved_views_list_stream() -> anyhow::Result<()> {\n let client = paperless_api_client::Client::new_from_env();\n let mut saved_views = client.saved_views();\n let mut stream = saved_views.list_stream(Some(4 as i64));\n loop {\n match stream.try_next().await {\n Ok(Some(item)) => {\n println!(\"{:?}\", item);\n }\n Ok(None) => {\n break;\n }\n Err(err) => {\n return Err(err.into());\n }\n }\n }\n\n Ok(())\n}\n```"]
15 #[tracing::instrument]
16 #[allow(non_snake_case)]
17 pub async fn list<'a>(
18 &'a self,
19 page: Option<i64>,
20 page_size: Option<i64>,
21 ) -> Result<crate::types::PaginatedSavedViewList, crate::types::error::Error> {
22 let mut req = self.client.client.request(
23 http::Method::GET,
24 format!("{}/{}", self.client.base_url, "api/saved_views/"),
25 );
26 req = req.header("Authorization", format!("Token {}", &self.client.token));
27 let mut query_params = vec![];
28 if let Some(p) = page {
29 query_params.push(("page", format!("{p}")));
30 }
31
32 if let Some(p) = page_size {
33 query_params.push(("page_size", format!("{p}")));
34 }
35
36 req = req.query(&query_params);
37 let resp = req.send().await?;
38 let status = resp.status();
39 if status.is_success() {
40 let text = resp.text().await.unwrap_or_default();
41 serde_json::from_str(&text).map_err(|err| {
42 crate::types::error::Error::from_serde_error(
43 format_serde_error::SerdeError::new(text.to_string(), err),
44 status,
45 )
46 })
47 } else {
48 let text = resp.text().await.unwrap_or_default();
49 Err(crate::types::error::Error::Server {
50 body: text.to_string(),
51 status,
52 })
53 }
54 }
55
56 #[doc = "Perform a `GET` request to `/api/saved_views/`.\n\n**Parameters:**\n\n- `page: Option<i64>`: A page number within the paginated result set.\n- `page_size: Option<i64>`: Number of results to return per page.\n\n```rust,no_run\nuse futures_util::TryStreamExt;\nasync fn example_saved_views_list_stream() -> anyhow::Result<()> {\n let client = paperless_api_client::Client::new_from_env();\n let mut saved_views = client.saved_views();\n let mut stream = saved_views.list_stream(Some(4 as i64));\n loop {\n match stream.try_next().await {\n Ok(Some(item)) => {\n println!(\"{:?}\", item);\n }\n Ok(None) => {\n break;\n }\n Err(err) => {\n return Err(err.into());\n }\n }\n }\n\n Ok(())\n}\n```"]
57 #[tracing::instrument]
58 #[cfg(not(feature = "js"))]
59 #[allow(non_snake_case)]
60 pub fn list_stream<'a>(
61 &'a self,
62 page_size: Option<i64>,
63 ) -> impl futures::Stream<Item = Result<crate::types::SavedView, crate::types::error::Error>>
64 + Unpin
65 + '_ {
66 use crate::types::paginate::Pagination;
67 use futures::{StreamExt, TryFutureExt, TryStreamExt};
68 self.list(None, page_size)
69 .map_ok(move |result| {
70 let items = futures::stream::iter(result.items().into_iter().map(Ok));
71 let next_pages = futures::stream::try_unfold(
72 (None, result),
73 move |(prev_page_token, new_result)| async move {
74 if new_result.has_more_pages()
75 && !new_result.items().is_empty()
76 && prev_page_token != new_result.next_page_token()
77 {
78 async {
79 let mut req = self.client.client.request(
80 http::Method::GET,
81 format!("{}/{}", self.client.base_url, "api/saved_views/"),
82 );
83 req = req.header(
84 "Authorization",
85 format!("Token {}", &self.client.token),
86 );
87 let mut request = req.build()?;
88 request = new_result.next_page(request)?;
89 let resp = self.client.client.execute(request).await?;
90 let status = resp.status();
91 if status.is_success() {
92 let text = resp.text().await.unwrap_or_default();
93 serde_json::from_str(&text).map_err(|err| {
94 crate::types::error::Error::from_serde_error(
95 format_serde_error::SerdeError::new(
96 text.to_string(),
97 err,
98 ),
99 status,
100 )
101 })
102 } else {
103 let text = resp.text().await.unwrap_or_default();
104 Err(crate::types::error::Error::Server {
105 body: text.to_string(),
106 status,
107 })
108 }
109 }
110 .map_ok(|result: crate::types::PaginatedSavedViewList| {
111 Some((
112 futures::stream::iter(result.items().into_iter().map(Ok)),
113 (new_result.next_page_token(), result),
114 ))
115 })
116 .await
117 } else {
118 Ok(None)
119 }
120 },
121 )
122 .try_flatten();
123 items.chain(next_pages)
124 })
125 .try_flatten_stream()
126 .boxed()
127 }
128
129 #[doc = "Perform a `POST` request to `/api/saved_views/`.\n\n```rust,no_run\nasync fn example_saved_views_create() -> anyhow::Result<()> {\n let client = paperless_api_client::Client::new_from_env();\n let result: paperless_api_client::types::SavedView = client\n .saved_views()\n .create(&paperless_api_client::types::SavedViewRequest {\n name: \"some-string\".to_string(),\n show_on_dashboard: true,\n show_in_sidebar: true,\n sort_field: Some(\"some-string\".to_string()),\n sort_reverse: Some(true),\n filter_rules: vec![paperless_api_client::types::SavedViewFilterRuleRequest {\n rule_type: 4 as i64,\n value: Some(\"some-string\".to_string()),\n }],\n page_size: Some(4 as i64),\n display_mode: Some(paperless_api_client::types::DisplayMode::LargeCards),\n display_fields: Some(serde_json::Value::String(\"some-string\".to_string())),\n owner: Some(4 as i64),\n })\n .await?;\n println!(\"{:?}\", result);\n Ok(())\n}\n```"]
130 #[tracing::instrument]
131 #[allow(non_snake_case)]
132 pub async fn create<'a>(
133 &'a self,
134 body: &crate::types::SavedViewRequest,
135 ) -> Result<crate::types::SavedView, crate::types::error::Error> {
136 let mut req = self.client.client.request(
137 http::Method::POST,
138 format!("{}/{}", self.client.base_url, "api/saved_views/"),
139 );
140 req = req.header("Authorization", format!("Token {}", &self.client.token));
141 req = req.json(body);
142 let resp = req.send().await?;
143 let status = resp.status();
144 if status.is_success() {
145 let text = resp.text().await.unwrap_or_default();
146 serde_json::from_str(&text).map_err(|err| {
147 crate::types::error::Error::from_serde_error(
148 format_serde_error::SerdeError::new(text.to_string(), err),
149 status,
150 )
151 })
152 } else {
153 let text = resp.text().await.unwrap_or_default();
154 Err(crate::types::error::Error::Server {
155 body: text.to_string(),
156 status,
157 })
158 }
159 }
160
161 #[doc = "Perform a `GET` request to `/api/saved_views/{id}/`.\n\n**Parameters:**\n\n- `id: i64`: A unique integer value identifying this saved view. (required)\n\n```rust,no_run\nasync fn example_saved_views_retrieve() -> anyhow::Result<()> {\n let client = paperless_api_client::Client::new_from_env();\n let result: paperless_api_client::types::SavedView = client.saved_views().retrieve(4 as i64).await?;\n println!(\"{:?}\", result);\n Ok(())\n}\n```"]
162 #[tracing::instrument]
163 #[allow(non_snake_case)]
164 pub async fn retrieve<'a>(
165 &'a self,
166 id: i64,
167 ) -> Result<crate::types::SavedView, crate::types::error::Error> {
168 let mut req = self.client.client.request(
169 http::Method::GET,
170 format!(
171 "{}/{}",
172 self.client.base_url,
173 "api/saved_views/{id}/".replace("{id}", &format!("{id}"))
174 ),
175 );
176 req = req.header("Authorization", format!("Token {}", &self.client.token));
177 let resp = req.send().await?;
178 let status = resp.status();
179 if status.is_success() {
180 let text = resp.text().await.unwrap_or_default();
181 serde_json::from_str(&text).map_err(|err| {
182 crate::types::error::Error::from_serde_error(
183 format_serde_error::SerdeError::new(text.to_string(), err),
184 status,
185 )
186 })
187 } else {
188 let text = resp.text().await.unwrap_or_default();
189 Err(crate::types::error::Error::Server {
190 body: text.to_string(),
191 status,
192 })
193 }
194 }
195
196 #[doc = "Perform a `PUT` request to `/api/saved_views/{id}/`.\n\n**Parameters:**\n\n- `id: i64`: A unique integer value identifying this saved view. (required)\n\n```rust,no_run\nasync fn example_saved_views_update() -> anyhow::Result<()> {\n let client = paperless_api_client::Client::new_from_env();\n let result: paperless_api_client::types::SavedView = client\n .saved_views()\n .update(\n 4 as i64,\n &paperless_api_client::types::SavedViewRequest {\n name: \"some-string\".to_string(),\n show_on_dashboard: true,\n show_in_sidebar: true,\n sort_field: Some(\"some-string\".to_string()),\n sort_reverse: Some(true),\n filter_rules: vec![paperless_api_client::types::SavedViewFilterRuleRequest {\n rule_type: 4 as i64,\n value: Some(\"some-string\".to_string()),\n }],\n page_size: Some(4 as i64),\n display_mode: Some(paperless_api_client::types::DisplayMode::LargeCards),\n display_fields: Some(serde_json::Value::String(\"some-string\".to_string())),\n owner: Some(4 as i64),\n },\n )\n .await?;\n println!(\"{:?}\", result);\n Ok(())\n}\n```"]
197 #[tracing::instrument]
198 #[allow(non_snake_case)]
199 pub async fn update<'a>(
200 &'a self,
201 id: i64,
202 body: &crate::types::SavedViewRequest,
203 ) -> Result<crate::types::SavedView, crate::types::error::Error> {
204 let mut req = self.client.client.request(
205 http::Method::PUT,
206 format!(
207 "{}/{}",
208 self.client.base_url,
209 "api/saved_views/{id}/".replace("{id}", &format!("{id}"))
210 ),
211 );
212 req = req.header("Authorization", format!("Token {}", &self.client.token));
213 req = req.json(body);
214 let resp = req.send().await?;
215 let status = resp.status();
216 if status.is_success() {
217 let text = resp.text().await.unwrap_or_default();
218 serde_json::from_str(&text).map_err(|err| {
219 crate::types::error::Error::from_serde_error(
220 format_serde_error::SerdeError::new(text.to_string(), err),
221 status,
222 )
223 })
224 } else {
225 let text = resp.text().await.unwrap_or_default();
226 Err(crate::types::error::Error::Server {
227 body: text.to_string(),
228 status,
229 })
230 }
231 }
232
233 #[doc = "Perform a `DELETE` request to `/api/saved_views/{id}/`.\n\n**Parameters:**\n\n- `id: i64`: A unique integer value identifying this saved view. (required)\n\n```rust,no_run\nasync fn example_saved_views_destroy() -> anyhow::Result<()> {\n let client = paperless_api_client::Client::new_from_env();\n client.saved_views().destroy(4 as i64).await?;\n Ok(())\n}\n```"]
234 #[tracing::instrument]
235 #[allow(non_snake_case)]
236 pub async fn destroy<'a>(&'a self, id: i64) -> Result<(), crate::types::error::Error> {
237 let mut req = self.client.client.request(
238 http::Method::DELETE,
239 format!(
240 "{}/{}",
241 self.client.base_url,
242 "api/saved_views/{id}/".replace("{id}", &format!("{id}"))
243 ),
244 );
245 req = req.header("Authorization", format!("Token {}", &self.client.token));
246 let resp = req.send().await?;
247 let status = resp.status();
248 if status.is_success() {
249 Ok(())
250 } else {
251 let text = resp.text().await.unwrap_or_default();
252 Err(crate::types::error::Error::Server {
253 body: text.to_string(),
254 status,
255 })
256 }
257 }
258
259 #[doc = "Perform a `PATCH` request to `/api/saved_views/{id}/`.\n\n**Parameters:**\n\n- `id: i64`: A unique integer value identifying this saved view. (required)\n\n```rust,no_run\nasync fn example_saved_views_partial_update() -> anyhow::Result<()> {\n let client = paperless_api_client::Client::new_from_env();\n let result: paperless_api_client::types::SavedView = client\n .saved_views()\n .partial_update(\n 4 as i64,\n &paperless_api_client::types::PatchedSavedViewRequest {\n name: Some(\"some-string\".to_string()),\n show_on_dashboard: Some(true),\n show_in_sidebar: Some(true),\n sort_field: Some(\"some-string\".to_string()),\n sort_reverse: Some(true),\n filter_rules: Some(vec![paperless_api_client::types::SavedViewFilterRuleRequest {\n rule_type: 4 as i64,\n value: Some(\"some-string\".to_string()),\n }]),\n page_size: Some(4 as i64),\n display_mode: Some(paperless_api_client::types::DisplayMode::LargeCards),\n display_fields: Some(serde_json::Value::String(\"some-string\".to_string())),\n owner: Some(4 as i64),\n },\n )\n .await?;\n println!(\"{:?}\", result);\n Ok(())\n}\n```"]
260 #[tracing::instrument]
261 #[allow(non_snake_case)]
262 pub async fn partial_update<'a>(
263 &'a self,
264 id: i64,
265 body: &crate::types::PatchedSavedViewRequest,
266 ) -> Result<crate::types::SavedView, crate::types::error::Error> {
267 let mut req = self.client.client.request(
268 http::Method::PATCH,
269 format!(
270 "{}/{}",
271 self.client.base_url,
272 "api/saved_views/{id}/".replace("{id}", &format!("{id}"))
273 ),
274 );
275 req = req.header("Authorization", format!("Token {}", &self.client.token));
276 req = req.json(body);
277 let resp = req.send().await?;
278 let status = resp.status();
279 if status.is_success() {
280 let text = resp.text().await.unwrap_or_default();
281 serde_json::from_str(&text).map_err(|err| {
282 crate::types::error::Error::from_serde_error(
283 format_serde_error::SerdeError::new(text.to_string(), err),
284 status,
285 )
286 })
287 } else {
288 let text = resp.text().await.unwrap_or_default();
289 Err(crate::types::error::Error::Server {
290 body: text.to_string(),
291 status,
292 })
293 }
294 }
295}