{"library":"adlfs","title":"adlfs","description":"adlfs provides an fsspec-compatible interface for accessing Azure Blob Storage, Azure Data Lake Storage Gen2, and the now-deprecated Azure Data Lake Storage Gen1. It allows Python users to interact with Azure storage as if it were a local filesystem, integrating seamlessly with data processing libraries like Dask, Pandas, and Ray. The library is currently at version 2026.2.0 and maintains an active release schedule.","language":"python","status":"active","last_verified":"Wed May 20","install":{"commands":["pip install adlfs"],"cli":null},"imports":["from adlfs import AzureBlobFileSystem","from adlfs import AzureDatalakeFileSystem"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom adlfs import AzureBlobFileSystem\n\n# Recommended: Use environment variables for credentials\n# e.g., AZURE_STORAGE_ACCOUNT_NAME, AZURE_STORAGE_ACCOUNT_KEY, AZURE_STORAGE_SAS_TOKEN\n# For DefaultAzureCredential, ensure AZURE_STORAGE_ACCOUNT_NAME is set and anon=False\n\naccount_name = os.environ.get('AZURE_STORAGE_ACCOUNT_NAME', 'your_account_name')\n# For demonstration, using anonymous access to a public container\n# In real scenarios, provide proper credentials (account_key, sas_token, or use anon=False)\nfs = AzureBlobFileSystem(account_name=account_name, anon=True)\n\n# Example: List contents of a public container\ncontainer_name = \"azureopendatastorage\" # A known public container\npath_to_list = f\"az://{container_name}/\" \n\ntry:\n    print(f\"Listing contents of {path_to_list}:\")\n    contents = fs.ls(path_to_list, detail=False)\n    for item in contents[:5]: # Print first 5 items\n        print(item)\n    if not contents: print(\"Container is empty or access denied (check credentials/permissions).\")\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\n    print(\"Please ensure 'AZURE_STORAGE_ACCOUNT_NAME' is set, or if accessing a private container, provide valid credentials.\")\n\n# Example: Read a file (requires appropriate permissions)\n# Replace with a real path if you have authenticated access\n# file_path = f\"az://{container_name}/path/to/your/file.txt\"\n# try:\n#     with fs.open(file_path, 'rb') as f:\n#         data = f.read()\n#         print(f\"\\nContent of {file_path[:50]}...: {data.decode()[:100]}...\")\n# except Exception as e:\n#     print(f\"\\nCould not read file {file_path[:50]}...: {e}\")","lang":"python","description":"This quickstart demonstrates how to initialize `adlfs.AzureBlobFileSystem` and list contents of a public Azure Blob Storage container. For private containers, authentication relies on `storage_options` parameters (like `account_key`, `sas_token`, `connection_string`, or service principal details) or automatic credential resolution via `DefaultAzureCredential` (by setting `anon=False` and ensuring `AZURE_STORAGE_ACCOUNT_NAME` is set).","tag":null,"tag_description":null,"last_tested":"2026-04-24","results":[{"runtime":"python:3.10-alpine","exit_code":0},{"runtime":"python:3.10-slim","exit_code":-1},{"runtime":"python:3.11-alpine","exit_code":0},{"runtime":"python:3.11-slim","exit_code":-1},{"runtime":"python:3.12-alpine","exit_code":0},{"runtime":"python:3.12-slim","exit_code":-1},{"runtime":"python:3.13-alpine","exit_code":0},{"runtime":"python:3.13-slim","exit_code":-1},{"runtime":"python:3.9-alpine","exit_code":0},{"runtime":"python:3.9-slim","exit_code":-1}]},"compatibility":{"tag":"verified","tag_description":"installs cleanly on critical runtimes, fast import, recently tested","last_tested":"2026-05-20","installed_version":"2025.8.0","pypi_latest":"2026.5.0","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":6.5,"avg_import_s":1.68,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.55,"mem_mb":24.1,"disk_size":"57.5M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":1.53,"mem_mb":25.5,"disk_size":"57.1M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":7.3,"import_time_s":1.1,"mem_mb":24.1,"disk_size":"60M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":1.17,"mem_mb":25.5,"disk_size":"59M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.76,"mem_mb":27.2,"disk_size":"63.0M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":2.23,"mem_mb":29.1,"disk_size":"62.7M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":6.3,"import_time_s":1.53,"mem_mb":27.2,"disk_size":"65M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":1.56,"mem_mb":29.1,"disk_size":"65M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.83,"mem_mb":26.9,"disk_size":"54.2M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":2.03,"mem_mb":28.6,"disk_size":"53.9M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":5,"import_time_s":1.78,"mem_mb":26.9,"disk_size":"56M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":2.15,"mem_mb":28.6,"disk_size":"56M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.81,"mem_mb":27.3,"disk_size":"53.9M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":2,"mem_mb":29,"disk_size":"53.5M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":5,"import_time_s":1.7,"mem_mb":27.3,"disk_size":"56M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":2.19,"mem_mb":29,"disk_size":"56M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.46,"mem_mb":25.6,"disk_size":"58.7M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":1.44,"mem_mb":25.4,"disk_size":"57.6M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":8.7,"import_time_s":1.39,"mem_mb":25.6,"disk_size":"61M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"adlfs","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":1.29,"mem_mb":25.4,"disk_size":"60M"}]}}