azure-storage-blob 12.26.0b1__py3-none-any.whl → 12.27.0__py3-none-any.whl

azure/storage/blob/_shared/policies.py

@@ -28,18 +28,18 @@ from azure.core.pipeline.policies import (
     HTTPPolicy,
     NetworkTraceLoggingPolicy,
     RequestHistory,
-    SansIOHTTPPolicy
+    SansIOHTTPPolicy,
 )
 
 from .authentication import AzureSigningError, StorageHttpChallenge
 from .constants import DEFAULT_OAUTH_SCOPE
-from .models import LocationMode
+from .models import LocationMode, StorageErrorCode
 
 if TYPE_CHECKING:
     from azure.core.credentials import TokenCredential
     from azure.core.pipeline.transport import (  # pylint: disable=non-abstract-transport-import
         PipelineRequest,
-        PipelineResponse
+        PipelineResponse,
     )
 
 
@@ -48,14 +48,14 @@ _LOGGER = logging.getLogger(__name__)
 
 def encode_base64(data):
     if isinstance(data, str):
-        data = data.encode('utf-8')
+        data = data.encode("utf-8")
     encoded = base64.b64encode(data)
-    return encoded.decode('utf-8')
+    return encoded.decode("utf-8")
 
 
 # Are we out of retries?
 def is_exhausted(settings):
-    retry_counts = (settings['total'], settings['connect'], settings['read'], settings['status'])
+    retry_counts = (settings["total"], settings["connect"], settings["read"], settings["status"])
     retry_counts = list(filter(None, retry_counts))
     if not retry_counts:
         return False
@@ -63,8 +63,8 @@ def is_exhausted(settings):
 
 
 def retry_hook(settings, **kwargs):
-    if settings['hook']:
-        settings['hook'](retry_count=settings['count'] - 1, location_mode=settings['mode'], **kwargs)
+    if settings["hook"]:
+        settings["hook"](retry_count=settings["count"] - 1, location_mode=settings["mode"], **kwargs)
 
 
 # Is this method/status code retryable? (Based on allowlists and control
@@ -72,7 +72,7 @@ def retry_hook(settings, **kwargs):
 # respect the Retry-After header, whether this header is present, and
 # whether the returned status code is on the list of status codes to
 # be retried upon on the presence of the aforementioned header)
-def is_retry(response, mode):
+def is_retry(response, mode):  # pylint: disable=too-many-return-statements
     status = response.http_response.status_code
     if 300 <= status < 500:
         # An exception occurred, but in most cases it was expected. Examples could
@@ -83,6 +83,14 @@ def is_retry(response, mode):
         if status == 408:
             # Response code 408 is a timeout and should be retried.
             return True
+        if status >= 400:
+            error_code = response.http_response.headers.get("x-ms-copy-source-error-code")
+            if error_code in [
+                StorageErrorCode.OPERATION_TIMED_OUT,
+                StorageErrorCode.INTERNAL_ERROR,
+                StorageErrorCode.SERVER_BUSY,
+            ]:
+                return True
         return False
     if status >= 500:
         # Response codes above 500 with the exception of 501 Not Implemented and
@@ -95,40 +103,39 @@ def is_retry(response, mode):
 
 def is_checksum_retry(response):
     # retry if invalid content md5
-    if response.context.get('validate_content', False) and response.http_response.headers.get('content-md5'):
-        computed_md5 = response.http_request.headers.get('content-md5', None) or \
-                            encode_base64(StorageContentValidation.get_content_md5(response.http_response.body()))
-        if response.http_response.headers['content-md5'] != computed_md5:
+    if response.context.get("validate_content", False) and response.http_response.headers.get("content-md5"):
+        computed_md5 = response.http_request.headers.get("content-md5", None) or encode_base64(
+            StorageContentValidation.get_content_md5(response.http_response.body())
+        )
+        if response.http_response.headers["content-md5"] != computed_md5:
             return True
     return False
 
 
 def urljoin(base_url, stub_url):
     parsed = urlparse(base_url)
