azure-storage-blob 12.21.0__py3-none-any.whl → 12.21.0b1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. azure/storage/blob/_blob_client.py +48 -53
  2. azure/storage/blob/_blob_service_client.py +11 -11
  3. azure/storage/blob/_container_client.py +20 -22
  4. azure/storage/blob/_download.py +167 -277
  5. azure/storage/blob/_lease.py +5 -5
  6. azure/storage/blob/_models.py +1 -1
  7. azure/storage/blob/_version.py +1 -1
  8. azure/storage/blob/aio/_blob_client_async.py +46 -49
  9. azure/storage/blob/aio/_blob_service_client_async.py +10 -10
  10. azure/storage/blob/aio/_container_client_async.py +19 -22
  11. azure/storage/blob/aio/_download_async.py +209 -317
  12. azure/storage/blob/aio/_lease_async.py +5 -5
  13. {azure_storage_blob-12.21.0.dist-info → azure_storage_blob-12.21.0b1.dist-info}/METADATA +7 -7
  14. {azure_storage_blob-12.21.0.dist-info → azure_storage_blob-12.21.0b1.dist-info}/RECORD +17 -18
  15. {azure_storage_blob-12.21.0.dist-info → azure_storage_blob-12.21.0b1.dist-info}/WHEEL +1 -1
  16. azure/storage/blob/_generated/py.typed +0 -1
  17. {azure_storage_blob-12.21.0.dist-info → azure_storage_blob-12.21.0b1.dist-info}/LICENSE +0 -0
  18. {azure_storage_blob-12.21.0.dist-info → azure_storage_blob-12.21.0b1.dist-info}/top_level.txt +0 -0
azure/storage/blob/aio/_container_client_async.py CHANGED
@@ -161,7 +161,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
161
161
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
162
162
  This value is not tracked or validated on the client. To configure client-side network timesouts
163
163
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
164
- #other-client--per-operation-configuration>`__.
164
+ #other-client--per-operation-configuration>`_.
165
165
  :returns: A dictionary of response headers.
166
166
  :rtype: Dict[str, Union[str, datetime]]
167
167
 
@@ -207,7 +207,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
207
207
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
208
208
  This value is not tracked or validated on the client. To configure client-side network timesouts
209
209
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
210
- #other-client--per-operation-configuration>`__.
210
+ #other-client--per-operation-configuration>`_.
211
211
  :returns: The renamed container.
212
212
  :rtype: ~azure.storage.blob.ContainerClient
213
213
  """
@@ -263,7 +263,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
263
263
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
264
264
  This value is not tracked or validated on the client. To configure client-side network timesouts
265
265
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
266
- #other-client--per-operation-configuration>`__.
266
+ #other-client--per-operation-configuration>`_.
267
267
  :rtype: None
268
268
 
269
269
  .. admonition:: Example:
@@ -329,7 +329,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
329
329
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
330
330
  This value is not tracked or validated on the client. To configure client-side network timesouts
331
331
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
332
- #other-client--per-operation-configuration>`__.
332
+ #other-client--per-operation-configuration>`_.
333
333
  :returns: A BlobLeaseClient object, that can be run in a context manager.
334
334
  :rtype: ~azure.storage.blob.aio.BlobLeaseClient
335
335
 
@@ -379,7 +379,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
379
379
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
380
380
  This value is not tracked or validated on the client. To configure client-side network timesouts
381
381
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
382
- #other-client--per-operation-configuration>`__.
382
+ #other-client--per-operation-configuration>`_.
383
383
  :return: Properties for the specified container within a container object.
384
384
  :rtype: ~azure.storage.blob.ContainerProperties
385
385
 
@@ -417,7 +417,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
417
417
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
418
418
  This value is not tracked or validated on the client. To configure client-side network timesouts
419
419
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
420
- #other-client--per-operation-configuration>`__.
420
+ #other-client--per-operation-configuration>`_.
421
421
  :returns: boolean
422
422
  :rtype: bool
423
423
  """
@@ -460,7 +460,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
460
460
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
461
461
  This value is not tracked or validated on the client. To configure client-side network timesouts
462
462
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
463
- #other-client--per-operation-configuration>`__.
463
+ #other-client--per-operation-configuration>`_.
464
464
  :returns: Container-updated property dict (Etag and last modified).
465
465
  :rtype: Dict[str, Union[str, datetime]]
466
466
 
@@ -540,7 +540,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
540
540
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
541
541
  This value is not tracked or validated on the client. To configure client-side network timesouts
542
542
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
543
- #other-client--per-operation-configuration>`__.
543
+ #other-client--per-operation-configuration>`_.
544
544
  :returns: Access policy information in a dict.
545
545
  :rtype: dict[str, Any]
546
546
 
@@ -607,7 +607,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
607
607
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
608
608
  This value is not tracked or validated on the client. To configure client-side network timesouts
609
609
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
610
- #other-client--per-operation-configuration>`__.
610
+ #other-client--per-operation-configuration>`_.
611
611
  :returns: Container-updated property dict (Etag and last modified).
612
612
  :rtype: dict[str, str or ~datetime.datetime]
613
613
 
@@ -671,7 +671,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
671
671
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
672
672
  This value is not tracked or validated on the client. To configure client-side network timesouts
673
673
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
674
- #other-client--per-operation-configuration>`__.
674
+ #other-client--per-operation-configuration>`_.
675
675
  :returns: An iterable (auto-paging) response of BlobProperties.
