consume_once

gistfile1.py

from itertools import tee

class consume_once(object):
    """
    Takes an iterator and returns an iterable that can be consumed
    multiple times while only consuming the original a single time.

    >>> x = consume_once(i for i in range(3))
    >>> list(x)
    [0, 1, 2]
    >>> list(x)
    [0, 1, 2]
    """

    def __init__(self, iterator):
        self.iterator = iterator

    def __iter__(self):
        my_iterator, self.iterator = tee(self.iterator)
        return my_iterator

Please don't use this, a much better implementation is consume_once = list