feat: support page_size in bucket.list_blobs (#1275)

Author: cojenco

google/cloud/storage/bucket.py

@@ -1308,6 +1308,7 @@ def list_blobs(
         match_glob=None,
         include_folders_as_prefixes=None,
         soft_deleted=None,
+        page_size=None,
     ):
         """Return an iterator used to find blobs in the bucket.
 
@@ -1401,6 +1402,11 @@ def list_blobs(
             Note ``soft_deleted`` and ``versions`` cannot be set to True simultaneously. See:
             https://cloud.google.com/storage/docs/soft-delete
 
+        :type page_size: int
+        :param page_size:
+            (Optional) Maximum number of blobs to return in each page.
+            Defaults to a value set by the API.
+
         :rtype: :class:`~google.api_core.page_iterator.Iterator`
         :returns: Iterator of all :class:`~google.cloud.storage.blob.Blob`
                   in this bucket matching the arguments.
@@ -1418,6 +1424,7 @@ def list_blobs(
             versions=versions,
             projection=projection,
             fields=fields,
+            page_size=page_size,
             timeout=timeout,
             retry=retry,
             match_glob=match_glob,

tests/unit/test_bucket.py

@@ -1179,6 +1179,7 @@ def test_list_blobs_w_defaults(self):
         expected_fields = None
         expected_include_folders_as_prefixes = None
         soft_deleted = None
+        page_size = None
         client.list_blobs.assert_called_once_with(
             bucket,
             max_results=expected_max_results,
@@ -1196,6 +1197,7 @@ def test_list_blobs_w_defaults(self):
             match_glob=expected_match_glob,
             include_folders_as_prefixes=expected_include_folders_as_prefixes,
             soft_deleted=soft_deleted,
+            page_size=page_size,
         )
 
     def test_list_blobs_w_explicit(self):
@@ -1211,6 +1213,7 @@ def test_list_blobs_w_explicit(self):
         include_folders_as_prefixes = True
         versions = True
         soft_deleted = True
+        page_size = 2
         projection = "full"
         fields = "items/contentLanguage,nextPageToken"
         bucket = self._make_one(client=None, name=name)
@@ -1236,6 +1239,7 @@ def test_list_blobs_w_explicit(self):
             match_glob=match_glob,
             include_folders_as_prefixes=include_folders_as_prefixes,
             soft_deleted=soft_deleted,
+            page_size=page_size,
         )
 
         self.assertIs(iterator, other_client.list_blobs.return_value)
@@ -1253,6 +1257,7 @@ def test_list_blobs_w_explicit(self):
         expected_fields = fields
         expected_include_folders_as_prefixes = include_folders_as_prefixes
         expected_soft_deleted = soft_deleted
+        expected_page_size = page_size
         other_client.list_blobs.assert_called_once_with(
             bucket,
             max_results=expected_max_results,
@@ -1270,6 +1275,7 @@ def test_list_blobs_w_explicit(self):
             match_glob=expected_match_glob,
             include_folders_as_prefixes=expected_include_folders_as_prefixes,
             soft_deleted=expected_soft_deleted,
+            page_size=expected_page_size,
         )
 
     def test_list_notifications_w_defaults(self):