676
676
  :rtype: ~azure.core.async_paging.AsyncItemPaged[~azure.storage.blob.BlobProperties]
677
677
 
@@ -723,7 +723,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
723
723
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
724
724
  This value is not tracked or validated on the client. To configure client-side network timesouts
725
725
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
726
- #other-client--per-operation-configuration>`__.
726
+ #other-client--per-operation-configuration>`_.
727
727
  :returns: An iterable (auto-paging) response of blob names as strings.
728
728
  :rtype: ~azure.core.async_paging.AsyncItemPaged[str]
729
729
  """
@@ -780,7 +780,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
780
780
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
781
781
  This value is not tracked or validated on the client. To configure client-side network timesouts
782
782
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
783
- #other-client--per-operation-configuration>`__.
783
+ #other-client--per-operation-configuration>`_.
784
784
  :returns: An iterable (auto-paging) response of BlobProperties.
785
785
  :rtype: ~azure.core.async_paging.AsyncItemPaged[~azure.storage.blob.BlobProperties]
786
786
  """
@@ -826,7 +826,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
826
826
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
827
827
  This value is not tracked or validated on the client. To configure client-side network timesouts
828
828
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
829
- #other-client--per-operation-configuration>`__.
829
+ #other-client--per-operation-configuration>`_.
830
830
  :returns: An iterable (auto-paging) response of FilteredBlob.
831
831
  :rtype: ~azure.core.paging.ItemPaged[~azure.storage.blob.BlobProperties]
832
832
  """
@@ -913,7 +913,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
913
913
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
914
914
  This value is not tracked or validated on the client. To configure client-side network timesouts
915
915
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
916
- #other-client--per-operation-configuration>`__. This method may make multiple calls to the service and
916
+ #other-client--per-operation-configuration>`_. This method may make multiple calls to the service and
917
917
  the timeout will apply to each call individually.
918
918
  multiple calls to the Azure service and the timeout will apply to
919
919
  each call individually.
@@ -1015,7 +1015,6 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
1015
1015
  value that, when present, specifies the version of the blob to delete.
1016
1016
 
1017
1017
  .. versionadded:: 12.4.0
1018
-
1019
1018
  This keyword argument was introduced in API version '2019-12-12'.
1020
1019
 
1021
1020
  :keyword lease:
@@ -1050,7 +1049,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
1050
1049
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1051
1050
  This value is not tracked or validated on the client. To configure client-side network timesouts
1052
1051
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1053
- #other-client--per-operation-configuration>`__.
1052
+ #other-client--per-operation-configuration>`_.
1054
1053
  :rtype: None
1055
1054
  """
1056
1055
  if isinstance(blob, BlobProperties):
@@ -1114,7 +1113,6 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
1114
1113
  value that, when present, specifies the version of the blob to download.
1115
1114
 
1116
1115
  .. versionadded:: 12.4.0
1117
-
1118
1116
  This keyword argument was introduced in API version '2019-12-12'.
1119
1117
 
1120
1118
  :keyword bool validate_content:
@@ -1173,7 +1171,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
1173
1171
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1174
1172
  This value is not tracked or validated on the client. To configure client-side network timesouts
1175
1173
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1176
- #other-client--per-operation-configuration>`__. This method may make multiple calls to the service and
1174
+ #other-client--per-operation-configuration>`_. This method may make multiple calls to the service and
1177
1175
  the timeout will apply to each call individually.
1178
1176
  multiple calls to the Azure service and the timeout will apply to
1179
1177
  each call individually.
@@ -1271,7 +1269,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
1271
1269
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1272
1270
  This value is not tracked or validated on the client. To configure client-side network timesouts
1273
1271
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1274
- #other-client--per-operation-configuration>`__.
1272
+ #other-client--per-operation-configuration>`_.
1275
1273
  :return: An async iterator of responses, one for each blob in order
1276
1274
  :rtype: asynciterator[~azure.core.pipeline.transport.AsyncHttpResponse]
1277
1275
 
@@ -1323,7 +1321,6 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
1323
1321
 
1324
1322
  .. note::
1325
1323
  When the blob type is dict, here's a list of keys, value rules.
1326
-
1327
1324
  blob name:
1328
1325
  key: 'name', value type: str
1329
1326
  standard blob tier:
@@ -1351,7 +1348,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
1351
1348
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1352
1349
  This value is not tracked or validated on the client. To configure client-side network timesouts
1353
1350
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1354
- #other-client--per-operation-configuration>`__.
1351
+ #other-client--per-operation-configuration>`_.
1355
1352
  :keyword bool raise_on_any_failure:
1356
1353
  This is a boolean param which defaults to True. When this is set, an exception
1357
1354
  is raised even if there is a single operation failure. For optimal performance,
@@ -1404,7 +1401,7 @@ class ContainerClient(AsyncStorageAccountHostsMixin, ContainerClientBase, Storag
1404
1401
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1405
1402
  This value is not tracked or validated on the client. To configure client-side network timesouts
1406
1403
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1407
- #other-client--per-operation-configuration>`__.
1404
+ #other-client--per-operation-configuration>`_.
1408
1405
  :keyword bool raise_on_any_failure:
1409
1406
  This is a boolean param which defaults to True. When this is set, an exception
1410
1407
  is raised even if there is a single operation failure. For optimal performance,