Office365-REST-Python-Client 3.1.0__py3-none-any.whl → 3.2.0__py3-none-any.whl

office365/migration/_util.py

@@ -1,73 +0,0 @@
-"""Shared helpers for the migration toolkit (progress, CSV/JSON, timestamps).
-
-Keeps the small, repeated idioms (progress emission, record export, ISO-8601
-timestamps) in one place instead of inlining them in every adapter/runner.
-"""
-
-from __future__ import annotations
-
-import csv
-import json
-import os
-from datetime import datetime, timezone
-from pathlib import Path
-
-
-def emit_progress(progress, *, done: int, total: int | None = None, stage: str, items=None) -> None:
-    """Invoke a progress hook (if any) with a ``Progress`` snapshot.
-
-    Centralizes the ``if callable(progress): Progress(...)`` idiom used across
-    the toolkit.
-    """
-    if callable(progress):
-        from office365.runtime.operations import Progress
-
-        progress(Progress(done=done, total=total, stage=stage, items=items))
-
-
-def write_csv_json(dir_: str | Path, stem: str, records: list[dict], columns: list[str] | None = None) -> list[str]:
-    """Write records as both CSV and JSON under ``dir_``; returns the file paths."""
-    os.makedirs(dir_, exist_ok=True)
-    columns = list(columns) if columns else (list(records[0]) if records else [])
-
-    csv_path = os.path.join(str(dir_), f"{stem}.csv")
-    with open(csv_path, "w", newline="", encoding="utf-8") as f:
-        writer = csv.DictWriter(f, fieldnames=columns, restval="n/a")
-        writer.writeheader()
-        writer.writerows(records)
-
-    json_path = os.path.join(str(dir_), f"{stem}.json")
-    with open(json_path, "w", encoding="utf-8") as f:
-        json.dump(records, f, indent=2)
-
-    return [csv_path, json_path]
-
-
-def coerce_int(value) -> int | None:
-    """Best-effort ``int`` conversion (``None`` for unset/invalid values)."""
-    try:
-        return int(value) if value is not None else None
-    except (TypeError, ValueError):
-        return None
-
-
-def utc_now_iso() -> str:
-    """Current UTC time as an ISO-8601 string (second precision)."""
-    return datetime.now(timezone.utc).isoformat(timespec="seconds")
-
-
-def iso(value) -> str:
-    """ISO-8601 string for a datetime (second precision); ``""`` for ``None``."""
-    if value is None:
-        return ""
-    return value.isoformat(timespec="seconds")
-
-
-def record_to_json(payload: object) -> str:
-    """Serialize a record to the canonical JSON text used when persisting it.
-
-    SharePoint property values are often entity/datetime objects, so a str
-    fallback keeps the payload JSON-safe. Source/target checksums both use this
-    form, so content verification compares identical text.
-    """
-    return json.dumps(payload, indent=2, default=str)

office365/sharepoint/listitems/caml/types.py

@@ -1,70 +0,0 @@
-from __future__ import annotations
-
-from office365.sharepoint.views.scope import ViewScope
-
-
-class WhereElement:
-    """Used within the context of a query to specify a filter."""
-
-    def __str__(self):
-        return "<Where></Where>"
-
-
-class OrderByElement:
-    """Determines the sort order for a query"""
-
-    def __str__(self):
-        return "<OrderBy></OrderBy>"
-
-
-class GroupByElement:
-    """Contains a Group By section for grouping the data returned through a query in a list view."""
-
-    def __str__(self):
-        return "<GroupBy></GroupBy>"
-
-
-class QueryElement:
-    """Defines the query for a view."""
-
-    def __init__(self):
-        self.Where = WhereElement()
-        self.OrderBy = OrderByElement()
-        self.GroupBy = GroupByElement()
-
-    @staticmethod
-    def parse(expr):
-        return QueryElement()
-
-    def __repr__(self):
-        return f"<Query>{str(self.Where)}</Query>"
-
-
-class RowLimitElement:
-    """Sets the row limit for the number of items to display in a view."""
-
-    def __init__(self, top=None):
-        """Args:
-        top (int):
-        """
-        self.Top = top
-
-    def __str__(self):
-        return f'<RowLimit Paged="TRUE">{self.Top}</RowLimit>'
-
-
-class ViewElement:
-    """"""
-
-    def __init__(
-        self,
-        scope=ViewScope.DefaultValue,
-        query=QueryElement(),
-        row_limit=RowLimitElement(),
-    ):
-        self.Scope = scope
-        self.Query = query
-        self.RowLimit = row_limit
-
-    def __str__(self):
-        return f'<View Scope="{self.Scope}"><Query>{str(self.Query)}</Query></View>'

