import os import csv import requests import time import re from datetime import datetime from msal import ConfidentialClientApplication from urllib.parse import urlparse, quote def sanitize_filename(name): \"\"\"Removes invalid characters and handles Unicode whitespace for Windows.\"\"\" if not name: return \"unnamed_item\" # Handle Unicode non-breaking spaces (common in SharePoint names) name = name.replace('\u00A0', ' ').replace('\u200b', '') # Illegal characters: < > : \" / \ | ? * invalid_chars = '<>:\"/\\\\|?*' for char in invalid_chars: name = name.replace(char, '_') # Control characters (0-31) name = \"\".join(c for c in name if ord(c) >= 32) # Windows doesn't like trailing spaces or dots name = name.strip(' .') # Reserved names reserved_names = {\"CON\", \"PRN\", \"AUX\", \"NUL\", \"COM1\", \"COM2\", \"COM3\", \"COM4\", \"COM5\", \"COM6\", \"COM7\", \"COM8\", \"COM9\", \"LPT1\", \"LPT2\", \"LPT3\", \"LPT4\", \"LPT5\", \"LPT6\", \"LPT7\", \"LPT8\", \"LPT9\"} base_part = name.split('.')[0].upper() if base_part in reserved_names: name = \"_\" + name return name if name else \"unnamed_item\" def get_long_path(path): \"\"\"Converts a path to a long-path-aware format on Windows.\"\"\" if os.name == 'nt': abs_path = os.path.abspath(path) if not abs_path.startswith('\\\\\\\\?\\\\'): if abs_path.startswith('\\\\\\\\'): # UNC path return '\\\\\\\\?\\\\UNC\\\\' + abs_path[2:] return '\\\\\\\\?\\\\' + abs_path return path def load_config(file_path): config = {} with open(file_path, 'r', encoding='utf-8') as f: for line in f: if '=' in line: key, value = line.split('=', 1) config[key.strip()] = value.strip().strip('\"') return config def create_msal_app(tenant_id, client_id, client_secret): return ConfidentialClientApplication( client_id, authority=f\"https://login.microsoftonline.com/{tenant_id}\", client_credential=client_secret, ) def get_headers(app): \"\"\"Acquires a token from cache or fetches a new one if expired.\"\"\" scopes = [\"https://graph.microsoft.com/.default\"] result = app.acquire_token_for_client(scopes=scopes) if \"access_token\" in result: return {'Authorization': f'Bearer {result[\"access_token\"]}'} else: raise Exception(f\"Could not acquire token: {result.get('error_description')}\") def get_site_id(app, site_url): headers = get_headers(app) parsed = urlparse(site_url) hostname = parsed.netloc site_path = parsed.path url = f\"https://graph.microsoft.com/v1.0/sites/{hostname}:{site_path}\" response = requests.get(url, headers=headers) response.raise_for_status() return response.json()['id'] def get_drive_id(app, site_id, drive_name): headers = get_headers(app) url = f\"https://graph.microsoft.com/v1.0/sites/{site_id}/drives\" response = requests.get(url, headers=headers) response.raise_for_status() drives = response.json().get('value', []) for drive in drives: if drive['name'] == drive_name: return drive['id'] raise Exception(f\"Drive '{drive_name}' not found in site.\") def download_file(download_url, local_path, expected_size): try: long_local_path = get_long_path(local_path) # Check if file exists and size matches if os.path.exists(long_local_path): if os.path.isdir(long_local_path): return False, f\"Path exists as a directory: {local_path}\" local_size = os.path.getsize(long_local_path) if int(local_size) == int(expected_size): return True, \"Skipped\" target_dir = os.path.dirname(long_local_path) if not os.path.exists(target_dir): os.makedirs(target_dir, exist_ok=True) elif not os.path.isdir(target_dir): return False, f\"Parent path exists but is not a directory: {target_dir}\" # Stream download with timeout and 1MB chunks response = requests.get(download_url, stream=True, timeout=60) response.raise_for_status() with open(long_local_path, 'wb') as f: for chunk in response.iter_content(chunk_size=1024*1024): if chunk: f.write(chunk) local_size = os.path.getsize(long_local_path) if int(local_size) == int(expected_size): return True, \"Downloaded\" else: return False, f\"Size mismatch: Remote={expected_size}, Local={local_size}\" except Exception as e: return False, f\"[Error {getattr(e, 'errno', 'unknown')}] {str(e)}\" def download_folder_recursive(app, drive_id, item_path, local_root_path, report): try: headers = get_headers(app) encoded_path = quote(item_path) url = f\"https://graph.microsoft.com/v1.0/drives/{drive_id}/root:/{encoded_path}:/children\" if not item_path: url = f\"https://graph.microsoft.com/v1.0/drives/{drive_id}/root/children\" response = requests.get(url, headers=headers) response.raise_for_status() items = response.json().get('value', []) for item in items: item_name = item['name'] sanitized_name = sanitize_filename(item_name) local_path = os.path.normpath(os.path.join(local_root_path, sanitized_name)) if 'folder' in item: sub_item_path = f\"{item_path}/{item_name}\".strip('/') download_folder_recursive(app, drive_id, sub_item_path, local_path, report) elif 'file' in item: download_url = item.get('@microsoft.graph.downloadUrl') if not download_url: report.append({\"Path\": f\"{item_path}/{item_name}\", \"Error\": \"No URL\", \"Timestamp\": datetime.now().isoformat()}) continue success, status = download_file(download_url, local_path, item['size']) if success: if status != \"Skipped\": print(f\"Downloaded: {item_path}/{item_name}\") else: print(f\"FAILED: {item_path}/{item_name} - {status}\") report.append({\"Path\": f\"{item_path}/{item_name}\", \"Error\": status, \"Timestamp\": datetime.now().isoformat()}) except Exception as e: err_msg = f\"Folder error: {str(e)}\" print(f\"FAILED FOLDER: {item_path} - {err_msg}\") report.append({\"Path\": item_path, \"Error\": err_msg, \"Timestamp\": datetime.now().isoformat()}) def main(): config = load_config('connection_info.txt') tenant_id = config.get('TENANT_ID') client_id = config.get('CLIENT_ID') client_secret = config.get('CLIENT_SECRET') site_url = config.get('SITE_URL') drive_name = config.get('DOCUMENT_LIBRARY') folders_to_download_str = config.get('FOLDERS_TO_DOWNLOAD', '') local_path_base = config.get('LOCAL_PATH', '').replace('\\\\', os.sep) folders_to_download = [f.strip() for f in folders_to_download_str.split(',') if f.strip()] if not folders_to_download: folders_to_download = [\"\"] print(f\"Connecting via Graph API...\") report = [] try: app = create_msal_app(tenant_id, client_id, client_secret) site_id = get_site_id(app, site_url) drive_id = get_drive_id(app, site_id, drive_name) for folder in folders_to_download: # Clean folder paths from config folder_parts = [sanitize_filename(p) for p in folder.split('/') if p] local_folder_path = os.path.normpath(os.path.join(local_path_base, *folder_parts)) print(f\"\\nProcessing: {folder if folder else 'Root'}\") download_folder_recursive(app, drive_id, folder, local_folder_path, report) except Exception as e: print(f\"Critical error: {e}\") report.append({\"Path\": \"GENERAL\", \"Error\": str(e), \"Timestamp\": datetime.now().isoformat()}) report_file = f\"download_report_{datetime.now().strftime('%Y%m%d_%H%M%S')}.csv\" with open(report_file, 'w', newline='', encoding='utf-8') as f: writer = csv.DictWriter(f, fieldnames=[\"Path\", \"Error\", \"Timestamp\"]) writer.writeheader() writer.writerows(report) print(f\"\\nProcess complete. Errors: {len(report)}\") if __name__ == \"__main__\": main()