-    parsed = parsed._replace(path=parsed.path + '/' + stub_url)
+    parsed = parsed._replace(path=parsed.path + "/" + stub_url)
     return parsed.geturl()
 
 
 class QueueMessagePolicy(SansIOHTTPPolicy):
 
     def on_request(self, request):
-        message_id = request.context.options.pop('queue_message_id', None)
+        message_id = request.context.options.pop("queue_message_id", None)
         if message_id:
-            request.http_request.url = urljoin(
-                request.http_request.url,
-                message_id)
+            request.http_request.url = urljoin(request.http_request.url, message_id)
 
 
 class StorageHeadersPolicy(HeadersPolicy):
-    request_id_header_name = 'x-ms-client-request-id'
+    request_id_header_name = "x-ms-client-request-id"
 
     def on_request(self, request: "PipelineRequest") -> None:
         super(StorageHeadersPolicy, self).on_request(request)
         current_time = format_date_time(time())
-        request.http_request.headers['x-ms-date'] = current_time
+        request.http_request.headers["x-ms-date"] = current_time
 
-        custom_id = request.context.options.pop('client_request_id', None)
-        request.http_request.headers['x-ms-client-request-id'] = custom_id or str(uuid.uuid1())
+        custom_id = request.context.options.pop("client_request_id", None)
+        request.http_request.headers["x-ms-client-request-id"] = custom_id or str(uuid.uuid1())
 
     # def on_response(self, request, response):
     #     # raise exception if the echoed client request id from the service is not identical to the one we sent
@@ -153,7 +160,7 @@ class StorageHosts(SansIOHTTPPolicy):
         super(StorageHosts, self).__init__()
 
     def on_request(self, request: "PipelineRequest") -> None:
-        request.context.options['hosts'] = self.hosts
+        request.context.options["hosts"] = self.hosts
         parsed_url = urlparse(request.http_request.url)
 
         # Detect what location mode we're currently requesting with
@@ -163,10 +170,10 @@ class StorageHosts(SansIOHTTPPolicy):
                 location_mode = key
 
         # See if a specific location mode has been specified, and if so, redirect
-        use_location = request.context.options.pop('use_location', None)
+        use_location = request.context.options.pop("use_location", None)
         if use_location:
             # Lock retries to the specific location
-            request.context.options['retry_to_secondary'] = False
+            request.context.options["retry_to_secondary"] = False
             if use_location not in self.hosts:
                 raise ValueError(f"Attempting to use undefined host location {use_location}")
             if use_location != location_mode:
@@ -175,7 +182,7 @@ class StorageHosts(SansIOHTTPPolicy):
                 request.http_request.url = updated.geturl()
                 location_mode = use_location
 
-        request.context.options['location_mode'] = location_mode
+        request.context.options["location_mode"] = location_mode
 
 
 class StorageLoggingPolicy(NetworkTraceLoggingPolicy):
@@ -200,19 +207,19 @@ class StorageLoggingPolicy(NetworkTraceLoggingPolicy):
             try:
                 log_url = http_request.url
                 query_params = http_request.query
-                if 'sig' in query_params:
-                    log_url = log_url.replace(query_params['sig'], "sig=*****")
+                if "sig" in query_params:
+                    log_url = log_url.replace(query_params["sig"], "sig=*****")
                 _LOGGER.debug("Request URL: %r", log_url)
                 _LOGGER.debug("Request method: %r", http_request.method)
                 _LOGGER.debug("Request headers:")
                 for header, value in http_request.headers.items():
-                    if header.lower() == 'authorization':
-                        value = '*****'
-                    elif header.lower() == 'x-ms-copy-source' and 'sig' in value:
+                    if header.lower() == "authorization":
+                        value = "*****"
+                    elif header.lower() == "x-ms-copy-source" and "sig" in value:
                         # take the url apart and scrub away the signed signature
                         scheme, netloc, path, params, query, fragment = urlparse(value)
                         parsed_qs = dict(parse_qsl(query))