office365_rest_python_client-3.1.0.dist-info/METADATA

@@ -1,475 +0,0 @@
-Metadata-Version: 2.3
-Name: office365-rest-python-client
-Version: 3.1.0
-Summary: Microsoft 365 & Microsoft Graph Library for Python
-Author: Vadim Gremyachev
-Author-email: Vadim Gremyachev <vvgrem@gmail.com>
-License: The MIT License (MIT)
-         
-         Copyright (c) 2016 Vadim Gremyachev
-         
-         Permission is hereby granted, free of charge, to any person obtaining a copy
-         of this software and associated documentation files (the "Software"), to deal
-         in the Software without restriction, including without limitation the rights
-         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-         copies of the Software, and to permit persons to whom the Software is
-         furnished to do so, subject to the following conditions:
-         
-         The above copyright notice and this permission notice shall be included in all
-         copies or substantial portions of the Software.
-         
-         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-         SOFTWARE.
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-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: Programming Language :: Python :: 3.14
-Classifier: Topic :: Internet :: WWW/HTTP
-Classifier: Topic :: Software Development :: Libraries
-Requires-Dist: msal>=1.28,<2
-Requires-Dist: pytz>=2021.1
-Requires-Dist: requests>=2.32.4,<3
-Requires-Dist: typing-extensions>=4.5
-Requires-Dist: faker ; extra == 'examples'
-Requires-Dist: openpyxl>=3.1 ; extra == 'excel'
-Requires-Dist: pandas>=1.3.0 ; extra == 'notebooks'
-Requires-Dist: jupyter ; extra == 'notebooks'
-Requires-Dist: nbformat ; extra == 'notebooks'
-Requires-Dist: jinja2 ; extra == 'notebooks'
-Requires-Dist: requests-ntlm ; extra == 'ntlm'
-Requires-Dist: pandas>=1.5 ; extra == 'pandas'
-Maintainer: Domenico Di Nicola
-Maintainer-email: Domenico Di Nicola <dom.dinicola@gmail.com>
-Requires-Python: >=3.8.0
-Project-URL: repository, https://github.com/vgrem/office365-rest-python-client
-Provides-Extra: examples
-Provides-Extra: excel
-Provides-Extra: notebooks
-Provides-Extra: ntlm
-Provides-Extra: pandas
-Description-Content-Type: text/markdown
-
-# office365-rest-python-client
-
-[![Downloads](https://pepy.tech/badge/office365-rest-python-client/month)](https://pepy.tech/project/office365-rest-python-client)
-[![PyPI](https://img.shields.io/pypi/v/office365-rest-python-client.svg)](https://pypi.python.org/pypi/office365-rest-python-client)
-[![PyPI pyversions](https://img.shields.io/pypi/pyversions/office365-rest-python-client.svg)](https://pypi.python.org/pypi/office365-rest-python-client/)
-[![Sponsor](https://img.shields.io/badge/-Sponsor-%23EA4AAA?logo=github&logoColor=white)](https://github.com/sponsors/vgrem)
-
-**Python client library for Microsoft 365 and Microsoft Graph APIs.**
-
-Covers SharePoint REST API v1, Microsoft Graph (Outlook, OneDrive, Teams, OneNote, Planner, and more), and supports all modern Azure AD authentication flows.
-
-> **Python 3.8+ required.**
-
----
-
-## Support
-
-`office365-rest-python-client` is free and maintained in the open. Sponsorship funds security updates, new API coverage, documentation, and releases. See the [roadmap](ROADMAP.md) for what's funded.
-
-- [**GitHub Sponsors**](https://github.com/sponsors/vgrem) — recurring monthly support
-- [**PayPal**](https://paypal.me/ossvgrem) — one-off donation
-- **Using this in production?** The [Organization tier](https://github.com/sponsors/vgrem) adds priority issue response and a roadmap vote; [contact us](https://github.com/vgrem/office365-rest-python-client/discussions) for paid support, custom feature work, or help migrating from 2.6.2 → 3.0.0.
-
----
-
-## Table of Contents
-
-- [Installation](#installation)
-- [Support](#support)
-- [Which client do I need?](#which-client-do-i-need)
-- [Authentication](#authentication)
-  - [ClientContext — SharePoint auth](#clientcontext--sharepoint-auth)
-  - [GraphClient — Microsoft Graph auth](#graphclient--microsoft-graph-auth)
-  - [Azure Environments](#azure-environments)
-- [SharePoint — ClientContext](#sharepoint--clientcontext)
-- [Microsoft Graph — GraphClient](#microsoft-graph--graphclient)
-- [Dependencies](#dependencies)
-
----
-
-## Installation
-
-```bash
-pip install office365-rest-python-client
-```
-
-With [uv](https://github.com/astral-sh/uv):
-
-```bash
-uv pip install office365-rest-python-client
-```
-
-Latest from GitHub (includes unreleased changes):
-
-```bash
-pip install git+https://github.com/vgrem/office365-rest-python-client.git
-```
-
----
-
-## Which client do I need?
-
-| | `ClientContext` | `GraphClient` |
-|---|---|---|
-| **Target API** | SharePoint REST API v1 | Microsoft Graph API |
-| **Use for** | SharePoint lists, files, folders, search, site admin, permissions | Outlook, OneDrive, Teams, OneNote, Planner, Users, Groups |
-| **SharePoint via Graph?** | — | Partial - use `ClientContext` for full SharePoint fidelity |
-| **Docs** | [SharePoint REST API](https://learn.microsoft.com/en-us/sharepoint/dev/sp-add-ins/get-to-know-the-sharepoint-rest-service) | [Microsoft Graph](https://learn.microsoft.com/en-us/graph/overview) |
-
----
-
-## Authentication
-
-> All modern auth flows use **Azure AD** via the [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-python) library.
-> Legacy flows (ACS, SAML) are fully retired as of April/May 2026.
->
-> [ACS retirement notice](https://aka.ms/retirement/acs/support) | [SAML retirement MC1184649](https://learn.microsoft.com/en-us/sharepoint/dev/security/saml-auth-retirement)
->
-> Migrating from SAML? See [examples/sharepoint/auth/modern/migrate_from_saml_to_cert.py](examples/sharepoint/auth/modern/migrate_from_saml_to_cert.py)
-
-Two clients, different auth capabilities:
-
-| | `ClientContext` | `GraphClient` |
-|---|---|---|
-| **Target** | SharePoint REST API v1 | Microsoft Graph API |
-| **Resource** | `{tenant}.sharepoint.com` | `graph.microsoft.com` |
-
-### ClientContext — SharePoint auth
-
-| Flow | Method | User/App | MFA | Status | Docs |
-|------|--------|----------|-----|--------|------|
-| **Certificate** (Azure AD) | `with_client_certificate(tenant, client_id, thumbprint, cert_path)` | App-only | — | ✅ Recommended | [Docs](https://learn.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azuread) |
-| **Username & password** (MSAL ROPC) | `with_username_and_password(tenant, client_id, username, password)` | Delegated | ❌ | ✅ Supported | [Docs](https://learn.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc) |
-| **Interactive** (browser) | `with_interactive(tenant, client_id)` | Delegated | ✅ | ✅ Supported | [Docs](https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-authentication-flows) |
-| **Device code** | `with_device_flow(tenant, client_id)` | Delegated | ✅ | ✅ Supported | [Docs](https://learn.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-device-code) |
-| **NTLM** (on-prem only) | `with_user_credentials(username, password)` | Delegated | — | ✅ On-prem only | [Example](examples/sharepoint/auth/legacy/with_ntlm.py) |
-| **Client secret** (Azure AD) | `with_client_secret(tenant, client_id, secret)` | App-only | — | ❌ Not documented | [Microsoft's own migration guidance](https://mc.merill.net/message/MC1184649) confirms: replace legacy ACS auth with OAuth2 client credentials flow using certificates, not client secrets, for SharePoint access. |
-| ~~SAML user auth~~ | `with_user_credentials(username, password)` | Delegated | ❌ | 🚫 Retired May 2026 | [Migration guide](examples/sharepoint/auth/modern/migrate_from_saml_to_cert.py) |
-| ~~ACS app-only~~ | `with_credentials(ClientCredential(...))` | App-only | — | 🚫 Retired Apr 2026 | [Notice](https://aka.ms/retirement/acs/support) |
-
-### GraphClient — Microsoft Graph auth
-
-| Flow | Method | User/App | MFA | Status | Docs |
-|------|--------|----------|-----|--------|------|
-| **Client secret** | `with_client_secret(client_id, secret)` | App-only | — | ✅ Recommended | [Docs](https://learn.microsoft.com/en-us/graph/auth-v2-service) |
-| **Certificate** | `with_client_certificate(client_id, thumbprint, key)` | App-only | — | ✅ Recommended | [Docs](https://learn.microsoft.com/en-us/graph/auth-v2-service) |
-| **Interactive** | `with_token_interactive(client_id)` | Delegated | ✅ | ✅ Supported | [Docs](https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-authentication-flows) |
-| **Username & password** | `with_username_and_password(client_id, username, password)` | Delegated | ❌ | ✅ Supported | [Docs](https://learn.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc) |
-| **Custom token** | `GraphClient(acquire_token_func)` | Both | ✅ | ✅ Supported | — |
-
----
-
-### Azure Environments
-
-For national and sovereign clouds, pass the `environment` parameter:
-
-```python
-from office365.azure_env import AzureEnvironment
-from office365.sharepoint.client_context import ClientContext
-
-ctx = ClientContext("{site_url}", environment=AzureEnvironment.USGovernmentHigh)\
-    .with_client_certificate(...)
-```
-
-| Environment | Constant |
-|---|---|
-| Global (default) | `AzureEnvironment.Global` |
-| US Government GCC | `AzureEnvironment.USGovernment` |
-| US Government GCC High | `AzureEnvironment.USGovernmentHigh` |
-| US Government DoD | `AzureEnvironment.USGovernmentDoD` |
-| China (21Vianet) | `AzureEnvironment.China` |
-| Germany (legacy) | `AzureEnvironment.Germany` |
-
----
-
-## SharePoint — ClientContext
-
-### Quick start
-
-```python
-from office365.sharepoint.client_context import ClientContext
-
-ctx = ClientContext("{site_url}").with_client_certificate(
-    tenant="{tenant}", client_id="{client_id}",
-    thumbprint="{thumbprint}", cert_path="./cert.pem"
-)
-web = ctx.web.get().execute_query()
-print(f"Site title: {web.title}")
-```
-
-### Lists & Items
-
-```python
-# Get all items (handles 5000+ row threshold automatically)
-items = ctx.web.lists.get_by_title("Orders").items.get_all().execute_query()
-for item in items:
-    print(item.properties["Title"])
-
-# Create item
-target_list = ctx.web.lists.get_by_title("Tasks")
-item = target_list.add_item({"Title": "New task", "Status": "Active"}).execute_query()
-
-# Bulk create — auto-batches in chunks of 100 (sequential by default)
-for row in data:
-    target_list.add_item({"Title": row["name"]})
-ctx.execute_batch()
-
-# Parallel bulk create — up to 5 batch requests in flight at once, cutting
-# wall time for large imports. Transient failures (e.g. HTTP 429) are retried,
-# honoring Retry-After. With concurrency > 1 the success_callback runs on the
-# caller thread in completion order (not submission order).
-ctx.execute_batch(concurrency=5)
-
-# Filter, select, expand
-items = ctx.web.lists.get_by_title("Projects")\
-    .items\
-    .filter("Status eq 'Active'")\
-    .select(["Title", "Author/Title"])\
-    .expand(["Author"])\
-    .get_all().execute_query()
-```
-
-[All list examples](examples/sharepoint/lists/)
-
-### Files & Folders
-
-```python
-# Upload file
-with open("report.pdf", "rb") as f:
-    folder = ctx.web.get_folder_by_server_relative_url("/sites/mysite/Shared Documents")
-    file = folder.upload_file("report.pdf", f).execute_query()
-
-# Download file
-with open("report.pdf", "wb") as f:
-    ctx.web.get_file_by_server_relative_path("/sites/mysite/Shared Documents/report.pdf")\
-        .download(f).execute_query()
-
-# Large file upload (chunked)
-folder.files.create_upload_session(
-    local_path, chunk_size=10*1024*1024,
-    chunk_uploaded=lambda offset: print(f"{offset} bytes uploaded")
-).execute_query()
-
-# Download folder as zip
-with open("archive.zip", "wb") as f:
-    folder.download_folder(f).execute_query()
-
-# Create nested folders
-base = ctx.web.get_folder_by_server_relative_url("/sites/mysite/Shared Documents")
-sub = base.add("Projects").execute_query()
-sub.add("2025").execute_query()
-```
-
-[All file examples](examples/sharepoint/files/) | [All folder examples](examples/sharepoint/folders/)
-
-### Search
-
-```python
-from office365.sharepoint.search.request import SearchRequest
-from office365.sharepoint.search.service import SearchService
-
-search = SearchService(ctx)
-request = SearchRequest("IsDocument:1", RowLimit=50, StartRow=0)
-result = search.post_query(request).execute_query()
-
-rows = result.value.PrimaryQueryResult.RelevantResults.Table.Rows
-for row in rows:
-    print(row)
-```
-
-[All search examples](examples/sharepoint/search/)
-
-### Permissions
-
-```python
-from office365.sharepoint.roles.type import RoleType
-
-# Break inheritance and grant access to a user
-role_def = ctx.web.role_definitions.get_by_type(RoleType.Reader)
-user = ctx.web.ensure_user("i:0#.f|membership|user@company.com")
-item = ctx.web.lists.get_by_title("Confidential").items.get_by_id(1)
-item.break_role_inheritance(copy_role_assignments=False)
-item.add_role_assignment(user, role_def)
-ctx.execute_query()
-```
-
-[Permissions examples](examples/sharepoint/permissions/)
-
-### Site Administration (Tenant)
-
-```python
-from office365.sharepoint.tenant.administration.tenant import Tenant
-
-tenant = Tenant(ctx)
-
-# List all sites
-sites = tenant.get_site_properties_from_sharepoint_by_filters().execute_query()
-for site in sites:
-    print(site.url)
-
-# Create a site
-tenant.create_site({"Url": "https://tenant.sharepoint.com/sites/newsite", "Title": "New Site"}).execute_query()
-```
-
-[All tenant/admin examples](examples/sharepoint/tenant/)
-
----
-
-## Microsoft Graph - GraphClient
-
-### Quick start
-
-```python
-from office365.graph_client import GraphClient
-
-client = GraphClient(tenant="{tenant}").with_client_secret(
-    client_id="{client_id}", client_secret="{client_secret}"
-)
-me = client.me.get().execute_query()
-print(f"Signed in as: {me.user_principal_name}")
-```
-
-### Outlook - Mail & Calendar
-
-```python
-# Send email
-client.me.send_mail(
-    subject="Hello",
-    body="Message body",
-    to_recipients=["user@company.com"]
-).execute_query()
-
-# List messages
-messages = client.me.messages.top(10).get().execute_query()
-for msg in messages:
-    print(msg.subject)
-
-# Create calendar event
-from office365.outlook.calendar.events.event import Event
-event = client.me.calendar.events.add(
-    subject="Team standup",
-    start="2025-06-01T09:00:00",
-    end="2025-06-01T09:30:00"
-).execute_query()
-```
-
-[All Outlook examples](examples/outlook/)
-
-### OneDrive
-
-```python
-# List drives
-drives = client.drives.get().execute_query()
-
-# Upload file to OneDrive
-with open("report.xlsx", "rb") as f:
-    client.me.drive.root.upload("report.xlsx", f).execute_query()
-
-# Download file
-with open("report.xlsx", "wb") as local_file:
-    client.me.drive.root.get_by_path("Documents/report.xlsx")\
-        .download(local_file).execute_query()
-```
-
-[All OneDrive examples](examples/onedrive/)
-
-### Teams
-
-```python
-# List all teams
-teams = client.groups.get().execute_query()
-
-# Send channel message
-client.teams["{team_id}"].channels["{channel_id}"]\
-    .messages.add(body="Hello team!").execute_query()
-
-# Create a team
-new_team = client.groups["{group_id}"].add_team().execute_query()
-```
-
-[All Teams examples](examples/teams/)
-
-### OneNote
-
-```python
-# Create a page
-with open("MyPage.html", "rb") as f:
-    page = client.me.onenote.pages.add(presentation_file=f).execute_query()
-```
-
-[All OneNote examples](examples/onenote/)
-
-### Planner
-
-```python
-# Create a task
-task = client.planner.tasks.add(
-    title="Review PR",
-    planId="{plan_id}"
-).execute_query()
-```
-
-[All Planner examples](examples/planner/)
-
-### Users & Groups
-
-```python
-# List users
-users = client.users.top(100).get().execute_query()
-
-# Create group
-group = client.groups.add(
-    display_name="Engineering",
-    mail_nickname="engineering",
-    mail_enabled=False,
-    security_enabled=True
-).execute_query()
-```
-
-[All user examples](examples/entraid/users/)
-
----
-
-## Dependencies
-
-Installed automatically:
-
-| Package | Purpose |
-|---|---|
-| [requests](https://github.com/psf/requests) | HTTP transport |
-| [msal](https://github.com/AzureAD/microsoft-authentication-library-for-python) | Azure AD authentication |
-
-Optional:
-
-```bash
-pip install office365-rest-python-client[pandas]   # to_dataframe() on collections
-```
-
----
-
-## Contributing
-
-PRs welcome. See [issues](https://github.com/vgrem/office365-rest-python-client/issues) for things to work on.
-
-## Links
-
-- [PyPI](https://pypi.org/project/office365-rest-python-client/)
-- [Changelog](CHANGELOG.md)
-- [SharePoint REST API docs](https://learn.microsoft.com/en-us/sharepoint/dev/sp-add-ins/get-to-know-the-sharepoint-rest-service)
-- [Microsoft Graph docs](https://learn.microsoft.com/en-us/graph/overview)
-- [MSAL for Python](https://github.com/AzureAD/microsoft-authentication-library-for-python)