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

azure/storage/blob/_generated/models/_models_py3.py

@@ -104,7 +104,7 @@ class AppendPositionAccessConditions(_serialization.Model):
 class ArrowConfiguration(_serialization.Model):
     """Groups the settings used for formatting the response if the response should be Arrow formatted.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar schema: Required.
     :vartype schema: list[~azure.storage.blob.models.ArrowField]
@@ -135,7 +135,7 @@ class ArrowConfiguration(_serialization.Model):
 class ArrowField(_serialization.Model):
     """Groups settings regarding specific field of an arrow schema.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar type: Required.
     :vartype type: str
@@ -188,7 +188,7 @@ class ArrowField(_serialization.Model):
 class BlobFlatListSegment(_serialization.Model):
     """BlobFlatListSegment.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar blob_items: Required.
     :vartype blob_items: list[~azure.storage.blob.models.BlobItemInternal]
@@ -215,7 +215,7 @@ class BlobFlatListSegment(_serialization.Model):
 class BlobHierarchyListSegment(_serialization.Model):
     """BlobHierarchyListSegment.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar blob_prefixes:
     :vartype blob_prefixes: list[~azure.storage.blob.models.BlobPrefix]
@@ -324,7 +324,7 @@ class BlobHTTPHeaders(_serialization.Model):
 class BlobItemInternal(_serialization.Model):
     """An Azure Storage blob.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar name: Required.
     :vartype name: ~azure.storage.blob.models.BlobName
@@ -479,7 +479,7 @@ class BlobName(_serialization.Model):
 class BlobPrefix(_serialization.Model):
     """BlobPrefix.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar name: Required.
     :vartype name: ~azure.storage.blob.models.BlobName
@@ -505,7 +505,7 @@ class BlobPrefix(_serialization.Model):
 class BlobPropertiesInternal(_serialization.Model):  # pylint: disable=too-many-instance-attributes
     """Properties of a blob.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar creation_time:
     :vartype creation_time: ~datetime.datetime
@@ -822,7 +822,7 @@ class BlobPropertiesInternal(_serialization.Model):  # pylint: disable=too-many-
 class BlobTag(_serialization.Model):
     """BlobTag.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar key: Required.
     :vartype key: str
@@ -856,7 +856,7 @@ class BlobTag(_serialization.Model):
 class BlobTags(_serialization.Model):
     """Blob tags.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar blob_tag_set: Required.
     :vartype blob_tag_set: list[~azure.storage.blob.models.BlobTag]
@@ -887,7 +887,7 @@ class BlobTags(_serialization.Model):
 class Block(_serialization.Model):
     """Represents a single block in a block blob.  It describes the block's ID and size.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar name: The base64 encoded block ID. Required.
     :vartype name: str
@@ -992,7 +992,7 @@ class BlockLookupList(_serialization.Model):
 class ClearRange(_serialization.Model):
     """ClearRange.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar start: Required.
     :vartype start: int
@@ -1064,7 +1064,7 @@ class ContainerCpkScopeInfo(_serialization.Model):
 class ContainerItem(_serialization.Model):
     """An Azure Storage container.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar name: Required.
     :vartype name: str
@@ -1125,7 +1125,7 @@ class ContainerItem(_serialization.Model):
 class ContainerProperties(_serialization.Model):  # pylint: disable=too-many-instance-attributes
     """Properties of a container.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar last_modified: Required.
     :vartype last_modified: ~datetime.datetime
@@ -1251,7 +1251,7 @@ class CorsRule(_serialization.Model):
     policy that prevents a web page from calling APIs in a different domain; CORS provides a secure
     way to allow one domain (the origin domain) to call APIs in another domain.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar allowed_origins: The origin domains that are permitted to make a request against the
      storage service via CORS. The origin domain is the domain from which the request originates.
@@ -1460,7 +1460,7 @@ class DelimitedTextConfiguration(_serialization.Model):
 class FilterBlobItem(_serialization.Model):
     """Blob info from a Filter Blobs API call.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar name: Required.
     :vartype name: str