-                        parsed_qs['sig'] = '*****'
+                        parsed_qs["sig"] = "*****"
 
                         # the SAS needs to be put back together
                         value = urlunparse((scheme, netloc, path, params, urlencode(parsed_qs), fragment))
@@ -242,11 +249,11 @@ class StorageLoggingPolicy(NetworkTraceLoggingPolicy):
                 # We don't want to log binary data if the response is a file.
                 _LOGGER.debug("Response content:")
                 pattern = re.compile(r'attachment; ?filename=["\w.]+', re.IGNORECASE)
-                header = response.http_response.headers.get('content-disposition')
+                header = response.http_response.headers.get("content-disposition")
                 resp_content_type = response.http_response.headers.get("content-type", "")
 
                 if header and pattern.match(header):
-                    filename = header.partition('=')[2]
+                    filename = header.partition("=")[2]
                     _LOGGER.debug("File attachments: %s", filename)
                 elif resp_content_type.endswith("octet-stream"):
                     _LOGGER.debug("Body contains binary data.")
@@ -268,11 +275,11 @@ class StorageLoggingPolicy(NetworkTraceLoggingPolicy):
 class StorageRequestHook(SansIOHTTPPolicy):
 
     def __init__(self, **kwargs):
-        self._request_callback = kwargs.get('raw_request_hook')
+        self._request_callback = kwargs.get("raw_request_hook")
         super(StorageRequestHook, self).__init__()
 
     def on_request(self, request: "PipelineRequest") -> None:
-        request_callback = request.context.options.pop('raw_request_hook', self._request_callback)
+        request_callback = request.context.options.pop("raw_request_hook", self._request_callback)
         if request_callback:
             request_callback(request)
 
@@ -280,49 +287,50 @@ class StorageRequestHook(SansIOHTTPPolicy):
 class StorageResponseHook(HTTPPolicy):
 
     def __init__(self, **kwargs):
-        self._response_callback = kwargs.get('raw_response_hook')
+        self._response_callback = kwargs.get("raw_response_hook")
         super(StorageResponseHook, self).__init__()
 
     def send(self, request: "PipelineRequest") -> "PipelineResponse":
         # Values could be 0
-        data_stream_total = request.context.get('data_stream_total')
+        data_stream_total = request.context.get("data_stream_total")
         if data_stream_total is None:
-            data_stream_total = request.context.options.pop('data_stream_total', None)
-        download_stream_current = request.context.get('download_stream_current')
+            data_stream_total = request.context.options.pop("data_stream_total", None)
+        download_stream_current = request.context.get("download_stream_current")
         if download_stream_current is None:
-            download_stream_current = request.context.options.pop('download_stream_current', None)
-        upload_stream_current = request.context.get('upload_stream_current')
+            download_stream_current = request.context.options.pop("download_stream_current", None)
+        upload_stream_current = request.context.get("upload_stream_current")
         if upload_stream_current is None:
-            upload_stream_current = request.context.options.pop('upload_stream_current', None)
+            upload_stream_current = request.context.options.pop("upload_stream_current", None)
 
-        response_callback = request.context.get('response_callback') or \
-            request.context.options.pop('raw_response_hook', self._response_callback)
+        response_callback = request.context.get("response_callback") or request.context.options.pop(
+            "raw_response_hook", self._response_callback
+        )
 
         response = self.next.send(request)
 
-        will_retry = is_retry(response, request.context.options.get('mode')) or is_checksum_retry(response)
+        will_retry = is_retry(response, request.context.options.get("mode")) or is_checksum_retry(response)
         # Auth error could come from Bearer challenge, in which case this request will be made again
         is_auth_error = response.http_response.status_code == 401
         should_update_counts = not (will_retry or is_auth_error)
 
         if should_update_counts and download_stream_current is not None:
