Office365-REST-Python-Client 2.5.14__py3-none-any.whl → 2.6.1__py3-none-any.whl

{Office365_REST_Python_Client-2.5.14.dist-info → Office365_REST_Python_Client-2.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Office365-REST-Python-Client
-Version: 2.5.14
+Version: 2.6.1
 Summary: Microsoft 365 & Microsoft Graph Library for Python
 Home-page: https://github.com/vgrem/Office365-REST-Python-Client
 Author: Vadim Gremyachev
@@ -34,6 +34,7 @@ Requires-Dist: typing-extensions >=4.0.0
 Provides-Extra: ntlmprovider
 Requires-Dist: requests-ntlm ; extra == 'ntlmprovider'
 
+
 # About
 Microsoft 365 & Microsoft Graph library for Python
 
@@ -129,7 +130,7 @@ Steps to access:
    - [Granting access via Azure AD App-Only](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azuread)  
    - [wiki](https://github.com/vgrem/Office365-REST-Python-Client/wiki/How-to-connect-to-SharePoint-Online-with-certificate-credentials) 
   
-  Example: [connect_with_client_certificate.py](examples/sharepoint/auth_client_certificate.py)
+  Example: [with_certificate.py](examples/sharepoint/auth_certificate.py)
 
 #### 4. Interactive
 
@@ -208,19 +209,18 @@ The list of examples:
   
 Refer [examples section](examples/sharepoint) for another scenarios
 
-### Support for non-standard SharePoint Online Environments
-
-  Support for non-standard SharePoint Environments is currently being implemented. Currently supported:
-  - GCC High
+### Support for Azure environments
 
-  To enable authentication to GCC High endpoints, add the `environment='GCCH'` parameter when calling the 
+  To enable authentication to specific Azure environment endpoints, add the `environment` parameter when calling the 
   `ClientContext class` with `.with_user_credentials`, `.with_client_credentials`, or `.with_credentials`
 
    Example:
    ```python
+   from office365.azure_env import AzureEnvironment
    from office365.sharepoint.client_context import ClientContext
+   from office365.runtime.auth.client_credential import ClientCredential
    client_credentials = ClientCredential('{client_id}','{client_secret}')
-   ctx = ClientContext('{url}').with_credentials(client_credentials, environment='GCCH')
+   ctx = ClientContext('{site-url}', environment=AzureEnvironment.USGovernmentHigh).with_credentials(client_credentials)
    ```
 
 # Working with Outlook API
@@ -249,26 +249,13 @@ Using [Microsoft Authentication Library (MSAL) for Python](https://pypi.org/proj
 > in the provided examples. Other forms of token acquisition can be found here: https://msal-python.readthedocs.io/en/latest/
 
 ```python
-import msal
 from office365.graph_client import GraphClient
-
-def acquire_token():
-    """
-    Acquire token via MSAL
-    """
-    authority_url = 'https://login.microsoftonline.com/{tenant_id_or_name}'
-    app = msal.ConfidentialClientApplication(
-        authority=authority_url,
-        client_id='{client_id}',
-        client_credential='{client_secret}'
-    )
-    token = app.acquire_token_for_client(scopes=["https://graph.microsoft.com/.default"])
-    return token
-
-
-client = GraphClient(acquire_token)
-
+client = GraphClient(tenant='{tenant_name_or_id}').with_client_secret(
+    client_id='{client_id}', 
+    client_secret='{client_secret}'
+)
 ```
+Example: [with_client_secret](examples/auth/with_client_secret.py)
 
 But in terms of Microsoft Graph API authentication, another OAuth spec compliant libraries 
 such as [adal](https://github.com/AzureAD/azure-activedirectory-library-for-python) 
@@ -304,7 +291,9 @@ The example demonstrates how to send an email via [Microsoft Graph endpoint](htt
 ```python
 from office365.graph_client import GraphClient
 
-client = GraphClient(acquire_token_func)
+client = GraphClient(tenant='{tenant_name_or_id}').with_username_and_password(
+    '{client_id}', '{username}', '{password}'
+)
 
 client.me.send_mail(
     subject="Meet for lunch?",
@@ -370,7 +359,7 @@ which corresponds to [`list available drives` endpoint](https://docs.microsoft.c
 from office365.graph_client import GraphClient
 
 tenant_name = "contoso.onmicrosoft.com"
-client = GraphClient(acquire_token_func)
+client = GraphClient(tenant=tenant_name)
 drives = client.drives.get().execute_query()
 for drive in drives:
     print("Drive url: {0}".format(drive.web_url))
@@ -381,7 +370,7 @@ for drive in drives:
 
 ```python
 from office365.graph_client import GraphClient
-client = GraphClient(acquire_token_func)
+client = GraphClient(tenant="contoso.onmicrosoft.com")
 # retrieve drive properties 
 drive = client.users["{user_id_or_principal_name}"].drive.get().execute_query()
 # download files from OneDrive into local folder 
@@ -451,7 +440,9 @@ Example: Create a new page
 
 ```python
 from office365.graph_client import GraphClient
-client = GraphClient(acquire_token_func)
+client = GraphClient(tenant='{tenant_name_or_id}').with_username_and_password(
+    '{client_id}', '{username}', '{password}'
+)
 
 files = {}
 with open("./MyPage.html", 'rb') as f, \