machineconfig 1.92__py3-none-any.whl → 1.94__py3-none-any.whl

machineconfig/jobs/python_custom_installers/dev/docker.py

@@ -0,0 +1,70 @@
+"""docker installer
+"""
+
+import platform
+from typing import Optional
+
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "lightweight containerization",
+        "filename_template_windows_amd_64": "",
+        "filename_template_linux_amd_64": "",
+        "strip_v": False,
+        "exe_name": "docker"
+}
+
+
+
+def main(version: Optional[str]):
+    print(f"""
+{'=' * 70}
+🐳 DOCKER INSTALLER | Setting up containerization platform
+💻 Platform: {platform.system()}
+🔄 Version: {'latest' if version is None else version}
+{'=' * 70}
+""")
+    
+    _ = version
+    if platform.system() == "Windows":
+        error_msg = "Docker installation not supported on Windows through this installer"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+💡 TIP: Please use Docker Desktop for Windows instead
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    elif platform.system() == "Linux":
+        print("🐧 Installing Docker on Linux using official script...")
+        import machineconfig.jobs.python_custom_installers as module
+        from pathlib import Path
+        program = Path(module.__file__).parent.joinpath("scripts/linux/docker.sh").read_text(encoding="utf-8")
+    else:
+        error_msg = f"Unsupported platform: {platform.system()}"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+        
+    print(f"""
+{'=' * 70}
+ℹ️  INFO | Docker features:
+📦 Container-based virtualization
+🚀 Simplified application deployment
+🔄 Consistent development environments
+🛡️ Isolated application environments
+📊 Efficient resource utilization
+{'=' * 70}
+""")
+    
+    # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)
+    # run script here as it requires user input
+    return program
+
+
+if __name__ == "__main__":
+    pass
+

machineconfig/jobs/python_custom_installers/dev/docker_desktop.py

@@ -0,0 +1,77 @@
+"""
+Installer
+"""
+# from machineconfig.utils.installer import get_latest_release
+# from crocodile.meta import Terminal
+from typing import Optional
+
+# https://docs.docker.com/desktop/install/ubuntu/
+# https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository
+# https://stackoverflow.com/questions/41133455/docker-repository-does-not-have-a-release-file-on-running-apt-get-update-on-ubun
+
+
+# url = r"https://github.com/koute/bytehound"
+# fname = r"bytehound-x86_64-unknown-linux-gnu.tgz"
+
+
+config_dict = {
+    "repo_url": "CUSTOM",
+    "doc": """Docker Desktop for Ubuntu as per https://docs.docker.com/desktop/install/ubuntu/""",
+    "filename_template_windows_amd_64": "gh_{}_windows_amd64.zip",
+    "filename_template_linux_amd_64": "gh_{}_linux_amd64.tar.gz",
+    "strip_v": True,
+    "exe_name": "docker"
+}
+
+
+def main(version: Optional[str]):
+    print(f"""
+{'=' * 70}
+🐳 DOCKER DESKTOP | Installing Docker Desktop for Ubuntu
+🔄 Version: {'latest' if version is None else version}
+📚 Source: https://docs.docker.com/desktop/install/ubuntu/
+{'=' * 70}
+""")
+    
+    _ = version
+    
+    print("""
+📋 Installation steps:
+1️⃣  Adding Docker's official GPG key
+2️⃣  Adding repository to Apt sources
+3️⃣  Updating package lists
+4️⃣  Installing Docker components
+""")
+    
+    code = """
+# Add Docker's official GPG key:
+sudo apt-get update
+sudo apt-get install ca-certificates curl gnupg
+sudo install -m 0755 -d /etc/apt/keyrings
+curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
+sudo chmod a+r /etc/apt/keyrings/docker.gpg
+
+# Add the repository to Apt sources:
+echo \
+  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
+  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
+  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+sudo apt-get update
+
+sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+
+"""
+    print(f"""
+{'=' * 70}
+ℹ️  INFO | After installation:
+🔹 Run 'sudo docker run hello-world' to verify installation
+🔹 Add your user to the docker group with 'sudo usermod -aG docker $USER'
+🔹 Log out and back in to apply group changes
+{'=' * 70}
+""")
+    
+    return code
+
+
+if __name__ == '__main__':
+    pass