-            download_stream_current += int(response.http_response.headers.get('Content-Length', 0))
+            download_stream_current += int(response.http_response.headers.get("Content-Length", 0))
             if data_stream_total is None:
-                content_range = response.http_response.headers.get('Content-Range')
+                content_range = response.http_response.headers.get("Content-Range")
                 if content_range:
-                    data_stream_total = int(content_range.split(' ', 1)[1].split('/', 1)[1])
+                    data_stream_total = int(content_range.split(" ", 1)[1].split("/", 1)[1])
                 else:
                     data_stream_total = download_stream_current
         elif should_update_counts and upload_stream_current is not None:
-            upload_stream_current += int(response.http_request.headers.get('Content-Length', 0))
+            upload_stream_current += int(response.http_request.headers.get("Content-Length", 0))
         for pipeline_obj in [request, response]:
-            if hasattr(pipeline_obj, 'context'):
-                pipeline_obj.context['data_stream_total'] = data_stream_total
-                pipeline_obj.context['download_stream_current'] = download_stream_current
-                pipeline_obj.context['upload_stream_current'] = upload_stream_current
+            if hasattr(pipeline_obj, "context"):
+                pipeline_obj.context["data_stream_total"] = data_stream_total
+                pipeline_obj.context["download_stream_current"] = download_stream_current
+                pipeline_obj.context["upload_stream_current"] = upload_stream_current
         if response_callback:
             response_callback(response)
-            request.context['response_callback'] = response_callback
+            request.context["response_callback"] = response_callback
         return response
 
 
@@ -332,7 +340,8 @@ class StorageContentValidation(SansIOHTTPPolicy):
 
     This will overwrite any headers already defined in the request.
     """
-    header_name = 'Content-MD5'
+
+    header_name = "Content-MD5"
 
     def __init__(self, **kwargs: Any) -> None:  # pylint: disable=unused-argument
         super(StorageContentValidation, self).__init__()
@@ -342,10 +351,10 @@ class StorageContentValidation(SansIOHTTPPolicy):
         # Since HTTP does not differentiate between no content and empty content,
         # we have to perform a None check.
         data = data or b""
-        md5 = hashlib.md5() # nosec
+        md5 = hashlib.md5()  # nosec
         if isinstance(data, bytes):
             md5.update(data)
-        elif hasattr(data, 'read'):
+        elif hasattr(data, "read"):
             pos = 0
             try:
                 pos = data.tell()
@@ -363,22 +372,25 @@ class StorageContentValidation(SansIOHTTPPolicy):
         return md5.digest()
 
     def on_request(self, request: "PipelineRequest") -> None:
-        validate_content = request.context.options.pop('validate_content', False)
-        if validate_content and request.http_request.method != 'GET':
+        validate_content = request.context.options.pop("validate_content", False)
+        if validate_content and request.http_request.method != "GET":
             computed_md5 = encode_base64(StorageContentValidation.get_content_md5(request.http_request.data))
             request.http_request.headers[self.header_name] = computed_md5
-            request.context['validate_content_md5'] = computed_md5
-        request.context['validate_content'] = validate_content
+            request.context["validate_content_md5"] = computed_md5
+        request.context["validate_content"] = validate_content
 
     def on_response(self, request: "PipelineRequest", response: "PipelineResponse") -> None:
-        if response.context.get('validate_content', False) and response.http_response.headers.get('content-md5'):
-            computed_md5 = request.context.get('validate_content_md5') or \
-                encode_base64(StorageContentValidation.get_content_md5(response.http_response.body()))
-            if response.http_response.headers['content-md5'] != computed_md5:
-                raise AzureError((
-                    f"MD5 mismatch. Expected value is '{response.http_response.headers['content-md5']}', "
-                    f"computed value is '{computed_md5}'."),
-                    response=response.http_response
+        if response.context.get("validate_content", False) and response.http_response.headers.get("content-md5"):
+            computed_md5 = request.context.get("validate_content_md5") or encode_base64(
+                StorageContentValidation.get_content_md5(response.http_response.body())
+            )
+            if response.http_response.headers["content-md5"] != computed_md5:
+                raise AzureError(
+                    (
+                        f"MD5 mismatch. Expected value is '{response.http_response.headers['content-md5']}', "
+                        f"computed value is '{computed_md5}'."
+                    ),
+                    response=response.http_response,
                 )
 
 
@@ -399,33 +411,41 @@ class StorageRetryPolicy(HTTPPolicy):
     """Whether the secondary endpoint should be retried."""
 
     def __init__(self, **kwargs: Any) -> None:
-        self.total_retries = kwargs.pop('retry_total', 10)
-        self.connect_retries = kwargs.pop('retry_connect', 3)
-        self.read_retries = kwargs.pop('retry_read', 3)
-        self.status_retries = kwargs.pop('retry_status', 3)
-        self.retry_to_secondary = kwargs.pop('retry_to_secondary', False)
+        self.total_retries = kwargs.pop("retry_total", 10)
+        self.connect_retries = kwargs.pop("retry_connect", 3)
+        self.read_retries = kwargs.pop("retry_read", 3)
+        self.status_retries = kwargs.pop("retry_status", 3)
+        self.retry_to_secondary = kwargs.pop("retry_to_secondary", False)
         super(StorageRetryPolicy, self).__init__()
 
     def _set_next_host_location(self, settings: Dict[str, Any], request: "PipelineRequest") -> None:
         """
         A function which sets the next host location on the request, if applicable.
 
