apache-airflow-providers-microsoft-azure 12.7.0__tar.gz → 12.8.1rc1__tar.gz

apache_airflow_providers_microsoft_azure-12.8.1rc1/NOTICE

@@ -0,0 +1,5 @@
+Apache Airflow
+Copyright 2016-2025 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (http://www.apache.org/).

{apache_airflow_providers_microsoft_azure-12.7.0 → apache_airflow_providers_microsoft_azure-12.8.1rc1}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: apache-airflow-providers-microsoft-azure
-Version: 12.7.0
+Version: 12.8.1rc1
 Summary: Provider package apache-airflow-providers-microsoft-azure for Apache Airflow
 Keywords: airflow-provider,microsoft.azure,airflow,integration
 Author-email: Apache Software Foundation <dev@airflow.apache.org>
 Maintainer-email: Apache Software Foundation <dev@airflow.apache.org>
 Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
+License-Expression: Apache-2.0
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Environment :: Web Environment
@@ -14,13 +15,15 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
 Classifier: Framework :: Apache Airflow
 Classifier: Framework :: Apache Airflow :: Provider
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: System :: Monitoring
-Requires-Dist: apache-airflow>=2.10.0
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: apache-airflow>=2.10.0rc1
+Requires-Dist: apache-airflow-providers-common-compat>=1.8.0rc1
 Requires-Dist: adlfs>=2023.10.0
 Requires-Dist: azure-batch>=8.0.0
 Requires-Dist: azure-cosmos>=4.6.0
@@ -36,13 +39,13 @@ Requires-Dist: azure-storage-file-share>=12.7.0
 Requires-Dist: azure-servicebus>=7.12.1
 Requires-Dist: azure-synapse-spark>=0.2.0
 Requires-Dist: azure-synapse-artifacts>=0.17.0
-Requires-Dist: adal>=1.2.7
 Requires-Dist: azure-storage-file-datalake>=12.9.1
-Requires-Dist: azure-kusto-data>=4.1.0,!=4.6.0
+Requires-Dist: azure-kusto-data>=4.1.0,!=4.6.0,!=5.0.0
 Requires-Dist: azure-mgmt-datafactory>=2.0.0
 Requires-Dist: azure-mgmt-containerregistry>=8.0.0
 Requires-Dist: azure-mgmt-containerinstance>=10.1.0
 Requires-Dist: msgraph-core>=1.3.3
+Requires-Dist: msgraphfs>=0.3.0
 Requires-Dist: microsoft-kiota-http>=1.9.4,<2.0.0
 Requires-Dist: microsoft-kiota-serialization-json>=1.9.4
 Requires-Dist: microsoft-kiota-serialization-text>=1.9.4
@@ -54,8 +57,8 @@ Requires-Dist: apache-airflow-providers-common-compat ; extra == "common-compat"
 Requires-Dist: apache-airflow-providers-oracle ; extra == "oracle"
 Requires-Dist: apache-airflow-providers-sftp ; extra == "sftp"
 Project-URL: Bug Tracker, https://github.com/apache/airflow/issues
-Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.7.0/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.7.0
+Project-URL: Changelog, https://airflow.staged.apache.org/docs/apache-airflow-providers-microsoft-azure/12.8.1/changelog.html
+Project-URL: Documentation, https://airflow.staged.apache.org/docs/apache-airflow-providers-microsoft-azure/12.8.1
 Project-URL: Mastodon, https://fosstodon.org/@airflow
 Project-URL: Slack Chat, https://s.apache.org/airflow-slack
 Project-URL: Source Code, https://github.com/apache/airflow
@@ -90,7 +93,7 @@ Provides-Extra: sftp
 
 Package ``apache-airflow-providers-microsoft-azure``
 
-Release: ``12.7.0``
+Release: ``12.8.1``
 
 
 `Microsoft Azure <https://azure.microsoft.com/>`__
@@ -103,7 +106,7 @@ This is a provider package for ``microsoft.azure`` provider. All classes for thi
 are in ``airflow.providers.microsoft.azure`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.7.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.8.1/>`_.
 
 Installation
 ------------
@@ -117,39 +120,40 @@ The package supports the following python versions: 3.10,3.11,3.12,3.13
 Requirements
 ------------
 
-========================================  ===================
-PIP package                               Version required
-========================================  ===================
-``apache-airflow``                        ``>=2.10.0``
-``adlfs``                                 ``>=2023.10.0``
-``azure-batch``                           ``>=8.0.0``
-``azure-cosmos``                          ``>=4.6.0``
-``azure-mgmt-cosmosdb``                   ``>=3.0.0``
-``azure-datalake-store``                  ``>=0.0.45``
-``azure-identity``                        ``>=1.3.1``
-``azure-keyvault-secrets``                ``>=4.1.0``
-``azure-mgmt-datalake-store``             ``>=0.5.0``
-``azure-mgmt-resource``                   ``>=2.2.0``
-``azure-storage-blob``                    ``>=12.26.0``
-``azure-mgmt-storage``                    ``>=16.0.0``
-``azure-storage-file-share``              ``>=12.7.0``
-``azure-servicebus``                      ``>=7.12.1``
-``azure-synapse-spark``                   ``>=0.2.0``
-``azure-synapse-artifacts``               ``>=0.17.0``
-``adal``                                  ``>=1.2.7``
-``azure-storage-file-datalake``           ``>=12.9.1``
-``azure-kusto-data``                      ``>=4.1.0,!=4.6.0``
-``azure-mgmt-datafactory``                ``>=2.0.0``
-``azure-mgmt-containerregistry``          ``>=8.0.0``
-``azure-mgmt-containerinstance``          ``>=10.1.0``
-``msgraph-core``                          ``>=1.3.3``
-``microsoft-kiota-http``                  ``>=1.9.4,<2.0.0``
-``microsoft-kiota-serialization-json``    ``>=1.9.4``
-``microsoft-kiota-serialization-text``    ``>=1.9.4``
-``microsoft-kiota-abstractions``          ``>=1.9.4,<2.0.0``
-``microsoft-kiota-authentication-azure``  ``>=1.9.4,<2.0.0``
-``msal-extensions``                       ``>=1.3.0``
-========================================  ===================
+==========================================  ===========================
+PIP package                                 Version required
+==========================================  ===========================
+``apache-airflow``                          ``>=2.10.0``
+``apache-airflow-providers-common-compat``  ``>=1.8.0``
+``adlfs``                                   ``>=2023.10.0``
+``azure-batch``                             ``>=8.0.0``
+``azure-cosmos``                            ``>=4.6.0``
+``azure-mgmt-cosmosdb``                     ``>=3.0.0``
+``azure-datalake-store``                    ``>=0.0.45``
+``azure-identity``                          ``>=1.3.1``
+``azure-keyvault-secrets``                  ``>=4.1.0``
+``azure-mgmt-datalake-store``               ``>=0.5.0``
+``azure-mgmt-resource``                     ``>=2.2.0``
+``azure-storage-blob``                      ``>=12.26.0``
+``azure-mgmt-storage``                      ``>=16.0.0``
+``azure-storage-file-share``                ``>=12.7.0``
+``azure-servicebus``                        ``>=7.12.1``
+``azure-synapse-spark``                     ``>=0.2.0``
+``azure-synapse-artifacts``                 ``>=0.17.0``
+``azure-storage-file-datalake``             ``>=12.9.1``
+``azure-kusto-data``                        ``>=4.1.0,!=4.6.0,!=5.0.0``
+``azure-mgmt-datafactory``                  ``>=2.0.0``
+``azure-mgmt-containerregistry``            ``>=8.0.0``
+``azure-mgmt-containerinstance``            ``>=10.1.0``
+``msgraph-core``                            ``>=1.3.3``
+``msgraphfs``                               ``>=0.3.0``
+``microsoft-kiota-http``                    ``>=1.9.4,<2.0.0``
+``microsoft-kiota-serialization-json``      ``>=1.9.4``
+``microsoft-kiota-serialization-text``      ``>=1.9.4``
+``microsoft-kiota-abstractions``            ``>=1.9.4,<2.0.0``
+``microsoft-kiota-authentication-azure``    ``>=1.9.4,<2.0.0``
+``msal-extensions``                         ``>=1.3.0``
+==========================================  ===========================
 
 Cross provider package dependencies
 -----------------------------------
@@ -173,6 +177,18 @@ Dependent package
 `apache-airflow-providers-sftp <https://airflow.apache.org/docs/apache-airflow-providers-sftp>`_                    ``sftp``
 ==================================================================================================================  =================
 
+Optional dependencies
+----------------------
+
+=================  ==========================================
+Extra              Dependencies
+=================  ==========================================
+``amazon``         ``apache-airflow-providers-amazon``
+``common.compat``  ``apache-airflow-providers-common-compat``
+``oracle``         ``apache-airflow-providers-oracle``
+``sftp``           ``apache-airflow-providers-sftp``
+=================  ==========================================
+
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.7.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.8.1/changelog.html>`_.
 

{apache_airflow_providers_microsoft_azure-12.7.0 → apache_airflow_providers_microsoft_azure-12.8.1rc1}/README.rst

@@ -23,7 +23,7 @@
 
 Package ``apache-airflow-providers-microsoft-azure``
 
-Release: ``12.7.0``
+Release: ``12.8.1``
 
 
 `Microsoft Azure <https://azure.microsoft.com/>`__
@@ -36,7 +36,7 @@ This is a provider package for ``microsoft.azure`` provider. All classes for thi
 are in ``airflow.providers.microsoft.azure`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.7.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.8.1/>`_.
 
 Installation
 ------------
@@ -50,39 +50,40 @@ The package supports the following python versions: 3.10,3.11,3.12,3.13
 Requirements
 ------------
 
-========================================  ===================
-PIP package                               Version required
-========================================  ===================
-``apache-airflow``                        ``>=2.10.0``
-``adlfs``                                 ``>=2023.10.0``
-``azure-batch``                           ``>=8.0.0``
-``azure-cosmos``                          ``>=4.6.0``
-``azure-mgmt-cosmosdb``                   ``>=3.0.0``
-``azure-datalake-store``                  ``>=0.0.45``
-``azure-identity``                        ``>=1.3.1``
-``azure-keyvault-secrets``                ``>=4.1.0``
-``azure-mgmt-datalake-store``             ``>=0.5.0``
-``azure-mgmt-resource``                   ``>=2.2.0``
-``azure-storage-blob``                    ``>=12.26.0``
-``azure-mgmt-storage``                    ``>=16.0.0``
-``azure-storage-file-share``              ``>=12.7.0``
-``azure-servicebus``                      ``>=7.12.1``
-``azure-synapse-spark``                   ``>=0.2.0``
-``azure-synapse-artifacts``               ``>=0.17.0``
-``adal``                                  ``>=1.2.7``
-``azure-storage-file-datalake``           ``>=12.9.1``
-``azure-kusto-data``                      ``>=4.1.0,!=4.6.0``
-``azure-mgmt-datafactory``                ``>=2.0.0``
-``azure-mgmt-containerregistry``          ``>=8.0.0``
-``azure-mgmt-containerinstance``          ``>=10.1.0``
-``msgraph-core``                          ``>=1.3.3``
-``microsoft-kiota-http``                  ``>=1.9.4,<2.0.0``
-``microsoft-kiota-serialization-json``    ``>=1.9.4``
-``microsoft-kiota-serialization-text``    ``>=1.9.4``
-``microsoft-kiota-abstractions``          ``>=1.9.4,<2.0.0``
-``microsoft-kiota-authentication-azure``  ``>=1.9.4,<2.0.0``
-``msal-extensions``                       ``>=1.3.0``
-========================================  ===================
+==========================================  ===========================
+PIP package                                 Version required
+==========================================  ===========================
+``apache-airflow``                          ``>=2.10.0``
+``apache-airflow-providers-common-compat``  ``>=1.8.0``
+``adlfs``                                   ``>=2023.10.0``
+``azure-batch``                             ``>=8.0.0``
+``azure-cosmos``                            ``>=4.6.0``
+``azure-mgmt-cosmosdb``                     ``>=3.0.0``
+``azure-datalake-store``                    ``>=0.0.45``
+``azure-identity``                          ``>=1.3.1``
+``azure-keyvault-secrets``                  ``>=4.1.0``
+``azure-mgmt-datalake-store``               ``>=0.5.0``
+``azure-mgmt-resource``                     ``>=2.2.0``
+``azure-storage-blob``                      ``>=12.26.0``
+``azure-mgmt-storage``                      ``>=16.0.0``
+``azure-storage-file-share``                ``>=12.7.0``
+``azure-servicebus``                        ``>=7.12.1``
+``azure-synapse-spark``                     ``>=0.2.0``
+``azure-synapse-artifacts``                 ``>=0.17.0``
+``azure-storage-file-datalake``             ``>=12.9.1``
+``azure-kusto-data``                        ``>=4.1.0,!=4.6.0,!=5.0.0``
+``azure-mgmt-datafactory``                  ``>=2.0.0``
+``azure-mgmt-containerregistry``            ``>=8.0.0``
+``azure-mgmt-containerinstance``            ``>=10.1.0``
+``msgraph-core``                            ``>=1.3.3``
+``msgraphfs``                               ``>=0.3.0``
+``microsoft-kiota-http``                    ``>=1.9.4,<2.0.0``
+``microsoft-kiota-serialization-json``      ``>=1.9.4``
+``microsoft-kiota-serialization-text``      ``>=1.9.4``
+``microsoft-kiota-abstractions``            ``>=1.9.4,<2.0.0``
+``microsoft-kiota-authentication-azure``    ``>=1.9.4,<2.0.0``
+``msal-extensions``                         ``>=1.3.0``
+==========================================  ===========================
 
 Cross provider package dependencies
 -----------------------------------
@@ -106,5 +107,17 @@ Dependent package
 `apache-airflow-providers-sftp <https://airflow.apache.org/docs/apache-airflow-providers-sftp>`_                    ``sftp``
 ==================================================================================================================  =================
 
+Optional dependencies
+----------------------
+
+=================  ==========================================
+Extra              Dependencies
+=================  ==========================================
+``amazon``         ``apache-airflow-providers-amazon``
+``common.compat``  ``apache-airflow-providers-common-compat``
+``oracle``         ``apache-airflow-providers-oracle``
+``sftp``           ``apache-airflow-providers-sftp``
+=================  ==========================================
+
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.7.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/12.8.1/changelog.html>`_.

{apache_airflow_providers_microsoft_azure-12.7.0 → apache_airflow_providers_microsoft_azure-12.8.1rc1}/docs/changelog.rst

@@ -27,11 +27,74 @@
 Changelog
 ---------
 
-12.7.0
+12.8.1
+......
+
+Misc
+~~~~
+
+* ``Convert all airflow distributions to be compliant with ASF requirements (#58138)``
+* ``Remove adal dependency (#57798)``
+
+.. Below changes are excluded from the changelog. Move them to
+   appropriate section above if needed. Do not delete the lines(!):
+   * ``Delete all unnecessary LICENSE Files (#58191)``
+   * ``Enable PT006 rule to microsoft Provider test(azure,mssql,psrp) (#57936)``
+   * ``Enable PT006 rule to microsoft Provider test(operators) (#57928)``
+   * ``Enable PT006 rule to microsoft Provider test(transfers) (#57925)``
+   * ``Enable PT006 rule to microsoft Provider test(log,sensors) (#57927)``
+   * ``Enable PT006 rule to microsoft Provider test(hooks) (#57932)``
+   * ``Fix mypy static errors in main (#57755)``
+   * ``Attempt to resolve pip "ResolutionTooDeep" on cffi conflict (#57697)``
+   * ``Enable ruff PLW1508 rule (#57653)``
+   * ``Fix documentation/provider.yaml consistencies (#57283)``
+
+12.8.0
+......
+
+Features
+~~~~~~~~
+
+* ``Add Microsoft Graph filesystem integration (#55454)``
+* ``update AzureBaseHook to return credentials that supports get_token method" (#56228)``
+
+Misc
+~~~~
+
+* ``Migrate microsoft providers to ''common.compat'' (#56995)``
+* ``improve exception handling in AzureDataFactoryTrigger (#56350)``
+
+Doc-only
+~~~~~~~~
+
+* ``Remove placeholder Release Date in changelog and index files (#56056)``
+
+.. Below changes are excluded from the changelog. Move them to
+   appropriate section above if needed. Do not delete the lines(!):
+   * ``Fix Databricks provider import error without fab provider (#56702)``
+   * ``Remove 'pytest.importorskip("flask_appbuilder")' from tests (#56679)``
+   * ``Revert "update AzureBaseHook to return credentials that supports get_token me…" (#56223)``
+   * ``update AzureBaseHook to return credentials that supports get_token method (#52182)``
+   * ``Enable PT011 rule to prvoider tests (#56021)``
+
+12.7.1
 ......
 
 
-Release Date: ``|PypiReleaseDate|``
+Bug Fixes
+~~~~~~~~~
+
+* ``[OSSTaskHandler, CloudwatchTaskHandler, S3TaskHandler, HdfsTaskHandler, ElasticsearchTaskHandler, GCSTaskHandler, OpensearchTaskHandler, RedisTaskHandler, WasbTaskHandler] supports log file size handling (#55455)``
+* ``Avoid using extra_dejson method on connection in KiotaRequestAdapterHook to avoid AsyncToSync RuntimeError (#55179)``
+
+.. Below changes are excluded from the changelog. Move them to
+   appropriate section above if needed. Do not delete the lines(!):
+   * ``Remove db dependency from test_wasb trigger tests (#55624)``
+   * ``Switch all airflow logging to structlog (#52651)``
+
+12.7.0
+......
+
 
 Features
 ~~~~~~~~

{apache_airflow_providers_microsoft_azure-12.7.0 → apache_airflow_providers_microsoft_azure-12.8.1rc1}/docs/connections/azure.rst

@@ -74,6 +74,8 @@ Extra (optional)
       It specifies the json that contains the authentication information.
     * ``managed_identity_client_id``:  The client ID of a user-assigned managed identity. If provided with ``workload_identity_tenant_id``, they'll pass to DefaultAzureCredential_.
     * ``workload_identity_tenant_id``: ID of the application's Microsoft Entra tenant. Also called its "directory" ID. If provided with ``managed_identity_client_id``, they'll pass to DefaultAzureCredential_.
+    * ``use_azure_identity_object``: If set to true, it will use credential of newer type: ClientSecretCredential or DefaultAzureCredential instead of ServicePrincipalCredentials or AzureIdentityCredentialAdapter.
+      These newer credentials support get_token method which can be used to generate OAuth token with custom scope.
 
     The entire extra column can be left out to fall back on DefaultAzureCredential_.
 

apache_airflow_providers_microsoft_azure-12.8.1rc1/docs/filesystems/index.rst

@@ -0,0 +1,26 @@
+ .. Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+ ..   http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Filesystems
+===========
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Filesystem Providers
+    :glob:
+
+    *

apache_airflow_providers_microsoft_azure-12.8.1rc1/docs/filesystems/msgraph.rst

@@ -0,0 +1,187 @@
+ .. Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+ ..   http://www.apache.org/licenses/LICENSE-2.0
+
+ .. Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Microsoft Graph Filesystem
+===========================
+
+The Microsoft Graph filesystem provides access to OneDrive, SharePoint, and Teams document libraries through Airflow's ObjectStoragePath interface.
+
+Supported URL formats:
+
+* ``msgraph://connection_id/drive_id/path/to/file``
+* ``sharepoint://connection_id/drive_id/path/to/file``
+* ``onedrive://connection_id/drive_id/path/to/file``
+* ``msgd://connection_id/drive_id/path/to/file``
+
+Connection Configuration
+------------------------
+
+Create a Microsoft Graph connection in Airflow with the following parameters:
+
+* **Connection Type**: msgraph
+* **Host**: Tenant ID
+* **Login**: Client ID
+* **Password**: Client Secret
+
+The connection form provides additional configuration fields:
+
+* **Tenant ID**: Azure AD tenant identifier
+* **Drive ID**: Specific drive to access (optional - leave empty for general access)
+* **Scopes**: OAuth2 scopes (default: https://graph.microsoft.com/.default)
+
+Additional OAuth2 parameters supported via connection extras:
+
+* **scope**: OAuth2 access scope
+* **token_endpoint**: Custom token endpoint URL
+* **redirect_uri**: OAuth2 redirect URI for authorization code flow
+* **token_endpoint_auth_method**: Client authentication method (default: client_secret_basic)
+* **code_challenge_method**: PKCE code challenge method (e.g., 'S256')
+* **username**: Username for password grant flow
+* **password**: Password for password grant flow
+
+Connection extra field configuration example:
+
+.. code-block:: json
+
+    {
+        "drive_id": "b!abc123...",
+        "scope": "https://graph.microsoft.com/.default",
+        "token_endpoint": "https://login.microsoftonline.com/your-tenant/oauth2/v2.0/token",
+        "redirect_uri": "http://localhost:8080/callback",
+        "token_endpoint_auth_method": "client_secret_post"
+    }
+
+Usage Examples
+--------------
+
+Reading Files
+^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    from airflow.sdk.io.path import ObjectStoragePath
+
+    # Access a file in OneDrive
+    path = ObjectStoragePath("onedrive://my_conn/drive123/Documents/data.csv")
+
+    # Read file content
+    with path.open("r") as f:
+        content = f.read()
+
+Directory Operations
+^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    # List directory contents in SharePoint
+    sharepoint_path = ObjectStoragePath("sharepoint://sp_conn/site_drive/Shared Documents/")
+
+    for item in sharepoint_path.iterdir():
+        print(f"Found: {item.name}")
+        if item.is_file():
+            print(f"  Size: {item.stat().st_size} bytes")
+
+File Operations
+^^^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    # Copy file between drives
+    source = ObjectStoragePath("msgraph://conn1/drive1/source.txt")
+    target = ObjectStoragePath("msgraph://conn2/drive2/backup/source.txt")
+    source.copy(target)
+
+    # Move file
+    old_path = ObjectStoragePath("onedrive://conn/drive/temp/file.txt")
+    new_path = ObjectStoragePath("onedrive://conn/drive/archive/file.txt")
+    old_path.move(new_path)
+
+    # Delete file
+    file_to_delete = ObjectStoragePath("msgraph://conn/drive/old_data.csv")
+    file_to_delete.unlink()
+
+Writing Files
+^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    # Write new file
+    output_path = ObjectStoragePath("sharepoint://sp_conn/docs/reports/report.txt")
+
+    with output_path.open("w") as f:
+        f.write("Generated report data\n")
+        f.write(f"Created at: {datetime.now()}\n")
+
+Drive Discovery
+^^^^^^^^^^^^^^^
+
+When you need to find the correct drive ID for your URLs, you can use the Microsoft Graph API operators:
+
+.. code-block:: python
+
+    from airflow.providers.microsoft.azure.operators.msgraph import MSGraphAsyncOperator
+
+    # List all drives for a user
+    list_drives = MSGraphAsyncOperator(
+        task_id="list_drives",
+        conn_id="msgraph_conn",
+        url="me/drives",
+        result_processor=lambda response: [
+            {"id": drive["id"], "name": drive["name"]} for drive in response["value"]
+        ],
+    )
+
+URL Scheme Mapping
+------------------
+
+The different URL schemes map to specific Microsoft Graph endpoints:
+
+* ``msgraph://`` - General Microsoft Graph access
+* ``onedrive://`` - OneDrive personal and business drives
+* ``sharepoint://`` - SharePoint document libraries
+* ``msgd://`` - Shortened form of msgraph://
+
+All schemes use the same underlying Microsoft Graph API and authentication.
+
+Requirements
+------------
+
+The Microsoft Graph filesystem requires:
+
+* ``msgraphfs`` Python package
+* Valid Azure AD application registration with appropriate permissions
+* Microsoft Graph API access for your tenant
+
+Required Microsoft Graph permissions:
+
+* ``Files.Read`` - To read files
+* ``Files.ReadWrite`` - To read and write files
+* ``Sites.Read.All`` - To access SharePoint sites (if using ``sharepoint://`` URLs)
+
+Cross-References
+----------------
+
+* :doc:`Microsoft Graph API Operators </operators/msgraph>` - For API operations and drive discovery
+
+Reference
+---------
+
+For further information, look at:
+
+* `Microsoft Graph Files API <https://learn.microsoft.com/en-us/graph/api/resources/onedrive>`__
+* `msgraphfs Python package <https://pypi.org/project/msgraphfs/>`__
+* `Use the Microsoft Graph API <https://learn.microsoft.com/en-us/graph/use-the-api/>`__