machineconfig/jobs/python_custom_installers/dev/espanso.py

@@ -0,0 +1,82 @@
+"""
+A text expander is a program that detects when you type a specific keyword and replaces it with something else
+
+https://github.com/espanso/espanso
+"""
+
+from typing import Optional
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "A text expander.",
+        "filename_template_windows_amd_64": "Espanso-Win-Installer-x86_64.exe",
+        "filename_template_linux_amd_64": "",
+        "strip_v": False,
+        "exe_name": "espanso"
+    }
+
+
+def main(version: Optional[str]):
+    print(f"""
+{'=' * 70}
+⚡ ESPANSO INSTALLER | Setting up text expansion tool
+🔄 Version: {'latest' if version is None else version}
+🔗 Source: https://github.com/espanso/espanso
+{'=' * 70}
+""")
+    
+    _ = version
+    import platform
+    config_dict["repo_url"] = "https://github.com/espanso/espanso"
+    if platform.system() == "Windows":
+        print("🪟 Installing Espanso on Windows...")
+    elif platform.system() == "Linux":
+        import os
+        env = os.environ["XDG_SESSION_TYPE"]
+        if env == "wayland":
+            print(f"""
+{'=' * 70}
+🖥️  DISPLAY SERVER | Wayland detected
+📦 Using Wayland-specific package
+{'=' * 70}
+""")
+            config_dict["filename_template_linux_amd_64"] = "espanso-debian-wayland-amd64.deb"
+        else:
+            print(f"""
+{'=' * 70}
+🖥️  DISPLAY SERVER | X11 detected
+📦 Using X11-specific package
+{'=' * 70}
+""")
+            config_dict["filename_template_linux_amd_64"] = "espanso-debian-x11-amd64.deb"
+    else:
+        error_msg = f"Unsupported platform: {platform.system()}"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+
+    print("🚀 Installing Espanso using installer...")
+    from machineconfig.utils.installer_utils.installer_class import Installer
+    installer = Installer.from_dict(config_dict, name="espanso")
+    installer.install(version=None)
+    
+    config = """
+espanso service register
+espanso start
+espanso install actually-all-emojis
+    """
+    
+    print(f"""
+{'=' * 70}
+✅ SUCCESS | Espanso installation completed
+📋 Post-installation steps:
+1️⃣  Register Espanso as a service
+2️⃣  Start the Espanso service
+3️⃣  Install the emoji package
+{'=' * 70}
+""")
+    
+    return config

machineconfig/jobs/python_custom_installers/dev/goes.py

@@ -0,0 +1,59 @@
+"""
+natural language to API
+https://github.com/ShishirPatil/gorilla
+"""
+
+from machineconfig.utils.ve import get_ve_install_script
+# import subprocess
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "natural language to API",
+        "filename_template_windows_amd_64": "",
+        "filename_template_linux_amd_64": "",
+        "strip_v": False,
+        "exe_name": "goex"
+    }
+
+ve_name = "goex"
+
+
+def main():
+    print(f"""
+{'=' * 70}
+🦍 GORILLA INSTALLER | Natural language to API converter
+🌐 Source: https://github.com/ShishirPatil/gorilla
+📦 Virtual Environment: {ve_name}
+{'=' * 70}
+""")
+    
+    print("🔄 Preparing installation script...")
+    install_script = get_ve_install_script(ve_name=ve_name, py_version="3.11", install_crocodile_and_machineconfig=False,
+                                        delete_if_exists=True)
+
+    install_script += f"""
+
+. $HOME/scripts/activate_ve {ve_name}
+cd ~/code/foreign
+git clone https://github.com/ShishirPatil/gorilla --depth 1
+cd gorilla/goex
+pip install -e .
+
+    """
+    
+    print(f"""
+{'=' * 70}
+📋 INSTALLATION STEPS:
+1️⃣  Creating Python 3.11 virtual environment: {ve_name}
+2️⃣  Cloning Gorilla repository to ~/code/foreign
+3️⃣  Installing Gorilla in development mode
+{'=' * 70}
+
+✅ Installation script prepared successfully!
+""")
+    
+    return install_script
+
+
+if __name__ == "__main__":
+    pass

