machineconfig 5.45__py3-none-any.whl → 5.47__py3-none-any.whl

machineconfig/profile/backup.toml

@@ -0,0 +1,49 @@
+
+# locations to be backed up to the cloud.
+
+[thunderbird_windows]
+path = '~/AppData/Roaming/Thunderbird/Profiles'
+encrypt = 'True'
+zip = 'True'
+rel2home = 'True'
+os_specific = 'True'
+
+
+[thunderbird_linux]
+path = '~/.thunderbird'
+encrypt = 'True'
+zip = 'True'
+rel2home = 'True'
+os_specific = 'True'
+
+
+[zoxide_windows]
+path = '~/AppData/Local/zoxide/db.zo'
+encrypt = 'False'
+zip = 'False'
+rel2home = 'True'
+os_specific = 'True'
+
+
+[zoxide_linux]
+path = '~/.local/share/zoxide/db.zo'
+encrypt = 'False'
+zip = 'False'
+rel2home = 'True'
+os_specific = 'True'
+
+
+#[dotfiles]
+# path = '~/dotfiles'
+# encrypt = 'True'
+# zip = 'True'
+# rel2home = 'True'
+# os_specific = 'True'
+
+
+[ipython]
+path = '~/.ipython'
+encrypt = 'True'
+zip = 'True'
+rel2home = 'True'
+os_specific = 'False'

machineconfig/profile/bash_shell_profiles.md

@@ -0,0 +1,11 @@
+
+# Non-login shells, .bashrc > .profile are read.
+# for login shells, e.g. SSH, .bash_login > .bash_profile > .profile is read.
+
+# The strategy to ensure consistent configuration for login and nonlogin shells is to put all the configuration in .bashrc, and then source it from .bash_profile and .profile.
+
+# ensure .bash_profile only calls .profile
+# ensure .profile calls .bashrc only at the end.
+
+When you login: /etc/profile -> ~/.profile -> ~/.bash_profile -> ~/.bashrc
+When you open a new terminal: ~/.bashrc

machineconfig/profile/mapper.toml

