machineconfig 6.23__py3-none-any.whl → 8.12__py3-none-any.whl

machineconfig/setup_mac/apps_gui.sh

@@ -0,0 +1,248 @@
+#!/usr/bin/env bash
+
+# macOS GUI Application Installation Script
+# Comprehensive GUI application installation via Homebrew Cask and Mac App Store
+# Supports Intel and Apple Silicon architectures
+
+set -e  # Exit on any error
+
+# Color codes for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Logging functions
+log_info() {
+    echo -e "${BLUE}ℹ️  $1${NC}"
+}
+
+log_success() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+log_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+log_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+
+# Architecture detection
+detect_architecture() {
+    local arch=$(uname -m)
+    if [[ "$arch" == "arm64" ]]; then
+        echo "arm64"
+    elif [[ "$arch" == "x86_64" ]]; then
+        echo "amd64"
+    else
+        log_warning "Unknown architecture: $arch, defaulting to amd64"
+        echo "amd64"
+    fi
+}
+
+# Check if Homebrew is installed
+check_homebrew() {
+    if ! command -v brew &> /dev/null; then
+        log_error "Homebrew is not installed. Please run apps.sh first to install Homebrew."
+        exit 1
+    fi
+    log_success "Homebrew found"
+}
+
+# Setup Mac App Store CLI
+setup_mas() {
+    log_info "Setting up Mac App Store CLI (mas)..."
+    
+    if ! command -v mas &> /dev/null; then
+        log_info "Installing mas (Mac App Store CLI)..."
+        brew install mas || {
+            log_error "Failed to install mas"
+            return 1
+        }
+    else
+        log_success "mas already installed"
+    fi
+    
+    # Check if user is signed in to Mac App Store
+    if ! mas account &> /dev/null; then
+        log_warning "Not signed in to Mac App Store. Some applications may not install."
+        log_info "Please sign in to the Mac App Store manually to install App Store applications."
+    else
+        log_success "Signed in to Mac App Store"
+    fi
+}
+
+# Install a GUI application with error handling
+install_gui_app() {
+    local app_name="$1"
+    local description="$2"
+    local install_cmd="$3"
+    local fallback_cmd="$4"
+    
+    log_info "Installing $description..."
+    
+    if eval "$install_cmd"; then
+        log_success "$app_name installed successfully"
+        return 0
+    elif [[ -n "$fallback_cmd" ]]; then
+        log_warning "Primary installation failed, trying fallback method..."
+        if eval "$fallback_cmd"; then
+            log_success "$app_name installed via fallback method"
+            return 0
+        else
+            log_error "Failed to install $app_name via fallback method"
+            return 1
+        fi
+    else
+        log_error "Failed to install $app_name"
+        return 1
+    fi
+}
+
+# Install GUI applications from a list
+install_gui_app_list() {
+    local group_name="$1"
+    shift
+    local apps=("$@")
+    
+    log_info "Installing $group_name applications..."
+    
+    local failed_apps=()
+    for app_info in "${apps[@]}"; do
+        IFS='|' read -r app_name description install_cmd fallback_cmd <<< "$app_info"
+        if ! install_gui_app "$app_name" "$description" "$install_cmd" "$fallback_cmd"; then
+            failed_apps+=("$app_name")
+        fi
+    done
+    
+    if [[ ${#failed_apps[@]} -gt 0 ]]; then
+        log_warning "$group_name: Failed to install: ${failed_apps[*]}"
+    else
+        log_success "All $group_name applications installed successfully"
+    fi
+}
+
+# Main installation function
+main() {
+    log_info "Starting macOS GUI application installation..."
+    log_info "Detected architecture: $(detect_architecture)"
+    
+    # Check prerequisites
+    check_homebrew
+    setup_mas
+    
+    # --GROUP:BROWSERS - Web browsers
+    local browsers=(
+        "brave-browser|Brave Browser - Privacy-focused web browser|brew install --cask brave-browser|"
+        "google-chrome|Google Chrome web browser|brew install --cask google-chrome|"
+        "firefox|Mozilla Firefox web browser|brew install --cask firefox|"
+        "microsoft-edge|Microsoft Edge web browser|brew install --cask microsoft-edge|"
+        "safari-technology-preview|Safari Technology Preview|brew install --cask safari-technology-preview|"
+    )
+    
+    install_gui_app_list "Browsers" "${browsers[@]}"
+    
+    # --GROUP:CODE_EDITORS - Code editors and IDEs
+    local code_editors=(
+        "visual-studio-code|Visual Studio Code|brew install --cask visual-studio-code|"
+        "cursor|Cursor AI-powered code editor|brew install --cask cursor|"
+        "sublime-text|Sublime Text editor|brew install --cask sublime-text|"
+        "atom|Atom text editor|brew install --cask atom|"
+        "webstorm|JetBrains WebStorm IDE|brew install --cask webstorm|"
+        "pycharm|JetBrains PyCharm IDE|brew install --cask pycharm|"
+        "intellij-idea|JetBrains IntelliJ IDEA|brew install --cask intellij-idea|"
+        "xcode|Xcode development environment|mas install 497799835|brew install --cask xcode"
+    )
+    
+    install_gui_app_list "Code Editors & IDEs" "${code_editors[@]}"
+    
+    # --GROUP:PRODUCTIVITY - Productivity and office applications
+    local productivity=(
+        "obsidian|Obsidian note-taking app|brew install --cask obsidian|"
+        "notion|Notion workspace|brew install --cask notion|"
+        "bitwarden|Bitwarden password manager|brew install --cask bitwarden|"
+        "1password|1Password password manager|brew install --cask 1password|mas install 1333542190"
+        "alfred|Alfred productivity app|brew install --cask alfred|"
+        "raycast|Raycast launcher and productivity tool|brew install --cask raycast|"
+        "rectangle|Rectangle window management|brew install --cask rectangle|"
+        "magnet|Magnet window manager|mas install 441258766|brew install --cask magnet"
+        "cleanmymac|CleanMyMac X system cleaner|mas install 1339170533|"
+    )
+    
+    install_gui_app_list "Productivity" "${productivity[@]}"
+    
+    # --GROUP:MEDIA - Media and entertainment applications
+    local media=(
+        "vlc|VLC media player|brew install --cask vlc|"
+        "obs|OBS Studio for streaming and recording|brew install --cask obs|"
+        "handbrake|HandBrake video transcoder|brew install --cask handbrake|"
+        "spotify|Spotify music streaming|brew install --cask spotify|mas install 324684580"
+        "youtube-music|YouTube Music|brew install --cask youtube-music|"
+        "plex|Plex media server|brew install --cask plex|"
+        "keka|Keka archive utility|brew install --cask keka|mas install 470158793"
+        "the-unarchiver|The Unarchiver|brew install --cask the-unarchiver|mas install 425424353"
+    )
+    
+    install_gui_app_list "Media & Entertainment" "${media[@]}"
+    
+    # --GROUP:DEVELOPMENT - Development and system tools
+    local development=(
+        "docker|Docker Desktop|brew install --cask docker|"
+        "postman|Postman API development|brew install --cask postman|"
+        "insomnia|Insomnia REST client|brew install --cask insomnia|"
+        "github-desktop|GitHub Desktop|brew install --cask github-desktop|"
+        "sourcetree|Sourcetree Git client|brew install --cask sourcetree|"
+        "iterm2|iTerm2 terminal emulator|brew install --cask iterm2|"
+        "warp|Warp modern terminal|brew install --cask warp|"
+        "alacritty|Alacritty terminal emulator|brew install --cask alacritty|"
+    )
+    
+    install_gui_app_list "Development Tools" "${development[@]}"
+    
+    # --GROUP:DATABASE - Database management tools
+    local database=(
+        "dbeaver-community|DBeaver database tool|brew install --cask dbeaver-community|"
+        "sequel-pro|Sequel Pro MySQL client|brew install --cask sequel-pro|"
+        "tableplus|TablePlus database client|brew install --cask tableplus|"
+        "redis-insight|RedisInsight Redis GUI|brew install --cask redisinsight|"
+        "mongodb-compass|MongoDB Compass|brew install --cask mongodb-compass|"
+    )
+    
+    install_gui_app_list "Database Tools" "${database[@]}"
+    
+    # --GROUP:COMMUNICATION - Communication and collaboration
+    local communication=(
+        "slack|Slack team communication|brew install --cask slack|mas install 803453959"
+        "discord|Discord voice and text chat|brew install --cask discord|"
+        "zoom|Zoom video conferencing|brew install --cask zoom|"
+        "microsoft-teams|Microsoft Teams|brew install --cask microsoft-teams|"
+        "whatsapp|WhatsApp Desktop|brew install --cask whatsapp|mas install 1147396723"
+        "telegram|Telegram messaging|brew install --cask telegram|mas install 747648890"
+    )
+    
+    install_gui_app_list "Communication" "${communication[@]}"
+    
+    # --GROUP:SYSTEM_UTILITIES - System utilities and maintenance
+    local system_utilities=(
+        "appcleaner|AppCleaner uninstaller|brew install --cask appcleaner|"
+        "coconutbattery|CoconutBattery system info|brew install --cask coconutbattery|"
+        "disk-utility|Disk Utility (built-in)|echo 'Disk Utility is built into macOS'|"
+        "activity-monitor|Activity Monitor (built-in)|echo 'Activity Monitor is built into macOS'|"
+        "finder|Finder (built-in)|echo 'Finder is built into macOS'|"
+        "homebrew|Homebrew package manager|echo 'Homebrew already installed'|"
+    )
+    
+    install_gui_app_list "System Utilities" "${system_utilities[@]}"
+    
+    log_success "macOS GUI application installation completed!"
+    log_info "Some applications may require additional setup or signing in to your accounts."
+    log_info "Check Applications folder for newly installed apps."
+}
+
+# Execute main function if script is run directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi

machineconfig/setup_mac/ssh/openssh_setup.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+
+# 🔐 OpenSSH Setup for macOS
+# This script sets up SSH configuration and permissions on macOS
+
+echo "🔐 Starting OpenSSH setup for macOS..."
+
+# ✅ SSH is built-in on macOS (OpenSSH comes pre-installed)
+echo "✅ OpenSSH is pre-installed on macOS"
+
+# 📁 Create SSH directory with correct permissions
+echo "📁 Setting up SSH directory..."
+mkdir -p ~/.ssh
+chmod 700 ~/.ssh
+echo "✅ SSH directory created with correct permissions (700)"
+
+# 📝 Create authorized_keys file if it doesn't exist
+if [ ! -f ~/.ssh/authorized_keys ]; then
+    touch ~/.ssh/authorized_keys
+    chmod 600 ~/.ssh/authorized_keys
+    echo "✅ Created authorized_keys file"
+else
+    echo "✅ authorized_keys file already exists"
+    chmod 600 ~/.ssh/authorized_keys
+fi
+
+# 🔑 Create SSH keys if they don't exist
+if [ ! -f ~/.ssh/id_rsa ]; then
+    echo "🔑 Generating SSH keys (RSA)..."
+    ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa -N "" -C "$(whoami)@$(hostname)"
+    echo "✅ SSH RSA keys generated: ~/.ssh/id_rsa"
+else
+    echo "✅ SSH keys already exist"
+fi
+
+# 🔐 Create Ed25519 keys (modern alternative)
+if [ ! -f ~/.ssh/id_ed25519 ]; then
+    echo "🔑 Generating SSH keys (Ed25519)..."
+    ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N "" -C "$(whoami)@$(hostname)"
+    echo "✅ SSH Ed25519 keys generated: ~/.ssh/id_ed25519"
+else
+    echo "✅ SSH Ed25519 keys already exist"
+fi
+
+# 🔧 Configure SSH config file for convenience
+SSH_CONFIG="$HOME/.ssh/config"
+if [ ! -f "$SSH_CONFIG" ]; then
+    echo "📝 Creating SSH config file..."
+    cat > "$SSH_CONFIG" << 'EOF'
+# SSH Config File for macOS
+# Add your remote hosts below
+
+# Example host configuration:
+# Host myserver
+#     HostName example.com
+#     User username
+#     Port 22
+#     IdentityFile ~/.ssh/id_ed25519
+#     IdentityFile ~/.ssh/id_rsa
+
+# Global settings
+Host *
+    AddKeysToAgent yes
+    UseKeychain yes
+    IdentityFile ~/.ssh/id_ed25519
+    IdentityFile ~/.ssh/id_rsa
+    ServerAliveInterval 60
+EOF
+    chmod 600 "$SSH_CONFIG"
+    echo "✅ SSH config file created: $SSH_CONFIG"
+else
+    echo "✅ SSH config file already exists"
+fi
+
+# 🔒 Ensure correct file permissions
+echo "🔒 Setting correct SSH file permissions..."
+chmod 700 ~/.ssh
+chmod 600 ~/.ssh/authorized_keys 2>/dev/null || true
+chmod 600 ~/.ssh/id_rsa 2>/dev/null || true
+chmod 644 ~/.ssh/id_rsa.pub 2>/dev/null || true
+chmod 600 ~/.ssh/id_ed25519 2>/dev/null || true
+chmod 644 ~/.ssh/id_ed25519.pub 2>/dev/null || true
+chmod 600 ~/.ssh/config 2>/dev/null || true
+echo "✅ SSH file permissions configured correctly"
+
+# ℹ️ Display SSH key information
+echo ""
+echo "📋 SSH Setup Summary:"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "SSH Directory: ~/.ssh"
+echo "SSH Config: ~/.ssh/config"
+echo ""
+echo "Available SSH Keys:"
+if [ -f ~/.ssh/id_rsa.pub ]; then
+    echo "  • RSA Key: ~/.ssh/id_rsa"
+fi
+if [ -f ~/.ssh/id_ed25519.pub ]; then
+    echo "  • Ed25519 Key: ~/.ssh/id_ed25519"
+fi
+echo ""
+echo "💡 Next Steps:"
+echo "  1. View your public key:"
+echo "     cat ~/.ssh/id_ed25519.pub  (or id_rsa.pub)"
+echo "  2. Add it to your GitHub/GitLab/server authorized_keys"
+echo "  3. Test connection:"
+echo "     ssh -v your_server"
+echo "  4. Configure hosts in ~/.ssh/config for easy access"
+echo ""
+echo "📚 Learn more about SSH:"
+echo "  • man ssh"
+echo "  • man ssh-keygen"
+echo "  • man ssh_config"
+echo ""
+echo "✅ OpenSSH setup complete!"

machineconfig/setup_mac/uv.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+# Install or update uv (universal version manager) on macOS
+# Mirrors Linux uv installer but adapts PATH and locations for mac
+
+set -euo pipefail
+
+UV_BIN="$HOME/.local/bin/uv"
+
+if [ ! -f "$UV_BIN" ]; then
+    echo "📦 uv binary not found — installing uv to $HOME/.local/bin..."
+    mkdir -p "$HOME/.local/bin"
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    echo "✅ uv installed to $UV_BIN"
+else
+    echo "🔄 uv binary found — attempting self-update..."
+    "$UV_BIN" self update || true
+fi
+
+# Ensure local bin is in PATH for this run
+export PATH="$HOME/.local/bin:$PATH"
+
+if ! command -v uv &> /dev/null; then
+    echo "⚠️ uv not found in PATH even after install; add \"$HOME/.local/bin\" to your shell profile"
+else
+    echo "🔧 uv available: $(command -v uv)"
+fi
+
+# Example uv usage: ensure Python 3.14 is available (adjust as needed)
+if command -v uv &> /dev/null; then
+    echo "📥 Ensuring Python 3.14 via uv (if supported)"
+    # uv may manage various runtimes; this is an example command and will be skipped gracefully if unsupported
+    uv python install 3.14 || true
+fi
+
+echo "✅ uv setup complete"

machineconfig/setup_windows/__init__.py

@@ -1,11 +1,9 @@
 
 from pathlib import Path
 
-APPS = Path(__file__).parent.joinpath("apps.ps1")
 UV = Path(__file__).parent.joinpath("uv.ps1")
 
-DOCKER = Path(__file__).parent.joinpath("others/docker.ps1")
-OBS = Path(__file__).parent.joinpath("others/obs.ps1")
-POWER_OPTIONS = Path(__file__).parent.joinpath("others/power_options.ps1")
+SSH_SERVER =  Path(__file__).parent.joinpath("ssh/openssh_server.ps1")
+INTERACTIVE = Path(__file__).parent.joinpath("web_shortcuts/interactive.ps1")
+LIVE =        Path(__file__).parent.joinpath("web_shortcuts/live_from_github.ps1")
 
-SSH_SERVER = Path(__file__).parent.joinpath("ssh/openssh_server.ps1")

machineconfig/setup_windows/ssh/openssh-server.ps1

@@ -5,7 +5,7 @@ Set-ExecutionPolicy Bypass
 # PowerShell.exe -ExecutionPolicy Bypass -File "C:\bypass\prompt\standard.ps1" 2>&1>$null
 
 # Install SSH-Server on a windows machine. see this one below if this one didn't work:
-# to install: winget install --Id Microsoft.OpenSSH.Preview --source winget --scope user  # from: https://github.com/PowerShell/Win32-OpenSSH/wiki/Install-Win32-OpenSSH
+# to install: winget install --Id Microsoft.OpenSSH.Preview --source winget --scope user --accept-package-agreements --accept-source-agreements  # from: https://github.com/PowerShell/Win32-OpenSSH/wiki/Install-Win32-OpenSSH
 # the result is installed in C:\Program Files\OpenSSH as opposed to C:\Windows\System32\OpenSSH which is the case if openssh is added as a feature/capability to windows
 # However, notice the new path is not in PATH as is the cases with system variant, so it needs to be added manually.
 # finally, ssh config files are always @ "$env:ProgramData\ssh" irrespective of installation method.

machineconfig/setup_windows/uv.ps1

@@ -7,4 +7,11 @@ if (-not (Test-Path -Path "$HOME\.local\bin\uv.exe")) {
     Write-Output "uv binary found, updating..."
     & "$HOME\.local\bin\uv.exe" self update
 }
-& "$HOME\.local\bin\uv.exe" python install 3.14
+
+# `C:\Users\aalsaf01\.local\bin` is not on your PATH. To use installed Python executables, run `$env:PATH = "C:\Users\aalsaf01\.local\bin;$env:PATH"` or `uv python update-shell`.
+& "$env:USERPROFILE\.local\bin\uv.exe" python update-shell
+$env:Path = [System.Environment]::GetEnvironmentVariable('Path', 'Machine') + ';' + [System.Environment]::GetEnvironmentVariable('Path', 'User')
+
+# & "$HOME\.local\bin\uv.exe" python install 3.14
+uv python install 3.14
+

machineconfig/setup_windows/web_shortcuts/interactive.ps1

@@ -1,14 +1,30 @@
 
 
 iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/uv.ps1").Content
-function mcfg {
-    & "$HOME\.local\bin\uv.exe" run --python 3.14 --with "machineconfig>=5.87" mcfg $args
-}
-function d { mcfg devops @args }
-function c { mcfg cloud @args }
-function a { mcfg agents @args }
-function s { mcfg sessions @args }
-function ff { mcfg ftpx @args }
-function f { mcfg fire @args }
-function cs { mcfg croshell @args }
+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>=8.12" devops $args }
+function cloud    { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" cloud $args }
+function agents   { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" agents $args }
+function sessions { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" sessions $args }
+function ftpx     { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" ftpx $args }
+function fire     { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" fire $args }
+function croshell { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" croshell $args }
+function utils    { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" utils $args }
+function terminal { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" terminal $args }
+function msearch  { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=8.12" 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/live_from_github.ps1

@@ -0,0 +1,30 @@
+
+
+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 "git+https://github.com/thisismygitrepo/machineconfig" mcfg $args }
+
+function devops {mcfg devops @args }
+function cloud {mcfg cloud @args }
+function agents {mcfg agents @args }
+function sessions {mcfg sessions @args }
+function ftpx {mcfg ftpx @args }
+function fire {mcfg fire @args }
+function croshell {mcfg croshell @args }
+function utils {mcfg utils @args }
+function terminal {mcfg terminal @args }
+function msearch {mcfg msearch @args }
+
+function d { wrap_in_shell_script mcfg devops @args }
+function c { wrap_in_shell_script mcfg cloud @args }
+function a { wrap_in_shell_script mcfg agents @args }
+function sx { wrap_in_shell_script mcfg sessions @args }
+function fx { wrap_in_shell_script mcfg ftpx @args }
+function f { wrap_in_shell_script mcfg fire @args }
+function rr { wrap_in_shell_script mcfg croshell @args }
+function u { wrap_in_shell_script mcfg utils @args }
+function t { wrap_in_shell_script mcfg terminal @args }
+function ms { wrap_in_shell_script mcfg msearch @args }
+
+Write-Host "mcfg command aliases are now defined in this PowerShell session."

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
+
+devops install --group termabc 
+wt  # start Windows Terminal to pick up config changes
+devops install --group gui

machineconfig/utils/accessories.py

@@ -1,4 +1,3 @@
-from pathlib import Path
 from typing import Optional, Any
 
 from datetime import datetime, timezone, timedelta
@@ -72,7 +71,6 @@ def split_list[T](sequence: list[T], every: Optional[int]=None, to: Optional[int
 
 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)
 
 
@@ -97,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