azure-storage-blob 12.20.0__py3-none-any.whl → 12.21.0__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 (44) hide show
  1. azure/storage/blob/_blob_client.py +53 -48
  2. azure/storage/blob/_blob_service_client.py +11 -11
  3. azure/storage/blob/_container_client.py +22 -20
  4. azure/storage/blob/_download.py +277 -167
  5. azure/storage/blob/_generated/_azure_blob_storage.py +1 -1
  6. azure/storage/blob/_generated/_configuration.py +2 -2
  7. azure/storage/blob/_generated/_patch.py +2 -0
  8. azure/storage/blob/_generated/_serialization.py +1 -1
  9. azure/storage/blob/_generated/aio/_azure_blob_storage.py +1 -1
  10. azure/storage/blob/_generated/aio/_configuration.py +2 -2
  11. azure/storage/blob/_generated/aio/_patch.py +2 -0
  12. azure/storage/blob/_generated/aio/operations/_append_blob_operations.py +10 -5
  13. azure/storage/blob/_generated/aio/operations/_blob_operations.py +45 -26
  14. azure/storage/blob/_generated/aio/operations/_block_blob_operations.py +12 -7
  15. azure/storage/blob/_generated/aio/operations/_container_operations.py +39 -20
  16. azure/storage/blob/_generated/aio/operations/_page_blob_operations.py +15 -10
  17. azure/storage/blob/_generated/aio/operations/_patch.py +3 -0
  18. azure/storage/blob/_generated/aio/operations/_service_operations.py +28 -10
  19. azure/storage/blob/_generated/models/_patch.py +3 -0
  20. azure/storage/blob/_generated/operations/_append_blob_operations.py +14 -9
  21. azure/storage/blob/_generated/operations/_blob_operations.py +76 -51
  22. azure/storage/blob/_generated/operations/_block_blob_operations.py +18 -13
  23. azure/storage/blob/_generated/operations/_container_operations.py +64 -39
  24. azure/storage/blob/_generated/operations/_page_blob_operations.py +24 -19
  25. azure/storage/blob/_generated/operations/_patch.py +3 -0
  26. azure/storage/blob/_generated/operations/_service_operations.py +43 -19
  27. azure/storage/blob/_generated/py.typed +1 -0
  28. azure/storage/blob/_lease.py +5 -5
  29. azure/storage/blob/_models.py +1 -1
  30. azure/storage/blob/_serialize.py +1 -0
  31. azure/storage/blob/_shared/authentication.py +62 -4
  32. azure/storage/blob/_shared/base_client.py +1 -1
  33. azure/storage/blob/_shared/base_client_async.py +3 -2
  34. azure/storage/blob/_version.py +1 -1
  35. azure/storage/blob/aio/_blob_client_async.py +49 -46
  36. azure/storage/blob/aio/_blob_service_client_async.py +10 -10
  37. azure/storage/blob/aio/_container_client_async.py +22 -19
  38. azure/storage/blob/aio/_download_async.py +317 -209
  39. azure/storage/blob/aio/_lease_async.py +5 -5
  40. {azure_storage_blob-12.20.0.dist-info → azure_storage_blob-12.21.0.dist-info}/METADATA +6 -6
  41. {azure_storage_blob-12.20.0.dist-info → azure_storage_blob-12.21.0.dist-info}/RECORD +44 -43
  42. {azure_storage_blob-12.20.0.dist-info → azure_storage_blob-12.21.0.dist-info}/WHEEL +1 -1
  43. {azure_storage_blob-12.20.0.dist-info → azure_storage_blob-12.21.0.dist-info}/LICENSE +0 -0
  44. {azure_storage_blob-12.20.0.dist-info → azure_storage_blob-12.21.0.dist-info}/top_level.txt +0 -0
@@ -84,7 +84,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
84
84
 
85
85
  For more optional configuration, please click
86
86
  `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
87
- #optional-configuration>`_.
87
+ #optional-configuration>`__.
88
88
 
89
89
  :param str account_url:
90
90
  The URI to the storage account. In order to create a client given the full URI to the container,
@@ -306,7 +306,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
306
306
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
307
307
  This value is not tracked or validated on the client. To configure client-side network timesouts