@@ -1521,7 +1521,7 @@ class FilterBlobItem(_serialization.Model):
 class FilterBlobSegment(_serialization.Model):
     """The result of a Filter Blobs API call.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar service_endpoint: Required.
     :vartype service_endpoint: str
@@ -1580,7 +1580,7 @@ class FilterBlobSegment(_serialization.Model):
 class GeoReplication(_serialization.Model):
     """Geo-Replication information for the Secondary Storage Service.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar status: The status of the secondary location. Required. Known values are: "live",
      "bootstrap", and "unavailable".
@@ -1646,7 +1646,7 @@ class JsonTextConfiguration(_serialization.Model):
 class KeyInfo(_serialization.Model):
     """Key information.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar start: The date-time the key is active in ISO 8601 UTC time. Required.
     :vartype start: str
@@ -1701,7 +1701,7 @@ class LeaseAccessConditions(_serialization.Model):
 class ListBlobsFlatSegmentResponse(_serialization.Model):
     """An enumeration of blobs.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar service_endpoint: Required.
     :vartype service_endpoint: str
@@ -1777,7 +1777,7 @@ class ListBlobsFlatSegmentResponse(_serialization.Model):
 class ListBlobsHierarchySegmentResponse(_serialization.Model):
     """An enumeration of blobs.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar service_endpoint: Required.
     :vartype service_endpoint: str
@@ -1860,7 +1860,7 @@ class ListBlobsHierarchySegmentResponse(_serialization.Model):
 class ListContainersSegmentResponse(_serialization.Model):
     """An enumeration of containers.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar service_endpoint: Required.
     :vartype service_endpoint: str
@@ -1932,7 +1932,7 @@ class ListContainersSegmentResponse(_serialization.Model):
 class Logging(_serialization.Model):
     """Azure Analytics Logging settings.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar version: The version of Storage Analytics to configure. Required.
     :vartype version: str
@@ -1997,7 +1997,7 @@ class Logging(_serialization.Model):
 class Metrics(_serialization.Model):
     """a summary of request statistics grouped by API in hour or minute aggregates for blobs.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar version: The version of Storage Analytics to configure.
     :vartype version: str
@@ -2152,7 +2152,7 @@ class PageList(_serialization.Model):
 class PageRange(_serialization.Model):
     """PageRange.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar start: Required.
     :vartype start: int
@@ -2186,7 +2186,7 @@ class PageRange(_serialization.Model):
 class QueryFormat(_serialization.Model):
     """QueryFormat.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar type: The quick query format type. Required. Known values are: "delimited", "json",
      "arrow", and "parquet".
@@ -2253,7 +2253,7 @@ class QueryRequest(_serialization.Model):
 
     Variables are only populated by the server, and will be ignored when sending a request.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar query_type: Required. The type of the provided query expression. Required. Default value
      is "SQL".
@@ -2308,7 +2308,7 @@ class QueryRequest(_serialization.Model):
 class QuerySerialization(_serialization.Model):
     """QuerySerialization.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar format: Required.
     :vartype format: ~azure.storage.blob.models.QueryFormat
@@ -2334,7 +2334,7 @@ class QuerySerialization(_serialization.Model):
 class RetentionPolicy(_serialization.Model):
     """the retention policy which determines how long the associated data should persist.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar enabled: Indicates whether a retention policy is enabled for the storage service.
      Required.
@@ -2426,7 +2426,7 @@ class SequenceNumberAccessConditions(_serialization.Model):
 class SignedIdentifier(_serialization.Model):
     """signed identifier.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar id: a unique id. Required.
     :vartype id: str
@@ -2526,7 +2526,7 @@ class SourceModifiedAccessConditions(_serialization.Model):
 class StaticWebsite(_serialization.Model):
     """The properties that enable an account to host a static website.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar enabled: Indicates whether this account is hosting a static website. Required.
     :vartype enabled: bool
