aws_sdk_ec2/operation/describe_reserved_instances_modifications/
paginator.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2/// Paginator for [`DescribeReservedInstancesModifications`](crate::operation::describe_reserved_instances_modifications::DescribeReservedInstancesModifications)
3pub struct DescribeReservedInstancesModificationsPaginator {
4    handle: std::sync::Arc<crate::client::Handle>,
5    builder: crate::operation::describe_reserved_instances_modifications::builders::DescribeReservedInstancesModificationsInputBuilder,
6    stop_on_duplicate_token: bool,
7}
8
9impl DescribeReservedInstancesModificationsPaginator {
10    /// Create a new paginator-wrapper
11    pub(crate) fn new(
12        handle: std::sync::Arc<crate::client::Handle>,
13        builder: crate::operation::describe_reserved_instances_modifications::builders::DescribeReservedInstancesModificationsInputBuilder,
14    ) -> Self {
15        Self {
16            handle,
17            builder,
18            stop_on_duplicate_token: true,
19        }
20    }
21
22    /// Create a flattened paginator
23    ///
24    /// This paginator automatically flattens results using `reserved_instances_modifications`. Queries to the underlying service
25    /// are dispatched lazily.
26    pub fn items(
27        self,
28    ) -> crate::operation::describe_reserved_instances_modifications::paginator::DescribeReservedInstancesModificationsPaginatorItems {
29        crate::operation::describe_reserved_instances_modifications::paginator::DescribeReservedInstancesModificationsPaginatorItems(self)
30    }
31
32    /// Stop paginating when the service returns the same pagination token twice in a row.
33    ///
34    /// Defaults to true.
35    ///
36    /// For certain operations, it may be useful to continue on duplicate token. For example,
37    /// if an operation is for tailing a log file in real-time, then continuing may be desired.
38    /// This option can be set to `false` to accommodate these use cases.
39    pub fn stop_on_duplicate_token(mut self, stop_on_duplicate_token: bool) -> Self {
40        self.stop_on_duplicate_token = stop_on_duplicate_token;
41        self
42    }
43
44    /// Create the pagination stream
45    ///
46    /// _Note:_ No requests will be dispatched until the stream is used
47    /// (e.g. with the [`.next().await`](aws_smithy_async::future::pagination_stream::PaginationStream::next) method).
48    pub fn send(
49        self,
50    ) -> ::aws_smithy_async::future::pagination_stream::PaginationStream<
51        ::std::result::Result<
52            crate::operation::describe_reserved_instances_modifications::DescribeReservedInstancesModificationsOutput,
53            ::aws_smithy_runtime_api::client::result::SdkError<
54                crate::operation::describe_reserved_instances_modifications::DescribeReservedInstancesModificationsError,
55                ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
56            >,
57        >,
58    > {
59        // Move individual fields out of self for the borrow checker
60        let builder = self.builder;
61        let handle = self.handle;
62        let runtime_plugins =
63            crate::operation::describe_reserved_instances_modifications::DescribeReservedInstancesModifications::operation_runtime_plugins(
64                handle.runtime_plugins.clone(),
65                &handle.conf,
66                ::std::option::Option::None,
67            )
68            .with_operation_plugin(crate::sdk_feature_tracker::paginator::PaginatorFeatureTrackerRuntimePlugin::new());
69        ::aws_smithy_async::future::pagination_stream::PaginationStream::new(::aws_smithy_async::future::pagination_stream::fn_stream::FnStream::new(
70            move |tx| {
71                ::std::boxed::Box::pin(async move {
72                    // Build the input for the first time. If required fields are missing, this is where we'll produce an early error.
73                    let mut input = match builder
74                        .build()
75                        .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)
76                    {
77                        ::std::result::Result::Ok(input) => input,
78                        ::std::result::Result::Err(e) => {
79                            let _ = tx.send(::std::result::Result::Err(e)).await;
80                            return;
81                        }
82                    };
83                    loop {
84                        let resp = crate::operation::describe_reserved_instances_modifications::DescribeReservedInstancesModifications::orchestrate(
85                            &runtime_plugins,
86                            input.clone(),
87                        )
88                        .await;
89                        // If the input member is None or it was an error
90                        let done = match resp {
91                            ::std::result::Result::Ok(ref resp) => {
92                                let new_token = crate::lens::reflens_describe_reserved_instances_modifications_output_output_next_token(resp);
93                                // Pagination is exhausted when the next token is an empty string
94                                let is_empty = new_token.map(|token| token.is_empty()).unwrap_or(true);
95                                if !is_empty && new_token == input.next_token.as_ref() && self.stop_on_duplicate_token {
96                                    true
97                                } else {
98                                    input.next_token = new_token.cloned();
99                                    is_empty
100                                }
101                            }
102                            ::std::result::Result::Err(_) => true,
103                        };
104                        if tx.send(resp).await.is_err() {
105                            // receiving end was dropped
106                            return;
107                        }
108                        if done {
109                            return;
110                        }
111                    }
112                })
113            },
114        ))
115    }
116}
117
118/// Flattened paginator for `DescribeReservedInstancesModificationsPaginator`
119///
120/// This is created with [`.items()`](DescribeReservedInstancesModificationsPaginator::items)
121pub struct DescribeReservedInstancesModificationsPaginatorItems(DescribeReservedInstancesModificationsPaginator);
122
123impl DescribeReservedInstancesModificationsPaginatorItems {
124    /// Create the pagination stream
125    ///
126    /// _Note_: No requests will be dispatched until the stream is used
127    /// (e.g. with the [`.next().await`](aws_smithy_async::future::pagination_stream::PaginationStream::next) method).
128    ///
129    /// To read the entirety of the paginator, use [`.collect::<Result<Vec<_>, _>()`](aws_smithy_async::future::pagination_stream::PaginationStream::collect).
130    pub fn send(
131        self,
132    ) -> ::aws_smithy_async::future::pagination_stream::PaginationStream<
133        ::std::result::Result<
134            crate::types::ReservedInstancesModification,
135            ::aws_smithy_runtime_api::client::result::SdkError<
136                crate::operation::describe_reserved_instances_modifications::DescribeReservedInstancesModificationsError,
137                ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
138            >,
139        >,
140    > {
141        ::aws_smithy_async::future::pagination_stream::TryFlatMap::new(self.0.send()).flat_map(|page| {
142            crate::lens::lens_describe_reserved_instances_modifications_output_output_reserved_instances_modifications(page)
143                .unwrap_or_default()
144                .into_iter()
145        })
146    }
147}