7 releases

0.2.2 Dec 7, 2023
0.2.1 Nov 29, 2023
0.1.3 Jan 22, 2022

#233 in Rust patterns

Download history 4040/week @ 2023-12-16 3674/week @ 2023-12-23 4901/week @ 2023-12-30 2594/week @ 2024-01-06 4160/week @ 2024-01-13 3515/week @ 2024-01-20 3292/week @ 2024-01-27 1659/week @ 2024-02-03 3507/week @ 2024-02-10 3080/week @ 2024-02-17 4238/week @ 2024-02-24 2417/week @ 2024-03-02 3610/week @ 2024-03-09 2951/week @ 2024-03-16 2181/week @ 2024-03-23 2295/week @ 2024-03-30

11,182 downloads per month
Used in risinglight

MIT/Apache

12KB
186 lines

iter-chunks

Yet another crate to provides chunks method to rust Iterator.

Please read the API documentation here.

Usage

Add this to your Cargo.toml:

[dependencies]
iter-chunks = "0.2"

Examples

Currently, only while loop over Chunks is supported.

use iter_chunks::IterChunks;

let arr = [1, 1, 2, 2, 3];
let expected = [vec![1, 1], vec![2, 2], vec![3]];
let mut chunks = arr.into_iter().chunks(2);
let mut i = 0;
while let Some(chunk) = chunks.next() {
    assert_eq!(chunk.collect::<Vec<_>>(), expected[i]);
    i += 1;
}

Why create this crate?

itertools provides many awesome extensions, including chunks. It's really useful, but it use RefCell internally, causing it's not Send.

It's a very common usecase in async context, which requires Chunks to be Send:

async fn do_some_work(input: impl Iterator<Item = i32>) {
    for chunk in input.chunks(1024) {
        for v in chunk {
            handle(v).await
        }
        do_some_flush().await
    }
}

This crate implements chunks without RefCell, so Chunks is both Send and Sync. As a price, Chunks cannot implement Iterator (which can be resolved later by GAT and LendingIterator).

Future works

The lack of the Iterator implementation is very difficult to use, and the best solution is to wait for GAT and a suitable LendingIterator crate. But in the short term, we can consider providing some common methods such as nth, for_each, try_for_each, and so on.

Contributions are welcome.

License

Licensed under either of

at your option.

No runtime deps