Use iterator for s3 object collection

>>> objects
s3.Bucket.objectsCollection(s3.Bucket(name='my-project'), s3.ObjectSummary)

>>> print(next(objects))
TypeError: 's3.Bucket.objectsCollection' object is not an iterator

https://wiki.python.org/moin/Iterator

It does support iter(objects) wrapping, e.g.

>>> obj_iter = iter(objects)
>>> obj_iter
<generator object ResourceCollection.__iter__ at 0x7f57efbff660>

But why is this necessary?

[dazza-codes]

Not sure if the latest release already supports this, but it seems like all() should return an iterable.

objects = s3.Bucket(name='test').objects.all()
next(objects) -> s3.ObjectSummary

The docs, e.g. https://boto3.amazonaws.com/v1/documentation/api/latest/guide/collections.html, explicitly indicate that A collection provides an iterable interface to a group of resources.

It seems like the distinction between iterable and iterator is important [1] and what the intention is for the collections. If the intention is to be an iterable and not an iterator, it’s good to go and close this issue at will.

[1] https://www.geeksforgeeks.org/python-difference-iterable-iterator/

[Aeternitaas]

Alternatively, you may also use something like:

...
bucket_iter = iter(objects)
next(bucket_iter)
...

This works since all Generators (which are used in boto3 to yield API results) are Iterators and all Iterators are Iterables.