NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #762 most downloaded on PyPI
Microsoft Azure File DataLake Storage Client Library for Python
Last release 4 days ago
30 Sep 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 40 of 40 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
69 releases · first in 2019
This version and all future versions will require Python 3.10+. Python 3.9 is no longer supported.
This version and all future versions will require Python 3.10+. Python 3.9 is no longer supported.
Added support for service version 2026-10-06.
One column per quarter.
Stable release of features from 12.25.0b1
Added support for service version 2026-06-06.
account_urls to accept URLs with -ipv6 and -dualstack suffixes
for DataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient, and DataLakeFileClient.DataLakeDirectoryClient and DataLakeFileClient's set_tags and get_tags APIs
to conditionally set and get tags associated with a directory or file client, respectively.max_concurrency=None by defaulting to the shared DEFAULT_MAX_CONCURRENCY constant.Stable release of features from 12.24.0b1
logging_enable and logging_body keywords on a per-request
basis and with retries. Prior to this fix logging may have not behaved as expected, especially on retries.Added support for service version 2026-04-06.
user_delegation_tid to DataLakeServiceClient.get_user_delegation_key
API, which can be used in generate_file_system_sas, generate_directory_sas, and generate_file_sas
to specify the Tenant ID that is authorized to use the generated SAS URL. Note that user_delegation_tid
must be used together with user_delegation_oid.request_headers to generate_file_system_sas, generate_directory_sas,
and generate_file_sas which specifies a set of headers and their corresponding values that
must be present in the request header when using the generated SAS.request_query_params to generate_file_system_sas, generate_directory_sas,
and generate_file_sas which specifies a set of query parameters and their corresponding values that
must be present in the request URL when using the generated SAS.azure-core dependency to 1.37.0.Stable release of features from 12.23.0b1
connection_data_block_size for all clients from 4 KiB to 256 KiB. This should result in
significantly better throughput on large file downloads for most environments.Added support for service version 2026-02-06.
start_from for DataLakeServiceClient's get_paths and
DataLakeDirectoryClient's get_paths APIs, which specifies the full path to start listing paths from.user_delegation_oid to generate_file_system_sas, generate_directory_sas, and
generate_file_sas, which specifies the Entra ID of the user that is authorized to use the generated SAS URL.UseDevelopmentStorage=true; as a valid connection string for Azurite.DataLakeFileClient.download_file via the decompress keyword.kwarg arguments to be named keywords.
Some public types may have been adjusted if they were previously erroneous or incomplete.__enter__ and __exit__ attributes for all asynchronous client objects for raising explicit TypeError,
and let the AttributeError raise directly.Stable release of features from 12.22.0b1
__enter__ and __exit__ attributes for all asynchronous client objects for raising explicit TypeError,
and let the AttributeError raise directly.This version and all future versions will require Python 3.9+. Python 3.8 is no longer supported.
This version and all future versions will require Python 3.9+. Python 3.8 is no longer supported.
Stable release of features from 12.21.0b1
Added support for service version 2025-07-05.
FileSystemClient's get_file_system_access_policy
and set_file_system_access_policy APIs.DataLakeFileClient's upload_data and download_file
APIs via a new optional callback, progress_hook.Updated type hints across the entire package and enabled MyPy to run during CI. Some public types may have been adjusted if they were previously erron
Stable release of features from 12.19.0b1
Added support for service version 2025-05-05.
Fixed an issue where custom transports may encounter AttributeError on certain requests.
AttributeError on certain requests.None value for expires_on keyword to set_file_expiry API.Stable release of features from 12.18.0b1
Code | Docs Synapse - AccessControl azure-synapse-accesscontrol
Code | Docs
Synapse - AccessControl
azure-synapse-accesscontrol
get_paths() on DataLakeDirectoryClient.Code | Docs Support: Active
Code | Docs
Support: Active
Added support for service version 2024-11-04.
azure-core dependency to 1.30.0.Stable release of features from 12.16.0b1
Updated OAuth implementation to use the AAD scope returned in a Bearer challenge.
Stable release of features from 12.15.0b1
This version and all future versions will require Python 3.8+. Python 3.7 is no longer supported.
This version and all future versions will require Python 3.8+. Python 3.7 is no longer supported.
services parameter has been added to the generate_account_sas API, which enables the ability to generate SAS
tokens to be used with multiple services. By default, the SAS token service scope will default to the current service.upn as an optional keyword that can be specified on APIs that return an instance of PathProperties, DirectoryProperties or
FileProperties. Specifying this keyword transforms the user identity values returned in the owner, group, and acl fields of the
corresponding Properties from Azure Active Directory Object IDs to User Principal Names.typing-extensions to >=4.6.0 to avoid potential TypeError with typing.TypeVar on
Python 3.12.AttributeError instead of ClientAuthenticationError when
using async OAuth credentials.Stable release of features from 12.14.0b1
Added support for service version 2023-11-03.
audience as an optional keyword that can be specified on APIs that have a credential parameter. This
keyword only has an effect when the credential provided is of type TokenCredential.Fixed an issue when an invalid type was provided for credential during client construction, the __str__ of the object would be present in the exceptio
credential during client construction, the
__str__ of the object would be present in the exception message and therefore potentially logged.Fixed breaking KeyError: 'sdk_moniker' in create_configuration. NOTE: This is not an exported method and therefore should not be imported/called direc
KeyError: 'sdk_moniker' in create_configuration.
NOTE: This is not an exported method and therefore should not be imported/called directly.Stable release of features from 12.13.0b1
Added support for service versions 2023-05-03 and 2023-08-03.
Stable release of features from 12.12.0b1
Added support for service version 2023-01-03.
encryption_context to the upload_data API. Previously, encryption_context support was only on the create_file API.owner, group, and permission properties to DirectoryProperties and FileProperties.Stable release of features from 12.11.0b1
Added support for service version 2022-11-02.
encryption_context, a string value that can be passed when creating a file that will not be
encrypted with the file. This value is returned on download_file, get_file_properties and get_paths.Fixed "duplicate type signatures" MyPy error.
Stable release of features from 12.10.0b1
Added support for service version 2021-12-02.
lease_action for details.AsyncIterable as data type for async file upload.rename_file and rename_directory would not work correctly if the new file/directory name
contained a ? character.msrest dependency.typing-extensions>=4.0.1 as a dependency.isodate>=0.6.1 as a dependency.aio for installing optional async dependencies. Use pip install azure-storage-file-datalake[aio] to install.Fixed possible ValueError for invalid content range that gets raised when downloading empty files through Azurite.
ValueError for invalid content range that gets raised when downloading empty files through Azurite.Stable release of features from 12.9.0b1.
read_timeout to 60 seconds for all clients.This version and all future versions will require Python 3.7+. Python 3.6 is no longer supported.
This version and all future versions will require Python 3.7+. Python 3.6 is no longer supported.
AzureNamedKeyCredential as a valid credential type.flush to append_data API, allowing for append and flush in one operation.create_file_system APIs (FileSystemClient, DataLakeServiceClient).read method to StorageStreamDownloader.Stable release of features from 12.8.0b1.
expiry_options from file create APIs. With this change, expires_on now covers all functionality expiry_options offered.Added support for service version 2021-08-06.
owner, group, acl, lease_id, lease_duration to both file and directory create APIs.expiry_options, expires_on to file create APIs.Code | Docs Text Analytics azure-ai-textanalytics
Code | Docs
Text Analytics
azure-ai-textanalytics
Added support for service version 2021-06-08 as well as previous versions.
get_paths() API now returns creation_time and expiry_time for each path.create_file_system() docstring to have the correct return-type of None/ symbols not being stripped properly in async clientsget_paths() would fail if a path did not contain last_modified from the service.This version and all future versions will require Python 3.6+. Python 2.7 is no longer supported.
This version and all future versions will require Python 3.6+. Python 2.7 is no longer supported.
permanent_deleteset_immutability_policyazure-core dependency to avoid inconsistent dependencies from being installed.delete_files() method on FileSystemClient. This feature will be added back
in a future release.Added support for service version 2021-02-12.
Added support for batch deleting files using the delete_files() method from a FileSystemClient
New features
delete_files() method from a FileSystemClientpermanent_deleteset_immutability_policy
FixesFileSystemProperties was not subscriptable. Now it is both subscriptable and attributes can also be accessed directly (#20772)Stable release of preview features
Stable release of preview features
Deprecated new_name in for undelete filesystem operation
New features
Fixes
Notes
Added support set_service_properties(),get_service_properties() on DataLakeServiceClient
New features
set_service_properties(),get_service_properties() on DataLakeServiceClientlist_deleted_paths() on FileSystemClientAdded support set_service_properties(),get_service_properties() on DataLakeServiceClient
New features
set_service_properties(),get_service_properties() on DataLakeServiceClientlist_deleted_paths() on FileSystemClientFixes
PathProperties problem (#18490)Fixed recursive=True on file deletion
Fixes
recursive=True on file deletionAccountName, AccountKey etc. in conn_str case insensitivedownloader.chunks() return chunks in different size (#9419, #15648)ThreadPoolExecutor (#8955)New Features
get_account_information() APIStable release of preview features
Stable release of preview features
DatalakeServiceClient.undelete_filesystem()DirectoryClient.exists(), FileClient.exists() and FileSystemClient.exists()Fixes
DatalakeServiceClient context manager/session closure issue (#15358)PurePosixPath is now handled correctly if passed as a path (#16159)Added support for DatalakeServiceClient.undelete_filesystem()
New Features
DatalakeServiceClient.undelete_filesystem()Fixes
DatalakeServiceClient context manager/session closure issue (#15358)PurePosixPath is now handled correctly if passed as a path (#16159)Fixes - Fixed paging issue
Fixes
Fixes - Fixed msrest dependency issue
Fixes
Added support for AzureSasCredential to allow SAS rotation in long living clients.
New features
AzureSasCredential to allow SAS rotation in long living clients.Fixes
Stable release of preview features
Stable release of preview features
set_file_expiry on DataLakeFileClient.Fixes
Notes
azure-core from azure-core<2.0.0,>=1.6.0 to azure-core<2.0.0,>=1.9.0Added support for recursive set/update/remove Access Control on a path and sub-paths.
New Features
Fixed renaming with SAS string (#12057).
Fixes
Your coding agent can read these notes before it upgrades. Set up the MCP server →