machineconfig/jobs/python_custom_installers/dev/lvim.py

@@ -0,0 +1,76 @@
+"""lvim
+"""
+
+from crocodile.meta import Terminal
+import subprocess
+import platform
+from typing import Optional
+
+
+_ = Terminal, subprocess
+# as per https://www.lunarvim.org/docs/installation
+
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "Terminal text editor based on neovim.",
+        "filename_template_windows_amd_64": "",
+        "filename_template_linux_amd_64": "",
+        "strip_v": False,
+        "exe_name": "lvim"
+    }
+
+
+def main(version: Optional[str]):
+    print(f"""
+{'=' * 70}
+🌙 LUNARVIM INSTALLER | Setting up Neovim-based IDE
+🔄 Version: {'latest' if version is None else version}
+📚 Branch: release-1.4/neovim-0.9
+{'=' * 70}
+""")
+    
+    _ = version
+    if platform.system() == "Windows":
+        print("🪟 Installing LunarVim on Windows...")
+        program = """
+
+pwsh -c "`$LV_BRANCH='release-1.4/neovim-0.9'; iwr https://raw.githubusercontent.com/LunarVim/LunarVim/release-1.4/neovim-0.9/utils/installer/install.ps1 -UseBasicParsing | iex"
+
+"""
+    elif platform.system() == "Linux":
+        print("🐧 Installing LunarVim on Linux...")
+        program = """
+
+LV_BRANCH='release-1.4/neovim-0.9' bash <(curl -s https://raw.githubusercontent.com/LunarVim/LunarVim/release-1.4/neovim-0.9/utils/installer/install.sh)
+
+"""
+    else:
+        error_msg = f"Unsupported platform: {platform.system()}"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+        
+    print(f"""
+{'=' * 70}
+ℹ️  INFO | LunarVim features:
+📝 IDE-like experience for Neovim
+🔌 Built-in plugin management
+🛠️  LSP configuration out of the box
+🔍 Powerful fuzzy finding
+⚙️  Simple and unified configuration
+{'=' * 70}
+
+⚠️  NOTE: The installer will prompt for user input during installation.
+""")
+    
+    # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)
+    # run script here as it requires user input
+    return program
+
+
+if __name__ == "__main__":
+    pass

machineconfig/jobs/python_custom_installers/dev/nerdfont.py

@@ -0,0 +1,67 @@
+"""nerfont installer
+"""
+
+import platform
+from typing import Optional
+
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "lightweight containerization",
+        "filename_template_windows_amd_64": "",
+        "filename_template_linux_amd_64": "",
+        "strip_v": False,
+        "exe_name": "nerdfont"
+}
+
+
+def main(version: Optional[str]):
+    print(f"""
+{'=' * 70}
+🔤 NERD FONTS INSTALLER | Installing programming fonts with icons
+💻 Platform: {platform.system()}
+🔄 Version: {'latest' if version is None else version}
+{'=' * 70}
+""")
+    
+    _ = version
+    if platform.system() == "Windows":
+        error_msg = "Nerd Fonts installation not supported on Windows through this installer"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+💡 TIP: Please download and install manually from https://www.nerdfonts.com
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    elif platform.system() == "Linux":
+        print("🐧 Installing Nerd Fonts on Linux using installation script...")
+        import machineconfig.jobs.python_custom_installers as module
+        from pathlib import Path
+        program = Path(module.__file__).parent.joinpath("scripts/linux/nerdfont.sh").read_text(encoding="utf-8")
+    else:
+        error_msg = f"Unsupported platform: {platform.system()}"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    
+    print(f"""
+{'=' * 70}
+ℹ️  INFO | Nerd Fonts features:
+🎨 Programming fonts patched with icons
+🔣 Includes icons from popular sets (FontAwesome, Devicons, etc.)
+🖥️  Perfect for terminals and coding environments
+🧰 Works with many terminal applications and editors
+{'=' * 70}
+""")
+    
+    # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)
+    # run script here as it requires user input
+    return program
+
+
+if __name__ == "__main__":
+    pass