@@ -2695,7 +2695,7 @@ class StorageServiceStats(_serialization.Model):
 class UserDelegationKey(_serialization.Model):
     """A user delegation key.
 
-    All required parameters must be populated in order to send to Azure.
+    All required parameters must be populated in order to send to server.
 
     :ivar signed_oid: The Azure Active Directory object ID in GUID format. Required.
     :vartype signed_oid: str

azure/storage/blob/_generated/operations/_append_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]]
 
@@ -156,7 +151,7 @@ def build_append_block_request(
     url: str,
     *,
     content_length: int,
-    content: IO,
+    content: IO[bytes],
     timeout: Optional[int] = None,
     transactional_content_md5: Optional[bytes] = None,
     transactional_content_crc64: Optional[bytes] = None,
@@ -490,11 +485,6 @@ class AppendBlobOperations:
         :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 "AppendBlob". 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:
@@ -551,7 +541,7 @@ class AppendBlobOperations:
             _if_tags = modified_access_conditions.if_tags
             _if_unmodified_since = modified_access_conditions.if_unmodified_since
 
-        request = build_create_request(
+        _request = build_create_request(
             url=self._config.url,
             content_length=content_length,
             timeout=timeout,
@@ -579,16 +569,15 @@ class AppendBlobOperations:
             legal_hold=legal_hold,
             blob_type=blob_type,
             version=self._config.version,
-            template_url=self.create.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,15 +609,13 @@ class AppendBlobOperations:
         )
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    create.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def append_block(  # pylint: disable=inconsistent-return-statements
         self,
         content_length: int,
-        body: IO,
+        body: IO[bytes],
         timeout: Optional[int] = None,
         transactional_content_md5: Optional[bytes] = None,
         transactional_content_crc64: Optional[bytes] = None,
@@ -647,7 +634,7 @@ class AppendBlobOperations:
         :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
@@ -674,10 +661,6 @@ class AppendBlobOperations:
         :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 "appendblock". 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:
@@ -728,7 +711,7 @@ class AppendBlobOperations:
             _if_unmodified_since = modified_access_conditions.if_unmodified_since
         _content = body
 
-        request = build_append_block_request(
+        _request = build_append_block_request(
             url=self._config.url,
             content_length=content_length,
             timeout=timeout,
@@ -751,16 +734,15 @@ class AppendBlobOperations:
             content_type=content_type,
             version=self._config.version,
             content=_content,
-            template_url=self.append_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
@@ -800,9 +782,7 @@ class AppendBlobOperations:
         )
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    append_block.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def append_block_from_url(  # pylint: disable=inconsistent-return-statements
@@ -870,10 +850,6 @@ class AppendBlobOperations:
         :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 "appendblock". 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:
@@ -931,7 +907,7 @@ class AppendBlobOperations:
             _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_append_block_from_url_request(
+        _request = build_append_block_from_url_request(
             url=self._config.url,
             source_url=source_url,
             content_length=content_length,
@@ -960,16 +936,15 @@ class AppendBlobOperations:
             copy_source_authorization=copy_source_authorization,
             comp=comp,
             version=self._config.version,
-            template_url=self.append_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
@@ -1006,9 +981,7 @@ class AppendBlobOperations:
         )
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    append_block_from_url.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore
 
     @distributed_trace
     def seal(  # pylint: disable=inconsistent-return-statements
@@ -1039,10 +1012,6 @@ class AppendBlobOperations:
         :param append_position_access_conditions: Parameter group. Default value is None.
         :type append_position_access_conditions:
          ~azure.storage.blob.models.AppendPositionAccessConditions
-        :keyword comp: comp. Default value is "seal". 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:
@@ -1077,7 +1046,7 @@ class AppendBlobOperations:
         if append_position_access_conditions is not None:
             _append_position = append_position_access_conditions.append_position
 
-        request = build_seal_request(
+        _request = build_seal_request(
             url=self._config.url,
             timeout=timeout,
             request_id_parameter=request_id_parameter,
@@ -1089,16 +1058,15 @@ class AppendBlobOperations:
             append_position=_append_position,
             comp=comp,
             version=self._config.version,
-            template_url=self.seal.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
@@ -1120,6 +1088,4 @@ class AppendBlobOperations:
         response_headers["x-ms-blob-sealed"] = self._deserialize("bool", response.headers.get("x-ms-blob-sealed"))
 
         if cls:
-            return cls(pipeline_response, None, response_headers)
-
-    seal.metadata = {"url": "{url}"}
+            return cls(pipeline_response, None, response_headers)  # type: ignore