machineconfig 5.14__py3-none-any.whl → 5.16__py3-none-any.whl

machineconfig/scripts/python/count_lines_frontend.py

@@ -8,8 +8,8 @@ def analyze_repo_development(repo_path: str = typer.Argument(..., help="Path to
     count_lines_path = Path(count_lines.__file__)
     # --project $HOME/code/machineconfig 
     cmd = f"""uv run --python 3.13 --with machineconfig[plot] {count_lines_path} analyze-over-time {repo_path}"""
-    from machineconfig.utils.code import run_script
-    run_script(cmd)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(cmd)
 
 
 if __name__ == "__main__":

machineconfig/scripts/python/croshell.py

@@ -145,8 +145,8 @@ from pathlib import Path
         else: profile = ""
         fire_line = f"uv run --python 3.13 --with machineconfig[plot] {interpreter} {interactivity} {profile} {str(pyfile)}"
 
-    from machineconfig.utils.code import run_script
-    run_script(fire_line)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(fire_line)
 
 
 def arg_parser() -> None:

machineconfig/scripts/python/fire_jobs.py

@@ -221,8 +221,8 @@ python -m machineconfig.cluster.templates.cli_click --file {choice_file} """
             command = "$ErrorActionPreference = 'SilentlyContinue';\n" + command + "\nStart-Sleep -Seconds 0.5"
         else:
             raise NotImplementedError(f"Platform {platform.system()} not supported.")
-    from machineconfig.utils.code import run_script
-    run_script(command)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(command)
 
 
 def main(

machineconfig/scripts/python/interactive.py

@@ -27,27 +27,23 @@ from questionary import Choice
 from rich.console import Console
 from rich.panel import Panel
 from rich.text import Text
-from machineconfig.utils.code import run_script as run_command
+from machineconfig.utils.code import run_shell_script
 
 _ = cast
 console = Console()
 
 
 def display_header() -> None:
-    """Display the script header."""
     header_text = Text("MACHINE CONFIGURATION", style="bold magenta")
     subtitle_text = Text("Interactive Installation Script", style="italic cyan")
     console.print(Panel(f"📦 {header_text}\n{subtitle_text}", border_style="blue", padding=(1, 2)))
 def display_completion_message() -> None:
-    """Display completion message."""
     completion_text = Text("INSTALLATION COMPLETE", style="bold green")
     subtitle_text = Text("System setup finished successfully", style="italic green")
     console.print(Panel(f"✨ {completion_text}\n{subtitle_text}\n\n🎉 Your system has been configured successfully!\n🔄 You may need to reboot to apply all changes.", border_style="green", padding=(1, 2)))
 def display_dotfiles_instructions() -> None:
-    """Display instructions for dotfiles migration."""
     header_text = Text("DOTFILES MIGRATION", style="bold yellow")
     subtitle_text = Text("Configuration transfer options", style="italic yellow")
-
     instructions = """
 🖱️  [bold blue]Method 1: USING MOUSE WITHOUT KB OR BROWSER SHARE[/bold blue]
     On original machine, run:
@@ -65,32 +61,9 @@ def display_dotfiles_instructions() -> None:
     [dim]cd ~
     cloud_copy SHARE_URL . --config ss[/dim]
     (requires symlinks to be created first)"""
-
     console.print(Panel(f"📂 {header_text}\n{subtitle_text}\n\n{instructions}", border_style="yellow", padding=(1, 2)))
 
 
-def install_windows_desktop_apps() -> bool:
-    """Install Windows desktop applications using winget."""
-    if system() != "Windows":
-        console.print("❌ This function is only available on Windows systems.", style="bold red")
-        return False   
-    console.print("🔧 Installing Nerd Fonts", style="bold cyan")
-    try:
-        from machineconfig.jobs.installer.custom_dev.nerfont_windows_helper import install_nerd_fonts
-        install_nerd_fonts()
-        console.print("✅ Nerd Fonts installed successfully", style="bold green")
-    except Exception as e:
-        console.print(f"❌ Error installing Nerd Fonts: {e}", style="bold red")
-    console.print("🔧 Setting Windows Terminal settings", style="bold cyan")
-    try:
-        from machineconfig.setup_windows.wt_and_pwsh.set_wt_settings import main as set_wt_settings_main
-        set_wt_settings_main()
-        console.print("✅ Windows Terminal settings configured successfully", style="bold green")
-    except Exception as e:
-        console.print(f"❌ Error setting Windows Terminal settings: {e}", style="bold red")    
-    return True
-
-
 def get_installation_choices() -> list[str]:
     """Get user choices for installation options."""
     choices = [
@@ -114,11 +87,15 @@ def get_installation_choices() -> list[str]:
 
 
 def execute_installations(selected_options: list[str]) -> None:
-    """Execute the selected installation options."""
     if system() == "Windows":
-        run_command("$HOME/.local/bin/uv.exe self update")
+        from machineconfig import setup_windows as module
+        script_path = Path(module.__file__).parent / "ve.ps1"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
     else:
-        run_command("$HOME/.local/bin/uv self update")
+        from machineconfig import setup_linux as module
+        script_path = Path(module.__file__).parent / "ve.sh"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
+
     for maybe_a_group in selected_options:
         if maybe_a_group in ("ESSENTIAL", "DEV", "ESSENTIAL_SYSTEM", "DEV_SYSTEM", "TerminalEyeCandy"):
             console.print(Panel("⚡ [bold bright_yellow]CLI APPLICATIONS[/bold bright_yellow]\n[italic]Command-line tools installation[/italic]", border_style="bright_yellow"))
@@ -129,21 +106,25 @@ def execute_installations(selected_options: list[str]) -> None:
                 console.print("✅ CLI applications installed successfully", style="bold green")
             except Exception as e:
                 console.print(f"❌ Error installing CLI applications: {e}", style="bold red")
-            run_command(". $HOME/.bashrc")
+            run_shell_script(". $HOME/.bashrc")
 
     if "upgrade_system" in selected_options:
         if system() == "Windows":
             console.print("❌ System upgrade is not applicable on Windows via this script.", style="bold red")
         elif system() == "Linux":
             console.print(Panel("🔄 [bold magenta]SYSTEM UPDATE[/bold magenta]\n[italic]Package management[/italic]", border_style="magenta"))
-            run_command("sudo nala upgrade -y")
+            run_shell_script("sudo nala upgrade -y")
         else:
             console.print(f"❌ System upgrade not supported on {system()}.", style="bold red")
     if "install_repos" in selected_options:
         console.print(Panel("🐍 [bold green]PYTHON ENVIRONMENT[/bold green]\n[italic]Virtual environment setup[/italic]", border_style="green"))
-        from machineconfig import setup_linux as module
-        script = Path(module.__file__).parent / "repos.sh"
-        run_command(f"bash {script}")
+        if system() == "Windows":
+            from machineconfig import setup_windows as module
+            script_path = Path(module.__file__).parent / "repos.ps1"
+        else:
+            from machineconfig import setup_linux as module
+            script_path = Path(module.__file__).parent / "repos.sh"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
 
     if "install_ssh_server" in selected_options:
         console.print(Panel("🔒 [bold red]SSH SERVER[/bold red]\n[italic]Remote access setup[/italic]", border_style="red"))
@@ -152,9 +133,9 @@ def execute_installations(selected_options: list[str]) -> None:
 Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
 Start-Service sshd
 Set-Service -Name sshd -StartupType 'Automatic'"""
-            run_command(f'powershell -Command "{powershell_script}"')
+            run_shell_script(f'powershell -Command "{powershell_script}"')
         else:
-            run_command("sudo nala install openssh-server -y")
+            run_shell_script("sudo nala install openssh-server -y")
 
     if "install_shell_profile" in selected_options:
         console.print(Panel("🐚 [bold green]SHELL PROFILE[/bold green]\n[italic]Shell configuration setup[/italic]", border_style="green"))
@@ -179,8 +160,8 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
                 console.print("✅ Symlinks created successfully", style="bold green")
             except Exception as e:
                 console.print(f"❌ Error creating symlinks: {e}", style="bold red")
-            run_command("sudo chmod 600 $HOME/.ssh/*")
-            run_command("sudo chmod 700 $HOME/.ssh")
+            run_shell_script("sudo chmod 600 $HOME/.ssh/*")
+            run_shell_script("sudo chmod 700 $HOME/.ssh")
         else:
             console.print("⏭️  Skipping symlink creation - finish dotfiles transfer first", style="yellow")
 
@@ -200,7 +181,10 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
             console.print(f"❌ Error retrieving backup data: {e}", style="bold red")
 
     if "install_windows_desktop" in selected_options:
-        install_windows_desktop_apps()
+        from machineconfig.jobs.installer.custom_dev.nerfont_windows_helper import install_nerd_fonts
+        install_nerd_fonts()
+        from machineconfig.setup_windows.wt_and_pwsh.set_wt_settings import main as set_wt_settings_main
+        set_wt_settings_main()
 
 
 def main() -> None:
@@ -210,7 +194,7 @@ def main() -> None:
     if not selected_options:
         console.print("❌ No options selected. Exiting...", style="bold red")
         sys.exit(0)
-    console.print(f"\n✅ Selected options: {', '.join(selected_options)}", style="bold green")
+    console.print(f"\n✅ Selected options: {'\n'.join(selected_options)}", style="bold green")
     proceed = questionary.confirm("🚀 Proceed with installation?", default=True).ask()
     if not proceed:
         console.print("❌ Installation cancelled.", style="bold red")

machineconfig/scripts/python/share_terminal.py

@@ -132,8 +132,8 @@ def main(
 #!/bin/bash
 ttyd --writable -t enableSixel=true {ssl_args} --port {port} --credential "{username}:{password}" -t 'theme={{"background": "black"}}' {start_command}
 """
-    from machineconfig.utils.code import run_script
-    run_script(code)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(code)
 
 
 def main_with_parser():

machineconfig/setup_linux/apps.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+
+
+# --GROUP:ESSENTIAL_SYSTEM:git,nano,net-utils,wget,curl,nala,nvm,nodejs
+echo "🔄 Updating apt package lists..."
+echo "📥 Installing nala package manager..."
+echo "📥 Installing essential network tools..."
+echo "📥 Installing Node Version Manager (NVM)..."
+sudo apt update -y || true
+sudo apt install nala -y || true
+sudo nala install curl wget gpg lsb-release apt-transport-https -y || true
+sudo nala install git net-tools htop nano -y || true
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+echo "🔧 Configuring NVM environment..."
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
+echo "📥 Installing latest Node.js..."
+nvm install node || true
+
+# --GROUP:TerminalEyeCandy:fortune,toilet,sl,aafire,cmatrix,hollywood,chafa
+echo "📥 Installing fortune - random wisdom generator..."
+echo "📥 Installing toilet - large ASCII text generator..."
+echo "📥 Installing sl - steam locomotive animation..."
+echo "📥 Installing aafire - ASCII art fire animation..."
+echo "📥 Installing cmatrix - Matrix-style terminal animation..."
+echo "📥 Installing hollywood - Hollywood hacker terminal effect..."
+echo "📥 Installing chafa - terminal image viewer..."
+sudo nala install cowsay -y || true
+sudo nala install lolcat -y || true
+sudo nala install boxes -y || true
+sudo nala install figlet -y || true
+sudo nala install fortune -y || true
+sudo nala install toilet -y || true
+sudo nala install chafa -y
+sudo nala install sl -y || true
+sudo nala install libaa-bin -y
+echo 'keyboard-configuration keyboard-configuration/layout select US English' | sudo debconf-set-selections
+echo 'keyboard-configuration keyboard-configuration/layoutcode string us' | sudo debconf-set-selections
+sudo DEBIAN_FRONTEND=noninteractive nala install -y cmatrix
+sudo nala install hollywood -y || true
+
+# --GROUP:NetworkTools: sshfs,samba,fuse3,nfs-common
+echo "📥 Installing sshfs - mount remote filesystems over SSH..."
+echo "📥 Installing Samba - LAN-based file sharing..."
+sudo nala install sshfs
+sudo nala install samba
+sudo nala install fuse3 -y || true
+sudo nala install nfs-common -y || true
+
+# --GROUP:DEV_SYSTEM: graphviz,make,rust,libssl-dev,sqlite3,postgresql-client,redis-tools
+echo "📥 Installing Graphviz - graph visualization software..."
+echo "📥 Installing make - build automation tool..."
+echo "📥 Installing SSL development libraries for Rust..."
+echo "📥 Installing Rust programming language and toolchain..."
+sudo nala install graphviz -y || true
+sudo nala install ffmpeg -y || true  # Required by some dev tools
+sudo nala install make -y || true  # Required by LunarVim and SpaceVim
+(curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh) || true
+sudo nala install libssl-dev -y
+
+
+# --GROUP:DATABASES: sqlite3,postgresql-client,redis-tools
+echo "📥 Installing SQLite - lightweight SQL database..."
+echo "📥 Installing PostgreSQL client..."
+echo "📥 Installing Redis command-line tools..."
+sudo nala install sqlite3 -y || true
+sudo nala install postgresql-client -y || true
+sudo nala install redis-tools -y || true

machineconfig/setup_linux/apps_desktop.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/bash
+#=======================================================================
+# 🖥️ DESKTOP APPLICATIONS INSTALLATION SCRIPT
+#=======================================================================
+# This script installs desktop applications for a Linux workstation
+
+echo """#=======================================================================
+🌐 WEB BROWSERS | Installing browser applications
+#=======================================================================
+"""
+# Google Chrome installation (commented reference)
+# echo "📥 Installing Google Chrome..."
+# wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
+# sudo dpkg -i google-chrome-stable_current_amd64.deb
+
+echo """#=======================================================================
+📝 TEXT EDITORS | Installing Neovim editor
+#=======================================================================
+"""
+echo "📥 Installing Neovim via Homebrew..."
+/home/linuxbrew/.linuxbrew/bin/brew install neovim
+
+echo """#=======================================================================
+📧 EMAIL CLIENT | Installing Thunderbird
+#=======================================================================
+"""
+echo "📥 Installing Thunderbird via Flatpak..."
+flatpak install flathub org.mozilla.Thunderbird
+
+echo """#=======================================================================
+🖲️ TERMINAL EMULATOR | Installing WezTerm
+#=======================================================================
+"""
+echo "📥 Installing WezTerm via Flatpak..."
+flatpak install flathub org.wezfurlong.wezterm
+echo "🚀 Launching WezTerm..."
+flatpak run org.wezfurlong.wezterm
+
+echo """#=======================================================================
+✏️ SCREEN ANNOTATION | Installing Gromit-MPX
+#=======================================================================
+"""
+echo "📥 Installing Gromit-MPX via Flatpak..."
+flatpak install net.christianbeier.Gromit-MPX
+
+echo """#=======================================================================
+📋 CLIPBOARD MANAGERS | Installing CopyQ
+#=======================================================================
+"""
+echo "📥 Installing CopyQ via Flatpak..."
+flatpak install flathub com.github.hluk.copyq --noninteractive
+
+echo """#=======================================================================
+🔗 REMOTE DESKTOP | Installing Remmina
+#=======================================================================
+"""
+echo "📥 Installing Remmina and RDP plugin..."
+sudo nala install remmina remmina-plugin-rdp -y
+
+# Alternative Remmina installation via flatpak (reference)
+# echo "📥 Setting up Flatpak repositories..."
+# flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+# flatpak install org.freedesktop.Platform
+# flatpak install org.freedesktop.Platform.openh264
+# flatpak install --user flathub org.remmina.Remmina
+# flatpak run --user org.remmina.Remmina
+
+echo """#=======================================================================
+🚀 APPLICATION LAUNCHER | Installing Rofi
+#=======================================================================
+"""
+echo "📥 Installing Rofi application launcher..."
+sudo nala install rofi -y
+
+echo """#=======================================================================
+📎 CLIPBOARD HISTORY | Installing Greenclip
+#=======================================================================
+"""
+# Session type detection (reference)
+# session_type=$(echo $XDG_SESSION_TYPE)
+# if [ "$session_type" == "x11" ]; then
+#     echo "Detected X11 session. Installing X11-related packages and tools..."
+#     sudo nala install xdotool xsel xclip -y
+# elif [ "$session_type" == "wayland" ]; then
+#     echo "Detected Wayland session. Installing Wayland-related packages and tools..."
+#     sudo nala install wl-copy wtype -y
+# else
+#     echo "Unknown session type: $session_type"
+#     exit 1
+# fi
+
+echo "📥 Downloading and installing Greenclip clipboard manager..."
+wget -P ~/Downloads https://github.com/erebe/greenclip/releases/download/v4.2/greenclip
+chmod +x ~/Downloads/greenclip
+sudo mv ~/Downloads/greenclip /usr/bin/
+
+echo "ℹ️ Usage instructions:"
+echo "- Start daemon: greenclip daemon &"
+echo "- With Rofi: rofi -modi \"clipboard:greenclip print\" -show clipboard -run-command '{cmd}'"
+echo "- For emoji picker: rofi -modi \"emoji:rofimoji\" -show emoji"
+echo "- Application launcher: rofi -show drun"
+
+echo """#=======================================================================
+🔄 APPLICATION LINKING | Linking applications to user space
+#=======================================================================
+"""
+echo "🔗 Creating application symlinks..."
+ln -s /home/$USER/.nix-profile/share/applications/* /home/$USER/.local/share/applications/
+
+echo """#=======================================================================
+✅ INSTALLATION COMPLETE | Desktop applications have been installed
+#=======================================================================
+"""

machineconfig/setup_linux/apps_gui.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+#=======================================================================
+# 🖥️ GUI APPLICATIONS AND DESKTOP ENVIRONMENT SETUP SCRIPT
+#=======================================================================
+# This script installs graphical user interfaces and desktop environments
+
+echo """#=======================================================================
+📦 INSTALLING GUI COMPONENTS | Setting up desktop environment
+#=======================================================================
+"""
+
+# echo "📥 Installing Nautilus file manager..."
+# sudo nala install nautilus -y  # 📂 graphical file manager
+# sudo nala install x11-apps  # 🎨 few graphical test apps like xeyes
+
+echo "📥 Installing XRDP - Remote Desktop Protocol server..."
+sudo nala install xrdp -y  # 🔌 remote desktop protocol
+
+# echo "📥 Installing X.Org server and components..."
+# sudo nala install xorg -y  # 🎯 xorg server
+# sudo nala install xinit -y  # 🚀 xorg init
+# sudo nala install xserver-xorg -y  # 🖼️ xorg server
+
+echo "📥 Installing XFCE4 desktop environment..."
+sudo nala install xfce4 -y  # 🏠 xfce4 desktop environment
+
+echo "📥 Installing XFCE4 additional components..."
+sudo nala install xfce4-goodies -y  # ✨ xfce4 desktop environment extras
+
+echo """#=======================================================================
+🔧 CONFIGURING XRDP | Setting up Remote Desktop service
+#=======================================================================
+"""
+
+# Back up original configuration
+echo "📄 Creating backup of XRDP configuration..."
+sudo cp /etc/xrdp/xrdp.ini /etc/xrdp/xrdp.ini.bak
+
+# Change default port to avoid conflict with Windows RDP
+echo "🔢 Changing XRDP port to 3391..."
+sudo sed -i 's/3389/3391/g' /etc/xrdp/xrdp.ini
+
+# Configure color depth and display settings
+echo "🎨 Configuring display quality settings..."
+sudo sed -i 's/max_bpp=32/#max_bpp=32\nmax_bpp=128/g' /etc/xrdp/xrdp.ini
+sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.ini
+
+# Set default session
+echo "🖥️ Setting up default XFCE4 session..."
+echo xfce4-session > ~/.xsession
+
+# Configure startup window manager
+echo "🚀 Configuring window manager startup..."
+sudo sed -i 's/test/#test/g' /etc/xrdp/startwm.sh
+sudo sed -i 's/exec/#exec/g' /etc/xrdp/startwm.sh
+echo "startxfce4" | sudo tee -a /etc/xrdp/startwm.sh
+
+echo """#=======================================================================
+🚀 STARTING SERVICES | Initializing XRDP service
+#=======================================================================
+"""
+
+echo "🔄 Starting XRDP service..."
+sudo /etc/init.d/xrdp start
+
+echo """#=======================================================================
+✅ SETUP COMPLETE | GUI environment has been configured
+#=======================================================================
+"""
+echo "ℹ️ Connect to this machine via Remote Desktop using port 3391"
+# Alternative commands:
+# sudo systemctl restart xrdp
+# sudo service xrdp restart
+

machineconfig/setup_linux/openssh_all.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/bash
+# 🔐 OpenSSH Server Setup and Configuration
+
+# Common pitfalls: 
+# 🚫 Wrong line endings (LF/CRLF) in config files
+# 🌐 Network port conflicts (try 2222 -> 2223) between WSL and Windows
+
+# 📁 Setup SSH directory and permissions
+mkdir -p ~/.ssh
+echo $pubkey_string >> ~/.ssh/authorized_keys
+sudo chmod 600 ~/.ssh/*
+sudo chmod 700 ~/.ssh
+echo "✅ FINISHED modifying .ssh folder attributes."
+
+# 🔄 Clean install OpenSSH server
+sudo nala purge openssh-server -y
+sudo nala install openssh-server -y
+echo "✅ FINISHED installing openssh-server."
+
+# 📝 Additional commands if needed:
+# sudo service ssh status
+# sudo nano /etc/ssh/sshd_config
+# sudo service ssh restart
+# For tunnels see: https://www.youtube.com/watch?v=Wp7boqm3Xts

machineconfig/setup_linux/openssh_wsl.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/bash
+# 🐧 WSL2 SSH Configuration for LAN Access 🌐
+# Purpose: Enable SSH access to WSL2 from LAN (requires wsl_server.ps1 in Windows)
+# Common pitfall: sshd fails after config changes due to wrong line endings/permissions
+
+# 🔍 Check if running in WSL
+if [[ $(uname -a) == *"icrosoft"* ]]; then
+  echo "✅ Running inside WSL"
+else
+  echo "❌ Not running inside WSL, no need for this script"
+  exit 0
+fi
+
+# 🔢 Set SSH port
+if [ -z "$port" ]; then
+  port=2222
+  echo "📝 Port variable not defined, setting it to $port"
+fi
+
+# 🛠️ Configure SSH
+sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
+sudo sed -i 's/#Port 22/Port '$port'/g' /etc/ssh/sshd_config
+sudo sed -i 's/#ListenAddress 0.0.0.0/ListenAddress 0.0.0.0/g' /etc/ssh/sshd_config
+sudo sed -i 's/#PubkeyAuthentication yes/PubkeyAuthentication yes/g' /etc/ssh/sshd_config
+sudo sed -i 's/PasswordAuthentication no/PasswordAuthentication yes/g' /etc/ssh/sshd_config
+
+# 🔑 Generate host keys and restart service
+sudo service ssh start
+sudo ssh-keygen -A
+sudo service ssh --full-restart
+sudo service ssh status
+
+echo "✨ FINISHED configuring SSH in WSL2."
+
+# 📚 References:
+# Service startup: https://superuser.com/questions/1701853/how-to-enable-a-service-to-start-with-wsl2
+# WSL config: https://learn.microsoft.com/en-us/windows/wsl/networking#accessing-a-wsl-2-distribution-from-your-local-area-network-lan
+

machineconfig/setup_linux/repos.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/bash
+
+
+echo """
+#=======================================================================
+🔄 REPOSITORIES SETUP | Cloning project codebases
+#=======================================================================
+"""
+
+echo """📥 Setting up repositories...
+   🐊 crocodile     - Main utility package
+   🔧 machineconfig - System configuration tools
+"""
+
+mkdir -p $HOME/code
+cd $HOME/code
+# Setup crocodile repository
+if [ -d "crocodile" ]; then
+    echo """🔄 crocodile directory exists, updating...
+    """
+    cd crocodile
+    git reset --hard
+    git pull
+    cd ..
+else
+    echo """⏳ Cloning crocodile repository...
+    """
+    git clone https://github.com/thisismygitrepo/crocodile.git --depth 4
+fi
+
+# Setup machineconfig repository
+cd $HOME/code
+if [ -d "machineconfig" ]; then
+    echo """🔄 machineconfig directory exists, updating...
+    """
+    cd machineconfig
+    git reset --hard
+    git pull
+    cd ..
+else
+    echo """⏳ Cloning machineconfig repository...
+    """
+    git clone https://github.com/thisismygitrepo/machineconfig --depth 4  # Choose browser-based authentication.
+fi
+
+cd $HOME/code/machineconfig
+$HOME/.local/bin/uv sync --no-dev
+$HOME/.local/bin/uv cache clean

machineconfig/setup_linux/ve.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/bash
+
+if [ ! -f "$HOME/.local/bin/uv" ]; then
+    echo """📦 uv binary not found
+   ⏳ Installing uv package manager..."""
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+else
+    echo """🔄 Updating uv package manager..."""
+    $HOME/.local/bin/uv self update
+fi
+# Add uv to PATH if not already there
+if ! command -v uv &> /dev/null; then
+    echo """🔍 uv command not found in PATH
+   ➕ Adding uv to system PATH...
+"""
+    export PATH="$HOME/.local/bin:$PATH"
+fi
+echo """✅ uv is installed and ready to use."""
+
+$HOME/.local/bin/uv python install 3.13

machineconfig/setup_windows/apps.ps1

@@ -0,0 +1,61 @@
+
+# to get exact version of an app in winget, head to: https://winget.run
+
+# --GROUP:ESSENTIAL_SYSTEM:WT+Brave+VSCode+WezTerm+OhMyPosh+Powershell+Starship+Git+Neovim+GNU Nano+Terminal-Icons+PSFzf
+winget install --no-upgrade --name "Windows Terminal"             --Id "Microsoft.WindowsTerminal"  --source winget --scope user --accept-package-agreements --accept-source-agreements  # Terminal is is installed by default on W 11
+winget install --no-upgrade --name "Brave"                        --Id "Brave.Brave"                --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Microsoft Visual Studio Code" --Id "Microsoft.VisualStudioCode" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "WezTerm"                      --Id "wez.wezterm"                --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Oh My Posh"                   --Id "JanDeDobbeleer.OhMyPosh"    --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Powershell"                   --Id "Microsoft.PowerShell"       --source winget --scope user --accept-package-agreements --accept-source-agreements  # powershell require admin
+winget install --no-upgrade --name "Starship"                     --Id "Starship.Starship"          --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Git"                          --Id "Git.Git"                    --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Neovim"                       --Id "Neovim.Neovim"              --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "GNU Nano"                     --Id "GNU.Nano"                   --source winget --scope user --accept-package-agreements --accept-source-agreements
+Install-Module -Name Terminal-Icons -Repository PSGallery -Force -AcceptLicense -PassThru -Confirm  # -RequiredVersion 2.5.10
+Install-Module -Name PSFzf  -SkipPublisherCheck  # -AcceptLicense -PassThru -Confirm  #  -RequiredVersion 2.5.10
+
+
+# --GROUP:DEV_SYSTEM:VSRedistrib+VSBuildTools+Codeblocks+GnuWin32: Make+GnuPG+graphviz+WinFsp+SSHFS-win+xming+Node.js+Rustup+Cloudflare+Cloudflare WARP+Microsoft Garage Mouse without Borders
+winget install --no-upgrade --name "VSRedistrib"                   --Id "Microsoft.VC++2015-2022Redist-x64"      --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "VSBuildTools"                  --Id "Microsoft.VisualStudio.2022.BuildTools" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Codeblocks"                    --Id "Codeblocks.Codeblocks"                  --source winget --scope user --accept-package-agreements --accept-source-agreements  # IDE for C/C++
+winget install --no-upgrade --name "GnuWin32: Make"                --Id "GnuWin32.Make"                          --source winget --scope user --accept-package-agreements --accept-source-agreements  # required for building some python packages with native extensions, like dlib
+winget install --no-upgrade --name "GnuPG"                         --Id "GnuPG.GnuPG"                            --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "graphviz"                      --Id "Graphviz.Graphviz"                      --source winget --scope user --accept-package-agreements --accept-source-agreements  # required by pygraphviz. Used in Base.viz_object_hirarchy and Model.plot_model()
+winget install --no-upgrade --name "WinFsp"                        --Id "WinFsp.WinFsp"                          --source winget --scope user --accept-package-agreements --accept-source-agreements  # mount remote filesystems and required by rclone
+winget install --no-upgrade --name "SSHFS-win"                     --Id "SSHFS-Win.SSHFS-Win"                    --source winget --scope user --accept-package-agreements --accept-source-agreements  # mount remote filesystems  # as per https://github.com/winfsp/sshfs-win
+winget install --no-upgrade --name "xming"                         --Id "xming.xming"                            --source winget --scope user --accept-package-agreements --accept-source-agreements  # X11 server. you need this while using wsl with gui, otherwise plt.show() returns: ImportError: Cannot load backend 'TkAgg' which requires the 'tk' interactive framework, as 'headless' is currently running
+winget install --no-upgrade --name "Node.js"                       --Id "OpenJS.NodeJS"                          --source winget --scope user --accept-package-agreements --accept-source-agreements  # ncessary for nvim plugins.
+winget install --no-upgrade --name "Rustup"                        --Id "Rustlang.Rustup"                        --source winget --scope user --accept-package-agreements --accept-source-agreements  # rust compiler, necessary for some nvim plugins
+winget install --no-upgrade --name "Cloudflare"                    --Id "Cloudflare.cloudflared"                 --source winget --scope user --accept-package-agreements --accept-source-agreements  # cloudflare tunnel client, alternative to ngrok
+winget install --no-upgrade --name "Cloudflare WARP"               --Id "Cloudflare.Warp"                        --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Microsoft Garage Mouse without Borders" --Id "Microsoft.MouseWithoutBorders" --source winget --scope user --accept-package-agreements --accept-source-agreements
+
+
+# --GROUP:OTHER_WINDOWS:nu+Chrome+ChromeRemoteDesktop+Zoom+7zip+Firefox+Thunderbird+StreamlabsOBS+OBSStudio+MiKTeX+TexMaker+notepad+++Lapce+TesseractOCR+perl+DB Browser for SQLite+sql server management studio+Adobe Acrobat Reader DC+julia+Chafa+bottom+onefetch+Just+hyperfine+AWS CLI
+winget install --no-upgrade --name "nu"                                 --Id "Nushell.Nushell"                   --source winget --scope user --accept-package-agreements --accept-source-agreements  # add to userpath C:\Program Files\nu\bin, done in symlinks
+winget install --no-upgrade --name "Google Chrome"                      --Id "Google.Chrome"                     --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Chrome Remote Desktop Host"         --Id "Google.ChromeRemoteDesktop"        --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Zoom"                               --Id "Zoom.Zoom"                         --source winget    --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "7-zip"                              --Id "7zip.7zip"                         --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Mozilla Firefox"                    --Id "Mozilla.Firefox" --source winget   --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Mozilla Thunderbird (en-US)"        --Id "Mozilla.Thunderbird"               --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "StreamlabsOBS"                      --Id "Streamlabs.StreamlabsOBS"          --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "OBSStudio"                          --Id "OBSProject.OBSStudio"              --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "MiKTeX"                             --Id "MiKTeX.MiKTeX"                     --source winget   --scope user  # library / lanugage
+winget install --no-upgrade --name "TexMaker"                           --Id "Texmaker.Texmaker"                 --source winget --scope user  # IDE better than simple TexWorks shipped with MikTex. IDE is basically GUI for cmd interface of Tex
+winget install --no-upgrade --name "notepad++"                          --Id "Notepad++.Notepad++"               --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Lapce"                              --Id "Lapce.Lapce"                       --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "TesseractOCR"                       --Id "UB-Mannheim.TesseractOCR"          --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "perl"                               --Id "StrawbgnogerryPerl.StrawberryPerl"     --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "DB Browser for SQLite"              --Id "DBBrowserForSQLite.DBBrowserForSQLite" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "sql server management studio"       --Id "Microsoft.SQLServerManagementStudio"   --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Adobe Acrobat Reader DC"            --Id "Adobe.Acrobat.Reader.64-bit"       --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "julia"                               --Id "Julialang.Julia" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "Chafa"                               --Id "hpjansson.Chafa" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "bottom"                              --Id "Clement.bottom" --source winget --scope user --accept-package-agreements --accept-source-agreements
+winget install --no-upgrade --name "onefetch"                            --Id "o2sh.onefetch" --source winget --scope user  # repo-version of system fastfetch, see also tokei
+winget install --no-upgrade --name "Just"                               --Id "Casey.Just" --source winget --scope user  # commandline runner
+winget install --no-upgrade --name "hyperfine"                          --Id "sharkdp.hyperfine" --source winget --scope user  # benchmarking tool
+winget install --no-upgrade --name "AWS Command Line Interface"         --Id "Amazon.AWSCLI" --source winget --scope user --accept-package-agreements --accept-source-agreements

machineconfig/setup_windows/openssh-server.ps1

@@ -0,0 +1,39 @@
+
+$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/openssh-server_add-sshkey.ps1

@@ -0,0 +1,32 @@
+
+# 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/openssh-server_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/openssh_all.ps1

@@ -0,0 +1,22 @@
+
+# install server (sshd).
+Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/openssh-server.ps1 | Invoke-Expression
+
+if (!$pubkey_string) {
+    $pubkey_url = 'https://github.com/thisismygitrepo.keys'  # (CHANGE APPROPRIATELY)
+    $pubkey_string = (Invoke-WebRequest $pubkey_url).Content
+} else {
+    Write-Output "pubkey_string is already defined."
+}
+
+cd ~
+echo $null >> .ssh/authorized_keys  # powershell way of touching a file if it doesn't exist
+echo $pubkey_string >> .ssh/authorized_keys
+echo $pubkey_string > .ssh/pubkey.pub
+Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/openssh-server_add-sshkey.ps1 | Invoke-Expression
+
+ipconfig.exe
+
+echo "Done"
+echo "USE: ssh $env:USERNAME@$env:COMPUTERNAME -p 22"
+

machineconfig/setup_windows/quirks.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/repos.ps1

@@ -0,0 +1,39 @@
+
+cd ~
+mkdir code -ErrorAction SilentlyContinue
+cd ~\code
+
+
+if (-not (Get-Command git.exe -ErrorAction SilentlyContinue)) {
+    winget install --no-upgrade --name "Git" --Id Git.Git --source winget --accept-package-agreements --accept-source-agreements --scope user
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+}
+
+# Setup crocodile repository
+if (Test-Path "crocodile") {
+    Write-Host "🔄 crocodile directory exists, updating..."
+    Set-Location crocodile
+    git reset --hard
+    git pull
+    Set-Location ..
+} else {
+    Write-Host "⏳ Cloning crocodile repository..."
+    git clone https://github.com/thisismygitrepo/crocodile.git --depth 4
+}
+
+# Setup machineconfig repository
+if (Test-Path "machineconfig") {
+    Write-Host "🔄 machineconfig directory exists, updating..."
+    Set-Location machineconfig
+    git reset --hard
+    git pull
+    Set-Location ..
+} else {
+    Write-Host "⏳ Cloning machineconfig repository..."
+    git clone https://github.com/thisismygitrepo/machineconfig --depth 4  # Choose browser-based authentication.
+}
+
+
+cd $HOME\code\machineconfig
+& "$HOME\.local\bin\uv.exe" sync --no-dev
+echo "Finished setting up repos"

machineconfig/setup_windows/symlinks.ps1

@@ -0,0 +1,5 @@
+
+
+. $HOME\code\machineconfig\.venv\Scripts\activate.ps1
+python -m fire machineconfig.profile.create main --choice=all
+deactivate

machineconfig/setup_windows/symlinks2linux.ps1

@@ -0,0 +1 @@
+

machineconfig/setup_windows/ve.ps1

@@ -0,0 +1,11 @@
+
+
+if (-not (Test-Path -Path "$HOME\.local\bin\uv.exe")) {
+    Write-Output "uv binary not found, installing..."
+    irm https://astral.sh/uv/install.ps1 | iex
+} else {
+    Write-Output "uv binary found, updating..."
+    & "$HOME\.local\bin\uv.exe" self update
+}
+
+& "$HOME\.local\bin\uv.exe" python install 3.13

machineconfig/setup_windows/web_shortcuts/interactive.ps1

@@ -10,3 +10,4 @@ Invoke-WebRequest -Uri "https://raw.githubusercontent.com/thisismygitrepo/machin
 rm ve.ps1
 
 uv run --python 3.13 --with machineconfig devops interactive
+# uv run --python 3.13 --with machineconfig https://raw.githubusercontent.com/thisismygitrepo/machineconfig/ee4f69e838e1acbb275bfb5a3d3faee23345f2a8/src/machineconfig/scripts/python/devops.py

machineconfig/setup_windows/wsl_refresh.ps1

@@ -0,0 +1,8 @@
+
+Write-Host "Currently, there is: "
+wsl -l -v
+wsl --unregister Ubuntu-22.04
+Write-Host "You can install ... "
+wsl --list --online
+wsl --install -d Ubuntu-22.04
+#  winget install Canonical.Ubuntu.2004 --source winget

machineconfig/setup_windows/wt_and_pwsh.ps1

@@ -0,0 +1,9 @@
+
+# apps
+winget install --no-upgrade --name "Windows Terminal" --Id "Microsoft.WindowsTerminal" --source winget --scope user  # Terminal is is installed by default on W 11
+winget install --no-upgrade --name "Powershell" --Id "Microsoft.PowerShell" --source winget --scope user  # powershell require admin
+
+. $HOME\code\machineconfig\.venv\Scripts\activate.ps1
+python -m fire machineconfig.setup_windows.wt_and_pwsh.install_nerd_fonts main
+python -m fire machineconfig.setup_windows.wt_and_pwsh.set_wt_settings main
+deactivate

machineconfig/utils/code.py

@@ -98,7 +98,7 @@ def print_code(code: str, lexer: str, desc: str, subtitle: str = ""):
     console.print(Panel(Syntax(code=code, lexer=lexer), title=f"📄 {desc}", subtitle=subtitle), style="bold red")
 
 
-def run_script(program: str):
+def run_shell_script(program: str):
     import tempfile
     if platform.system() == "Windows":
         suffix = ".ps1"

machineconfig/utils/files/headers.py

@@ -6,21 +6,28 @@ import random
 from pathlib import Path
 from rich import pretty
 from rich.console import Console
-from rich.text import Text
 from typing import Optional
 
 
 def print_header():
     console = Console()
     pretty.install()
-    _header = f"🐍 Python {platform.python_version()} in VE `{os.getenv('VIRTUAL_ENV')}` On {platform.system()} 🐍"
-    _header = Text(_header)
-    _header.stylize("bold blue")
-    console.rule(_header, style="bold red", align="center")
-    version = "14.5"
-    _ = Text(f"✨ 🐊 Crocodile Shell {version} ✨" + f" Made with 🐍 | Built with ❤️. Running @ {Path.cwd()}")
-    _.stylize("#05f8fc on #293536")
-    console.print(_)
+
+    # Environment Information Panel
+    from rich.panel import Panel
+    from rich.table import Table
+
+    table = Table(show_header=False, show_edge=False, pad_edge=False)
+    table.add_column("Label", style="cyan", no_wrap=True)
+    table.add_column("Value", style="white")
+
+    table.add_row("Python Version", platform.python_version())
+    table.add_row("Operating System", platform.system())
+    table.add_row("Virtual Environment", os.getenv('VIRTUAL_ENV', 'None'))
+    table.add_row("Running @", str(Path.cwd()))
+
+
+    console.print(Panel(table, title="[bold blue]✨ 🐊 Crocodile Shell 14.5 ✨ Made with 🐍 | Built with ❤️[/bold blue]", border_style="blue"))
 def print_logo(logo: str):
     from machineconfig.utils.files.ascii_art import font_box_color, character_color, character_or_box_color
     if platform.system() == "Windows":

machineconfig/utils/installer_utils/installer.py

@@ -125,12 +125,12 @@ def install_group(package_group: PACKAGE_GROUPS):
     else:
         options_system = get_installers_system_groups()
         from machineconfig.utils.schemas.installer.installer_types import get_normalized_arch, get_os_name
-        from machineconfig.utils.code import run_script
+        from machineconfig.utils.code import run_shell_script
         for an_item in options_system:
             if an_item["appName"] == package_group:
                 program = an_item["fileNamePattern"][get_normalized_arch()][get_os_name()]
                 if program is not None:
-                    run_script(program)
+                    run_shell_script(program)
                     break
 
 

machineconfig/utils/terminal.py

@@ -147,7 +147,7 @@ class Terminal:
             return os.getuid() == 0  # Check for root on Posix
 '''
 
-    # def run_script(self, script: str, shell: SHELLS = "default", verbose: bool = False):
+    # def run_shell_script(self, script: str, shell: SHELLS = "default", verbose: bool = False):
     #     if self.machine == "Linux":
     #         script = "#!/bin/bash" + "\n" + script  # `source` is only available in bash.
     #     script_file = PathExtended.tmpfile(name="tmp_shell_script", suffix=".ps1" if self.machine == "Windows" else ".sh", folder="tmp_scripts")

{machineconfig-5.14.dist-info → machineconfig-5.16.dist-info}/METADATA

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

{machineconfig-5.14.dist-info → machineconfig-5.16.dist-info}/RECORD

@@ -143,8 +143,8 @@ machineconfig/scripts/python/cloud_mount.py,sha256=GwcXbd5ohoHGESfX5edtCEl2-umDD
 machineconfig/scripts/python/cloud_repo_sync.py,sha256=8dnlHbQqRymPRU0v01pNIuaIvFeY4fReP7ewNSSCt34,9765
 machineconfig/scripts/python/cloud_sync.py,sha256=RWGpAfJ9fnN18yNBSgN44dzA38Hmd4879JL5r2pcyrM,3514
 machineconfig/scripts/python/count_lines.py,sha256=ZexMRsV70pe9fhLbGuens9EP5gCf078EwTDRHRZo5A0,15960
-machineconfig/scripts/python/count_lines_frontend.py,sha256=tqUiJggHC8_uy5ZV81i_ycxM1x0j-2nJin3e3FJqLXs,521
-machineconfig/scripts/python/croshell.py,sha256=ggLy1X45Dqo8AV8qUY2-O74r7yQNc9nnRhzt8RisMX8,6535
+machineconfig/scripts/python/count_lines_frontend.py,sha256=bIha5lKjWxKiO1OJAbt9gKzVyECXFbWKWIy69bdyaJg,533
+machineconfig/scripts/python/croshell.py,sha256=zHUhOqWG81AOTeawZoDkpURnV1fAisY2lyZ0apvlmVY,6547
 machineconfig/scripts/python/devops.py,sha256=JB4_M6S-nO3yqas8wtAlU2r6jsmHu_nlq7aoEOH-54Y,3486
 machineconfig/scripts/python/devops_add_identity.py,sha256=wvjNgqsLmqD2SxbNCW_usqfp0LI-TDvcJJKGOWt2oFw,3775
 machineconfig/scripts/python/devops_add_ssh_key.py,sha256=BXB-9RvuSZO0YTbnM2azeABW2ngLW4SKhhAGAieMzfw,6873
@@ -155,14 +155,14 @@ machineconfig/scripts/python/fire_agents_help_launch.py,sha256=1ymWiszfjCyPv3ofi
 machineconfig/scripts/python/fire_agents_help_search.py,sha256=qIfSS_su2YJ1Gb0_lu4cbjlJlYMBw0v52NTGiSrGjk8,2991
 machineconfig/scripts/python/fire_agents_helper_types.py,sha256=zKu8Vr6iucaGSkCm_Tkt_WrYU7-6Nript3coYyzTXzY,295
 machineconfig/scripts/python/fire_agents_load_balancer.py,sha256=mpqx3uaQdBXYieuvhdK-qsvLepf9oIMo3pwPj9mSEDI,1079
-machineconfig/scripts/python/fire_jobs.py,sha256=Mg7M6pm3PvyJlnMGYas8hEVYLIJYiyy-pBiRWCGLFjQ,15895
+machineconfig/scripts/python/fire_jobs.py,sha256=VIZZOjnE0u1g7U1jmYN3YUTFsLt8MM4_z67U951oEm4,15907
 machineconfig/scripts/python/fire_jobs_args_helper.py,sha256=-gl5I-26Op12nToIpAA-YEpvn8MMkNlI5XjhUbj50I0,4273
 machineconfig/scripts/python/fire_jobs_route_helper.py,sha256=EFWsg6F9TeSAtYQec57WtPopUbm2euGZTUZv6J4RhNE,3026
 machineconfig/scripts/python/fire_jobs_streamlit_helper.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/scripts/python/ftpx.py,sha256=QfQTp-6jQP6yxfbLc5sKxiMtTgAgc8sjN7d17_uLiZc,9400
 machineconfig/scripts/python/get_zellij_cmd.py,sha256=e35-18hoXM9N3PFbvbizfkNY_-63iMicieWE3TbGcCQ,576
 machineconfig/scripts/python/gh_models.py,sha256=3BLfW25mBRiPO5VKtVm-nMlKLv-PaZDw7mObajq6F6M,5538
-machineconfig/scripts/python/interactive.py,sha256=wjxwxU5KtCh8MgujCQjEQctZPpKfPc71lMVFLhODQFE,11769
+machineconfig/scripts/python/interactive.py,sha256=gxAaVasW37TbSPswiyli-ImNQLU8jQbCb6Csnk5Igdg,11188
 machineconfig/scripts/python/mount_nfs.py,sha256=aECrL64j9g-9rF49sVJAjGmzaoGgcMnl3g9v17kQF4c,3239
 machineconfig/scripts/python/mount_nw_drive.py,sha256=iru6AtnTyvyuk6WxlK5R4lDkuliVpPV5_uBTVVhXtjQ,1550
 machineconfig/scripts/python/mount_ssh.py,sha256=k2fKq3f5dKq_7anrFOlqvJoI_3U4EWNHLRZ1o3Lsy6M,2268
@@ -176,7 +176,7 @@ machineconfig/scripts/python/repos_helper_record.py,sha256=dtnnInQPn00u1cyr0oOgJ
 machineconfig/scripts/python/repos_helper_update.py,sha256=AYyKIB7eQ48yoYmFjydIhRI1lV39TBv_S4_LCa-oKuQ,11042
 machineconfig/scripts/python/scheduler.py,sha256=rKhssuxkD697EY6qaV6CSdNhxpAQLDWO4fE8GMCQ9FA,3061
 machineconfig/scripts/python/sessions.py,sha256=e8gL0fVWOZ5WcJsA3ZWfqJBc5c7g-rMlVf0SF63rIaU,8547
-machineconfig/scripts/python/share_terminal.py,sha256=pqKnly6QRtcPmw0lLyRN6NRuK2bntM1hOdqQfw5jJnc,5324
+machineconfig/scripts/python/share_terminal.py,sha256=D9zwPZk4cV2ix5f-fHDfp0awtMsI5C5ANlfv1vW-VKE,5336
 machineconfig/scripts/python/snapshot.py,sha256=aDvKeoniZaeTSNv9zWBUajaj2yagAxVdfuvO1_tgq5Y,1026
 machineconfig/scripts/python/start_slidev.py,sha256=FAJ1_WkAQ7KcbRZ3cSN_72NDgV_flRrwxmXv1imyulI,4897
 machineconfig/scripts/python/start_terminals.py,sha256=DRWbMZumhPmL0DvvsCsbRNFL5AVQn1SgaziafTio3YQ,6149
@@ -357,6 +357,13 @@ machineconfig/settings/zellij/layouts/st.kdl,sha256=QXLRK7Wx05aKbKRHVmm4RspLYzPm
 machineconfig/settings/zellij/layouts/st2.kdl,sha256=1FKTH3qQWYMWp_wPMreP7fKOTlVd4cfBy3J8fv4zCBc,1489
 machineconfig/settings/zellij/layouts/stacked_panes.kdl,sha256=usY8kKKwX1KUMXnWDivPg0i0drpM1Biw-tOnNZVjiZU,163
 machineconfig/setup_linux/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+machineconfig/setup_linux/apps.sh,sha256=0PdPojpj2B-wOxE6ryvguKwBvL6vEt-43A1NdnwJumM,3198
+machineconfig/setup_linux/apps_desktop.sh,sha256=nBt_24tbdgKYK68w15ZiktgcEEJ7ytLoPWIrDluTkIQ,5077
+machineconfig/setup_linux/apps_gui.sh,sha256=ufsCqmShc8G3XyKBmchD1tJ85FZYjSDY2yiE_0Rl7v4,3031
+machineconfig/setup_linux/openssh_all.sh,sha256=11eguvmuF3zM4lPIdI9TLnNHivmylBnrqz8KCP1AJJA,756
+machineconfig/setup_linux/openssh_wsl.sh,sha256=1eeRGrloVB34K5z8yWVUMG5b9pV-WBfHgV9jqXiYgCQ,1398
+machineconfig/setup_linux/repos.sh,sha256=kPBhhBmUAgB_9xwBQGyoL6_m0E4mlonnSqTEzi2gH9Q,1215
+machineconfig/setup_linux/ve.sh,sha256=yHxDzRoiAkEmLvUHNHUZksyOWpwiirLJruM_tgsuwYs,579
 machineconfig/setup_linux/nix/cli_installation.sh,sha256=AQ_wRmldeD1tPqCmU7qgz9ZrZFly4OYwBJDGRpb9IJ0,5470
 machineconfig/setup_linux/others/mint_keyboard_shortcuts.sh,sha256=F5dbg0n9RHsKGPn8fIdZMn3p0RrHEkb8rWBGsdVGbus,1207
 machineconfig/setup_linux/others/openssh-server_add_pub_key.sh,sha256=UiJcD1o4UekKKtp5YJKRq135PpqdTLXy7M6HvQ-Qum4,1993
@@ -365,18 +372,30 @@ machineconfig/setup_linux/web_shortcuts/croshell.sh,sha256=X9-B1cVptbaFWaWTA-2EL
 machineconfig/setup_linux/web_shortcuts/interactive.sh,sha256=3bQr-0Gtly7lx6LPXtCUCs49jiCCozv3T1idHK678EY,463
 machineconfig/setup_linux/web_shortcuts/ssh.sh,sha256=k6BAY-zAWsi1beOMiZODxw4VOjZCTABZu__gxSET1eU,1924
 machineconfig/setup_windows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+machineconfig/setup_windows/apps.ps1,sha256=wr8QvyiYyFUUY6JyI4kD-fBuR4xDVkhQpFp6uaZP6KQ,11030
+machineconfig/setup_windows/openssh-server.ps1,sha256=7FopRdNn8hQbst4Cq_T1qoU_Q397Q_O6B2JgH2FdZxE,2531
+machineconfig/setup_windows/openssh-server_add-sshkey.ps1,sha256=qiNC02kzUZi6KBV7O-nRQ7pQ0OGixbq-rUvSCQ7TVxc,1656
+machineconfig/setup_windows/openssh-server_add_identity.ps1,sha256=b8ZXpmNUSw3IMYvqSY7ClpdWPG39FS7MefoWnRhWN2U,506
+machineconfig/setup_windows/openssh_all.ps1,sha256=hxYrqV4YjZBxqVVHWP0Cx10zmVLpC0Nunvtyv7Fm3iY,850
+machineconfig/setup_windows/quirks.ps1,sha256=c7Hn94jBD5GWF29CxMhmNpuM0hgXTQgVJmIRR_7sdcY,182
+machineconfig/setup_windows/repos.ps1,sha256=_JBVfW4UZPM3iGIIXjHr7e7f8RkDm4Zpu2uceFV_xtc,1257
+machineconfig/setup_windows/symlinks.ps1,sha256=88zEzGQOGHOx3DlKsb4wDlCweY763E3wCFGNVJDSvAc,129
+machineconfig/setup_windows/symlinks2linux.ps1,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+machineconfig/setup_windows/ve.ps1,sha256=a0Vk7BJfp_dY5GpDYC20WrJbqZHIWWbCZ9hDpKobMDk,311
+machineconfig/setup_windows/wsl_refresh.ps1,sha256=0h-w1lB1H7WyKjJVSRfGA31NpxZo8BMI3XYZ1W-T5i4,216
+machineconfig/setup_windows/wt_and_pwsh.ps1,sha256=BvgWrpMXLAOTjaJep9hsN0pfPVr1J9rlocssrFh5YdI,525
 machineconfig/setup_windows/others/docker.ps1,sha256=M8NfsSxH8YlmY92J4rSe1xWOwTW8IFrdgb8cI8Riu2E,311
 machineconfig/setup_windows/others/obs.ps1,sha256=2andchcXpxS3rqZjGaMpY5VShxTAKWvw6eCrayjuaLo,30
 machineconfig/setup_windows/web_shortcuts/all.ps1,sha256=L03JJ4Jua_bzgtF3kuDOkuQ-Nqaj_ZcV3CFEkCHD1WI,908
 machineconfig/setup_windows/web_shortcuts/ascii_art.ps1,sha256=pUVTtgKHOdgaK3hxz7JoMZzTyQ7vm2RfE_OJgB7e4cw,1270
 machineconfig/setup_windows/web_shortcuts/croshell.ps1,sha256=cTQnegGLGYhuFY3YuuAj2ortN__adA2dznk2E737h4A,644
-machineconfig/setup_windows/web_shortcuts/interactive.ps1,sha256=-76toOluRnxtgo6NuAHgHWMnZQT3zroeCBBLkMTd13g,522
+machineconfig/setup_windows/web_shortcuts/interactive.ps1,sha256=RMUq_GNf0FCD_o4g4BEbBRg098VOyUEh9ezL2rRNEOI,714
 machineconfig/setup_windows/web_shortcuts/ssh.ps1,sha256=Tj9axEugJE7I3AQ0w1eUGLPb8ufME5jvU5S7VUjlLJE,424
 machineconfig/setup_windows/wt_and_pwsh/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/setup_windows/wt_and_pwsh/set_wt_settings.py,sha256=ogxJnwpdcpH7N6dFJu95UCNoGYirZKQho_3X0F_hmXs,6791
 machineconfig/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/utils/accessories.py,sha256=W_9dLzjwNTW5JQk_pe3B2ijQ1nA2-8Kdg2r7VBtzgQs,4340
-machineconfig/utils/code.py,sha256=S7uY5kLPxLcLlR7B2KHeYkenlysAYSPcxFiUYHXSxX8,5646
+machineconfig/utils/code.py,sha256=Q44GVBgI5wEphGAKsMmXE2wEtzjJngy5pfJV9NCJ8EA,5652
 machineconfig/utils/installer.py,sha256=xYM6tyctqLmr2lLXUKWgobTRufGIua31uspMXP4HGjY,9945
 machineconfig/utils/io.py,sha256=ZXB3aataS1IZ_0WMcCRSmoN1nbkvEO-bWYcs-TpngqU,2872
 machineconfig/utils/links.py,sha256=S0XICdbcFESUqm5RINDrOf3O8G1b7QEADncXXcC8IQc,15520
@@ -389,7 +408,7 @@ machineconfig/utils/scheduler.py,sha256=pOzpOowapfC6Fl_k82JbESmLS8eh-zk4FyjJyUX1
 machineconfig/utils/scheduling.py,sha256=RF1iXJpqf4Dg18jdZWtBixz97KAHC6VKYqTFSpdLWuc,11188
 machineconfig/utils/source_of_truth.py,sha256=GnjcVkKm11RyZFHGnPbne5YDEBYoZ5yryBNkpfGC7O4,854
 machineconfig/utils/ssh.py,sha256=KTUp42nT4Vuh350_EvArQoR2N5iVXrc2BFld93fRUX4,20919
-machineconfig/utils/terminal.py,sha256=Jqojb1xta_SLftUIXmWK7Mn87e1NJXavC5Hbf3fRT-I,11795
+machineconfig/utils/terminal.py,sha256=IlmOByfQG-vjhaFFxxzU5rWzP5_qUzmalRfuey3PAmc,11801
 machineconfig/utils/upgrade_packages.py,sha256=H96zVJEWXJW07nh5vhjuSCrPtXGqoUb7xeJsFYYdmCI,3330
 machineconfig/utils/ve.py,sha256=L-6PBXnQGXThiwWgheJMQoisAZOZA6SVCbGw2J-GFnI,2414
 machineconfig/utils/ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -397,19 +416,19 @@ machineconfig/utils/ai/generate_file_checklist.py,sha256=ajbmhcBToRugl75c_KZRq2X
 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
-machineconfig/utils/files/headers.py,sha256=crnjWt5R0rmZOQ45KhF6HtFpsUm1oeCPoYeptR4o-U0,3437
+machineconfig/utils/files/headers.py,sha256=L54G11DfLadyZGyQXSQ7y8UI_tNvlld7zqP4qEAWL88,3647
 machineconfig/utils/files/read.py,sha256=dyf-DDkLnCKgwmRH0Af4UtBIZh6iMUaYmjgJtdSGRFg,4744
 machineconfig/utils/installer_utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/utils/installer_utils/github_release_bulk.py,sha256=WJf_qZlF02SmIc6C7o1h4Gy4gAaJAfeAS8O9s2Itj-k,6535
-machineconfig/utils/installer_utils/installer.py,sha256=_XcatwArhwRepMYfaGYpjd-lqNGfijnjeZB8l4uKd-c,9266
+machineconfig/utils/installer_utils/installer.py,sha256=H9wukQBSZDLlpB6Xn4Sa2hSV8iCUr9UQChcgOa3u-L8,9278
 machineconfig/utils/installer_utils/installer_abc.py,sha256=VTHe5O3jA6k6rnUnXhgnEf6mVvkVQlEuXjzYLEDgEAs,11140
 machineconfig/utils/installer_utils/installer_class.py,sha256=fN4Nfqn4tlSfQGW52A_Ipi6GT6utC30ZuSj5WM_yxIY,20252
 machineconfig/utils/schemas/fire_agents/fire_agents_input.py,sha256=pTxvLzIpD5RF508lUUBBkWcc4V1B10J4ylvVgVGkcM0,2037
 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.14.dist-info/METADATA,sha256=mFhObJHO12yrWPAN5ujBFZSEscyXA61ekpyxdMlytj0,8030
-machineconfig-5.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-machineconfig-5.14.dist-info/entry_points.txt,sha256=2afE1mw-o4MUlfxyX73SV02XaQI4SV_LdL2r6_CzhPU,1074
-machineconfig-5.14.dist-info/top_level.txt,sha256=porRtB8qms8fOIUJgK-tO83_FeH6Bpe12oUVC670teA,14
-machineconfig-5.14.dist-info/RECORD,,
+machineconfig-5.16.dist-info/METADATA,sha256=QLDF21ufCMJ5ndIuNZfcg6L2ISE6XnhPPqo6YsDqCcs,8030
+machineconfig-5.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+machineconfig-5.16.dist-info/entry_points.txt,sha256=2afE1mw-o4MUlfxyX73SV02XaQI4SV_LdL2r6_CzhPU,1074
+machineconfig-5.16.dist-info/top_level.txt,sha256=porRtB8qms8fOIUJgK-tO83_FeH6Bpe12oUVC670teA,14
+machineconfig-5.16.dist-info/RECORD,,