google-cloud-storage 3.1.0__tar.gz → 3.2.0__tar.gz

{google_cloud_storage-3.1.0/google_cloud_storage.egg-info → google_cloud_storage-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: google-cloud-storage
-Version: 3.1.0
+Version: 3.2.0
 Summary: Google Cloud Storage API client library
 Home-page: https://github.com/googleapis/python-storage
 Author: Google LLC
@@ -18,20 +18,33 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
 Requires-Python: >=3.7
 License-File: LICENSE
-Requires-Dist: google-auth<3.0dev,>=2.26.1
-Requires-Dist: google-api-core<3.0.0dev,>=2.15.0
-Requires-Dist: google-cloud-core<3.0dev,>=2.4.2
-Requires-Dist: google-resumable-media>=2.7.2
-Requires-Dist: requests<3.0.0dev,>=2.18.0
-Requires-Dist: google-crc32c<2.0dev,>=1.0
+Requires-Dist: google-auth<3.0.0,>=2.26.1
+Requires-Dist: google-api-core<3.0.0,>=2.15.0
+Requires-Dist: google-cloud-core<3.0.0,>=2.4.2
+Requires-Dist: google-resumable-media<3.0.0,>=2.7.2
+Requires-Dist: requests<3.0.0,>=2.22.0
+Requires-Dist: google-crc32c<2.0.0,>=1.1.3
 Provides-Extra: protobuf
-Requires-Dist: protobuf<6.0.0dev; extra == "protobuf"
+Requires-Dist: protobuf<7.0.0,>=3.20.2; extra == "protobuf"
 Provides-Extra: tracing
-Requires-Dist: opentelemetry-api>=1.1.0; extra == "tracing"
+Requires-Dist: opentelemetry-api<2.0.0,>=1.1.0; extra == "tracing"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: platform
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 Python Client for Google Cloud Storage
 ======================================
@@ -43,6 +56,8 @@ allows world-wide storage and retrieval of any amount of data at any time. You c
 Cloud Storage for a range of scenarios including serving website content, storing data
 for archival and disaster recovery, or distributing large data objects to users via direct download.
 
+**NOTE**: `3.0 Major Version Notes`_ are available. Feedback welcome.
+
 A comprehensive list of changes in each version may be found in the `CHANGELOG`_.
 
 - `Product Documentation`_
@@ -64,7 +79,7 @@ Google APIs Client Libraries, in `Client Libraries Explained`_.
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-storage.svg
    :target: https://pypi.org/project/google-cloud-storage/
 .. _Google Cloud Storage: https://cloud.google.com/storage
-.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/storage/latest
+.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/storage/latest/summary_overview
 .. _Product Documentation:  https://cloud.google.com/storage
 .. _CHANGELOG:  https://github.com/googleapis/python-storage/blob/main/CHANGELOG.md
 .. _github.com/googleapis/python-storage: https://github.com/googleapis/python-storage
@@ -72,75 +87,6 @@ Google APIs Client Libraries, in `Client Libraries Explained`_.
 .. _Storage Control API: https://cloud.google.com/storage/docs/reference/rpc/google.storage.control.v2
 .. _Client Libraries Explained: https://cloud.google.com/apis/docs/client-libraries-explained
 
-3.0 Major Version Notes
------------------------
-
-Feedback Welcome
-~~~~~~~~~~~~~~~~
-
-If you experience that backwards compatibility for your application is broken
-with this major version release, please let us know through the Github issues
-system. While some breaks of backwards compatibility may be unavoidable due to
-new features in the major version release, we will do our best to minimize
-them. Thank you.
-
-Exception Handling
-~~~~~~~~~~~~~~~~~~
-
-In Python Storage 3.0, the dependency ``google-resumable-media`` was integrated.
-The ``google-resumable-media`` dependency included exceptions
-``google.resumable_media.common.InvalidResponse`` and
-``google.resumable_media.common.DataCorruption``, which were often imported
-directly in user application code. The replacements for these exceptions are
-``google.cloud.storage.exceptions.InvalidResponse`` and
-``google.cloud.storage.exceptions.DataCorruption``. Please update application code
-to import and use these exceptions instead.
-
-For backwards compatibility, if ``google-resumable-media`` is installed, the new
-exceptions will be defined as subclasses of the old exceptions, so applications
-should continue to work without modification. This backwards compatibility
-feature may be removed in a future major version update.
-
-Some users may be using the original exception classes from the
-``google-resumable-media`` library without explicitly installing that library. So
-as not to break user applications following this pattern,
-``google-resumable-media`` is still in the list of dependencies in this package's
-setup.py file. Applications which do not import directly from
-``google-resumable-media`` can safely disregard this dependency.
-This backwards compatibility feature **will be removed** in a future major
-version update. Please migrate to using the ``google.cloud.storage.exceptions``
-classes as above.
-
-Checksum Defaults
-~~~~~~~~~~~~~~~~~
-
-In Python Storage 3.0, uploads and downloads now have a default of "auto" where
-applicable. "Auto" will use crc32c checksums, except for unusual cases where the
-fast (C extension) crc32c implementation is not available, in which case it will
-use md5 instead. Before Python Storage 3.0, the default was md5 for most
-downloads and None for most uploads. Note that ranged downloads ("start" or
-"end" set) still do not support any checksumming, and some features in
-``transfer_manager.py`` still support crc32c only.
-
-Note: The method ``Blob.upload_from_file()`` requires a file in bytes mode, but
-when checksum is set to None, as was the previous default, would not throw an
-error if passed a file in string mode under some circumstances. With the new
-defaults, it will now raise a TypeError. Please use a file opened in bytes
-reading mode as required.
-
-Miscellaneous
-~~~~~~~~~~~~~
-
-- The ``BlobWriter`` class now attempts to terminate an ongoing resumable upload if
-  the writer exits with an exception.
-- Retry behavior is now identical between media operations (uploads and
-  downloads) and other operations, and custom predicates are now supported for
-  media operations as well.
-- ``Blob.download_as_filename()`` will now delete the empty file if it results in a
-  google.cloud.exceptions.NotFound exception (HTTP 404).
-- Previously, object upload, metadata update, and delete methods had retries
-  disabled by default unless the generation or metageneration was specified in
-  the request. This has now changed so that retries are enabled by default.
 
 Quick Start
 -----------
@@ -221,6 +167,26 @@ Windows
     pip install google-cloud-storage
 
 
+Example Usage
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+    # Imports the Google Cloud client library
+    from google.cloud import storage
+
+    # Instantiates a client
+    storage_client = storage.Client()
+
+    # The name for the new bucket
+    bucket_name = "my-new-bucket"
+
+    # Creates the new bucket
+    bucket = storage_client.create_bucket(bucket_name)
+
+    print(f"Bucket {bucket.name} created.")
+
+
 Tracing With OpenTelemetry
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -275,6 +241,77 @@ For a list of libraries that can be instrumented, refer to the `OpenTelemetry Re
 .. _Google Cloud Trace: https://cloud.google.com/trace
 
 
+3.0 Major Version Notes
+-----------------------
+
+Feedback Welcome
+~~~~~~~~~~~~~~~~
+
+If you experience that backwards compatibility for your application is broken
+with this major version release, please let us know through the Github issues
+system. While some breaks of backwards compatibility may be unavoidable due to
+new features in the major version release, we will do our best to minimize
+them. Thank you.
+
+Exception Handling
+~~~~~~~~~~~~~~~~~~
+
+In Python Storage 3.0, the dependency ``google-resumable-media`` was integrated.
+The ``google-resumable-media`` dependency included exceptions
+``google.resumable_media.common.InvalidResponse`` and
+``google.resumable_media.common.DataCorruption``, which were often imported
+directly in user application code. The replacements for these exceptions are
+``google.cloud.storage.exceptions.InvalidResponse`` and
+``google.cloud.storage.exceptions.DataCorruption``. Please update application code
+to import and use these exceptions instead.
+
+For backwards compatibility, if ``google-resumable-media`` is installed, the new
+exceptions will be defined as subclasses of the old exceptions, so applications
+should continue to work without modification. This backwards compatibility
+feature may be removed in a future major version update.
+
+Some users may be using the original exception classes from the
+``google-resumable-media`` library without explicitly installing that library. So
+as not to break user applications following this pattern,
+``google-resumable-media`` is still in the list of dependencies in this package's
+setup.py file. Applications which do not import directly from
+``google-resumable-media`` can safely disregard this dependency.
+This backwards compatibility feature **will be removed** in a future major
+version update. Please migrate to using the ``google.cloud.storage.exceptions``
+classes as above.
+
+Checksum Defaults
+~~~~~~~~~~~~~~~~~
+
+In Python Storage 3.0, uploads and downloads now have a default of "auto" where
+applicable. "Auto" will use crc32c checksums, except for unusual cases where the
+fast (C extension) crc32c implementation is not available, in which case it will
+use md5 instead. Before Python Storage 3.0, the default was md5 for most
+downloads and None for most uploads. Note that ranged downloads ("start" or
+"end" set) still do not support any checksumming, and some features in
+``transfer_manager.py`` still support crc32c only.
+
+Note: The method ``Blob.upload_from_file()`` requires a file in bytes mode, but
+when checksum is set to None, as was the previous default, would not throw an
+error if passed a file in string mode under some circumstances. With the new
+defaults, it will now raise a TypeError. Please use a file opened in bytes
+reading mode as required.
+
+Miscellaneous
+~~~~~~~~~~~~~
+
+- The ``BlobWriter`` class now attempts to terminate an ongoing resumable upload if
+  the writer exits with an exception.
+- Retry behavior is now identical between media operations (uploads and
+  downloads) and other operations, and custom predicates are now supported for
+  media operations as well.
+- ``Blob.download_as_filename()`` will now delete the empty file if it results in a
+  google.cloud.exceptions.NotFound exception (HTTP 404).
+- Previously, object upload, metadata update, and delete methods had retries
+  disabled by default unless the generation or metageneration was specified in
+  the request. This has now changed so that retries are enabled by default.
+
+
 Next Steps
 ~~~~~~~~~~
 

{google_cloud_storage-3.1.0 → google_cloud_storage-3.2.0}/README.rst

@@ -8,6 +8,8 @@ allows world-wide storage and retrieval of any amount of data at any time. You c
 Cloud Storage for a range of scenarios including serving website content, storing data
 for archival and disaster recovery, or distributing large data objects to users via direct download.
 
+**NOTE**: `3.0 Major Version Notes`_ are available. Feedback welcome.
+
 A comprehensive list of changes in each version may be found in the `CHANGELOG`_.
 
 - `Product Documentation`_
@@ -29,7 +31,7 @@ Google APIs Client Libraries, in `Client Libraries Explained`_.
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-storage.svg
    :target: https://pypi.org/project/google-cloud-storage/
 .. _Google Cloud Storage: https://cloud.google.com/storage
-.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/storage/latest
+.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/storage/latest/summary_overview
 .. _Product Documentation:  https://cloud.google.com/storage
 .. _CHANGELOG:  https://github.com/googleapis/python-storage/blob/main/CHANGELOG.md
 .. _github.com/googleapis/python-storage: https://github.com/googleapis/python-storage
@@ -37,75 +39,6 @@ Google APIs Client Libraries, in `Client Libraries Explained`_.
 .. _Storage Control API: https://cloud.google.com/storage/docs/reference/rpc/google.storage.control.v2
 .. _Client Libraries Explained: https://cloud.google.com/apis/docs/client-libraries-explained
 
-3.0 Major Version Notes
------------------------
-
-Feedback Welcome
-~~~~~~~~~~~~~~~~
-
-If you experience that backwards compatibility for your application is broken
-with this major version release, please let us know through the Github issues
-system. While some breaks of backwards compatibility may be unavoidable due to
-new features in the major version release, we will do our best to minimize
-them. Thank you.
-
-Exception Handling
-~~~~~~~~~~~~~~~~~~
-
-In Python Storage 3.0, the dependency ``google-resumable-media`` was integrated.
-The ``google-resumable-media`` dependency included exceptions
-``google.resumable_media.common.InvalidResponse`` and
-``google.resumable_media.common.DataCorruption``, which were often imported
-directly in user application code. The replacements for these exceptions are
-``google.cloud.storage.exceptions.InvalidResponse`` and
-``google.cloud.storage.exceptions.DataCorruption``. Please update application code
-to import and use these exceptions instead.
-
-For backwards compatibility, if ``google-resumable-media`` is installed, the new
-exceptions will be defined as subclasses of the old exceptions, so applications
-should continue to work without modification. This backwards compatibility
-feature may be removed in a future major version update.
-
-Some users may be using the original exception classes from the
-``google-resumable-media`` library without explicitly installing that library. So
-as not to break user applications following this pattern,
-``google-resumable-media`` is still in the list of dependencies in this package's
-setup.py file. Applications which do not import directly from
-``google-resumable-media`` can safely disregard this dependency.
-This backwards compatibility feature **will be removed** in a future major
-version update. Please migrate to using the ``google.cloud.storage.exceptions``
-classes as above.
-
-Checksum Defaults
-~~~~~~~~~~~~~~~~~
-
-In Python Storage 3.0, uploads and downloads now have a default of "auto" where
-applicable. "Auto" will use crc32c checksums, except for unusual cases where the
-fast (C extension) crc32c implementation is not available, in which case it will
-use md5 instead. Before Python Storage 3.0, the default was md5 for most
-downloads and None for most uploads. Note that ranged downloads ("start" or
-"end" set) still do not support any checksumming, and some features in
-``transfer_manager.py`` still support crc32c only.
-
-Note: The method ``Blob.upload_from_file()`` requires a file in bytes mode, but
-when checksum is set to None, as was the previous default, would not throw an
-error if passed a file in string mode under some circumstances. With the new
-defaults, it will now raise a TypeError. Please use a file opened in bytes
-reading mode as required.
-
-Miscellaneous
-~~~~~~~~~~~~~
-
-- The ``BlobWriter`` class now attempts to terminate an ongoing resumable upload if
-  the writer exits with an exception.
-- Retry behavior is now identical between media operations (uploads and
-  downloads) and other operations, and custom predicates are now supported for
-  media operations as well.
-- ``Blob.download_as_filename()`` will now delete the empty file if it results in a
-  google.cloud.exceptions.NotFound exception (HTTP 404).
-- Previously, object upload, metadata update, and delete methods had retries
-  disabled by default unless the generation or metageneration was specified in
-  the request. This has now changed so that retries are enabled by default.
 
 Quick Start
 -----------
@@ -186,6 +119,26 @@ Windows
     pip install google-cloud-storage
 
 
+Example Usage
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+    # Imports the Google Cloud client library
+    from google.cloud import storage
+
+    # Instantiates a client
+    storage_client = storage.Client()
+
+    # The name for the new bucket
+    bucket_name = "my-new-bucket"
+
+    # Creates the new bucket
+    bucket = storage_client.create_bucket(bucket_name)
+
+    print(f"Bucket {bucket.name} created.")
+
+
 Tracing With OpenTelemetry
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -240,6 +193,77 @@ For a list of libraries that can be instrumented, refer to the `OpenTelemetry Re
 .. _Google Cloud Trace: https://cloud.google.com/trace
 
 
+3.0 Major Version Notes
+-----------------------
+
+Feedback Welcome
+~~~~~~~~~~~~~~~~
+
+If you experience that backwards compatibility for your application is broken
+with this major version release, please let us know through the Github issues
+system. While some breaks of backwards compatibility may be unavoidable due to
+new features in the major version release, we will do our best to minimize
+them. Thank you.
+
+Exception Handling
+~~~~~~~~~~~~~~~~~~
+
+In Python Storage 3.0, the dependency ``google-resumable-media`` was integrated.
+The ``google-resumable-media`` dependency included exceptions
+``google.resumable_media.common.InvalidResponse`` and
+``google.resumable_media.common.DataCorruption``, which were often imported
+directly in user application code. The replacements for these exceptions are
+``google.cloud.storage.exceptions.InvalidResponse`` and
+``google.cloud.storage.exceptions.DataCorruption``. Please update application code
+to import and use these exceptions instead.
+
+For backwards compatibility, if ``google-resumable-media`` is installed, the new
+exceptions will be defined as subclasses of the old exceptions, so applications
+should continue to work without modification. This backwards compatibility
+feature may be removed in a future major version update.
+
+Some users may be using the original exception classes from the
+``google-resumable-media`` library without explicitly installing that library. So
+as not to break user applications following this pattern,
+``google-resumable-media`` is still in the list of dependencies in this package's
+setup.py file. Applications which do not import directly from
+``google-resumable-media`` can safely disregard this dependency.
+This backwards compatibility feature **will be removed** in a future major
+version update. Please migrate to using the ``google.cloud.storage.exceptions``
+classes as above.
+
+Checksum Defaults
+~~~~~~~~~~~~~~~~~
+
+In Python Storage 3.0, uploads and downloads now have a default of "auto" where
+applicable. "Auto" will use crc32c checksums, except for unusual cases where the
+fast (C extension) crc32c implementation is not available, in which case it will
+use md5 instead. Before Python Storage 3.0, the default was md5 for most
+downloads and None for most uploads. Note that ranged downloads ("start" or
+"end" set) still do not support any checksumming, and some features in
+``transfer_manager.py`` still support crc32c only.
+
+Note: The method ``Blob.upload_from_file()`` requires a file in bytes mode, but
+when checksum is set to None, as was the previous default, would not throw an
+error if passed a file in string mode under some circumstances. With the new
+defaults, it will now raise a TypeError. Please use a file opened in bytes
+reading mode as required.
+
+Miscellaneous
+~~~~~~~~~~~~~
+
+- The ``BlobWriter`` class now attempts to terminate an ongoing resumable upload if
+  the writer exits with an exception.
+- Retry behavior is now identical between media operations (uploads and
+  downloads) and other operations, and custom predicates are now supported for
+  media operations as well.
+- ``Blob.download_as_filename()`` will now delete the empty file if it results in a
+  google.cloud.exceptions.NotFound exception (HTTP 404).
+- Previously, object upload, metadata update, and delete methods had retries
+  disabled by default unless the generation or metageneration was specified in
+  the request. This has now changed so that retries are enabled by default.
+
+
 Next Steps
 ~~~~~~~~~~
 

{google_cloud_storage-3.1.0 → google_cloud_storage-3.2.0}/google/cloud/storage/_media/_download.py

@@ -140,7 +140,7 @@ class Download(DownloadBase):
             ``start`` to the end of the media.
         headers (Optional[Mapping[str, str]]): Extra headers that should
             be sent with the request, e.g. headers for encrypted data.
-        checksum Optional([str]): The type of checksum to compute to verify
+        checksum (Optional[str]): The type of checksum to compute to verify
             the integrity of the object. The response headers must contain
             a checksum of the requested type. If the headers lack an
             appropriate checksum (for instance in the case of transcoded or
@@ -157,6 +157,9 @@ class Download(DownloadBase):
             See the retry.py source code and docstrings in this package
             (google.cloud.storage.retry) for information on retry types and how
             to configure them.
+        single_shot_download (Optional[bool]): If true, download the object in a single request.
+            Caution: Enabling this will increase the memory overload for your application.
+            Please enable this as per your use case.
 
     """
 
@@ -169,6 +172,7 @@ class Download(DownloadBase):
         headers=None,
         checksum="auto",
         retry=DEFAULT_RETRY,
+        single_shot_download=False,
     ):
         super(Download, self).__init__(
             media_url, stream=stream, start=start, end=end, headers=headers, retry=retry
@@ -178,6 +182,7 @@ class Download(DownloadBase):
             self.checksum = (
                 "crc32c" if _helpers._is_crc32c_available_and_fast() else "md5"
             )
+        self.single_shot_download = single_shot_download
         self._bytes_downloaded = 0
         self._expected_checksum = None
         self._checksum_object = None

{google_cloud_storage-3.1.0 → google_cloud_storage-3.2.0}/google/cloud/storage/_media/requests/download.py

@@ -43,6 +43,12 @@ Error writing to stream while handling a gzip-compressed file download.
 Please restart the download.
 """
 
+_RESPONSE_HEADERS_INFO = """\
+The X-Goog-Stored-Content-Length is {}. The X-Goog-Stored-Content-Encoding is {}.
+The download request read {} bytes of data.
+If the download was incomplete, please check the network connection and restart the download.
+"""
+
 
 class Download(_request_helpers.RequestsMixin, _download.Download):
     """Helper to manage downloading a resource from a Google API.
@@ -126,13 +132,24 @@ class Download(_request_helpers.RequestsMixin, _download.Download):
             # the stream is indeed compressed, this will delegate the checksum
             # object to the decoder and return a _DoNothingHash here.
             local_checksum_object = _add_decoder(response.raw, checksum_object)
-            body_iter = response.iter_content(
-                chunk_size=_request_helpers._SINGLE_GET_CHUNK_SIZE, decode_unicode=False
-            )
-            for chunk in body_iter:
-                self._stream.write(chunk)
-                self._bytes_downloaded += len(chunk)
-                local_checksum_object.update(chunk)
+
+            # This is useful for smaller files, or when the user wants to
+            # download the entire file in one go.
+            if self.single_shot_download:
+                content = response.raw.read(decode_content=True)
+                self._stream.write(content)
+                self._bytes_downloaded += len(content)
+                local_checksum_object.update(content)
+                response._content_consumed = True
+            else:
+                body_iter = response.iter_content(
+                    chunk_size=_request_helpers._SINGLE_GET_CHUNK_SIZE,
+                    decode_unicode=False,
+                )
+                for chunk in body_iter:
+                    self._stream.write(chunk)
+                    self._bytes_downloaded += len(chunk)
+                    local_checksum_object.update(chunk)
 
         # Don't validate the checksum for partial responses.
         if (
@@ -141,13 +158,30 @@ class Download(_request_helpers.RequestsMixin, _download.Download):
         ):
             actual_checksum = _helpers.prepare_checksum_digest(checksum_object.digest())
             if actual_checksum != expected_checksum:
-                msg = _CHECKSUM_MISMATCH.format(
-                    self.media_url,
-                    expected_checksum,
-                    actual_checksum,
-                    checksum_type=self.checksum.upper(),
+                headers = self._get_headers(response)
+                x_goog_encoding = headers.get("x-goog-stored-content-encoding")
+                x_goog_length = headers.get("x-goog-stored-content-length")
+                content_length_msg = _RESPONSE_HEADERS_INFO.format(
+                    x_goog_length, x_goog_encoding, self._bytes_downloaded
                 )
-                raise DataCorruption(response, msg)
+                if (
+                    x_goog_length
+                    and self._bytes_downloaded < int(x_goog_length)
+                    and x_goog_encoding != "gzip"
+                ):
+                    # The library will attempt to trigger a retry by raising a ConnectionError, if
+                    # (a) bytes_downloaded is less than response header x-goog-stored-content-length, and
+                    # (b) the object is not gzip-compressed when stored in Cloud Storage.
+                    raise ConnectionError(content_length_msg)
+                else:
+                    msg = _CHECKSUM_MISMATCH.format(
+                        self.media_url,
+                        expected_checksum,
+                        actual_checksum,
+                        checksum_type=self.checksum.upper(),
+                    )
+                    msg += content_length_msg
+                    raise DataCorruption(response, msg)
 
     def consume(
         self,
@@ -322,13 +356,21 @@ class RawDownload(_request_helpers.RawRequestsMixin, _download.Download):
             checksum_object = self._checksum_object
 
         with response:
-            body_iter = response.raw.stream(
-                _request_helpers._SINGLE_GET_CHUNK_SIZE, decode_content=False
-            )
-            for chunk in body_iter:
-                self._stream.write(chunk)
-                self._bytes_downloaded += len(chunk)
-                checksum_object.update(chunk)
+            # This is useful for smaller files, or when the user wants to
+            # download the entire file in one go.
+            if self.single_shot_download:
+                content = response.raw.read()
+                self._stream.write(content)
+                self._bytes_downloaded += len(content)
+                checksum_object.update(content)
+            else:
+                body_iter = response.raw.stream(
+                    _request_helpers._SINGLE_GET_CHUNK_SIZE, decode_content=False
+                )
+                for chunk in body_iter:
+                    self._stream.write(chunk)
+                    self._bytes_downloaded += len(chunk)
+                    checksum_object.update(chunk)
             response._content_consumed = True
 
         # Don't validate the checksum for partial responses.
@@ -339,13 +381,30 @@ class RawDownload(_request_helpers.RawRequestsMixin, _download.Download):
             actual_checksum = _helpers.prepare_checksum_digest(checksum_object.digest())
 
             if actual_checksum != expected_checksum:
-                msg = _CHECKSUM_MISMATCH.format(
-                    self.media_url,
-                    expected_checksum,
-                    actual_checksum,
-                    checksum_type=self.checksum.upper(),
+                headers = self._get_headers(response)
+                x_goog_encoding = headers.get("x-goog-stored-content-encoding")
+                x_goog_length = headers.get("x-goog-stored-content-length")
+                content_length_msg = _RESPONSE_HEADERS_INFO.format(
+                    x_goog_length, x_goog_encoding, self._bytes_downloaded
                 )
-                raise DataCorruption(response, msg)
+                if (
+                    x_goog_length
+                    and self._bytes_downloaded < int(x_goog_length)
+                    and x_goog_encoding != "gzip"
+                ):
+                    # The library will attempt to trigger a retry by raising a ConnectionError, if
+                    # (a) bytes_downloaded is less than response header x-goog-stored-content-length, and
+                    # (b) the object is not gzip-compressed when stored in Cloud Storage.
+                    raise ConnectionError(content_length_msg)
+                else:
+                    msg = _CHECKSUM_MISMATCH.format(
+                        self.media_url,
+                        expected_checksum,
+                        actual_checksum,
+                        checksum_type=self.checksum.upper(),
+                    )
+                    msg += content_length_msg
+                    raise DataCorruption(response, msg)
 
     def consume(
         self,