308
308
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
309
- #other-client--per-operation-configuration>`_.
309
+ #other-client--per-operation-configuration>`__.
310
310
  :returns: A dictionary of response headers.
311
311
  :rtype: Dict[str, Union[str, datetime]]
312
312
 
@@ -352,7 +352,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
352
352
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
353
353
  This value is not tracked or validated on the client. To configure client-side network timesouts
354
354
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
355
- #other-client--per-operation-configuration>`_.
355
+ #other-client--per-operation-configuration>`__.
356
356
  :returns: The renamed container client.
357
357
  :rtype: ~azure.storage.blob.ContainerClient
358
358
  """
@@ -408,7 +408,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
408
408
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
409
409
  This value is not tracked or validated on the client. To configure client-side network timesouts
410
410
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
411
- #other-client--per-operation-configuration>`_.
411
+ #other-client--per-operation-configuration>`__.
412
412
  :rtype: None
413
413
 
414
414
  .. admonition:: Example:
@@ -474,7 +474,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
474
474
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
475
475
  This value is not tracked or validated on the client. To configure client-side network timesouts
476
476
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
477
- #other-client--per-operation-configuration>`_.
477
+ #other-client--per-operation-configuration>`__.
478
478
  :returns: A BlobLeaseClient object, that can be run in a context manager.
479
479
  :rtype: ~azure.storage.blob.BlobLeaseClient
480
480
 
@@ -524,7 +524,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
524
524
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
525
525
  This value is not tracked or validated on the client. To configure client-side network timesouts
526
526
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
527
- #other-client--per-operation-configuration>`_.
527
+ #other-client--per-operation-configuration>`__.
528
528
  :return: Properties for the specified container within a container object.
529
529
  :rtype: ~azure.storage.blob.ContainerProperties
530
530
 
@@ -562,7 +562,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
562
562
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
563
563
  This value is not tracked or validated on the client. To configure client-side network timesouts
564
564
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
565
- #other-client--per-operation-configuration>`_.
565
+ #other-client--per-operation-configuration>`__.
566
566
  :returns: boolean
567
567
  :rtype: bool
568
568
  """
@@ -614,7 +614,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
614
614
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
615
615
  This value is not tracked or validated on the client. To configure client-side network timesouts
616
616
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
617
- #other-client--per-operation-configuration>`_.
617
+ #other-client--per-operation-configuration>`__.
618
618
  :returns: Container-updated property dict (Etag and last modified).
619
619
  :rtype: dict[str, str or datetime]
620
620
 
@@ -693,7 +693,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
693
693
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
694
694
  This value is not tracked or validated on the client. To configure client-side network timesouts
695
695
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
696
- #other-client--per-operation-configuration>`_.
696
+ #other-client--per-operation-configuration>`__.
697
697
  :returns: Access policy information in a dict.
698
698
  :rtype: dict[str, Any]
699
699
 
@@ -760,7 +760,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
760
760
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
761
761
  This value is not tracked or validated on the client. To configure client-side network timesouts
762
762
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
763
- #other-client--per-operation-configuration>`_.
763
+ #other-client--per-operation-configuration>`__.
764
764
  :returns: Container-updated property dict (Etag and last modified).
765
765
  :rtype: dict[str, str or ~datetime.datetime]
766
766
 
@@ -823,7 +823,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
823
823
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
824
824
  This value is not tracked or validated on the client. To configure client-side network timesouts
825
825
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
826
- #other-client--per-operation-configuration>`_.
826
+ #other-client--per-operation-configuration>`__.
827
827
  :returns: An iterable (auto-paging) response of BlobProperties.
828
828
  :rtype: ~azure.core.paging.ItemPaged[~azure.storage.blob.BlobProperties]
829
829
 
@@ -872,7 +872,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
872
872
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
873
873
  This value is not tracked or validated on the client. To configure client-side network timesouts
874
874
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
875
- #other-client--per-operation-configuration>`_.
875
+ #other-client--per-operation-configuration>`__.
876
876
  :returns: An iterable (auto-paging) response of blob names as strings.
877
877
  :rtype: ~azure.core.paging.ItemPaged[str]