@@ -0,0 +1,268 @@
+
+
+# =================== PRIVATE ================================
+
+[git]
+gitconfig = {this = '~/.gitconfig', to_this = '~/dotfiles/creds/git/.gitconfig'}
+gitcred = {this = '~/.git-credentials', to_this = '~/dotfiles/creds/git/.git-credentials'}
+
+[ssh]
+keys = {this = '~/.ssh', to_this = '~/dotfiles/creds/.ssh', contents = true}
+
+[pypi]
+creds = {this = '~/.pypirc', to_this = '~/dotfiles/creds/msc/.pypirc'}
+
+[rclone_linux]
+config = {this = '~/.config/rclone/rclone.conf', to_this = '~/dotfiles/creds/rclone/rclone.conf'}
+
+[rclone_windows]
+config = {this = '~/AppData/Roaming/rclone/rclone.conf', to_this = '~/dotfiles/creds/rclone/rclone.conf'}
+
+[cloudflare]
+config = {this = '~/.cloudflared', to_this = '~/dotfiles/creds/cloudflare/.cloudflared'}
+
+[ngrok_linux]
+config = {this = '~/.config/ngrok/ngrok.yml', to_this = '~/dotfiles/creds/tokens/ngrok.yml'}
+
+[ngrok_windows]
+config = {this = '~/AppData/Local/ngrok/ngrok.yml', to_this = '~/dotfiles/creds/tokens/ngrok.yml'}
+
+[m365]
+config1 = {this = '~/.cli-m365-msal.json',            to_this = '~/dotfiles/creds/tokens/.cli-m365-msal.json'}
+config2 = {this = '~/.cli-m365-all-connections.json', to_this = '~/dotfiles/creds/tokens/.cli-m365-all-connections.json'}
+config3 = {this = '~/.cli-m365-connection.json',      to_this = '~/dotfiles/creds/tokens/.cli-m365-connection.json'}
+# config2 = {this = '~/.cli-m365-tokens.json',        to_this = '~/dotfiles/creds/tokens/.cli-m365-tokens.json'}
+
+[bash_linux]
+bashrc = {this = '~/.inputrc', to_this = '~/dotfiles/shells/bash/.inputrc'}
+[remmina]
+data = {this = '~/.var/app/org.remmina.Remmina/data/remmina', to_this = '~/dotfiles/creds/RDP/remmina/data/remmina'}
+
+[webapp_linux]
+brave = {this = '~/.local/share/applications', to_this = '~/dotfiles/config/webapps/linux/brave', contents = true}
+
+# [startup_windows]
+# startup = {this = '~/AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup', to_this = '~/dotfiles/scripts/windows_startup', contents = true}
+
+# [aws]
+# config = {this = '~/.aws/config', to_this = '~/dotfiles/aws/.aws', contents = true}
+
+[wt_windows]
+settings = { this = '~/AppData/Local/Packages/Microsoft.WindowsTerminal_8wekyb3d8bbwe/LocalState/settings.json', to_this = 'CONFIG_ROOT/settings/shells/wt/settings.json' }
+
+# [wsl_windows]
+# home = {this = '~/wsl', to_this = '\\wsl.localhost\Ubuntu-22.04\home\username'}
+# see \\wsl$ and ~\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc\LocalState
+# config = {this = '~/.wslconfig', to_this = 'CONFIG_ROOT/settings/wsl/.wslconfig'}
+
+# [wsl_linux]
+# home = {this = '~/win', to_this = '/mnt/c/Users/username'}
+
+
+# =================== LLMs ============================
+
+[chatgpt]
+config = { this = '~/.config/chatgpt/config.json', to_this = '~/dotfiles/creds/llm/chatgpt_cli/config.json' }
+
+[mods]
+config = {this = '~/.config/mods/mods.yml', to_this = '~/dotfiles/creds/llm/mods_cli/mods.yml'}
+
+[github_cli_token]
+token = {this = '~/.copilot-cli-access-token', to_this = '~/dotfiles/creds/llm/github_cli/.copilot-cli-access-token'}
+
+[aider]
+config = {this = '~/.aider.conf.yml', to_this = '~/dotfiles/creds/llm/aider/.aider.conf.yml'}
+
+[marvin]
+config = {this = '~/.marvin/.env', to_this = '~/dotfiles/creds/llm/marvin/.env'}
+threads = {this = '~/.marvin/cli/threads/default.json', to_this = '~/dotfiles/creds/llm/marvin/threads/default.json'}
+
+[docker]
+config = {this = '~/.docker/config.json', to_this = '~/dotfiles/creds/docker/config.json'}
+
+
+# =========================== PUBLIC ======================================
+
+[presenterm]
+config = {this = '~/.config/presenterm/config.yaml', to_this = 'CONFIG_ROOT/settings/presenterm/config.yaml'}
+
+[keras]
+config = {this = '~/.keras/keras.json', to_this = 'CONFIG_ROOT/settings/keras/keras.json'}
+
+[streamlit]
+config = {this = '~/.streamlit/config.toml', to_this = 'CONFIG_ROOT/settings/streamlit/config.toml'}
+
+
+[procs]
+config = {this = '~/.procs.toml', to_this = 'CONFIG_ROOT/settings/procs/.procs.toml'}
+config_again = {this = '~/.config/procs/config.toml', to_this = 'CONFIG_ROOT/settings/procs/.procs.toml'}
+
+[rofi_linux]
+config = {this = '~/.config/rofi/config.rasi', to_this = 'CONFIG_ROOT/settings/rofi/config.rasi'}
+
+[yazi_windows]
+yazi = {this = '~/AppData/Roaming/yazi/config/yazi.toml', to_this = 'CONFIG_ROOT/settings/yazi/yazi.toml'}
+keymap = {this = '~/AppData/Roaming/yazi/config/keymap.toml', to_this = 'CONFIG_ROOT/settings/yazi/keymap.toml'}
+theme = {this = '~/AppData/Roaming/yazi/config/theme.toml', to_this = 'CONFIG_ROOT/settings/yazi/theme.toml'}
+
+[yazi_linux]
+yazi = {this = '~/.config/yazi/yazi.toml', to_this = 'CONFIG_ROOT/settings/yazi/yazi.toml'}
+keymap = {this = '~/.config/yazi/keymap.toml', to_this = 'CONFIG_ROOT/settings/yazi/keymap.toml'}
+theme = {this = '~/.config/yazi/theme.toml', to_this = 'CONFIG_ROOT/settings/yazi/theme.toml'}
+
+[lf_windows]
+config = {this = '~/AppData/Local/lf/lfrc', to_this = 'CONFIG_ROOT/settings/lf/windows/lfrc'}
+colors = {this = '~/AppData/Local/lf/colors', to_this = 'CONFIG_ROOT/settings/lf/windows/colors'}
+icons = {this = '~/AppData/Local/lf/icons', to_this = 'CONFIG_ROOT/settings/lf/windows/icons'}
+
+[lf_linux]
+colors = {this = '~/.config/lf/colors', to_this = 'CONFIG_ROOT/settings/lf/linux/colors'}
+config = {this = '~/.config/lf/lfrc', to_this = 'CONFIG_ROOT/settings/lf/linux/lfrc'}
+icons = {this = '~/.config/lf/icons', to_this = 'CONFIG_ROOT/settings/lf/linux/icons'}
+
+[broot]
+config = {this = '~/.config/broot/conf.toml', to_this = 'CONFIG_ROOT/settings/broot/conf.toml'}
+
+[pistol_linux]
+config = {this = '~/.config/pistol/pistol.conf', to_this = 'CONFIG_ROOT/settings/pistol/pistol.conf'}
+
+[glow]
+config = {this = '~/.config/glow/glow.yml', to_this = 'CONFIG_ROOT/settings/glow/glow.yml'}
+
+[gromit_linux]
+config = {this = '~/.var/app/net.christianbeier.Gromit-MPX/config/gromit-mpx.cfg', to_this = 'CONFIG_ROOT/settings/gromit-mpx/gromit-mpx.cfg', copy = true}
+
+# zoxide can't read symlink files see: https://github.com/ajeetdsouza/zoxide/issues?q=is%3Aissue+is%3Aopen+symlink
+# [zoxide_windows]
+# database = {this = '~/AppData/Local/zoxide/db.zo', to_this = '~/dotfiles/settings/zoxide_windows/db.zo'}
+
+# [zoxide_linux]
+# database = {this = '~/.local/share/zoxide/db.zo', to_this = '~/dotfiles/settings/zoxide_linux/db.zo'}
+
+#[broot_windows]
+#config = { this = '~/AppData/Roaming/dystroy/config', to_this = 'CONFIG_ROOT/settings/broot/config' }
+
+[starship]
+config = {this = '~/.config/starship.toml', to_this = 'CONFIG_ROOT/settings/shells/starship/starship.toml'}
+
+
+[kanata]
+config = {this = '~/.config/kanata/kanata.kbd', to_this = 'CONFIG_ROOT/settings/keyboard/kanata/kanata.kbd'}
+
+[espanso]
+config = {this = '~/.config/espanso/config/default.yml', to_this = 'CONFIG_ROOT/settings/keyboard/espanso/config/default.yml'}
+match = {this = '~/.config/espanso/match/base.yml', to_this = 'CONFIG_ROOT/settings/keyboard/espanso/match/base.yml', copy = true}
+
+
+[pudb]
+config = {this = '~/.config/pudb/pudb.cfg', to_this = 'CONFIG_ROOT/settings/pudb/pudb.cfg'}
+
+
+# ============================= shells profiles ==================================
+
+# [powershell_windows]
+# CurrentUserCurrentHost = {this = '~/Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1', to_this = '~/dotfiles/shells/windows_powershell/CurrentUserCurrentHost/Microsoft.PowerShell_profile.ps1'}
+# CurrentUserAllHosts = {this = '~/Documents\WindowsPowerShell\profile.ps1', to_this = '~/dotfiles/shells/windows_powershell/CurrentUserAllHosts/profile.ps1'}
+# AllUsersCurrentHost = {this = 'C:\Windows\System32\WindowsPowerShell\v1.0\Microsoft.PowerShell_profile.ps1', to_this = '~/dotfiles/shells/powershell/AllUsersCurrentHost/Microsoft.PowerShell_profile.ps1'}
+# AllUsersAllHosts = {this = 'C:\Windows\System32\WindowsPowerShell\v1.0\profile.ps1', to_this = '~/dotfiles/shells/windows_powershell/AllUsersAllHosts/profile.ps1'}
+
+[pwsh_windows]
+CurrentUserCurrentHost = {this = '~/Documents/PowerShell/Microsoft.PowerShell_profile.ps1', to_this = 'CONFIG_ROOT/settings/shells/pwsh/init.ps1'}
+CurrentUserAllHosts = {this = '~/Documents/PowerShell/profile.ps1', to_this = 'CONFIG_ROOT/settings/shells/pwsh/profile.ps1'}
+AllUsersCurrentHost = {this = 'C:\Program Files\PowerShell\7\Microsoft.PowerShell_profile.ps1', to_this = 'CONFIG_ROOT/settings/shells/pwsh/init.ps1'}
+AllUsersAllHosts = {this = 'C:\Program Files\PowerShell\7\profile.ps1', to_this = 'CONFIG_ROOT/settings/shells/pwsh/init.ps1'}
+
+[nushell_windows]
+config = {this = '~/AppData/Roaming/nushell/config.nu', to_this = 'CONFIG_ROOT/settings/shells/nushell/config.nu'}
+env = {this = '~/AppData/Roaming/nushell/env.nu', to_this = 'CONFIG_ROOT/settings/shells/nushell/env.nu'}
+
+[nushell_linux]
+config = {this = '~/.config/nushell/config.nu', to_this = 'CONFIG_ROOT/settings/shells/nushell/config.nu'}
+env = {this = '~/.config/nushell/env.nu', to_this = 'CONFIG_ROOT/settings/shells/nushell/env.nu'}
+
+[kitty_linux]
+config = {this = '~/.config/kitty/kitty.conf', to_this = 'CONFIG_ROOT/settings/shells/kitty/kitty.conf'}
+
+[alacritty_linux]
+config = {this = '~/.config/alacritty/alacritty.toml', to_this = 'CONFIG_ROOT/settings/shells/alacritty/alacritty.toml'}
+config_yaml = {this = '~/.config/alacritty/alacritty.yml', to_this = 'CONFIG_ROOT/settings/shells/alacritty/alacritty.yml'}
+
+[alacritty_windows]
+config = {this = '~/AppData/Roaming/alacritty/alacritty.toml', to_this = 'CONFIG_ROOT/settings/shells/alacritty/alacritty.toml'}
+
+[hyper_terminal]
+config = {this = '~/.hyper.js', to_this = 'CONFIG_ROOT/settings/shells/hyper/.hyper.js'}
+
+[wezterminal]
+config = {this = '~/.config/wezterm/wezterm.lua', to_this = 'CONFIG_ROOT/settings/shells/wezterm/wezterm.lua'}
+
+[vtm_windows]
+settings = {this = '~/.config/vtm/settings.xml', to_this = 'CONFIG_ROOT/settings/shells/vtm/settings.xml'}
+
+# [ipython_default_config]
+# config = {this = '~/.ipython/profile_default/ipython_config.py', to_this = 'CONFIG_ROOT/settings/shells/ipy/profiles/default/ipython_config.py'}
+# play_extension = {this = '~/.ipython/profile_default/startup/playext.py', to_this = 'CONFIG_ROOT/settings/shells/ipy/profiles/default/startup/playext.py'}
+
+[mprocs_windows]
+config = {this = '~/mprocs.yaml', to_this = 'CONFIG_ROOT/settings/mprocs/windows/mprocs.yaml'}
+
+# [tmux_linux]
+# config = {this = '~/.tmux.conf', to_this = 'CONFIG_ROOT/settings/tmux/.tmux.conf'}
+# tmate = {this = '~/.tmate.conf', to_this = 'CONFIG_ROOT/settings/tmux/.tmate.conf'}
+
+
+[zellij_linux]
+config = { this = '~/.config/zellij', to_this = 'CONFIG_ROOT/settings/zellij' }
+#themes = { this = '~/.config/zellij/themes', to_this = 'CONFIG_ROOT/settings/zellij/themes' }
+#layouts = { this = '~/.config/zellij/layouts', to_this = 'CONFIG_ROOT/settings/zellij/layouts' }
+
+
+# ===================== IDEs ============================
+
+[zed_linux]
+settings = {this = '~/.config/zed/settings.json', to_this = 'CONFIG_ROOT/settings/zed/settings.json'}
+
+[helix_windows]
+languages = { this = '~/AppData/Roaming/helix/languages.toml', to_this = 'CONFIG_ROOT/settings/helix/languages.toml' }
+config = { this = '~/AppData/Roaming/helix/config.toml', to_this = 'CONFIG_ROOT/settings/helix/config.toml' }
+
+[helix_linux]
+languages = { this = '~/.config/helix/languages.toml', to_this = 'CONFIG_ROOT/settings/helix/languages.toml' }
+config = { this = '~/.config/helix/config.toml', to_this = 'CONFIG_ROOT/settings/helix/config.toml' }
+
+[lvim_windows]
+config = { this = '~/AppData/Local/lvim/config.lua', to_this = 'CONFIG_ROOT/settings/lvim/windows/config.lua' }
+
+[lvim_linux]
+config = { this = '~/.config/lvim/config.lua', to_this = 'CONFIG_ROOT/settings/lvim/linux/config.lua' }
+
+
+[svim_windows]
+init = { this = '~/.SpaceVim.d/init.toml', to_this = 'CONFIG_ROOT/settings/svim/windows/init.toml' }
+
+[svim_linux]
+init = { this = '~/.SpaceVim.d/init.toml', to_this = 'CONFIG_ROOT/settings/svim/linux/init.toml' }
+
+[linters]
+flake8 = {this = '~/.flake8', to_this = 'CONFIG_ROOT/settings/linters/.flake8'}
+# as per https://mypy.readthedocs.io/en/stable/config_file.html
+mypy = {this = '~/mypy/config/mypy.ini', to_this = 'CONFIG_ROOT/settings/linters/.mypy.ini'}
+mypy2 = {this = '~/.config/mypy/config', to_this = 'CONFIG_ROOT/settings/linters/.mypy.ini'}
+ruff = {this = '~/.ruff.toml', to_this = 'CONFIG_ROOT/settings/linters/.ruff.toml'}
+pylint = {this = '~/.pylintrc', to_this = 'CONFIG_ROOT/settings/linters/.pylintrc'}
+
+# ======================= OS ===============================
+
+[apps_windows]
+notepadpp = {this = '~/AppData/Local/Microsoft/WindowsApps/notepad++.exe', to_this = 'C:/Program Files/Notepad++/notepad++.exe'}
+# tesseract = {this = '~/AppData/Local/Microsoft/WindowsApps/tesseract.exe', to_this = '~/AppData/Local/Tesseract-OCR/tesseract.exe'}  # doesn't work without whole installation dir is on PATH.
+
+
+[scripts_linux]
+public = {this = '~/scripts', to_this = 'CONFIG_ROOT/scripts/linux'}
+
+[scripts_windows]
+public = {this = '~/scripts', to_this = 'CONFIG_ROOT/scripts/windows'}
+
+
+

