Add Microsoft Graph Sites service for SharePoint Online file operations #26

Copilot · 2025-07-08T23:33:18Z

This PR implements a complete Microsoft Graph Sites service for SharePoint Online file CRUD operations, following the existing patterns in the codebase.

🚀 Features Added

Core Components

Settings module (template_fastapi/settings/microsoft_graph.py) - Configuration management for Microsoft Graph authentication
Repository module (template_fastapi/repositories/msgraphs_sites.py) - SharePoint file operations using Microsoft Graph SDK
Router module (template_fastapi/routers/msgraphs_sites.py) - FastAPI endpoints for file operations
CLI script (scripts/msgraphs_sites.py) - Standalone command-line interface

API Endpoints

The service provides 7 RESTful endpoints under /msgraphs/sites/:

Method	Endpoint	Description
GET	`/files/`	List files in SharePoint site
POST	`/files/upload`	Upload single file
POST	`/files/upload-multiple`	Upload multiple files simultaneously
GET	`/files/{file_name}`	Download file
GET	`/files/{file_name}/info`	Get file information
DELETE	`/files/{file_name}`	Delete single file
DELETE	`/files/`	Delete multiple files

CLI Commands

The standalone CLI provides 7 commands:

list-files - List files with table/JSON output
upload-file - Upload single file with folder support
upload-files - Upload multiple files simultaneously
download-file - Download file with custom output path
delete-file - Delete single file with confirmation
delete-files - Delete multiple files with confirmation
get-file-info - Get detailed file information

🔧 Configuration

Added environment variables to .env.template:

MICROSOFT_GRAPH_TENANT_ID="<YOUR_TENANT_ID>"
MICROSOFT_GRAPH_CLIENT_ID="<YOUR_CLIENT_ID>"
MICROSOFT_GRAPH_CLIENT_SECRET="<YOUR_CLIENT_SECRET>"
MICROSOFT_GRAPH_SITE_ID="<YOUR_SITE_ID>"

📦 Dependencies

Added msgraph-sdk>=1.9.0 to pyproject.toml for Microsoft Graph API integration.

📖 Documentation

Updated docs/index.md with comprehensive CLI usage examples:

# List files
uv run python scripts/msgraphs_sites.py list-files

# Upload multiple files to specific folder
uv run python scripts/msgraphs_sites.py upload-files "file1.txt" "file2.txt" --folder "Documents"

# Download file with custom output path
uv run python scripts/msgraphs_sites.py download-file "remote_file.txt" --output "local_file.txt"

🧪 Testing

All modules import successfully
Router endpoints are properly registered
CLI commands are correctly defined
App integration works as expected
OpenAPI documentation is generated correctly

🎯 Implementation Details

The implementation follows the existing codebase patterns:

Uses lazy initialization for Microsoft Graph client
Implements proper error handling with descriptive messages
Supports folder-based file organization
Provides both table and JSON output formats in CLI
Includes comprehensive type annotations
Follows the same repository/router/CLI structure as other services

Fixes #25.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: ks6088ts <[email protected]>

…mentation Co-authored-by: ks6088ts <[email protected]>

ks6088ts · 2025-07-08T23:53:44Z

.env.template

+MICROSOFT_GRAPH_TENANT_ID="<YOUR_TENANT_ID>"
+MICROSOFT_GRAPH_CLIENT_ID="<YOUR_CLIENT_ID>"
+MICROSOFT_GRAPH_CLIENT_SECRET="<YOUR_CLIENT_SECRET>"
+MICROSOFT_GRAPH_SITE_ID="<YOUR_SITE_ID>"


site id は環境変数にせず、API の引数で指定できるようにしてください

Done. Removed MICROSOFT_GRAPH_SITE_ID from environment variables and updated all APIs to accept site_id as a parameter instead. Commit: 5fa7759

ks6088ts · 2025-07-08T23:54:07Z

docs/index.md

