More Itertools

Python’s itertools library is a gem - you can compose elegant solutions for a variety of problems with the functions it provides. In more-itertools we collect additional building blocks, recipes, and routines for working with Python iterables.

Grouping	chunked, ichunked, sliced, distribute, divide, split_at, split_before, split_after, split_into, split_when, bucket, unzip, grouper, partition
Lookahead and lookback	spy, peekable, seekable
Windowing	windowed, substrings, substrings_indexes, stagger, windowed_complete, pairwise, triplewise, sliding_window subslices,
Augmenting	count_cycle, intersperse, padded, mark_ends, repeat_last, adjacent, groupby_transform, pad_none, ncycles
Combining	collapse, sort_together, interleave, interleave_longest, interleave_evenly, zip_offset, zip_equal, zip_broadcast, dotproduct, convolve, flatten, roundrobin, prepend, value_chain
Summarizing	ilen, unique_to_each, sample, consecutive_groups, run_length, map_reduce, exactly_n, is_sorted, all_equal, all_unique, minmax, first_true, quantify
Selecting	islice_extended, first, last, one, only, strictly_n, strip, lstrip, rstrip, filter_except, map_except, nth_or_last, unique_in_window, before_and_after, nth, take, tail, unique_everseen, unique_justseen, duplicates_everseen, duplicates_justseen
Combinatorics	distinct_permutations, distinct_combinations, circular_shifts, partitions, set_partitions, product_index, combination_index, permutation_index, powerset, random_product, random_permutation, random_combination, random_combination_with_replacement, nth_product, nth_permutation, nth_combination
Wrapping	always_iterable, always_reversible, countable, consumer, with_iter, iter_except
Others	locate, rlocate, replace, numeric_range, side_effect, iterate, difference, make_decorator, SequenceView, time_limited, consume, tabulate, repeatfunc

Getting started

To get started, install the library with pip:

pip install more-itertools

The recipes from the itertools docs are included in the top-level package:

>>> from more_itertools import flatten
>>> iterable = [(0, 1), (2, 3)]
>>> list(flatten(iterable))
[0, 1, 2, 3]

Several new recipes are available as well:

>>> from more_itertools import chunked
>>> iterable = [0, 1, 2, 3, 4, 5, 6, 7, 8]
>>> list(chunked(iterable, 3))
[[0, 1, 2], [3, 4, 5], [6, 7, 8]]

>>> from more_itertools import spy
>>> iterable = (x * x for x in range(1, 6))
>>> head, iterable = spy(iterable, n=3)
>>> list(head)
[1, 4, 9]
>>> list(iterable)
[1, 4, 9, 16, 25]

For the full listing of functions, see the API documentation.

Links elsewhere

Blog posts about more-itertools:

Development

more-itertools is maintained by @erikrose and @bbayles, with help from many others. If you have a problem or suggestion, please file a bug or pull request in this repository. Thanks for contributing!

Version History

The version history can be found in documentation.

Release files for more-itertools 8.13.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for more-itertools 8.13.0
File	Size	Uploaded
more-itertools-8.13.0.tar.gz	101.3 kB	May 6, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for more-itertools 8.13.0
File	Interpreter	ABI	Platform	Reset
more_itertools-8.13.0-py3-none-any.whl 51.6 kB May 6, 2022	Python 3	none	any	Details

Total release size: 152.9 kB

Release files / more-itertools-8.13.0.tar.gz

Download URL	more-itertools-8.13.0.tar.gz
Size	101.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`a42901a0a5b169d925f6f217cd5a190e32ef54360905b9c39ee7db5313bfec0f`
BLAKE2b-256 checksum How to use checksums	`b4232987c2792c18a211dfe913e2f60e55cde0af6dfc41217e4da74ac7cd68f4`
Upload date	May 6, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.0 CPython/3.9.7`

Release files / more_itertools-8.13.0-py3-none-any.whl

Download URL	more_itertools-8.13.0-py3-none-any.whl
Size	51.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c5122bffc5f104d37c1626b8615b511f3427aa5389b94d61e5ef8236bfbc3ddb`
BLAKE2b-256 checksum How to use checksums	`bd3fc4b3dbd315e248f84c388bd4a72b131a29f123ecacc37ffb2b3834546e42`
Upload date	May 6, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.0 CPython/3.9.7`