-        :param Dict[str, Any]] settings: The configurable values pertaining to the next host location.
+        :param Dict[str, Any] settings: The configurable values pertaining to the next host location.
         :param PipelineRequest request: A pipeline request object.
         """
-        if settings['hosts'] and all(settings['hosts'].values()):
+        if settings["hosts"] and all(settings["hosts"].values()):
             url = urlparse(request.url)
             # If there's more than one possible location, retry to the alternative
-            if settings['mode'] == LocationMode.PRIMARY:
-                settings['mode'] = LocationMode.SECONDARY
+            if settings["mode"] == LocationMode.PRIMARY:
+                settings["mode"] = LocationMode.SECONDARY
             else:
-                settings['mode'] = LocationMode.PRIMARY
-            updated = url._replace(netloc=settings['hosts'].get(settings['mode']))
+                settings["mode"] = LocationMode.PRIMARY
+            updated = url._replace(netloc=settings["hosts"].get(settings["mode"]))
             request.url = updated.geturl()
 
     def configure_retries(self, request: "PipelineRequest") -> Dict[str, Any]:
+        """
+        Configure the retry settings for the request.
+        
+        :param request: A pipeline request object.
+        :type request: ~azure.core.pipeline.PipelineRequest
+        :return: A dictionary containing the retry settings.
+        :rtype: Dict[str, Any]
+        """
         body_position = None
-        if hasattr(request.http_request.body, 'read'):
+        if hasattr(request.http_request.body, "read"):
             try:
                 body_position = request.http_request.body.tell()
             except (AttributeError, UnsupportedOperation):
@@ -433,129 +453,140 @@ class StorageRetryPolicy(HTTPPolicy):
                 pass
         options = request.context.options
         return {
-            'total': options.pop("retry_total", self.total_retries),
-            'connect': options.pop("retry_connect", self.connect_retries),
-            'read': options.pop("retry_read", self.read_retries),
-            'status': options.pop("retry_status", self.status_retries),
-            'retry_secondary': options.pop("retry_to_secondary", self.retry_to_secondary),
-            'mode': options.pop("location_mode", LocationMode.PRIMARY),
-            'hosts': options.pop("hosts", None),
-            'hook': options.pop("retry_hook", None),
-            'body_position': body_position,
-            'count': 0,
-            'history': []
+            "total": options.pop("retry_total", self.total_retries),
+            "connect": options.pop("retry_connect", self.connect_retries),
+            "read": options.pop("retry_read", self.read_retries),
+            "status": options.pop("retry_status", self.status_retries),
+            "retry_secondary": options.pop("retry_to_secondary", self.retry_to_secondary),
+            "mode": options.pop("location_mode", LocationMode.PRIMARY),
+            "hosts": options.pop("hosts", None),
+            "hook": options.pop("retry_hook", None),
+            "body_position": body_position,
+            "count": 0,
+            "history": [],
         }
 
     def get_backoff_time(self, settings: Dict[str, Any]) -> float:  # pylint: disable=unused-argument
-        """ Formula for computing the current backoff.
+        """Formula for computing the current backoff.
         Should be calculated by child class.
 
         :param Dict[str, Any] settings: The configurable values pertaining to the backoff time.
-        :returns: The backoff time.
+        :return: The backoff time.
         :rtype: float
         """
         return 0
 
     def sleep(self, settings, transport):