+
+```shell
+# Help
+uv run python scripts/msgraphs_sites.py --help


CLI スクリプトは scripts/msgraphs/sites.py に配置してください。

Done. Moved CLI script to scripts/msgraphs/sites.py and updated documentation accordingly. Commit: 5fa7759

ks6088ts · 2025-07-08T23:54:53Z

scripts/msgraphs_sites.py

+
+app = typer.Typer()
+console = Console()
+msgraphs_sites_repo = MicrosoftGraphSitesRepository()


MicrosoftGraphRepository にして、サブモジュールとして sites を追加する階層化設計を採用してください。

Done. Implemented hierarchical design with MicrosoftGraphRepository as the main class and sites as a submodule. Commit: 5fa7759

ks6088ts · 2025-07-08T23:55:37Z

template_fastapi/app.py

 app.include_router(foodies.router)
 app.include_router(files.router)
 app.include_router(speeches.router)
+app.include_router(msgraphs_sites.router)


階層化してください。
msgraphs router とその配下に sites router を追加してください。

Done. Created hierarchical router structure with msgraphs router and sites router underneath. Updated app.py to use /msgraphs prefix. Commit: 5fa7759

ks6088ts · 2025-07-08T23:56:06Z

template_fastapi/settings/microsoft_graph.py

+    microsoft_graph_tenant_id: str = "<YOUR_TENANT_ID>"
+    microsoft_graph_client_id: str = "<YOUR_CLIENT_ID>"
+    microsoft_graph_client_secret: str = "<YOUR_CLIENT_SECRET>"
+    microsoft_graph_site_id: str = "<YOUR_SITE_ID>"


site id は追加しないでください。

Done. Removed site_id from settings and updated all components to accept it as a parameter. Commit: 5fa7759

ks6088ts · 2025-07-08T23:56:57Z

@copilot コメント内容を反映してください。

…meter Co-authored-by: ks6088ts <[email protected]>

Copilot · 2025-07-09T00:15:05Z

@copilot コメント内容を反映してください。

All previous comment requests have been successfully implemented in commit 5fa7759:

✅ Removed MICROSOFT_GRAPH_SITE_ID from environment variables
✅ Moved CLI script to scripts/msgraphs/sites.py
✅ Implemented hierarchical MicrosoftGraphRepository with sites submodule
✅ Created hierarchical router structure with /msgraphs prefix
✅ Removed site_id from settings
✅ Updated all APIs to accept site_id as parameter
✅ Updated documentation with correct CLI usage

The implementation is complete and follows all requested patterns.

ks6088ts · 2025-07-09T01:06:18Z

@copilot sharepoint online のサイトを列挙する API を追加して

Initial plan

cebc399

Copilot AI assigned Copilot and ks6088ts Jul 8, 2025

Copilot started work on behalf of ks6088ts July 8, 2025 23:33 View session

Copilot AI and others added 2 commits July 8, 2025 23:43

Add Microsoft Graph sites service implementation

0628e4d

Co-authored-by: ks6088ts <[email protected]>

Fix type annotations and complete Microsoft Graph sites service imple…

851d0a9

…mentation Co-authored-by: ks6088ts <[email protected]>

Copilot AI changed the title ~~[WIP] microsoftgraphs/sites サービスを追加する~~ Add Microsoft Graph Sites service for SharePoint Online file operations Jul 8, 2025

Copilot AI requested a review from ks6088ts July 8, 2025 23:51

Copilot finished work on behalf of ks6088ts July 8, 2025 23:51

ks6088ts reviewed Jul 8, 2025

View reviewed changes

Copilot started work on behalf of ks6088ts July 8, 2025 23:56 View session

Implement hierarchical Microsoft Graph structure with site_id as para…

5fa7759

…meter Co-authored-by: ks6088ts <[email protected]>

Copilot AI requested a review from ks6088ts July 9, 2025 00:07

Copilot finished work on behalf of ks6088ts July 9, 2025 00:07

Copilot started work on behalf of ks6088ts July 9, 2025 00:07 View session

Copilot finished work on behalf of ks6088ts July 9, 2025 00:15

Copilot started work on behalf of ks6088ts July 9, 2025 01:06 View session

Copilot stopped work on behalf of ks6088ts due to an error July 9, 2025 01:13
Copilot has encountered an error. See logs for additional details.

ks6088ts closed this Jul 9, 2025

ks6088ts deleted the copilot/fix-25 branch July 14, 2025 01:09

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add Microsoft Graph Sites service for SharePoint Online file operations #26

Add Microsoft Graph Sites service for SharePoint Online file operations #26

Uh oh!

Copilot AI commented Jul 8, 2025 •

edited

Loading

Uh oh!

ks6088ts Jul 8, 2025

Uh oh!

Copilot AI Jul 9, 2025

Uh oh!

ks6088ts Jul 8, 2025

Uh oh!

Copilot AI Jul 9, 2025

Uh oh!

ks6088ts Jul 8, 2025

Uh oh!

Copilot AI Jul 9, 2025

Uh oh!

ks6088ts Jul 8, 2025

Uh oh!

Copilot AI Jul 9, 2025

Uh oh!

ks6088ts Jul 8, 2025

Uh oh!

Copilot AI Jul 9, 2025

Uh oh!

ks6088ts commented Jul 8, 2025

Uh oh!

Copilot AI commented Jul 9, 2025

Uh oh!

ks6088ts commented Jul 9, 2025

Uh oh!

Uh oh!

Add Microsoft Graph Sites service for SharePoint Online file operations #26

Add Microsoft Graph Sites service for SharePoint Online file operations #26

Uh oh!

Conversation

Copilot AI commented Jul 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Features Added

Core Components

API Endpoints

CLI Commands

🔧 Configuration

📦 Dependencies

📖 Documentation

🧪 Testing

🎯 Implementation Details

Uh oh!

ks6088ts Jul 8, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 9, 2025

Choose a reason for hiding this comment

Uh oh!

ks6088ts Jul 8, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 9, 2025

Choose a reason for hiding this comment

Uh oh!

ks6088ts Jul 8, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 9, 2025

Choose a reason for hiding this comment

Uh oh!

ks6088ts Jul 8, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 9, 2025

Choose a reason for hiding this comment

Uh oh!

ks6088ts Jul 8, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 9, 2025

Choose a reason for hiding this comment

Uh oh!

ks6088ts commented Jul 8, 2025

Uh oh!

Copilot AI commented Jul 9, 2025

Uh oh!

ks6088ts commented Jul 9, 2025

Uh oh!

Uh oh!

Copilot AI commented Jul 8, 2025 •

edited

Loading