Recursively list all files and folders in the drive.

Walks the whole hierarchy with get_files() / get_folders() and reports a flat inventory — useful for audits, migrations, or quota reporting.

Permissions

Requires delegated permission Files.Read.

Reference

• https://learn.microsoft.com/en-us/graph/api/driveitem-list-children

View source

import argparse

from office365.graph_client import GraphClient
from office365.onedrive.driveitems.driveItem import DriveItem
from office365.runtime.operations import Progress
from tests.settings import client_id, password, tenant, username


def progress_bar(description: str):
    """tqdm-backed hook — the library only needs a ``Callable[[Progress], None]``."""
    from tqdm import tqdm

    bar = tqdm(desc=description)

    def hook(p: Progress[DriveItem]) -> None:
        bar.update(p.done - bar.n)

    return hook


def main():
    parser = argparse.ArgumentParser(description="List all files and folders recursively")
    parser.add_argument("--folder", default="/", help="path to start from (default: drive root)")
    parser.add_argument("--no-progress", action="store_true", help="do not show tqdm progress bars")
    args = parser.parse_args()

    client = GraphClient(tenant=tenant).with_username_and_password(client_id, username, password)
    root = client.me.drive.root.get_by_path(args.folder).get().execute_query()

    folders_hook = None if args.no_progress else progress_bar("Folders")
    files_hook = None if args.no_progress else progress_bar("Files")
    folders = root.get_folders(recursive=True, progress=folders_hook).execute_query()
    files = root.get_files(recursive=True, progress=files_hook).execute_query()

    total_size = sum(f.size or 0 for f in files)
    print(f"Under '{args.folder}':")
    print(f"  {len(folders):,} folders, {len(files):,} files ({total_size:,} bytes total)\n")

    print("Files (first 25):")
    for f in list(files)[:25]:
        print(f"  {f.name:40s}  {f.size or 0:,} bytes")


if __name__ == "__main__":
    main()

---

← Back to OneDrive & SharePoint Folders