+        """Sleep for the backoff time.
+        
+        :param Dict[str, Any] settings: The configurable values pertaining to the sleep operation.
+        :param transport: The transport to use for sleeping.
+        :type transport:
+            ~azure.core.pipeline.transport.AsyncioBaseTransport or
+            ~azure.core.pipeline.transport.BaseTransport
+        """
         backoff = self.get_backoff_time(settings)
         if not backoff or backoff < 0:
             return
         transport.sleep(backoff)
 
     def increment(
-        self, settings: Dict[str, Any],
+        self,
+        settings: Dict[str, Any],
         request: "PipelineRequest",
         response: Optional["PipelineResponse"] = None,
-        error: Optional[AzureError] = None
+        error: Optional[AzureError] = None,
     ) -> bool:
         """Increment the retry counters.
 
         :param Dict[str, Any] settings: The configurable values pertaining to the increment operation.
-        :param PipelineRequest request: A pipeline request object.
-        :param Optional[PipelineResponse] response: A pipeline response object.
-        :param Optional[AzureError] error: An error encountered during the request, or
+        :param request: A pipeline request object.
+        :type request: ~azure.core.pipeline.PipelineRequest
+        :param response: A pipeline response object.
+        :type response: ~azure.core.pipeline.PipelineResponse or None
+        :param error: An error encountered during the request, or
             None if the response was received successfully.
-        :returns: Whether the retry attempts are exhausted.
+        :type error: ~azure.core.exceptions.AzureError or None
+        :return: Whether the retry attempts are exhausted.
         :rtype: bool
         """
-        settings['total'] -= 1
+        settings["total"] -= 1
 
         if error and isinstance(error, ServiceRequestError):
             # Errors when we're fairly sure that the server did not receive the
             # request, so it should be safe to retry.
-            settings['connect'] -= 1
-            settings['history'].append(RequestHistory(request, error=error))
+            settings["connect"] -= 1
+            settings["history"].append(RequestHistory(request, error=error))
 
         elif error and isinstance(error, ServiceResponseError):
             # Errors that occur after the request has been started, so we should
             # assume that the server began processing it.
-            settings['read'] -= 1
-            settings['history'].append(RequestHistory(request, error=error))
+            settings["read"] -= 1
+            settings["history"].append(RequestHistory(request, error=error))
 
         else:
             # Incrementing because of a server error like a 500 in
             # status_forcelist and a the given method is in the allowlist
             if response:
-                settings['status'] -= 1
-                settings['history'].append(RequestHistory(request, http_response=response))
+                settings["status"] -= 1
+                settings["history"].append(RequestHistory(request, http_response=response))
 
         if not is_exhausted(settings):