machineconfig/scripts/Restore-ThunderbirdProfile.ps1

@@ -0,0 +1,92 @@
+
+<#
+.SYNOPSIS
+    Restores a Thunderbird profile from a backup.
+
+.DESCRIPTION
+    This script automates the restoration of a Thunderbird profile. It finds the
+    default backup profile located in ~/.thunderbird and copies its contents to
+    the active Thunderbird profile folder in AppData/Roaming.
+
+    WARNING: This script will overwrite the current active Thunderbird profile.
+    Ensure Thunderbird is closed before running.
+#>
+
+# --- Configuration ---
+$ErrorActionPreference = "Stop"
+
+# --- Script ---
+
+# 1. Define the root paths for backup and active profiles
+$thunderbirdBackupRoot = "$env:USERPROFILE\.thunderbird"
+$thunderbirdAppdataRoot = "$env:APPDATA\Thunderbird"
+
+Write-Host "Thunderbird Profile Restore Script"
+Write-Host "-----------------------------------"
+
+# 2. Find the default profile path from the backup's profiles.ini
+try {
+    $backupIniPath = Join-Path $thunderbirdBackupRoot "profiles.ini"
+    $backupProfileRelativePath = (Get-Content $backupIniPath | Select-String -Pattern '^Path=' | Select-Object -First 1) -replace '^Path=', ''
+    $backupProfileFullPath = Join-Path $thunderbirdBackupRoot $backupProfileRelativePath
+    Write-Host "Found backup profile: $backupProfileFullPath" -ForegroundColor Green
+}
+catch {
+    Write-Error "Could not find or read the backup profiles.ini at '$backupIniPath'."
+    exit 1
+}
+
+# 3. Find the default profile path from the active installation's profiles.ini
+try {
+    $activeIniPath = Join-Path $thunderbirdAppdataRoot "profiles.ini"
+    $activeProfileRelativePath = (Get-Content $activeIniPath | Select-String -Pattern '^Path=' | Select-Object -First 1) -replace '^Path=', ''
+    $activeProfileFullPath = Join-Path $thunderbirdAppdataRoot $activeProfileRelativePath
+    Write-Host "Found active profile: $activeProfileFullPath" -ForegroundColor Green
+}
+catch {
+    Write-Error "Could not find or read the active profiles.ini at '$activeIniPath'."
+    exit 1
+}
+
+# 4. Safety Check: Confirm both profile paths exist
+if (-not (Test-Path -Path $backupProfileFullPath -PathType Container)) {
+    Write-Error "Backup profile directory does not exist: $backupProfileFullPath"
+    exit 1
+}
+if (-not (Test-Path -Path $activeProfileFullPath -PathType Container)) {
+    Write-Error "Active profile directory does not exist: $activeProfileFullPath"
+    exit 1
+}
+
+# 5. CRITICAL: Get user confirmation before proceeding
+Write-Warning "This will completely overwrite the profile at '$activeProfileFullPath' with the contents of the backup."
+$confirmation = Read-Host "Are you absolutely sure you want to continue? (y/n)"
+
+if ($confirmation -ne 'y') {
+    Write-Host "Operation cancelled by user." -ForegroundColor Yellow
+    exit 0
+}
+
+# 6. Ensure Thunderbird is not running
+Write-Host "Checking for running Thunderbird process..."
+$thunderbirdProcess = Get-Process thunderbird -ErrorAction SilentlyContinue
+if ($thunderbirdProcess) {
+    Write-Host "Closing Thunderbird to prevent file conflicts..."
+    Stop-Process -InputObject $thunderbirdProcess -Force
+    Start-Sleep -Seconds 3 # Give it a moment to close gracefully
+} else {
+    Write-Host "Thunderbird is not running. Good."
+}
+
+# 7. Copy the backup profile to the active profile directory using robocopy
+Write-Host "Starting profile restoration... (This may take a while)"
+try {
+    robocopy $backupProfileFullPath $activeProfileFullPath /MIR /E /IS /IT /NFL /NDL /NJH /NJS /nc /ns /np
+    Write-Host "Profile restoration complete!" -ForegroundColor Green
+    Write-Host "You can now start Thunderbird."
+}
+catch {
+    Write-Error "An error occurred during the file copy operation."
+    exit 1
+}
+

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`

machineconfig/utils/links.py

@@ -121,6 +121,13 @@ def symlink_map(config_file_default_path: PathExtended, self_managed_config_file
     action_taken = ""
     details = ""
     
+    # Handle broken symlinks first - they exist as symlinks but point to non-existent targets
+    if config_file_default_path.is_symlink() and not config_file_default_path.exists():
+        action_taken = "fixing_broken_link"
+        details = "Removed broken symlink and will create new one"
+        console.print(Panel(f"🔄 FIXING BROKEN LINK | Removing broken symlink {config_file_default_path}, will create link to {self_managed_config_file_path}", title="Fixing Broken Link", expand=False))
+        config_file_default_path.unlink()
+    
     # Case analysis based on docstring
     if config_file_default_path.exists():
         if self_managed_config_file_path.exists():
@@ -238,6 +245,13 @@ def copy_map(config_file_default_path: PathExtended, self_managed_config_file_pa
     action_taken = ""
     details = ""
     
+    # Handle broken symlinks first - they exist as symlinks but point to non-existent targets
+    if config_file_default_path.is_symlink() and not config_file_default_path.exists():
+        action_taken = "fixing_broken_link"
+        details = "Removed broken symlink and will copy new file"
+        console.print(Panel(f"🔄 FIXING BROKEN LINK | Removing broken symlink {config_file_default_path}, will copy from {self_managed_config_file_path}", title="Fixing Broken Link", expand=False))
+        config_file_default_path.unlink()
+    
     match (config_file_default_path.exists(), self_managed_config_file_path.exists()):
         case (True, True):
             # Both files exist

{machineconfig-5.45.dist-info → machineconfig-5.47.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 5.45
+Version: 5.47
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{machineconfig-5.45.dist-info → machineconfig-5.47.dist-info}/RECORD

@@ -92,15 +92,19 @@ machineconfig/jobs/windows/archive/openssh-server_copy-ssh-id.ps1,sha256=-7pElYi
 machineconfig/jobs/windows/msc/cli_agents.bat,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/jobs/windows/msc/cli_agents.ps1,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/profile/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+machineconfig/profile/backup.toml,sha256=Hb25sIdKVvLqOF62NgiOpGZxd45I6IhsNHu623RtfQQ,766
+machineconfig/profile/bash_shell_profiles.md,sha256=mio0xkMTwO-F3fikWIfgcdQaPCmQrmkxJMNtZsTe9TI,514
 machineconfig/profile/create_helper.py,sha256=IKUspFNg4LDeQO4t3elt9rI9Hhi8b37ZHqBkyBNU6Qk,1018
 machineconfig/profile/create_links.py,sha256=yBqfcujukllbHI1P8M5XDbLXMZ_gb38ZvQK901EPbaA,13962
 machineconfig/profile/create_links_export.py,sha256=OEmuJE-F7FZX5xvOl1rqJzHg_BWtPKCiWdrq4RPOobs,3173
 machineconfig/profile/create_shell_profile.py,sha256=ifsEAK90ovvY7ftyxuY5-Xh8f2JuQYX7IMYUXp6x2Sw,9538
+machineconfig/profile/mapper.toml,sha256=oXWCWF8yyVHC8FncFqTPiRGgdHAhgGbpS4tYAjKlw3I,12886
 machineconfig/profile/records/generic/shares.toml,sha256=FduDztfyQtZcr5bfx-RSKhEEweweQSWfVXkKWnx8hCY,143
 machineconfig/profile/records/linux/apps_summary_report.csv,sha256=pw9djvaRUPalKDLn2sl3odcbD2_Zx3aEupsQ8UPfaaY,2738
 machineconfig/profile/records/linux/apps_summary_report.md,sha256=l77oofA6Rliql0ZgKGIZi8bstFoGyyGTxeS8p2PtOj0,5634
 machineconfig/profile/records/windows/apps_summary_report.csv,sha256=nN5BoACBqXgKNczm2t5KaCLdDnxFCIscX8iRkWBm0a4,47
 machineconfig/profile/records/windows/apps_summary_report.md,sha256=O5hmAcpObaLmOjYLvHg9kkPJryqFwFaP8OsmfPwfR1o,137
+machineconfig/scripts/Restore-ThunderbirdProfile.ps1,sha256=HYIT48vW_E86QJq7RqfWAV06ZAMqjiZS8EDSET11Y04,3605
 machineconfig/scripts/__init__.py,sha256=v0cMjnaIo39C3ltLiTf1S0fCTMAqWtEU7zrVenUj4PQ,71
 machineconfig/scripts/linux/fzf2g,sha256=YK_YLmxCm6zms24ytylgoUHnvWqq8oTdRTiskzDClS0,831
 machineconfig/scripts/linux/fzfag,sha256=x0rX7vM_YjKLZ822D2Xh0HdaTj5kR_gG3g_5_w6ring,679
@@ -366,7 +370,7 @@ machineconfig/utils/accessories.py,sha256=W_9dLzjwNTW5JQk_pe3B2ijQ1nA2-8Kdg2r7VB
 machineconfig/utils/code.py,sha256=0sAlozPgbbGwNE0sksK1XiBMyfCBtBt5d_6ExL1K9_8,6489
 machineconfig/utils/installer.py,sha256=ZnhW_gRmGlq5uXwzNvIn-x1vXuOJxkzVqjNu188f37s,10465
 machineconfig/utils/io.py,sha256=rzEwAnq-gyT29Y4CDHHGxAA6ddIIFOCxrqZ6dn0ALa4,2255
-machineconfig/utils/links.py,sha256=GQExBsMoxewOhwIrNdERuzk9HVKcmWgNUGO-RzPMS6M,22588
+machineconfig/utils/links.py,sha256=KM6vIn3hag9FYEzLSHP5MAM9tU_RStw2mCq2_OvmmZA,23672
 machineconfig/utils/notifications.py,sha256=tuXIudcip0tEioG-bm8BbLr3FMDve4f6BktlznBhKxM,9013
 machineconfig/utils/options.py,sha256=vUO4Kej-vDOv64wHr2HNDyu6PATURpjd7xp6N8OOoJg,7083
 machineconfig/utils/path_extended.py,sha256=Xjdn2AVnB8p1jfNMNe2kJutVa5zGnFFJVGZbw-Bp_hg,53200
@@ -381,6 +385,7 @@ machineconfig/utils/upgrade_packages.py,sha256=H96zVJEWXJW07nh5vhjuSCrPtXGqoUb7x
 machineconfig/utils/ve.py,sha256=L-6PBXnQGXThiwWgheJMQoisAZOZA6SVCbGw2J-GFnI,2414
 machineconfig/utils/ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/utils/ai/generate_file_checklist.py,sha256=ajbmhcBToRugl75c_KZRq2XJumxKgIqQhyf7_YtF5q4,2729
+machineconfig/utils/cloud/onedrive/README.md,sha256=i20oRG110AN0yLF3DARHfWXDJjPBiSgWI8CP2HQAqrk,3774
 machineconfig/utils/cloud/onedrive/setup_oauth.py,sha256=ZTVkqgrwbV_EoPvyT8dyOTUE0ur3BW4sa9o6QYtt5Bo,2341
 machineconfig/utils/cloud/onedrive/transaction.py,sha256=m-aNcnWj_gfZVvJOSpkdIqjZxU_3nXx2CA-qKbQgP3I,26232
 machineconfig/utils/files/ascii_art.py,sha256=cNJaJC07vx94fS44-tzgfbfBeCwXVrgpnWGBLUnfC38,5212
@@ -398,8 +403,8 @@ machineconfig/utils/schemas/fire_agents/fire_agents_input.py,sha256=Xbi59rU35AzR
 machineconfig/utils/schemas/installer/installer_types.py,sha256=QClRY61QaduBPJoSpdmTIdgS9LS-RvE-QZ-D260tD3o,1214
 machineconfig/utils/schemas/layouts/layout_types.py,sha256=TcqlZdGVoH8htG5fHn1KWXhRdPueAcoyApppZsPAPto,2020
 machineconfig/utils/schemas/repos/repos_types.py,sha256=ECVr-3IVIo8yjmYmVXX2mnDDN1SLSwvQIhx4KDDQHBQ,405
-machineconfig-5.45.dist-info/METADATA,sha256=8Jq_P38IUHDA8QbTfRifEJMVUuMSo5obI6vp4N-3PXo,3111
-machineconfig-5.45.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-machineconfig-5.45.dist-info/entry_points.txt,sha256=z7b9guivf0GSKUG6b8ALgbDoRg2LuPfkGP_p-PxgX9g,469
-machineconfig-5.45.dist-info/top_level.txt,sha256=porRtB8qms8fOIUJgK-tO83_FeH6Bpe12oUVC670teA,14
-machineconfig-5.45.dist-info/RECORD,,
+machineconfig-5.47.dist-info/METADATA,sha256=qQlk_75QfjpJwXdd1X07K2Lxsthyie6TtawEv1i3m04,3111
+machineconfig-5.47.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+machineconfig-5.47.dist-info/entry_points.txt,sha256=z7b9guivf0GSKUG6b8ALgbDoRg2LuPfkGP_p-PxgX9g,469
+machineconfig-5.47.dist-info/top_level.txt,sha256=porRtB8qms8fOIUJgK-tO83_FeH6Bpe12oUVC670teA,14
+machineconfig-5.47.dist-info/RECORD,,