philiprehberger-list-chunk 0.1.5

Split iterables into evenly sized chunks

philiprehberger-list-chunk

Split iterables into evenly sized chunks.

Installation

pip install philiprehberger-list-chunk

Usage

from philiprehberger_list_chunk import chunk, chunk_by, sliding_window, interleave, flatten

chunk([1, 2, 3, 4, 5], size=2)
# [[1, 2], [3, 4], [5]]

chunk([1, 2, 3], size=2, pad=0)
# [[1, 2], [3, 0]]

chunk_by([1, 1, 2, 2, 3], key=lambda x: x)
# [[1, 1], [2, 2], [3]]

sliding_window([1, 2, 3, 4, 5], size=3)
# [[1, 2, 3], [2, 3, 4], [3, 4, 5]]

interleave([1, 2, 3], ["a", "b", "c"])
# [1, "a", 2, "b", 3, "c"]

flatten([[1, 2], [3, 4]])
# [1, 2, 3, 4]

API

• chunk(items, size, pad=None) — Fixed-size chunks
• chunk_by(items, key) — Group consecutive elements by key
• sliding_window(items, size, step=1) — Sliding window views
• interleave(*iterables) — Round-robin interleave
• flatten(nested) — Flatten one level of nesting

Development

pip install -e .
python -m pytest tests/ -v

License

MIT