-            if request.method not in ['PUT'] and settings['retry_secondary']:
+            if request.method not in ["PUT"] and settings["retry_secondary"]:
                 self._set_next_host_location(settings, request)
 
             # rewind the request body if it is a stream
-            if request.body and hasattr(request.body, 'read'):
+            if request.body and hasattr(request.body, "read"):
                 # no position was saved, then retry would not work
-                if settings['body_position'] is None:
+                if settings["body_position"] is None:
                     return False
                 try:
                     # attempt to rewind the body to the initial position
-                    request.body.seek(settings['body_position'], SEEK_SET)
+                    request.body.seek(settings["body_position"], SEEK_SET)
                 except (UnsupportedOperation, ValueError):
                     # if body is not seekable, then retry would not work
                     return False
-            settings['count'] += 1
+            settings["count"] += 1
             return True
         return False
 
     def send(self, request):
+        """Send the request with retry logic.
+        
+        :param request: A pipeline request object.
+        :type request: ~azure.core.pipeline.PipelineRequest
+        :return: A pipeline response object.
+        :rtype: ~azure.core.pipeline.PipelineResponse
+        """
         retries_remaining = True
         response = None
         retry_settings = self.configure_retries(request)
         while retries_remaining:
             try:
                 response = self.next.send(request)
-                if is_retry(response, retry_settings['mode']) or is_checksum_retry(response):
+                if is_retry(response, retry_settings["mode"]) or is_checksum_retry(response):
                     retries_remaining = self.increment(
-                        retry_settings,
-                        request=request.http_request,
-                        response=response.http_response)
+                        retry_settings, request=request.http_request, response=response.http_response
+                    )
                     if retries_remaining:
                         retry_hook(
-                            retry_settings,
-                            request=request.http_request,
-                            response=response.http_response,
-                            error=None)
+                            retry_settings, request=request.http_request, response=response.http_response, error=None
+                        )
                         self.sleep(retry_settings, request.context.transport)
                         continue
                 break
             except AzureError as err:
                 if isinstance(err, AzureSigningError):
                     raise
-                retries_remaining = self.increment(
-                    retry_settings, request=request.http_request, error=err)
+                retries_remaining = self.increment(retry_settings, request=request.http_request, error=err)
                 if retries_remaining:
-                    retry_hook(
-                        retry_settings,
-                        request=request.http_request,
-                        response=None,
-                        error=err)
+                    retry_hook(retry_settings, request=request.http_request, response=None, error=err)
                     self.sleep(retry_settings, request.context.transport)
                     continue
                 raise err
-        if retry_settings['history']:
-            response.context['history'] = retry_settings['history']
-        response.http_response.location_mode = retry_settings['mode']
+        if retry_settings["history"]:
+            response.context["history"] = retry_settings["history"]
+        response.http_response.location_mode = retry_settings["mode"]
         return response
 
 
@@ -571,12 +602,13 @@ class ExponentialRetry(StorageRetryPolicy):
     """A number in seconds which indicates a range to jitter/randomize for the back-off interval."""
 
     def __init__(
-        self, initial_backoff: int = 15,
+        self,
+        initial_backoff: int = 15,
         increment_base: int = 3,
         retry_total: int = 3,
         retry_to_secondary: bool = False,
         random_jitter_range: int = 3,
-        **kwargs: Any
+        **kwargs: Any,
     ) -> None:
         """
         Constructs an Exponential retry object. The initial_backoff is used for
@@ -601,21 +633,20 @@ class ExponentialRetry(StorageRetryPolicy):
         self.initial_backoff = initial_backoff
         self.increment_base = increment_base
         self.random_jitter_range = random_jitter_range
-        super(ExponentialRetry, self).__init__(
-            retry_total=retry_total, retry_to_secondary=retry_to_secondary, **kwargs)
+        super(ExponentialRetry, self).__init__(retry_total=retry_total, retry_to_secondary=retry_to_secondary, **kwargs)
 
     def get_backoff_time(self, settings: Dict[str, Any]) -> float:
         """
         Calculates how long to sleep before retrying.
 