878
878
  """
@@ -929,7 +929,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
929
929
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
930
930
  This value is not tracked or validated on the client. To configure client-side network timesouts
931
931
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
932
- #other-client--per-operation-configuration>`_.
932
+ #other-client--per-operation-configuration>`__.
933
933
  :returns: An iterable (auto-paging) response of BlobProperties.
934
934
  :rtype: ~azure.core.paging.ItemPaged[~azure.storage.blob.BlobProperties]
935
935
  """
@@ -975,7 +975,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
975
975
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
976
976
  This value is not tracked or validated on the client. To configure client-side network timesouts
977
977
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
978
- #other-client--per-operation-configuration>`_.
978
+ #other-client--per-operation-configuration>`__.
979
979
  :returns: An iterable (auto-paging) response of FilteredBlob.
980
980
  :rtype: ~azure.core.paging.ItemPaged[~azure.storage.blob.BlobProperties]
981
981
  """
@@ -1062,7 +1062,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
1062
1062
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1063
1063
  This value is not tracked or validated on the client. To configure client-side network timesouts
1064
1064
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1065
- #other-client--per-operation-configuration>`_. This method may make multiple calls to the service and
1065
+ #other-client--per-operation-configuration>`__. This method may make multiple calls to the service and
1066
1066
  the timeout will apply to each call individually.
1067
1067
  :keyword ~azure.storage.blob.PremiumPageBlobTier premium_page_blob_tier:
1068
1068
  A page blob tier value to set the blob to. The tier correlates to the size of the
@@ -1163,6 +1163,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
1163
1163
  value that, when present, specifies the version of the blob to delete.
1164
1164
 
1165
1165
  .. versionadded:: 12.4.0
1166
+
1166
1167
  This keyword argument was introduced in API version '2019-12-12'.
1167
1168
 
1168
1169
  :keyword lease:
@@ -1197,7 +1198,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
1197
1198
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1198
1199
  This value is not tracked or validated on the client. To configure client-side network timesouts
1199
1200
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1200
- #other-client--per-operation-configuration>`_.
1201
+ #other-client--per-operation-configuration>`__.
1201
1202
  :rtype: None
1202
1203
  """
1203
1204
  if isinstance(blob, BlobProperties):
@@ -1261,6 +1262,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
1261
1262
  value that, when present, specifies the version of the blob to download.
1262
1263
 
1263
1264
  .. versionadded:: 12.4.0
1265
+
1264
1266
  This keyword argument was introduced in API version '2019-12-12'.
1265
1267
 
1266
1268
  :keyword bool validate_content:
@@ -1319,7 +1321,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
1319
1321
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1320
1322
  This value is not tracked or validated on the client. To configure client-side network timesouts
1321
1323
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1322
- #other-client--per-operation-configuration>`_. This method may make multiple calls to the service and
1324
+ #other-client--per-operation-configuration>`__. This method may make multiple calls to the service and
1323
1325
  the timeout will apply to each call individually.
1324
1326
  multiple calls to the Azure service and the timeout will apply to
1325
1327
  each call individually.
@@ -1538,7 +1540,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
1538
1540
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1539
1541
  This value is not tracked or validated on the client. To configure client-side network timesouts
1540
1542
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1541
- #other-client--per-operation-configuration>`_.
1543
+ #other-client--per-operation-configuration>`__.
1542
1544
  :return: An iterator of responses, one for each blob in order
1543
1545
  :rtype: Iterator[~azure.core.pipeline.transport.HttpResponse]
1544
1546
 
@@ -1708,7 +1710,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
1708
1710
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1709
1711
  This value is not tracked or validated on the client. To configure client-side network timesouts
1710
1712
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1711
- #other-client--per-operation-configuration>`_.
1713
+ #other-client--per-operation-configuration>`__.
1712
1714
  :keyword bool raise_on_any_failure:
1713
1715
  This is a boolean param which defaults to True. When this is set, an exception
1714
1716
  is raised even if there is a single operation failure.
@@ -1761,7 +1763,7 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin): # py
1761
1763
  https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
1762
1764
  This value is not tracked or validated on the client. To configure client-side network timesouts
1763
1765
  see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob
1764
- #other-client--per-operation-configuration>`_.
1766
+ #other-client--per-operation-configuration>`__.
1765
1767
  :keyword bool raise_on_any_failure:
1766
1768
  This is a boolean param which defaults to True. When this is set, an exception
1767
1769
  is raised even if there is a single operation failure.