Removing Iterator.reset().

[dhermes]

This is in advance of supporting GAX page iterators within our Iterator class.

Iterator.reset() isn't a feature that a typical Python user expects to exist, and restarting an iterator can be as easy as:

>>> my_iter = client.list_foo(*args, **kwargs)
>>> consume_it(my_iter)
>>> restarted_iter = client.list_foo(*args, **kwargs)

[daspecster]

>>> my_iter = client.list_foo(*args, **kwargs)
>>> consume_it(my_iter)
>>> restarted_iter = client.list_foo(*args, **kwargs)  # API call.
>>> my_iter.reset()  # No API call.

I don't know if that matters? Supporting GAX page iterators is a bigger benefit over making an extra API call I would think.

[dhermes]

@daspecster It's not about API calls, it's about not being able to re-set to the initial state for a GAX iterator. And calling list_foo() doesn't make any API calls until the user starts to consume the iterator.