Skip to main content

Add a RepeatableIterable type and a function to obtain it

Project description

python-repeatable-iterable

pypi-version Downloads Code style: black Imports: isort Checked with mypy linting: pylint CodeFactor CodeClimateMaintainability Codacy Badge GitHub top language GitHub License PyPI - Python Version GitHub code size in bytes GitHub Sponsors

| A new type RepeatableIterable for Python and a way to obtain one instance |

Since in Python an Iterator is an Iterable and that you cannot iterate multiple times on an iterator, you may encounter WTF bugs, even with type checking. This package provides possible solutions to this problem. See here for a discussion on this problem: https://stackoverflow.com/questions/63104689/what-is-the-pythonic-way-to-represent-an-iterable-that-can-be-iterated-over-mult

Before:

def foo(iterable: Iterable):
    for that in iterable:
        bar(that)
    for that in iterable:
        # possible bug
        baz(that)

foo(something)

After solution 1:

from python_repeatable_iterable import RepeatableIterable

def foo(iterable: RepeatableIterable[object]):
    for that in iterable:
        bar(that)
    for that in iterable:
        baz(that)

something_else = RepeatableIterable(something)
foo(something_else)

After solution 2:

from python_repeatable_iterable import RepeatableIterable

def foo(iterable: Iterable):
    iterable = RepeatableIterable(iterable)
    for that in iterable:
        bar(that)
    for that in iterable:
        baz(that)

foo(something)

If you develop something where you have no control on what another dev might give you as input, you have 2 possibilities:

  • hope for the best ;),
  • or harden your code to have less support work to do :).

This applies if you dev something that is:

  • closed source or open source,
  • available to everyone on the Internet, available only to customers or colleagues that you may personally know or not.

Solution 2 above is a nice solution with a reasonable performance cost :).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python_repeatable_iterable-2.1.2.tar.gz (19.0 kB view hashes)

Uploaded Source

Built Distribution

python_repeatable_iterable-2.1.2-py3-none-any.whl (22.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page