machineconfig 3.7__py3-none-any.whl → 7.69__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

@@ -0,0 +1,8 @@
+
+from pathlib import Path
+
+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")

machineconfig/setup_windows/others/power_options.ps1

@@ -0,0 +1,7 @@
+
+# power and sleep options.
+Powercfg /Change monitor-timeout-ac 60
+Powercfg /Change monitor-timeout-dc 0
+Powercfg /Change standby-timeout-ac 0
+Powercfg /Change standby-timeout-dc 0
+

machineconfig/setup_windows/ssh/add-sshkey.ps1

@@ -0,0 +1,29 @@
+
+# This script adds a public key to the authorized_keys file for the sshd service
+# as a result, a remote can connet to the machine if they got the corresponding private key (identity).
+
+# https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_keymanagement
+# http://woshub.com/using-ssh-key-based-authentication-on-windows/
+
+$ErrorActionPreference = "Stop"
+$sshd_dir = "$env:ProgramData\ssh"
+$sshfile = "$env:USERPROFILE\.ssh\pubkey.pub"  # this directory is for normal users, not admins.
+# Once they are populated, we can create administrators_authorized_keys
+
+Get-Content $sshfile >> "$sshd_dir\administrators_authorized_keys"
+# set appropirate persmissions for this file
+Set-Location $sshd_dir
+icacls administrators_authorized_keys /inheritance:r /grant "Administrators:F" /grant "SYSTEM:F"
+# Lastly, enabling public key authentication.
+$sshd_config = "$sshd_dir\sshd_config"
+(Get-Content $sshd_config) -replace '#PubkeyAuthentication', 'PubkeyAuthentication' | Out-File -encoding ASCII $sshd_config
+#(Get-Content $sshd_dir\sshd_config) -replace 'AuthorizedKeysFile __PROGRAMDATA__', '#AuthorizedKeysFile __PROGRAMDATA__' | Out-File -encoding ASCII $sshd_config
+#(Get-Content $sshd_dir\sshd_config) -replace 'Match Group administrators', '#Match Group administrators' | Out-File -encoding ASCII $sshd_config
+#cat C:\ProgramData\ssh\sshd_config
+
+# to load the fresh settings, we need to restart the service:
+Restart-Service sshd -Force
+
+#Write-Host "Use this to Login/test Now"
+#write-host ssh $env:UserName@localhost
+# debug tip: use nano editor to inspect files above, if unreadable max-text format is used, ssh won't work.

machineconfig/setup_windows/ssh/add_identity.ps1

@@ -0,0 +1,11 @@
+
+# on the side of the local machine, you need to sort out the following:
+# if the $sshfile doesn't have a standard name, you will need to explicitly specify the identity while SSHing (e.g. ssh u@s -i ~/.ssh/my_id)
+# However, this must be done every time. For permanent solutions, use .ssh/config
+
+$sshfile = "$env:USERPROFILE\.ssh\id_rsa"
+
+Set-Service ssh-agent -StartupType Manual  # allow the service to be started manually
+ssh-agent  # start the service
+ssh-add.exe $sshfile # add the key to the agent
+

machineconfig/setup_windows/ssh/openssh-server.ps1

@@ -0,0 +1,37 @@
+
+$ErrorActionPreference = "Stop"
+# ALL of the following require admin priviliages:
+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
+# 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.
+# if ssh key is created on windows, it doesn't work on linux and gives a cryptlib error. It must be read again and saved in non DOS format.
+
+Add-WindowsCapability -Online -Name OpenSSH.Server
+Add-WindowsCapability -Online -Name OpenSSH.Client
+
+#New-NetFirewallRule -Name sshd -DisplayName 'OpenSSH SSH Server' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22 -Program "%WINDIR%\System32\OpenSSH\sshd.exe"
+
+# Must Enable ssh-agent before starting. But even before that, one need to update path so that same shell has access to the NEWLY added ssh program
+$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+
+Set-Service -Name sshd -StartupType Automatic
+#Get-Service -Name ssh-agent | Set-Service -StartupType Automatic
+#Set-Service -Name ssh-agent -StartupType Automatic
+#Start-Service ssh-agent
+# Starting the service for the first time will populate the directory with config files.
+Start-Service sshd
+
+# Next up, change default shell to powershell, becuse CMD is lame
+# following: https://github.com/PowerShell/Win32-OpenSSH/wiki/DefaultShell
+$shell = "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe"  # "C:\Windows\System32\wsl.exe"
+# $shell = "C:\Program Files\PowerShell\7\pwsh.exe"  # it slows SSH down because of startup time, one can still use it by running it explicitly
+New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value $shell -PropertyType String -Force
+New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShellCommandOption -Value "/c" -PropertyType String -Force
+
+cd ~
+mkdir .ssh -ErrorAction SilentlyContinue

machineconfig/setup_windows/uv.ps1

@@ -0,0 +1,17 @@
+
+
+if (-not (Test-Path -Path "$HOME\.local\bin\uv.exe")) {
+    Write-Output "uv binary not found, installing..."
+    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+} else {
+    Write-Output "uv binary found, updating..."
+    & "$HOME\.local\bin\uv.exe" self update
+}
+
+# `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
+