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

azure/storage/blob/_generated/operations/_block_blob_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.
@@ -7,8 +7,7 @@
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 import datetime
-import sys
-from typing import Any, Callable, Dict, IO, Optional, TypeVar, Union
+from typing import Any, Callable, Dict, IO, Literal, Optional, TypeVar, Union
 
 from azure.core.exceptions import (
     ClientAuthenticationError,
@@ -28,10 +27,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]]
 
@@ -43,7 +38,7 @@ def build_upload_request(
     url: str,
     *,
     content_length: int,
-    content: IO,
+    content: IO[bytes],
     timeout: Optional[int] = None,
     transactional_content_md5: Optional[bytes] = None,
     blob_content_type: Optional[str] = None,
@@ -319,7 +314,7 @@ def build_stage_block_request(
     *,
     block_id: str,
     content_length: int,
-    content: IO,
+    content: IO[bytes],
     transactional_content_md5: Optional[bytes] = None,
     transactional_content_crc64: Optional[bytes] = None,
     timeout: Optional[int] = None,
@@ -674,7 +669,7 @@ class BlockBlobOperations:
     def upload(  # pylint: disable=inconsistent-return-statements
         self,
         content_length: int,
-        body: IO,
+        body: IO[bytes],
         timeout: Optional[int] = None,
         transactional_content_md5: Optional[bytes] = None,
         metadata: Optional[Dict[str, str]] = None,
@@ -701,7 +696,7 @@ class BlockBlobOperations:
         :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
@@ -750,11 +745,6 @@ class BlockBlobOperations:
         :type cpk_scope_info: ~azure.storage.blob.models.CpkScopeInfo
         :param modified_access_conditions: Parameter group. Default value is None.
         :type modified_access_conditions: ~azure.storage.blob.models.ModifiedAccessConditions
-        :keyword blob_type: Specifies the type of blob to create: block blob, page blob, or append
-         blob. Default value is "BlockBlob". Note that overriding this default value may result in
-         unsupported behavior.
-        :paramtype blob_type: 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:
@@ -813,7 +803,7 @@ class BlockBlobOperations:
             _if_unmodified_since = modified_access_conditions.if_unmodified_since
         _content = body
 
-        request = build_upload_request(
+        _request = build_upload_request(
             url=self._config.url,
             content_length=content_length,
             timeout=timeout,
@@ -846,16 +836,15 @@ class BlockBlobOperations:
             content_type=content_type,
             version=self._config.version,
             content=_content,
-            template_url=self.upload.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
@@ -887,9 +876,7 @@ class BlockBlobOperations:
         )
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    upload.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def put_blob_from_url(  # pylint: disable=inconsistent-return-statements
@@ -980,11 +967,6 @@ class BlockBlobOperations:
         :param source_modified_access_conditions: Parameter group. Default value is None.
         :type source_modified_access_conditions:
          ~azure.storage.blob.models.SourceModifiedAccessConditions
-        :keyword blob_type: Specifies the type of blob to create: block blob, page blob, or append
-         blob. Default value is "BlockBlob". Note that overriding this default value may result in
-         unsupported behavior.
-        :paramtype blob_type: 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:
@@ -1052,7 +1034,7 @@ class BlockBlobOperations:
             _source_if_tags = source_modified_access_conditions.source_if_tags
             _source_if_unmodified_since = source_modified_access_conditions.source_if_unmodified_since
 
-        request = build_put_blob_from_url_request(
+        _request = build_put_blob_from_url_request(
             url=self._config.url,
             content_length=content_length,
             copy_source=copy_source,
@@ -1089,16 +1071,15 @@ class BlockBlobOperations:
             copy_source_tags=copy_source_tags,
             blob_type=blob_type,
             version=self._config.version,
-            template_url=self.put_blob_from_url.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
@@ -1130,16 +1111,14 @@ class BlockBlobOperations:
         )
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    put_blob_from_url.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def stage_block(  # pylint: disable=inconsistent-return-statements
         self,
         block_id: str,
         content_length: int,
-        body: IO,
+        body: IO[bytes],
         transactional_content_md5: Optional[bytes] = None,
         transactional_content_crc64: Optional[bytes] = None,
         timeout: Optional[int] = None,
@@ -1158,7 +1137,7 @@ class BlockBlobOperations:
         :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 transactional_content_md5: Specify the transactional md5 for the body, to be validated
          by the service. Default value is None.
         :type transactional_content_md5: bytes
@@ -1180,10 +1159,6 @@ class BlockBlobOperations:
         :type cpk_info: ~azure.storage.blob.models.CpkInfo
         :param cpk_scope_info: Parameter group. Default value is None.
         :type cpk_scope_info: ~azure.storage.blob.models.CpkScopeInfo
-        :keyword comp: comp. Default value is "block". 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:
@@ -1218,7 +1193,7 @@ class BlockBlobOperations:
             _encryption_scope = cpk_scope_info.encryption_scope
         _content = body
 
-        request = build_stage_block_request(
+        _request = build_stage_block_request(
             url=self._config.url,
             block_id=block_id,
             content_length=content_length,
@@ -1235,16 +1210,15 @@ class BlockBlobOperations:
             content_type=content_type,
             version=self._config.version,
             content=_content,
-            template_url=self.stage_block.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
@@ -1276,9 +1250,7 @@ class BlockBlobOperations:
         )
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    stage_block.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def stage_block_from_url(  # pylint: disable=inconsistent-return-statements
@@ -1338,10 +1310,6 @@ class BlockBlobOperations:
         :param source_modified_access_conditions: Parameter group. Default value is None.
         :type source_modified_access_conditions:
          ~azure.storage.blob.models.SourceModifiedAccessConditions
-        :keyword comp: comp. Default value is "block". 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:
@@ -1383,7 +1351,7 @@ class BlockBlobOperations:
             _source_if_none_match = source_modified_access_conditions.source_if_none_match
             _source_if_unmodified_since = source_modified_access_conditions.source_if_unmodified_since
 
-        request = build_stage_block_from_url_request(
+        _request = build_stage_block_from_url_request(
             url=self._config.url,
             block_id=block_id,
             content_length=content_length,
@@ -1405,16 +1373,15 @@ class BlockBlobOperations:
             copy_source_authorization=copy_source_authorization,
             comp=comp,
             version=self._config.version,
-            template_url=self.stage_block_from_url.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
@@ -1446,9 +1413,7 @@ class BlockBlobOperations:
         )
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    stage_block_from_url.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def commit_block_list(  # pylint: disable=inconsistent-return-statements
@@ -1529,10 +1494,6 @@ class BlockBlobOperations:
         :type cpk_scope_info: ~azure.storage.blob.models.CpkScopeInfo
         :param modified_access_conditions: Parameter group. Default value is None.
         :type modified_access_conditions: ~azure.storage.blob.models.ModifiedAccessConditions
-        :keyword comp: comp. Default value is "blocklist". 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:
@@ -1591,7 +1552,7 @@ class BlockBlobOperations:
             _if_unmodified_since = modified_access_conditions.if_unmodified_since
         _content = self._serialize.body(blocks, "BlockLookupList", is_xml=True)
 
-        request = build_commit_block_list_request(
+        _request = build_commit_block_list_request(
             url=self._config.url,
             timeout=timeout,
             blob_cache_control=_blob_cache_control,
@@ -1623,16 +1584,15 @@ class BlockBlobOperations:
             content_type=content_type,
             version=self._config.version,
             content=_content,
-            template_url=self.commit_block_list.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
@@ -1667,9 +1627,7 @@ class BlockBlobOperations:
         )
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    commit_block_list.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def get_block_list(
@@ -1708,10 +1666,6 @@ class BlockBlobOperations:
         :type lease_access_conditions: ~azure.storage.blob.models.LeaseAccessConditions
         :param modified_access_conditions: Parameter group. Default value is None.
         :type modified_access_conditions: ~azure.storage.blob.models.ModifiedAccessConditions
-        :keyword comp: comp. Default value is "blocklist". 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: BlockList or the result of cls(response)
         :rtype: ~azure.storage.blob.models.BlockList
         :raises ~azure.core.exceptions.HttpResponseError:
@@ -1737,7 +1691,7 @@ class BlockBlobOperations:
         if modified_access_conditions is not None:
             _if_tags = modified_access_conditions.if_tags
 
-        request = build_get_block_list_request(
+        _request = build_get_block_list_request(
             url=self._config.url,
             snapshot=snapshot,
             list_type=list_type,
@@ -1747,16 +1701,15 @@ class BlockBlobOperations:
             request_id_parameter=request_id_parameter,
             comp=comp,
             version=self._config.version,
-            template_url=self.get_block_list.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
@@ -1783,8 +1736,6 @@ class BlockBlobOperations:
         deserialized = self._deserialize("BlockList", pipeline_response)
 
         if cls:
-            return cls(pipeline_response, deserialized, response_headers)
-
-        return deserialized
+            return cls(pipeline_response, deserialized, response_headers)  # type: ignore
 
-    get_block_list.metadata = {"url": "{url}"}
+        return deserialized  # type: ignore