-        :param Dict[str, Any]] settings: The configurable values pertaining to get backoff time.
-        :returns:
+        :param Dict[str, Any] settings: The configurable values pertaining to get backoff time.
+        :return:
             A float indicating how long to wait before retrying the request,
             or None to indicate no retry should be performed.
         :rtype: float
         """
         random_generator = random.Random()
-        backoff = self.initial_backoff + (0 if settings['count'] == 0 else pow(self.increment_base, settings['count']))
+        backoff = self.initial_backoff + (0 if settings["count"] == 0 else pow(self.increment_base, settings["count"]))
         random_range_start = backoff - self.random_jitter_range if backoff > self.random_jitter_range else 0
         random_range_end = backoff + self.random_jitter_range
         return random_generator.uniform(random_range_start, random_range_end)
@@ -630,11 +661,12 @@ class LinearRetry(StorageRetryPolicy):
     """A number in seconds which indicates a range to jitter/randomize for the back-off interval."""
 
     def __init__(
-        self, backoff: int = 15,
+        self,
+        backoff: int = 15,
         retry_total: int = 3,
         retry_to_secondary: bool = False,
         random_jitter_range: int = 3,
-        **kwargs: Any
+        **kwargs: Any,
     ) -> None:
         """
         Constructs a Linear retry object.
@@ -653,15 +685,14 @@ class LinearRetry(StorageRetryPolicy):
         """
         self.backoff = backoff
         self.random_jitter_range = random_jitter_range
-        super(LinearRetry, self).__init__(
-            retry_total=retry_total, retry_to_secondary=retry_to_secondary, **kwargs)
+        super(LinearRetry, self).__init__(retry_total=retry_total, retry_to_secondary=retry_to_secondary, **kwargs)
 
     def get_backoff_time(self, settings: Dict[str, Any]) -> float:
         """
         Calculates how long to sleep before retrying.
 
-        :param Dict[str, Any]] settings: The configurable values pertaining to the backoff time.
-        :returns:
+        :param Dict[str, Any] settings: The configurable values pertaining to the backoff time.
+        :return:
             A float indicating how long to wait before retrying the request,
             or None to indicate no retry should be performed.
         :rtype: float
@@ -669,19 +700,27 @@ class LinearRetry(StorageRetryPolicy):
         random_generator = random.Random()
         # the backoff interval normally does not change, however there is the possibility
         # that it was modified by accessing the property directly after initializing the object
-        random_range_start = self.backoff - self.random_jitter_range \
-            if self.backoff > self.random_jitter_range else 0
+        random_range_start = self.backoff - self.random_jitter_range if self.backoff > self.random_jitter_range else 0
         random_range_end = self.backoff + self.random_jitter_range
         return random_generator.uniform(random_range_start, random_range_end)
 
 
 class StorageBearerTokenCredentialPolicy(BearerTokenCredentialPolicy):
-    """ Custom Bearer token credential policy for following Storage Bearer challenges """
+    """Custom Bearer token credential policy for following Storage Bearer challenges"""
 
     def __init__(self, credential: "TokenCredential", audience: str, **kwargs: Any) -> None:
         super(StorageBearerTokenCredentialPolicy, self).__init__(credential, audience, **kwargs)
 
     def on_challenge(self, request: "PipelineRequest", response: "PipelineResponse") -> bool:
+        """Handle the challenge from the service and authorize the request.
+        
+        :param request: The request object.
+        :type request: ~azure.core.pipeline.PipelineRequest
+        :param response: The response object.
+        :type response: ~azure.core.pipeline.PipelineResponse        
+        :return: True if the request was authorized, False otherwise.
+        :rtype: bool
+        """
         try:
             auth_header = response.http_response.headers.get("WWW-Authenticate")
             challenge = StorageHttpChallenge(auth_header)