machineconfig 3.7__py3-none-any.whl → 7.69__py3-none-any.whl

machineconfig/setup_windows/web_shortcuts/interactive.ps1

@@ -1,191 +1,30 @@
-Write-Host "
-🚀 ===========================================
-📦 Machine Configuration Installation Script
-============================================="
 
-Write-Host "ℹ️  If you have execution policy issues, run:
-Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser"
-Write-Host "💡 To accept all prompts automatically, run: `$yesAll = `$true`n"
 
-
-Write-Host "🔄 Setting up Python environment..."
-Invoke-WebRequest -Uri "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/ve.ps1" -OutFile "ve.ps1"
-.\ve.ps1
-rm ve.ps1
-
-Write-Host "`n🔄 Setting up repositories..."
-Invoke-WebRequest -Uri "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/repos.ps1" -OutFile "repos.ps1"
-.\repos.ps1
-rm repos.ps1
-
-Write-Host "`n📂 ============================================
-🔄 DOTFILES MIGRATION OPTIONS
-============================================="
-
-Write-Host "🖱️  Method 1: USING MOUSE WITHOUT KB OR BROWSER SHARE
-    On original machine, run:
-    cd ~/dotfiles/creds/msc
-    easy-sharing . --password rew
-    Then open browser on new machine to get MouseWithoutBorders password"
-
-Write-Host "`n🔐 Method 2: USING SSH
-    FROM REMOTE, RUN:
-    ftpx ~/dotfiles `$(hostname):^ -z"
-
-Write-Host "`n💻 For WSL:
-    wsl_server.ps1
-    ftpx ~/dotfiles `$env:USERNAME@localhost:2222 -z
-    # OR:
-    New-Item -ItemType SymbolicLink -Path `$env:USERPROFILE\dotfiles -Target \\wsl`$\Ubuntu\home\`$env:USERNAME\dotfiles"
-
-Write-Host "`n☁️  Method 3: USING INTERNET SECURE SHARE
-    cd ~
-    cloud_copy SHARE_URL . --config ss
-    (requires symlinks to be created first)"
-
-Write-Host "`n----------------------------------------"
-if (-not $yesAll) {
-    $choice = Read-Host "🔒 Install SSH Server [y]/n"
-} else {
-    $choice = "y"
-}
-if ([string]::IsNullOrEmpty($choice)) { $choice = "y" }
-if ($choice -eq "y" -or $choice -eq "Y") {
-    Write-Host "`n🔧 Installing and configuring SSH server..."
-    Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
-    Start-Service sshd
-    Set-Service -Name sshd -StartupType 'Automatic'
-    Write-Host "✅ SSH Server installed and configured successfully!"
-} else {
-    Write-Host "⏭️  Skipping SSH server installation"
-}
-
-Write-Host "`n✨ ===========================================
-🎉 Installation Complete!
-============================================="
-
-# Confirm copying finished
-if (-not $yesAll) {
-    $choice = Read-Host "Did you finish copying [y]/n ? "
-} else {
-    $choice = "y"
-}
-if ([string]::IsNullOrEmpty($choice)) { $choice = "y" }
-if ($choice -eq "y" -or $choice -eq "Y") {
-    Write-Host "Proceeding..."
-} else {
-    Write-Host "Installation aborted."
-}
-
-# Create Symlinks
-if (-not $yesAll) {
-    $createLinksChoice = Read-Host "Create (Sym/Hard)links (finish dotfiles transfer first) [y]/n ? "
-} else {
-    $createLinksChoice = "y"
-}
-if ([string]::IsNullOrEmpty($createLinksChoice)) { $createLinksChoice = "y" }
-
-if ($createLinksChoice -eq "y" -or $createLinksChoice -eq "Y") {
-    if (-not $yesAll) {
-        $linkTypeChoice = Read-Host "Create Symlinks (s) or Hardlinks (h) [s]/h ? "
-    } else {
-        $linkTypeChoice = "h"
-    }
-
-    . ~\code\machineconfig\.venv\Scripts\Activate.ps1
-
-    if ($linkTypeChoice -eq "s" -or $linkTypeChoice -eq "S") {
-        python -m fire machineconfig.profile.create main --choice=all
-    } elseif ($linkTypeChoice -eq "h" -or $linkTypeChoice -eq "H") {
-        # python -m fire machineconfig.profile.create_hardlinks main --choice=all
-        python -m fire machineconfig.profile.create main --choice=all
-    } else {
-        Write-Host "Invalid choice for link type. Installation aborted."
-    }
-
-    # icacls "~\.ssh\*" /inheritance:r /grant:r "$($env:USERNAME):(F)"
-    # icacls "~\.ssh" /inheritance:r /grant:r "$($env:USERNAME):(F)"
-} else {
-    Write-Host "Installation aborted."
-}
-
-# Install CLI Apps
-if (-not $yesAll) {
-    $choice = Read-Host "Install CLI Apps [y]/n ? "
-    if ([string]::IsNullOrEmpty($choice)) { $choice = "y" }
-    if ($choice -eq "y" -or $choice -eq "Y") {
-        . ~\code\machineconfig\src\machineconfig\setup_windows\devapps.ps1
-    } else {
-        Write-Host "Installation aborted."
-    }
-    
-} else {
-    uv run --python 3.13 --with machineconfig python -m fire machineconfig.scripts.python.devops_devapps_install main  --which=AllEssentials
-}
-
-
-# Retrieve Repos
-if (-not $yesAll) {
-    $choice = Read-Host "Retrieve Repos at ~/code [y]/n ? "
-} else {
-    $choice = "y"
-}
-if ([string]::IsNullOrEmpty($choice)) { $choice = "y" }
-if ($choice -eq "y" -or $choice -eq "Y") {
-    repos ~\code --clone --cloud odg1
-} else {
-    Write-Host "Installation aborted."
-}
-
-# Retrieve Data
-if (-not $yesAll) {
-    $choice = Read-Host "Retrieve data [y]/n ? "
-} else {
-    $choice = "y"
-}
-if ([string]::IsNullOrEmpty($choice)) { $choice = "y" }
-if ($choice -eq "y" -or $choice -eq "Y") {
-    uv run --python 3.13 --with machineconfig python -m fire machineconfig.scripts.python.devops_backup_retrieve main --direction=RETRIEVE
-} else {
-    Write-Host "Installation aborted."
-}
-
-
-# Install Brave, WezTerm, and VSCode
-if (-not $yesAll) {
-    $choice = Read-Host "Install Brave+WindowsTerminal+WezTerm+VSCode [y]/n ? "
-} else {
-    $choice = "y"
-}
-if ([string]::IsNullOrEmpty($choice)) { $choice = "y" }
-if ($choice -eq "y" -or $choice -eq "Y") {
-    winget install --no-upgrade --name "Windows Terminal"             --Id "Microsoft.WindowsTerminal"  --source winget --scope user --accept-package-agreements --accept-source-agreements  # Terminal is is installed by default on W 11
-    winget install --no-upgrade --name "Powershell"                   --Id "Microsoft.PowerShell"       --source winget --scope user --accept-package-agreements --accept-source-agreements  # powershell require admin
-    winget install --no-upgrade --name "Brave"                        --Id "Brave.Brave"                --source winget --scope user --accept-package-agreements --accept-source-agreements
-    winget install --no-upgrade --name "Microsoft Visual Studio Code" --Id "Microsoft.VisualStudioCode" --source winget --scope user --accept-package-agreements --accept-source-agreements
-    uv run --python 3.13 --with machineconfig python -m fire machineconfig.setup_windows.wt_and_pwsh.install_nerd_fonts main
-    uv run --python 3.13 --with machineconfig python -m fire machineconfig.setup_windows.wt_and_pwsh.set_wt_settings main
-} else {
-    Write-Host "Installation aborted."
-}
-
-
-# Install Apps
-if (-not $yesAll) {
-    $choice = Read-Host "Install Windows Apps [y]/n ? "
-} else {
-    $choice = "y"
-}
-if ($choice -eq "y" -or $choice -eq "Y") {
-    Invoke-WebRequest -Uri "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/apps.ps1" -OutFile "apps.ps1"
-    .\apps.ps1
-} else {
-    Write-Host "Installation aborted."
-}
-
-# Instructions for Thunderbird profile restoration
-# Run this after installing Thunderbird and starting it and shutting it down but before downloading backup
-# cd ~/AppData/Roaming/ThunderBird/Profiles
-# $res = Get-ChildItem
-# $name = $res[0].Name
-# Move-Item $backup_folder $name
+iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/uv.ps1").Content
+iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/scripts/windows/wrap_mcfg.ps1").Content
+
+function devops   { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" devops $args }
+function cloud    { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" cloud $args }
+function agents   { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" agents $args }
+function sessions { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" sessions $args }
+function ftpx     { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" ftpx $args }
+function fire     { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" fire $args }
+function croshell { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" croshell $args }
+function utils    { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" utils $args }
+function terminal { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" terminal $args }
+function msearch  { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.69" msearch $args }
+
+function d { wrap_in_shell_script devops @args }
+function c { wrap_in_shell_script cloud @args }
+function a { wrap_in_shell_script agents @args }
+function sx { wrap_in_shell_script sessions @args }
+function fx { wrap_in_shell_script ftpx @args }
+function f { wrap_in_shell_script fire @args }
+function rr { wrap_in_shell_script croshell @args }
+function u { wrap_in_shell_script utils @args }
+function t { wrap_in_shell_script terminal @args }
+function ms { wrap_in_shell_script msearch @args }
+
+Write-Host "mcfg command aliases are now defined in this PowerShell session."
+
+devops self interactive

machineconfig/setup_windows/web_shortcuts/quick_init.ps1

@@ -0,0 +1,17 @@
+
+iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/uv.ps1").Content
+# iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/scripts/windows/wrap_mcfg.ps1").Content
+
+uv tool install --upgrade  --python 3.14 machineconfig
+
+devops install --group sysabc
+
+# configs
+devops config copy-assets both
+devops config public --method copy --on-conflict overwrite-default-path --which all
+devops config shell
+devops config shell --which nushell
+
+wt  # start Windows Terminal to pick up config changes
+devops install --group termabc 
+devops install --group gui

machineconfig/setup_windows/wt_and_pwsh/set_wt_settings.py

@@ -1,13 +1,14 @@
 """Set Windows Terminal Settings"""
 
 from machineconfig.utils.accessories import randstr
-from machineconfig.utils.path_extended import PathExtended as PathExtended
+from machineconfig.utils.path_extended import PathExtended
 from machineconfig.utils.io import read_json, save_json
 import platform
 
 # from uuid import uuid4
 import os
 from typing import Any
+from rich import box
 from rich.console import Console
 from rich.panel import Panel
 
@@ -28,34 +29,41 @@ system = platform.system()  # Linux or Windows
 assert system == "Windows", "This script is only for Windows."
 
 
+def render_banner(message: str, title: str, border_style: str, box_style: box.Box) -> None:
+    console.print(Panel.fit(message, title=title, border_style=border_style, box=box_style, padding=(1, 4)))
+
+
 class TerminalSettings(object):
     def __init__(self):
         # Grabbing Terminal Settings file:
-        print(f"\n{'=' * 80}\n🔍 INITIALIZING TERMINAL SETTINGS 🔍\n{'=' * 80}")
+        console.print()
+        render_banner("🔍 INITIALIZING TERMINAL SETTINGS 🔍", "Windows Terminal", "cyan", box.DOUBLE)
+        console.print()
         tmp = os.getenv("LOCALAPPDATA")
         if not isinstance(tmp, str):
-            print("❌ ERROR: Could not find LOCALAPPDATA environment variable!")
+            console.print("❌ ERROR: Could not find LOCALAPPDATA environment variable!")
             raise ValueError("Could not find LOCALAPPDATA environment variable.")
         self.path = PathExtended(tmp).joinpath(r"Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json")
         backup_name = f".orig_{randstr()}"
-        print(f"📝 Creating backup of original settings as {backup_name}...")
+        console.print(f"📝 Creating backup of original settings as {backup_name}...")
         self.path.copy(append=backup_name)
-        print(f"📂 Loading Windows Terminal settings from: {self.path}")
+        console.print(f"📂 Loading Windows Terminal settings from: {self.path}")
         self.dat: dict[str, Any] = read_json(self.path)
         # Use a plain Python list for profiles
         self.profs = list(self.dat["profiles"]["list"])
-        console = Console()
-        console.print(Panel(f"✅ Successfully loaded {len(self.profs)} profiles", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue"))
+        console.print(Panel(f"✅ Successfully loaded {len(self.profs)} profiles", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue", box=box.ROUNDED))
 
     def save_terminal_settings(self):
-        print(f"\n💾 Saving terminal settings to: {self.path}")
+        console.print()
+        console.print(f"💾 Saving terminal settings to: {self.path}")
         self.dat["profiles"]["list"] = list(self.profs)
         save_json(obj=self.dat, path=self.path, indent=5)
-        console.print(Panel("✅ Settings saved successfully!", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue"))
+        console.print(Panel("✅ Settings saved successfully!", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue", box=box.ROUNDED))
 
     # ========================= Terminal Settings =========================================
     def update_default_settings(self):
-        print("\n⚙️  Updating default terminal settings...")
+        console.print()
+        console.print("⚙️  Updating default terminal settings...")
         # Changing start up settings:
         self.dat["startOnUserLogin"] = True
         self.dat["launchMode"] = "fullscreen"
@@ -64,12 +72,13 @@ class TerminalSettings(object):
         self.dat["copyOnSelect"] = True
         self.dat["profiles"]["defaults"]["padding"] = "0"
         self.dat["profiles"]["defaults"]["useAcrylic"] = False
-        console.print(Panel("✅ Default settings updated", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue"))
+        console.print(Panel("✅ Default settings updated", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue", box=box.ROUNDED))
 
     # 1- Customizing Powershell========================================================
     # as opposed to Windows Powershell
     def customize_powershell(self, nerd_font: bool = True):
-        print("\n🛠️  Customizing PowerShell profile...")
+        console.print()
+        console.print("🛠️  Customizing PowerShell profile...")
         pwsh: dict[str, Any] = dict(
             name="PowerShell",
             commandline="pwsh",
@@ -79,45 +88,50 @@ class TerminalSettings(object):
             startingDirectory="%USERPROFILE%",  # "%USERPROFILE%",   # None: inherent from parent process.
         )
         if nerd_font:
-            print("🔤 Setting PowerShell font to CaskaydiaCove Nerd Font...")
+            console.print("🔤 Setting PowerShell font to CaskaydiaCove Nerd Font...")
             pwsh["font"] = dict(face="CaskaydiaCove Nerd Font")  # because oh-my-posh uses glyphs from this font.
 
         for idx, item in enumerate(self.profs):
             if item["name"] == "PowerShell":
                 self.profs[idx].update(pwsh)
-                console.print(Panel("✅ PowerShell profile customized successfully", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue"))
+                console.print(Panel("✅ PowerShell profile customized successfully", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue", box=box.ROUNDED))
                 break
         else:
-            console.print(Panel("❌ Couldn't customize PowerShell because profile not found, try to install it first.", title="[bold red]Terminal Settings[/bold red]", border_style="red"))
+            console.print(Panel("❌ Couldn't customize PowerShell because profile not found, try to install it first.", title="[bold red]Terminal Settings[/bold red]", border_style="red", box=box.ROUNDED))
 
     def make_powershell_default_profile(self):
-        print("\n🌟 Setting PowerShell as the default profile...")
+        console.print()
+        console.print("🌟 Setting PowerShell as the default profile...")
         for profile in self.profs:
             if profile["name"] == "PowerShell":
                 self.dat["defaultProfile"] = profile["guid"]
-                console.print(Panel("✅ PowerShell is now the default profile!", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue"))
+                console.print(Panel("✅ PowerShell is now the default profile!", title="[bold blue]Terminal Settings[/bold blue]", border_style="blue", box=box.ROUNDED))
                 break
         else:
-            console.print(Panel("❌ PowerShell profile was not found in the list of profiles and therefore was not made the default.", title="[bold red]Terminal Settings[/bold red]", border_style="red"))
+            console.print(Panel("❌ PowerShell profile was not found in the list of profiles and therefore was not made the default.", title="[bold red]Terminal Settings[/bold red]", border_style="red", box=box.ROUNDED))
 
 
 def main():
-    print(f"\n{'=' * 80}\n🖥️  WINDOWS TERMINAL SETUP 🖥️\n{'=' * 80}")
+    console.print()
+    render_banner("🖥️  WINDOWS TERMINAL SETUP 🖥️", "Windows Terminal", "cyan", box.DOUBLE)
+    console.print()
     shell = {"powershell": "pwsh.exe", "Windows Powershell": "powershell.exe"}["powershell"].split(".exe", maxsplit=1)[0]
     if shell == "pwsh":
-        print("🚀 Starting Windows Terminal configuration with PowerShell...")
+        console.print("🚀 Starting Windows Terminal configuration with PowerShell...")
         ts = TerminalSettings()
         ts.update_default_settings()
         ts.customize_powershell(nerd_font=True)
         ts.make_powershell_default_profile()
-        print("⌨️  Adding keyboard shortcut for pane zoom (ctrl+shift+z)...")
+        console.print("⌨️  Adding keyboard shortcut for pane zoom (ctrl+shift+z)...")
         ts.dat["actions"].append({"command": "togglePaneZoom", "keys": "ctrl+shift+z"})
 
         ts.save_terminal_settings()
-        print(f"\n{'=' * 80}\n✨ WINDOWS TERMINAL SETUP COMPLETE ✨\n{'=' * 80}")
+        console.print()
+        render_banner("✨ WINDOWS TERMINAL SETUP COMPLETE ✨", "Windows Terminal", "green", box.DOUBLE)
+        console.print()
     else:
         error_msg = "❌ ERROR: Only PowerShell is supported, not Windows PowerShell!"
-        print(error_msg)
+        console.print(error_msg)
         raise NotImplementedError(error_msg)
 
 

machineconfig/utils/accessories.py

@@ -1,6 +1,7 @@
-from pathlib import Path
 from typing import Optional, Any
 
+from datetime import datetime, timezone, timedelta
+
 
 def randstr(length: int = 10, lower: bool = True, upper: bool = True, digits: bool = True, punctuation: bool = False, safe: bool = False, noun: bool = False) -> str:
     if safe:
@@ -18,23 +19,58 @@ def randstr(length: int = 10, lower: bool = True, upper: bool = True, digits: bo
     return "".join(random.choices(population, k=length))
 
 
-def split[T](iterable: list[T], every: int = 1, to: Optional[int] = None) -> list[list[T]]:
+def split_timeframe(start_dt: str, end_dt: str, resolution_ms: int, to: Optional[int]=None, every_ms: Optional[int]=None) -> list[tuple[datetime, datetime]]:
+    if (to is None) == (every_ms is None):
+        raise ValueError("Exactly one of 'to' or 'every_ms' must be provided, not both or neither")    
+    start_dt_obj = datetime.fromisoformat(start_dt).replace(tzinfo=timezone.utc)
+    end_dt_obj = datetime.fromisoformat(end_dt).replace(tzinfo=timezone.utc)
+    delta = end_dt_obj - start_dt_obj
+    resolution = timedelta(milliseconds=resolution_ms)
+    res: list[tuple[datetime, datetime]] = []    
+    if to is not None:
+        split_size_seconds: float = delta.total_seconds() / to
+        split_size_rounded: float = round(split_size_seconds / 60) * 60
+        split_size = timedelta(seconds=split_size_rounded)
+        
+        for idx in range(to):
+            start = start_dt_obj + split_size * idx
+            assert start < end_dt_obj
+            if idx == to - 1:
+                end = end_dt_obj
+            else:
+                end = start_dt_obj + split_size * (idx + 1) - resolution
+            res.append((start, end))
+    else:
+        if every_ms is None:
+            raise ValueError("every_ms cannot be None when to is None")
+        split_size = timedelta(milliseconds=every_ms)
+        current_start = start_dt_obj
+        while current_start < end_dt_obj:
+            current_end = min(current_start + split_size - resolution, end_dt_obj)
+            res.append((current_start, current_end))
+            current_start += split_size
+    return res
+def split_list[T](sequence: list[T], every: Optional[int]=None, to: Optional[int]=None) -> list[list[T]]:
+    if (every is None) == (to is None):
+        raise ValueError("Exactly one of 'every' or 'to' must be provided, not both or neither")
+    if len(sequence) == 0:
+        return []
     import math
-
-    every = every if to is None else math.ceil(len(iterable) / to)
+    if to is not None:
+        every = math.ceil(len(sequence) / to)
+    assert every is not None
     res: list[list[T]] = []
-    for ix in range(0, len(iterable), every):
-        if ix + every < len(iterable):
-            tmp = iterable[ix : ix + every]
+    for ix in range(0, len(sequence), every):
+        if ix + every < len(sequence):
+            tmp = sequence[ix : ix + every]
         else:
-            tmp = iterable[ix : len(iterable)]
+            tmp = sequence[ix : len(sequence)]
         res.append(list(tmp))
     return list(res)
 
 
 def pprint(obj: dict[Any, Any], title: str) -> None:
     from rich import inspect
-
     inspect(type("TempStruct", (object,), obj)(), value=False, title=title, docs=False, dunder=False, sort=False)
 
 
@@ -59,14 +95,18 @@ def human_friendly_dict(d: dict[str, Any]) -> dict[str, Any]:
     return result
 
 
-def get_repo_root(path: Path) -> Optional[Path]:
+def get_repo_root(path: "Path") -> Optional["Path"]:
     from git import Repo, InvalidGitRepositoryError
-
     try:
-        repo = Repo(str(path), search_parent_directories=True)
+        repo = Repo(path, search_parent_directories=True)
         root = repo.working_tree_dir
         if root is not None:
+            from pathlib import Path
             return Path(root)
     except InvalidGitRepositoryError:
         pass
     return None
+
+
+if __name__ == "__main__":
+    from pathlib import Path

machineconfig/utils/cloud/onedrive/README.md

@@ -0,0 +1,139 @@
+# OneDrive API without rclone
+
+This module provides direct OneDrive integration using Microsoft Graph API without requiring rclone.
+
+## Features
+
+- ✅ Automatic token refresh when expired
+- ✅ Persistent token storage
+- ✅ Upload/download files with progress tracking
+- ✅ Support for large file uploads (chunked)
+- ✅ Direct OAuth2 authentication setup
+
+## Quick Start
+
+### Option 1: Direct OAuth Setup (Recommended)
+
+1. **Set up Azure App Registration:**
+   - Go to [Azure Portal](https://portal.azure.com)
+   - Navigate to 'Azure Active Directory' > 'App registrations'
+   - Click 'New registration'
+   - Name: 'OneDrive API Access'
+   - Redirect URI: `http://localhost:8080/callback`
+   - Add permissions: `Files.ReadWrite.All` and `offline_access`
+
+2. **Set environment variables:**
+   ```bash
+   export ONEDRIVE_CLIENT_ID='your_client_id_here'
+   export ONEDRIVE_REDIRECT_URI='http://localhost:8080/callback'
+   ```
+
+3. **Run initial setup:**
+   ```python
+   from transaction import setup_oauth_authentication
+   setup_oauth_authentication()
+   ```
+
+### Option 2: Using existing rclone token
+
+If you already have rclone configured, the system will automatically use and refresh your existing tokens.
+
+## Usage Examples
+
+```python
+from transaction import push_to_onedrive, pull_from_onedrive
+
+# Upload a file
+success = push_to_onedrive('/path/to/local/file.pdf', '/Documents/file.pdf')
+
+# Download a file
+success = pull_from_onedrive('/Documents/file.pdf', '/path/to/local/downloaded.pdf')
+```
+
+## Token Management
+
+### Automatic Token Refresh
+
+The system automatically handles token refresh:
+
+```python
+from transaction import get_access_token
+
+# This will automatically refresh if expired
+token = get_access_token()
+```
+
+### Manual Token Operations
+
+```python
+from transaction import refresh_access_token, save_token_to_file, load_token_from_file
+
+# Manually refresh token
+new_token = refresh_access_token()
+
+# Save token to file
+save_token_to_file(token_data)
+
+# Load token from file
+token_data = load_token_from_file()
+```
+
+## How Token Renewal Works
+
+1. **Automatic Detection**: The system checks token expiry before each API call
+2. **Refresh Attempt**: If expired, it automatically uses the refresh token to get a new access token
+3. **Persistent Storage**: New tokens are saved to `~/.onedrive_token.json` for future use
+4. **Fallback**: If refresh fails, it provides clear instructions for manual intervention
+
+## No rclone Required
+
+This implementation eliminates the need for rclone by:
+
+- Using Microsoft Graph API directly
+- Implementing OAuth2 flow natively
+- Managing token lifecycle automatically
+- Providing persistent token storage
+
+## Error Handling
+
+The system gracefully handles various scenarios:
+
+- Expired tokens → Automatic refresh
+- Network errors → Detailed error messages
+- Missing permissions → Clear setup instructions
+- Invalid tokens → Step-by-step recovery guide
+
+## Files Created
+
+- `~/.onedrive_token.json`: Encrypted token storage (chmod 600)
+- Token is automatically loaded on import
+
+## Security
+
+- Tokens are stored with restrictive permissions (600)
+- Client secrets are optional (public client mode supported)
+- Refresh tokens are securely managed
+- No sensitive data in logs
+
+## Troubleshooting
+
+### Token Refresh Failed
+```python
+# Try manual refresh
+from transaction import refresh_access_token
+token = refresh_access_token()
+
+# Or re-run OAuth setup
+from transaction import setup_oauth_authentication
+setup_oauth_authentication()
+```
+
+### Permission Errors
+Make sure your Azure app has the correct permissions:
+- `Files.ReadWrite.All` (Delegated)
+- `offline_access` (Delegated)
+
+### Network Issues
+Check your firewall allows connections to:
+- `https://login.microsoftonline.com`
+- `https://graph.microsoft.com`