azure-storage-blob 12.19.1__py3-none-any.whl → 12.20.0__py3-none-any.whl

azure/storage/blob/_generated/operations/_service_operations.py

@@ -1,4 +1,4 @@
-# pylint: disable=too-many-lines
+# pylint: disable=too-many-lines,too-many-statements
 # coding=utf-8
 # --------------------------------------------------------------------------
 # Copyright (c) Microsoft Corporation. All rights reserved.
@@ -6,8 +6,7 @@
 # Code generated by Microsoft (R) AutoRest Code Generator.
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
-import sys
-from typing import Any, Callable, Dict, IO, Iterator, List, Optional, TypeVar, Union
+from typing import Any, Callable, Dict, IO, Iterator, List, Literal, Optional, TypeVar, Union
 
 from azure.core.exceptions import (
     ClientAuthenticationError,
@@ -27,10 +26,6 @@ from .. import models as _models
 from .._serialization import Serializer
 from .._vendor import _convert_request
 
-if sys.version_info >= (3, 8):
-    from typing import Literal  # pylint: disable=no-name-in-module, ungrouped-imports
-else:
-    from typing_extensions import Literal  # type: ignore  # pylint: disable=ungrouped-imports
 T = TypeVar("T")
 ClsType = Optional[Callable[[PipelineResponse[HttpRequest, HttpResponse], T, Dict[str, Any]], Any]]
 
@@ -260,7 +255,7 @@ def build_submit_batch_request(
     url: str,
     *,
     content_length: int,
-    content: IO,
+    content: IO[bytes],
     timeout: Optional[int] = None,
     request_id_parameter: Optional[str] = None,
     **kwargs: Any
@@ -387,13 +382,6 @@ class ServiceOperations:
          limit that is recorded in the analytics logs when storage analytics logging is enabled. Default
          value is None.
         :type request_id_parameter: str
-        :keyword restype: restype. Default value is "service". Note that overriding this default value
-         may result in unsupported behavior.
-        :paramtype restype: str
-        :keyword comp: comp. Default value is "properties". Note that overriding this default value may
-         result in unsupported behavior.
-        :paramtype comp: str
-        :keyword callable cls: A custom type or function that will be passed the direct response
         :return: None or the result of cls(response)
         :rtype: None
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -416,7 +404,7 @@ class ServiceOperations:
 
         _content = self._serialize.body(storage_service_properties, "StorageServiceProperties", is_xml=True)
 
-        request = build_set_properties_request(
+        _request = build_set_properties_request(
             url=self._config.url,
             timeout=timeout,
             request_id_parameter=request_id_parameter,
@@ -425,16 +413,15 @@ class ServiceOperations:
             content_type=content_type,
             version=self._config.version,
             content=_content,
-            template_url=self.set_properties.metadata["url"],
             headers=_headers,
             params=_params,
         )
-        request = _convert_request(request)
-        request.url = self._client.format_url(request.url)
+        _request = _convert_request(_request)
+        _request.url = self._client.format_url(_request.url)
 
         _stream = False
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
-            request, stream=_stream, **kwargs
+            _request, stream=_stream, **kwargs
         )
 
         response = pipeline_response.http_response
@@ -452,9 +439,7 @@ class ServiceOperations:
         response_headers["x-ms-version"] = self._deserialize("str", response.headers.get("x-ms-version"))
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    set_properties.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def get_properties(
@@ -472,13 +457,6 @@ class ServiceOperations:
          limit that is recorded in the analytics logs when storage analytics logging is enabled. Default
          value is None.
         :type request_id_parameter: str
-        :keyword restype: restype. Default value is "service". Note that overriding this default value
-         may result in unsupported behavior.
-        :paramtype restype: str
-        :keyword comp: comp. Default value is "properties". Note that overriding this default value may
-         result in unsupported behavior.
-        :paramtype comp: str
-        :keyword callable cls: A custom type or function that will be passed the direct response
         :return: StorageServiceProperties or the result of cls(response)
         :rtype: ~azure.storage.blob.models.StorageServiceProperties
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -498,23 +476,22 @@ class ServiceOperations:
         comp: Literal["properties"] = kwargs.pop("comp", _params.pop("comp", "properties"))
         cls: ClsType[_models.StorageServiceProperties] = kwargs.pop("cls", None)
 
-        request = build_get_properties_request(
+        _request = build_get_properties_request(
             url=self._config.url,
             timeout=timeout,
             request_id_parameter=request_id_parameter,
             restype=restype,
             comp=comp,
             version=self._config.version,
-            template_url=self.get_properties.metadata["url"],
             headers=_headers,
             params=_params,
         )
-        request = _convert_request(request)
-        request.url = self._client.format_url(request.url)
+        _request = _convert_request(_request)
+        _request.url = self._client.format_url(_request.url)
 
         _stream = False
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
-            request, stream=_stream, **kwargs
+            _request, stream=_stream, **kwargs
         )
 
         response = pipeline_response.http_response
@@ -534,11 +511,9 @@ class ServiceOperations:
         deserialized = self._deserialize("StorageServiceProperties", pipeline_response)
 
         if cls:
-            return cls(pipeline_response, deserialized, response_headers)
-
-        return deserialized
+            return cls(pipeline_response, deserialized, response_headers)  # type: ignore
 
-    get_properties.metadata = {"url": "{url}"}
+        return deserialized  # type: ignore
 
     @distributed_trace
     def get_statistics(
@@ -557,13 +532,6 @@ class ServiceOperations:
          limit that is recorded in the analytics logs when storage analytics logging is enabled. Default
          value is None.
         :type request_id_parameter: str
-        :keyword restype: restype. Default value is "service". Note that overriding this default value
-         may result in unsupported behavior.
-        :paramtype restype: str
-        :keyword comp: comp. Default value is "stats". Note that overriding this default value may
-         result in unsupported behavior.
-        :paramtype comp: str
-        :keyword callable cls: A custom type or function that will be passed the direct response
         :return: StorageServiceStats or the result of cls(response)
         :rtype: ~azure.storage.blob.models.StorageServiceStats
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -583,23 +551,22 @@ class ServiceOperations:
         comp: Literal["stats"] = kwargs.pop("comp", _params.pop("comp", "stats"))
         cls: ClsType[_models.StorageServiceStats] = kwargs.pop("cls", None)
 
-        request = build_get_statistics_request(
+        _request = build_get_statistics_request(
             url=self._config.url,
             timeout=timeout,
             request_id_parameter=request_id_parameter,
             restype=restype,
             comp=comp,
             version=self._config.version,
-            template_url=self.get_statistics.metadata["url"],
             headers=_headers,
             params=_params,
         )
-        request = _convert_request(request)
-        request.url = self._client.format_url(request.url)
+        _request = _convert_request(_request)
+        _request.url = self._client.format_url(_request.url)
 
         _stream = False
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
-            request, stream=_stream, **kwargs
+            _request, stream=_stream, **kwargs
         )
 
         response = pipeline_response.http_response
@@ -620,11 +587,9 @@ class ServiceOperations:
         deserialized = self._deserialize("StorageServiceStats", pipeline_response)
 
         if cls:
-            return cls(pipeline_response, deserialized, response_headers)
-
-        return deserialized
+            return cls(pipeline_response, deserialized, response_headers)  # type: ignore
 
-    get_statistics.metadata = {"url": "{url}"}
+        return deserialized  # type: ignore
 
     @distributed_trace
     def list_containers_segment(
@@ -669,10 +634,6 @@ class ServiceOperations:
          limit that is recorded in the analytics logs when storage analytics logging is enabled. Default
          value is None.
         :type request_id_parameter: str
-        :keyword comp: comp. Default value is "list". Note that overriding this default value may
-         result in unsupported behavior.
-        :paramtype comp: str
-        :keyword callable cls: A custom type or function that will be passed the direct response
         :return: ListContainersSegmentResponse or the result of cls(response)
         :rtype: ~azure.storage.blob.models.ListContainersSegmentResponse
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -691,7 +652,7 @@ class ServiceOperations:
         comp: Literal["list"] = kwargs.pop("comp", _params.pop("comp", "list"))
         cls: ClsType[_models.ListContainersSegmentResponse] = kwargs.pop("cls", None)
 
-        request = build_list_containers_segment_request(
+        _request = build_list_containers_segment_request(
             url=self._config.url,
             prefix=prefix,
             marker=marker,
@@ -701,16 +662,15 @@ class ServiceOperations:
             request_id_parameter=request_id_parameter,
             comp=comp,
             version=self._config.version,
-            template_url=self.list_containers_segment.metadata["url"],
             headers=_headers,
             params=_params,
         )
-        request = _convert_request(request)
-        request.url = self._client.format_url(request.url)
+        _request = _convert_request(_request)
+        _request.url = self._client.format_url(_request.url)
 
         _stream = False
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
-            request, stream=_stream, **kwargs
+            _request, stream=_stream, **kwargs
         )
 
         response = pipeline_response.http_response
@@ -730,11 +690,9 @@ class ServiceOperations:
         deserialized = self._deserialize("ListContainersSegmentResponse", pipeline_response)
 
         if cls:
-            return cls(pipeline_response, deserialized, response_headers)
-
-        return deserialized
+            return cls(pipeline_response, deserialized, response_headers)  # type: ignore
 
-    list_containers_segment.metadata = {"url": "{url}"}
+        return deserialized  # type: ignore
 
     @distributed_trace
     def get_user_delegation_key(
@@ -758,13 +716,6 @@ class ServiceOperations:
          limit that is recorded in the analytics logs when storage analytics logging is enabled. Default
          value is None.
         :type request_id_parameter: str
-        :keyword restype: restype. Default value is "service". Note that overriding this default value
-         may result in unsupported behavior.
-        :paramtype restype: str
-        :keyword comp: comp. Default value is "userdelegationkey". Note that overriding this default
-         value may result in unsupported behavior.
-        :paramtype comp: str
-        :keyword callable cls: A custom type or function that will be passed the direct response
         :return: UserDelegationKey or the result of cls(response)
         :rtype: ~azure.storage.blob.models.UserDelegationKey
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -787,7 +738,7 @@ class ServiceOperations:
 
         _content = self._serialize.body(key_info, "KeyInfo", is_xml=True)
 
-        request = build_get_user_delegation_key_request(
+        _request = build_get_user_delegation_key_request(
             url=self._config.url,
             timeout=timeout,
             request_id_parameter=request_id_parameter,
@@ -796,16 +747,15 @@ class ServiceOperations:
             content_type=content_type,
             version=self._config.version,
             content=_content,
-            template_url=self.get_user_delegation_key.metadata["url"],
             headers=_headers,
             params=_params,
         )
-        request = _convert_request(request)
-        request.url = self._client.format_url(request.url)
+        _request = _convert_request(_request)
+        _request.url = self._client.format_url(_request.url)
 
         _stream = False
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
-            request, stream=_stream, **kwargs
+            _request, stream=_stream, **kwargs
         )
 
         response = pipeline_response.http_response
@@ -826,23 +776,14 @@ class ServiceOperations:
         deserialized = self._deserialize("UserDelegationKey", pipeline_response)
 
         if cls:
-            return cls(pipeline_response, deserialized, response_headers)
-
-        return deserialized
+            return cls(pipeline_response, deserialized, response_headers)  # type: ignore
 
-    get_user_delegation_key.metadata = {"url": "{url}"}
+        return deserialized  # type: ignore
 
     @distributed_trace
     def get_account_info(self, **kwargs: Any) -> None:  # pylint: disable=inconsistent-return-statements
         """Returns the sku name and account kind.
 
-        :keyword restype: restype. Default value is "account". Note that overriding this default value
-         may result in unsupported behavior.
-        :paramtype restype: str
-        :keyword comp: comp. Default value is "properties". Note that overriding this default value may
-         result in unsupported behavior.
-        :paramtype comp: str
-        :keyword callable cls: A custom type or function that will be passed the direct response
         :return: None or the result of cls(response)
         :rtype: None
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -862,21 +803,20 @@ class ServiceOperations:
         comp: Literal["properties"] = kwargs.pop("comp", _params.pop("comp", "properties"))
         cls: ClsType[None] = kwargs.pop("cls", None)
 
-        request = build_get_account_info_request(
+        _request = build_get_account_info_request(
             url=self._config.url,
             restype=restype,
             comp=comp,
             version=self._config.version,
-            template_url=self.get_account_info.metadata["url"],
             headers=_headers,
             params=_params,
         )
-        request = _convert_request(request)
-        request.url = self._client.format_url(request.url)
+        _request = _convert_request(_request)
+        _request.url = self._client.format_url(_request.url)
 
         _stream = False
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
-            request, stream=_stream, **kwargs
+            _request, stream=_stream, **kwargs
         )
 
         response = pipeline_response.http_response
@@ -898,15 +838,13 @@ class ServiceOperations:
         response_headers["x-ms-is-hns-enabled"] = self._deserialize("bool", response.headers.get("x-ms-is-hns-enabled"))
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    get_account_info.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def submit_batch(
         self,
         content_length: int,
-        body: IO,
+        body: IO[bytes],
         timeout: Optional[int] = None,
         request_id_parameter: Optional[str] = None,
         **kwargs: Any
@@ -916,7 +854,7 @@ class ServiceOperations:
         :param content_length: The length of the request. Required.
         :type content_length: int
         :param body: Initial data. Required.
-        :type body: IO
+        :type body: IO[bytes]
         :param timeout: The timeout parameter is expressed in seconds. For more information, see
          :code:`<a
          href="https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
@@ -926,11 +864,7 @@ class ServiceOperations:
          limit that is recorded in the analytics logs when storage analytics logging is enabled. Default
          value is None.
         :type request_id_parameter: str
-        :keyword comp: comp. Default value is "batch". Note that overriding this default value may
-         result in unsupported behavior.
-        :paramtype comp: str
-        :keyword callable cls: A custom type or function that will be passed the direct response
-        :return: Iterator of the response bytes or the result of cls(response)
+        :return: Iterator[bytes] or the result of cls(response)
         :rtype: Iterator[bytes]
         :raises ~azure.core.exceptions.HttpResponseError:
         """
@@ -953,7 +887,7 @@ class ServiceOperations:
 
         _content = body
 
-        request = build_submit_batch_request(
+        _request = build_submit_batch_request(
             url=self._config.url,
             content_length=content_length,
             timeout=timeout,
@@ -962,16 +896,15 @@ class ServiceOperations:
             multipart_content_type=multipart_content_type,
             version=self._config.version,
             content=_content,
-            template_url=self.submit_batch.metadata["url"],
             headers=_headers,
             params=_params,
         )
-        request = _convert_request(request)
-        request.url = self._client.format_url(request.url)
+        _request = _convert_request(_request)
+        _request.url = self._client.format_url(_request.url)
 
         _stream = True
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
-            request, stream=_stream, **kwargs
+            _request, stream=_stream, **kwargs
         )
 
         response = pipeline_response.http_response
@@ -993,8 +926,6 @@ class ServiceOperations:
 
         return deserialized  # type: ignore
 
-    submit_batch.metadata = {"url": "{url}"}
-
     @distributed_trace
     def filter_blobs(
         self,
@@ -1039,10 +970,6 @@ class ServiceOperations:
         :param include: Include this parameter to specify one or more datasets to include in the
          response. Default value is None.
         :type include: list[str or ~azure.storage.blob.models.FilterBlobsIncludeItem]
-        :keyword comp: comp. Default value is "blobs". Note that overriding this default value may
-         result in unsupported behavior.
-        :paramtype comp: str
-        :keyword callable cls: A custom type or function that will be passed the direct response
         :return: FilterBlobSegment or the result of cls(response)
         :rtype: ~azure.storage.blob.models.FilterBlobSegment
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -1061,7 +988,7 @@ class ServiceOperations:
         comp: Literal["blobs"] = kwargs.pop("comp", _params.pop("comp", "blobs"))
         cls: ClsType[_models.FilterBlobSegment] = kwargs.pop("cls", None)
 
-        request = build_filter_blobs_request(
+        _request = build_filter_blobs_request(
             url=self._config.url,
             timeout=timeout,
             request_id_parameter=request_id_parameter,
@@ -1071,16 +998,15 @@ class ServiceOperations:
             include=include,
             comp=comp,
             version=self._config.version,
-            template_url=self.filter_blobs.metadata["url"],
             headers=_headers,
             params=_params,
         )
-        request = _convert_request(request)
-        request.url = self._client.format_url(request.url)
+        _request = _convert_request(_request)
+        _request.url = self._client.format_url(_request.url)
 
         _stream = False
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
-            request, stream=_stream, **kwargs
+            _request, stream=_stream, **kwargs
         )
 
         response = pipeline_response.http_response
@@ -1101,8 +1027,6 @@ class ServiceOperations:
         deserialized = self._deserialize("FilterBlobSegment", pipeline_response)
 
         if cls:
-            return cls(pipeline_response, deserialized, response_headers)
-
-        return deserialized
+            return cls(pipeline_response, deserialized, response_headers)  # type: ignore
 
-    filter_blobs.metadata = {"url": "{url}"}
+        return deserialized  # type: ignore

azure/storage/blob/_lease.py

@@ -3,6 +3,7 @@
 # Licensed under the MIT License. See License.txt in the project root for
 # license information.
 # --------------------------------------------------------------------------
+# pylint: disable=docstring-keyword-should-match-keyword-only
 
 import uuid
 

azure/storage/blob/_models.py

@@ -651,7 +651,7 @@ class CopyProperties(DictMixin):
         self.source = kwargs.get('x-ms-copy-source')
         self.status = get_enum_value(kwargs.get('x-ms-copy-status'))
         self.progress = kwargs.get('x-ms-copy-progress')
-        self.completion_time = kwargs.get('x-ms-copy-completion_time')
+        self.completion_time = kwargs.get('x-ms-copy-completion-time')
         self.status_description = kwargs.get('x-ms-copy-status-description')
         self.incremental_copy = kwargs.get('x-ms-incremental-copy')
         self.destination_snapshot = kwargs.get('x-ms-copy-destination-snapshot')
@@ -792,9 +792,8 @@ class AccessPolicy(GenAccessPolicy):
     :param start:
         The time at which the shared access signature becomes valid. If
         omitted, start time for this call is assumed to be the time when the
-        storage service receives the request. Azure will always convert values
-        to UTC. If a date is passed in without timezone info, it is assumed to
-        be UTC.
+        storage service receives the request. The provided datetime will always
+        be interpreted as UTC.
     :type start: ~datetime.datetime or str
     """
     def __init__(self, permission=None, expiry=None, start=None):

azure/storage/blob/_serialize.py

@@ -57,6 +57,7 @@ _SUPPORTED_API_VERSIONS = [
     '2023-05-03',
     '2023-08-03',
     '2023-11-03',
+    '2024-05-04',
 ]
 
 

azure/storage/blob/_shared/authentication.py

@@ -55,7 +55,7 @@ def _storage_header_sort(input_headers: List[Tuple[str, str]]) -> List[Tuple[str
     # Build list of sorted tuples
     sorted_headers = []
     for key in header_keys:
-        sorted_headers.append((key, header_dict.get(key)))
+        sorted_headers.append((key, header_dict.pop(key)))
     return sorted_headers
 
 

azure/storage/blob/_shared/avro/avro_io.py

@@ -433,9 +433,3 @@ class DatumReader(object):
     def skip_record(self, writer_schema, decoder):
         for field in writer_schema.fields:
             self.skip_data(field.type, decoder)
-
-
-# ------------------------------------------------------------------------------
-
-if __name__ == '__main__':
-    raise Exception('Not a standalone module')

azure/storage/blob/_shared/avro/avro_io_async.py

@@ -417,9 +417,3 @@ class AsyncDatumReader(object):
     async def skip_record(self, writer_schema, decoder):
         for field in writer_schema.fields:
             await self.skip_data(field.type, decoder)
-
-
-# ------------------------------------------------------------------------------
-
-if __name__ == '__main__':
-    raise Exception('Not a standalone module')

azure/storage/blob/_shared/avro/datafile.py

@@ -255,7 +255,3 @@ class DataFileReader(object):  # pylint: disable=too-many-instance-attributes
     def close(self):
         """Close this reader."""
         self.reader.close()
-
-
-if __name__ == '__main__':
-    raise Exception('Not a standalone module')

azure/storage/blob/_shared/avro/datafile_async.py

@@ -208,7 +208,3 @@ class AsyncDataFileReader(object):  # pylint: disable=too-many-instance-attribut
     def close(self):
         """Close this reader."""
         self.reader.close()
-
-
-if __name__ == '__main__':
-    raise Exception('Not a standalone module')

azure/storage/blob/_shared/avro/schema.py

@@ -194,7 +194,7 @@ class Schema(metaclass=abc.ABCMeta):
     # re-defining schemas that are already listed in the parameter names.
     @abc.abstractmethod
     def to_json(self, names):
-        raise Exception('Cannot run abstract method.')
+        ...
 
 
 # ------------------------------------------------------------------------------
@@ -433,7 +433,7 @@ class NamedSchema(Schema):
     # of not re-defining schemas that are already listed in the parameter names.
     @abc.abstractmethod
     def to_json(self, names):
-        raise Exception('Cannot run abstract method.')
+        ...
 
 # ------------------------------------------------------------------------------
 
@@ -1086,7 +1086,7 @@ def _schema_from_json_object(json_object, names):
                 other_props=other_props,
             )
         else:
-            raise Exception(f'Internal error: unknown type {data_type!r}.')
+            raise ValueError(f'Internal error: unknown type {data_type!r}.')
 
     elif data_type in VALID_TYPES:
         # Unnamed, non-primitive Avro type:
@@ -1118,7 +1118,7 @@ def _schema_from_json_object(json_object, names):
             result = ErrorUnionSchema(schemas=error_schemas)
 
         else:
-            raise Exception(f'Internal error: unknown type {data_type!r}.')
+            raise ValueError(f'Internal error: unknown type {data_type!r}.')
     else:
         raise SchemaParseException(f'Invalid JSON descriptor for an Avro schema: {json_object!r}')
     return result