machineconfig/jobs/python_custom_installers/dev/redis.py

@@ -0,0 +1,69 @@
+"""nedis installer
+"""
+
+import platform
+from typing import Optional
+
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "submillisecond fast key-value db",
+        "filename_template_windows_amd_64": "",
+        "filename_template_linux_amd_64": "",
+        "strip_v": False,
+        "exe_name": "redis"
+}
+
+
+def main(version: Optional[str]):
+    print(f"""
+{'=' * 70}
+🗃️  REDIS INSTALLER | Setting up in-memory database
+💻 Platform: {platform.system()}
+🔄 Version: {'latest' if version is None else version}
+{'=' * 70}
+""")
+    
+    _ = version
+    if platform.system() == "Windows":
+        error_msg = "Redis installation not supported on Windows through this installer"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+💡 TIP: Consider using WSL2 or Docker to run Redis on Windows
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    elif platform.system() == "Linux":
+        print("🐧 Installing Redis on Linux using installation script...")
+        import machineconfig.jobs.python_custom_installers as module
+        from pathlib import Path
+        program = Path(module.__file__).parent.joinpath("scripts/linux/redis.sh").read_text(encoding="utf-8")
+    else:
+        error_msg = f"Unsupported platform: {platform.system()}"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    
+    print(f"""
+{'=' * 70}
+ℹ️  INFO | Redis features:
+⚡ In-memory data structure store
+🔑 Key-value database with optional persistence
+🚀 Sub-millisecond response times
+💾 Supports strings, lists, sets, sorted sets, hashes
+🔄 Built-in replication and Lua scripting
+{'=' * 70}
+""")
+    
+    # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)
+    # run script here as it requires user input
+    return program
+
+
+if __name__ == "__main__":
+    pass
+

machineconfig/jobs/python_custom_installers/dev/reverse_proxy.md

@@ -0,0 +1,31 @@
+
+
+given terminal access to a remote computer in my home in australia, and using frpc and frps, give me commands (no config files) to start a proxy server that enable me to access a website https://example.com.au that is only available in Australia, so I can access it from my vocation house in iraq. I have http port 8100 on my computer in australia accesssible securely to me everywhere through cloudflare.
+
+
+# Start frps to listen on port 8100
+./frps -p 8100
+./frps --bind_addr 0.0.0.0 --bind_port 8100 --token "yoursecretqwe"
+
+# Start frpc with HTTP proxy configuration
+./frpc http --server_addr "AUSTRALIA_MACHINE_DOMAIN_OR_IP:8100" \
+     --token "yoursecret" \
+     --local_port 8080 \
+     --plugin http_proxy \
+     --plugin_local_addr "example.com.au:443" \
+     --plugin_host_header "example.com.au"
+
+# Start local proxy to forward traffic
+ssh -L 8080:example.com.au:443 localhost
+# Now you can access the Australian site through: https://localhost:8080
+
+
+---
+
+
+./frps --bind_port=7000 --token=secret
+
+./frpc http selfservice.hrms.sa.gov.au/PROD2:443 \
+  --server_addr=127.0.0.1 --server_port=7000 \
+  --token=secret
+

