7 releases (breaking)
new 0.6.0 | Jan 10, 2025 |
---|---|
0.5.0 | Jan 6, 2025 |
0.4.0 | Dec 23, 2024 |
0.3.0 | Dec 17, 2024 |
0.1.1 | Nov 6, 2024 |
#1349 in Rust patterns
473 downloads per month
29KB
321 lines
tryiter
Utility functions for Iterators of Results. This crate is heavily inspired by TryStreamExt in the futures crate as well as Yoshua Wuyts post on Fallible Iterator Adapters.
TryIteratorExt
This crate exports a trait called TryIteratorExt
which provides utility methods on top of any Iterator which returns a Result
. TryIteratorExt
is automatically implemented on top of compatible Iterators via a generic impl
so all you have to do is import the trait and start calling methods on your iterators.
The methods provide two fundamental simplifications over regular Iterator methods:
- They operate directly on
Ok
orErr
values, passing through the other values transparently. - They take in fallible closures which can return
Err
.
See tests/sanity.rs for a quick overview of using this crate.
Release Stability
This crate is still pre-1.0 and will be until someone wants to use it in production. If you want to use it before that point please pin a specific version number and be prepared for breaking changes.