Storage: Bucket.list_blobs(max_results=n) does not behave as documented about python-storage HOT 1 CLOSED

Hi folks,

I dug into the Page iterator and found that max_results is strict in the total number of results to retrieve. However, I think there's a usability issue here in the case you want to limit the number of items per page while retrieving all items.

Given the expectation is set in the code, moving forward with the PR that exists makes sense for now because it would require adding support for this path.

The workaround for this is the following:

from google.cloud import storage

storage_client = storage.Client()
bucket = storage_client.bucket("bucket-name")

blobs = bucket.list_blobs(max_results=3)
start = False
while blobs.next_page_token or start is False:
   for blob in blobs:
       print(blob.name)
   blobs = bucket.list_blobs(max_results=3, page_token=blobs.next_page_token)
   start = True

@crwilcox this is a usability issue because it doesn't fully expose the GCS API behavior when setting maxResults.

from python-storage.