machineconfig/jobs/python_custom_installers/dev/warp-cli.py

@@ -0,0 +1,71 @@
+"""warp-cli installer
+"""
+
+import platform
+from typing import Optional
+
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "cli for warp from cloudflare",
+        "filename_template_windows_amd_64": "",
+        "filename_template_linux_amd_64": "",
+        "strip_v": False,
+        "exe_name": "warp-cli"
+}
+
+
+def main(version: Optional[str]):
+    print(f"""
+{'═' * 70}
+🌐 CLOUDFLARE WARP | Installing Cloudflare WARP CLI
+💻 Platform: {platform.system()}
+🔄 Version: {'latest' if version is None else version}
+{'═' * 70}
+""")
+    
+    _ = version
+    if platform.system() == "Windows":
+        error_msg = "WARP CLI installation not supported on Windows through this installer"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+💡 TIP: Please download and install manually from Cloudflare website
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    elif platform.system() == "Linux":
+        print("""
+🐧 LINUX SETUP | Installing Cloudflare WARP CLI using installation script...
+""")
+        import machineconfig.jobs.python_custom_installers as module
+        from pathlib import Path
+        program = Path(module.__file__).parent.joinpath("scripts/linux/warp-cli.sh").read_text(encoding="utf-8")
+    else:
+        error_msg = f"Unsupported platform: {platform.system()}"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    
+    print(f"""
+{'═' * 70}
+ℹ️  INFO | Cloudflare WARP Features:
+🔒 Secure your internet connection
+🚀 Improve browsing performance
+🛡️ Hide your IP address
+🔐 Encrypt your DNS queries
+🌐 Access Cloudflare Zero Trust services
+{'═' * 70}
+""")
+    
+    # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)
+    # run script here as it requires user input
+    return program
+
+
+if __name__ == "__main__":
+    pass
+

machineconfig/jobs/python_custom_installers/dev/wezterm.py

@@ -0,0 +1,71 @@
+"""wezterm installer
+"""
+
+import platform
+from typing import Optional
+
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "cli for wezterm",
+        "filename_template_windows_amd_64": "",
+        "filename_template_linux_amd_64": "",
+        "strip_v": False,
+        "exe_name": "wezterm"
+}
+
+
+def main(version: Optional[str]):
+    print(f"""
+{'═' * 70}
+🖥️  WEZTERM INSTALLER | Modern, GPU-accelerated terminal emulator
+💻 Platform: {platform.system()}
+🔄 Version: {'latest' if version is None else version}
+{'═' * 70}
+""")
+    
+    _ = version
+    if platform.system() == "Windows":
+        error_msg = "WezTerm installation not supported on Windows through this installer"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+💡 TIP: Please download and install manually from the WezTerm website
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    elif platform.system() == "Linux":
+        print("""
+🐧 LINUX SETUP | Installing WezTerm terminal emulator using installation script...
+""")
+        import machineconfig.jobs.python_custom_installers as module
+        from pathlib import Path
+        program = Path(module.__file__).parent.joinpath("scripts/linux/wezterm.sh").read_text(encoding="utf-8")
+    else:
+        error_msg = f"Unsupported platform: {platform.system()}"
+        print(f"""
+{'⚠️' * 20}
+❌ ERROR | {error_msg}
+{'⚠️' * 20}
+""")
+        raise NotImplementedError(error_msg)
+    
+    print(f"""
+{'═' * 70}
+ℹ️  INFO | WezTerm Features:
+⚡ GPU-accelerated rendering
+🎨 Full color emoji support
+🧩 Multiplexing with panes and tabs
+⚙️  Lua configuration
+📦 Cross-platform support
+🔌 Plugin system
+{'═' * 70}
+""")
+    
+    # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)
+    # run script here as it requires user input
+    return program
+
+
+if __name__ == "__main__":
+    pass