machineconfig 5.45__tar.gz → 5.47__tar.gz

{machineconfig-5.45/src/machineconfig.egg-info → machineconfig-5.47}/PKG-INFO

@@ -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 → machineconfig-5.47}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "5.45"
+version = "5.47"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -83,6 +83,9 @@ license-files = []
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.package-data]
+machineconfig = ["**/*.toml", "**/*.md", "**/*.sh", "**/*.ps1"]
+
 [dependency-groups]
 dev = [
     "aider>=0.2.6",

machineconfig-5.47/src/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-5.47/src/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-5.47/src/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-5.47/src/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-5.47/src/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-5.45 → machineconfig-5.47}/src/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 → machineconfig-5.47/src/machineconfig.egg-info}/PKG-INFO

@@ -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 → machineconfig-5.47}/src/machineconfig.egg-info/SOURCES.txt

@@ -101,15 +101,19 @@ src/machineconfig/jobs/windows/archive/openssh-server_copy-ssh-id.ps1
 src/machineconfig/jobs/windows/msc/cli_agents.bat
 src/machineconfig/jobs/windows/msc/cli_agents.ps1
 src/machineconfig/profile/__init__.py
+src/machineconfig/profile/backup.toml
+src/machineconfig/profile/bash_shell_profiles.md
 src/machineconfig/profile/create_helper.py
 src/machineconfig/profile/create_links.py
 src/machineconfig/profile/create_links_export.py
 src/machineconfig/profile/create_shell_profile.py
+src/machineconfig/profile/mapper.toml
 src/machineconfig/profile/records/generic/shares.toml
 src/machineconfig/profile/records/linux/apps_summary_report.csv
 src/machineconfig/profile/records/linux/apps_summary_report.md
 src/machineconfig/profile/records/windows/apps_summary_report.csv
 src/machineconfig/profile/records/windows/apps_summary_report.md
+src/machineconfig/scripts/Restore-ThunderbirdProfile.ps1
 src/machineconfig/scripts/__init__.py
 src/machineconfig/scripts/linux/fzf2g
 src/machineconfig/scripts/linux/fzfag
@@ -390,6 +394,7 @@ src/machineconfig/utils/upgrade_packages.py
 src/machineconfig/utils/ve.py
 src/machineconfig/utils/ai/__init__.py
 src/machineconfig/utils/ai/generate_file_checklist.py
+src/machineconfig/utils/cloud/onedrive/README.md
 src/machineconfig/utils/cloud/onedrive/setup_oauth.py
 src/machineconfig/utils/cloud/onedrive/transaction.py
 src/machineconfig/utils/files/ascii_art.py