flati 0.2.1

Flatten nested iterable object (Pure-Python)

flati

Flatten nested iterable object (Pure-Python implementation)

Japanese document is available: https://qiita.com/yukinoi/items/9570c76034c28bdae0a8

Installation

$ pip install flati

Usage

import flati

iterable = [(1, 2, 3), (4, (5, 6))]
list(flati.flatten(iterable))
# => [1, 2, 3, 4, 5, 6]

# The flati.flatten function returns a generator
import types
isinstance(flati.flatten(iterable), types.GeneratorType)
# => True

# If you want to avoid flattening specific type, then use "ignore" parameter
iterable = [('abc'), ('def', ('g', 'hi'))]
list(flati.flatten(iterable, ignore=str))
# => ['abc', 'def', 'g', 'hi']

# The flatten_non_str function is alias of "flatten(iterable, ignore=str)"
iterable = [('abc'), ('def', ('g', 'hi'))]
list(flati.flatten_non_str(iterable))
# => ['abc', 'def', 'g', 'hi']

Tips

If you want to flatten numpy.ndarray, I recommend using following methods:

• numpy.ravel()

• ndarray.reshape(-1)

• ndarray.flatten() # This method is a bit slow because it makes a copy

Contribution

Contributions are welcome.

See https://github.com/ikegami-yukino/flati/blob/master/CONTRIBUTING.md

CHANGES

0.2.1 (2025-08-15)

• Add flatten_non_str function that alias of flatten(iterable, ignore=str)

0.2.0 (2025-08-02)

• Add stub files according to PEP 561

• Support Python 3.9, 3.10, 3.11, 3.12, 3.13

0.1.2 (2019-12-31)

• Support Python 3.8

0.1.1 (2019-1-28)

• Support Python 2.7

0.1 (2019-1-27)

• First release