machineconfig 5.15__py3-none-any.whl → 7.98__py3-none-any.whl

machineconfig/utils/installer_utils/installer.py

@@ -1,189 +0,0 @@
-"""Devops Devapps Install"""
-
-from machineconfig.utils.installer import get_installers_system_groups
-import typer
-from rich.console import Console
-from rich.panel import Panel
-from rich.table import Table
-from typing import Optional, cast, get_args
-from machineconfig.jobs.installer.package_groups import PACKAGE_GROUPS, PACKAGE_GROUP2NAMES
-
-console = Console()
-
-
-def _handle_installer_not_found(search_term: str, all_installers: list["InstallerData"]) -> None:  # type: ignore
-    """Handle installer not found with friendly suggestions using fuzzy matching."""
-    from difflib import get_close_matches
-
-    all_names = []
-    for inst in all_installers:
-        exe_name = inst["appName"]
-        all_names.append(exe_name)
-    close_matches = get_close_matches(search_term, all_names, n=5, cutoff=0.4)
-    console.print(f"\n❌ '[red]{search_term}[/red]' was not found.", style="bold")
-
-    if close_matches:
-        console.print("🤔 Did you mean one of these?", style="yellow")
-        table = Table(show_header=False, box=None, pad_edge=False)
-        for i, match in enumerate(close_matches, 1):
-            table.add_row(f"[cyan]{i}.[/cyan]", f"[green]{match}[/green]")
-        console.print(table)
-    else:
-        console.print("📋 Here are some available options:", style="blue")
-        # Show first 10 installers as examples
-        sample_names = []
-        for inst in all_installers[:10]:
-            exe_name = inst["appName"]
-            sample_names.append(exe_name)
-
-        table = Table(show_header=False, box=None, pad_edge=False)
-        for i, name in enumerate(sample_names, 1):
-            table.add_row(f"[cyan]{i}.[/cyan]", f"[green]{name}[/green]")
-        console.print(table)
-
-        if len(all_installers) > 10:
-            console.print(f"   [dim]... and {len(all_installers) - 10} more[/dim]")
-
-    panel = Panel(f"[bold blue]💡 Use 'ia' to interactively browse all available installers.[/bold blue]\n[bold blue]💡 Use one of the categories: {list(get_args(PACKAGE_GROUPS))}[/bold blue]", title="[yellow]Helpful Tips[/yellow]", border_style="yellow")
-    console.print(panel)
-
-
-def main_with_parser():
-    import typer
-    app = typer.Typer()
-    app.command()(main)
-    app()
-
-
-def main(
-    which: Optional[str] = typer.Option(None, "--which", "-w", help="Comma-separated list of program names to install."),
-    group: Optional[PACKAGE_GROUPS] = typer.Option(None, "--group", "-g", help=f"Group name (one of {list(get_args(PACKAGE_GROUPS))})"),
-    interactive: bool = typer.Option(False, "--interactive", "-ia", help="Interactive selection of programs to install."),
-) -> None:
-    if which is not None:
-        return install_clis(clis_names=[x.strip() for x in which.split(",") if x.strip() != ""])
-    if group is not None:
-        return install_group(package_group=group)
-    if interactive:
-        return install_interactively()
-    typer.echo("❌ You must provide either --which, --group, or --interactive/-ia option.")
-    import click
-    ctx = click.get_current_context()
-    typer.echo(ctx.get_help())
-    raise typer.Exit(1)
-
-
-def install_interactively():
-    from machineconfig.utils.options import choose_from_options
-    from machineconfig.utils.schemas.installer.installer_types import get_normalized_arch, get_os_name
-    from machineconfig.utils.installer import get_installers
-    from machineconfig.utils.installer_utils.installer_class import Installer
-    installers = get_installers(os=get_os_name(), arch=get_normalized_arch(), which_cats=None)
-    installer_options = []
-    for x in installers:
-        installer_options.append(Installer(installer_data=x).get_description())
-    
-    # Build category options and maintain a mapping from display text to actual category name
-    category_display_to_name: dict[str, str] = {}
-    for group_name, group_values in PACKAGE_GROUP2NAMES.items():
-        display = f"📦 {group_name:<20}" + "   --   " + f"{'|'.join(group_values):<60}"
-        category_display_to_name[display] = group_name
-    
-    options_system = get_installers_system_groups()
-    for item in options_system:
-        display = f"📦 {item['appName']:<20}   --   {item['doc']:<60}"
-        category_display_to_name[display] = item['appName']
-    
-    options = list(category_display_to_name.keys()) + ["─" * 50] + installer_options
-    program_names = choose_from_options(multi=True, msg="Categories are prefixed with 📦", options=options, header="🚀 CHOOSE DEV APP OR CATEGORY", default="📦 essentials", fzf=True)
-    installation_messages: list[str] = []
-    for _an_idx, a_program_name in enumerate(program_names):
-        if a_program_name.startswith("─"):  # 50 dashes separator
-            continue
-        if a_program_name.startswith("📦 "):
-            category_name = category_display_to_name.get(a_program_name)
-            if category_name:
-                install_group(package_group=cast(PACKAGE_GROUPS, category_name))
-        else:
-            installer_idx = installer_options.index(a_program_name)
-            an_installer_data = installers[installer_idx]
-            status_message = Installer(an_installer_data).install_robust(version=None)  # finish the task - this returns a status message, not a command
-            installation_messages.append(status_message)
-    if installation_messages:
-        panel = Panel("\n".join([f"[blue]• {message}[/blue]" for message in installation_messages]), title="[bold green]📊 Installation Summary[/bold green]", border_style="green", padding=(1, 2))
-        console.print(panel)
-
-
-def install_group(package_group: PACKAGE_GROUPS):
-    panel = Panel(f"[bold yellow]Installing programs from category: [green]{package_group}[/green][/bold yellow]", title="[bold blue]📦 Category Installation[/bold blue]", border_style="blue", padding=(1, 2))
-    console.print(panel)
-    from machineconfig.utils.installer import get_installers, install_bulk
-    from machineconfig.utils.schemas.installer.installer_types import get_normalized_arch, get_os_name
-    if package_group in PACKAGE_GROUP2NAMES:
-        installers_ = get_installers(os=get_os_name(), arch=get_normalized_arch(), which_cats=[package_group])
-        install_bulk(installers_data=installers_)
-    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_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_shell_script(program)
-                    break
-
-
-def choose_from_system_package_groups(options_system: dict[str, tuple[str, str]]) -> str:
-    from machineconfig.utils.options import choose_from_options
-    display_options = []
-    for group_name, (description, _) in options_system.items():
-        if description:
-            display_options.append(f"{group_name:<20} - {description}")
-        else:
-            display_options.append(group_name)
-    program_names = choose_from_options(multi=True, msg="", options=sorted(display_options), header="🚀 CHOOSE DEV APP", fzf=True)
-    program = ""
-    for display_name in program_names:
-        # Extract the actual group name (everything before " - " if present)
-        group_name = display_name.split(" - ")[0].strip() if " - " in display_name else display_name.strip()
-        console.print(f"\n[bold cyan]⚙️  Installing: [yellow]{group_name}[/yellow][/bold cyan]", style="bold")
-        _, sub_program = options_system[group_name]  # Extract content from tuple
-        if sub_program.startswith("#winget"):
-            sub_program = sub_program[1:]
-        program += "\n" + sub_program
-    return program
-
-
-def install_clis(clis_names: list[str]):
-    from machineconfig.utils.schemas.installer.installer_types import get_normalized_arch, get_os_name
-    from machineconfig.utils.installer import get_installers
-    from machineconfig.utils.installer_utils.installer_class import Installer
-
-    total_messages: list[str] = []
-    for a_which in clis_names:
-        all_installers = get_installers(os=get_os_name(), arch=get_normalized_arch(), which_cats=None)
-        selected_installer = None
-        for installer in all_installers:
-            app_name = installer["appName"]
-            if app_name.lower() == a_which.lower():
-                selected_installer = installer
-                break
-        if selected_installer is None:
-            _handle_installer_not_found(a_which, all_installers)
-            return None
-        message = Installer(selected_installer).install_robust(version=None)  # finish the task
-        total_messages.append(message)
-    if total_messages:
-        console.print("\n[bold green]📊 Installation Results:[/bold green]")
-        for a_message in total_messages:
-            console.print(f"[blue]• {a_message}[/blue]")
-    return None
-
-
-if __name__ == "__main__":
-    from machineconfig.utils.schemas.installer.installer_types import InstallerData
-    from machineconfig.utils.installer_utils.installer_class import Installer
-
-    _ = InstallerData, Installer
-    pass

machineconfig-5.15.dist-info/METADATA

@@ -1,188 +0,0 @@
-Metadata-Version: 2.4
-Name: machineconfig
-Version: 5.15
-Summary: Dotfiles management package
-Author-email: Alex Al-Saffar <programmer@usa.com>
-License: Apache 2.0
-Project-URL: Homepage, https://github.com/thisismygitrepo/machineconfig
-Project-URL: Bug Tracker, https://github.com/thisismygitrepo/machineconfig/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.13
-Description-Content-Type: text/markdown
-Requires-Dist: cryptography>=44.0.2
-Requires-Dist: fire>=0.7.0
-Requires-Dist: joblib>=1.5.2
-Requires-Dist: paramiko>=3.5.1
-Requires-Dist: randomname>=0.2.1
-Requires-Dist: requests>=2.32.5
-Requires-Dist: rich>=14.0.0
-Requires-Dist: tenacity>=9.1.2
-Requires-Dist: psutil>=7.0.0
-Requires-Dist: gitpython>=3.1.44
-Requires-Dist: pyfzf>=0.3.1
-Requires-Dist: rclone-python>=0.1.23
-Requires-Dist: pyjson5>=1.6.9
-Requires-Dist: typer-slim>=0.19.2
-Requires-Dist: questionary>=2.1.1
-Requires-Dist: typer>=0.19.2
-Provides-Extra: windows
-Requires-Dist: pywin32; extra == "windows"
-Provides-Extra: docs
-Requires-Dist: pdoc>=15.0.2; extra == "docs"
-
-
-<p align="center">
-
-<a href="https://github.com/thisismygitrepo/machineconfig/commits">
-<img src="https://img.shields.io/github/commit-activity/m/thisismygitrepo/machineconfig" />
-</a>
-
-</p>
-
-
-# Welcome to machineconfig
-
-# Shortcuts
-* `bit.ly/cfgroot` is a shortcut to this repo.
-* `glow https://bit.ly/cfgread` OR `curl bit.ly/cfgread -L | bat -l md --style="header"` to get the readme file.
-
-Machineconfig is a package for managing configuration files (aka dotfiles). The idea is to collect those critical, time-consuming-files-to-setup in one directory and reference them via symbolic links from their original locations. Thus, when a new machine is to be setup, all that is required is to clone the repo in that machine and create the symbolic links.
-Dotfiles include, but are not limited to:
-* `~/.gitconfig`
-* `~/.ssh`
-* `~/.aws`
-* `~/.bash_profile`
-* `~/.bashrc`
-* `~/.config`
-* `$profile` in Windows Powershell
-* etc
-
-
-Additionally, files that contain data, sensitive information that should not be pushed to a repository are contained in a directory `~/dotfiles`. The files therein are encrypted before backedup.
-
-
-## Windows Setup
-With elevated `PowerShell`, run the following: (short `curl bit.ly/cfgallwindows -L | iex`)
-
-**You have to have `winget` first. If its not available in the your terminal, try those resources:**
-
-* https://github.com/asheroto/winget-install
-* https://github.com/microsoft/winget-cli
-* https://github.com/microsoft/winget-cli/discussions/3258
-
-
-```shell
-# apps  # short: `(iwr bit.ly/cfgappswindows).Content | iex`
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/apps.ps1 | Invoke-Expression
-# virtual enviornment  # short (iwr bit.ly/cfgvewindows).Content | iex OR `curl bit.ly/cfgvewindows -L | iex`
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/ve.ps1 | Invoke-Expression
-# symlinks # short `(iwr bit.ly/cfgsymlinkswindows).Content | iex` OR `curl bit.ly/cfgsymlinkswindows -L | iex`
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-# devapps:
-$HOME/code/machineconfig/src/machineconfig/setup_windows/devapps.ps1
-# pwsh and wt settings: (iwr bit.ly/cfgwt).Content | iex
-iwr https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/wt_and_pwsh.ps1 | iex
-
-```
-
-```shell
-
-(iwr bit.ly/cfgappswindows).Content | iex
-(iwr bit.ly/cfgvewindows).Content | iex
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/devapps.ps1
-(iwr bit.ly/cfgwt).Content | iex
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-
-& "$HOME\code\machineconfig\.venv\Scripts\activate.ps1"
-python -m fire machineconfig.profile.create main2 --choice=all
-deactivate
-
-```
-
-###### Setup SSH connection:
-```shell
-# CHANGE pubkey_string APPROPRIATELY
-$pubkey_string=(Invoke-WebRequest 'https://github.com/thisismygitrepo.keys').Content
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/openssh_all.ps1 | Invoke-Expression
-```
-short `(iwr bit.ly/cfgsshwindows).Content | iex` OR `curl bit.ly/cfgsshwindows -L | iex`
-
-###### Install Croshell Terminal Directly,
-```shell
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/web_shortcuts/croshell.ps1 | Invoke-Expression
-```
-short: `curl bit.ly/cfgcroshellwindows -L | iex` OR `(iwr bit.ly/cfgcroshellwindows).Content | iex`
-
-
-# Linux Setup
-With `sudo` access, run the following: (short `curl bit.ly/cfgalllinux -L | bash`)
-```bash
-export package_manager="nala"
-export package_manager="nix"
-
-# apps  # short: `curl bit.ly/cfgappslinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps.sh | bash
-# Optionally: curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps_dev.sh | bash
-
-# virtual enviornment  # short `curl bit.ly/cfgvelinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/ve.sh | bash
-
-# repos  # short `curl bit.ly/cfgreposlinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/repos.sh | bash
-# symlinks and bash profile: # short `curl bit.ly/cfgsymlinkslinux -L | bash`
-source ~/code/machineconfig/src/machineconfig/setup_linux/symlinks.sh  # requires sudo since it invloves chmod of dotfiles/.ssh, however sudo doesn't work with source. best to have sudo -s earlier.
-
-# devapps
-source <(sudo cat ~/code/machineconfig/src/machineconfig/setup_linux/devapps.sh)
-```
-
-###### Setup SSH connection:
-```bash
-pubkey_url='https://github.com/thisismygitrepo.keys'  # (CHANGE APPROPRIATELY)
-export pubkey_string=$(curl --silent $pubkey_url)
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_all.sh | sudo bash
-# For WSL only, also run the following:
-export port=2223
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_wsl.sh | sudo bash
-# don't forget to run `wsl_ssh_windows_port_forwarding -p 2223` from Windows using the designated port with
-```
-short `curl bit.ly/cfgsshlinux -L | bash`
-
-
-###### Install Croshell Terminal Directly
-
-```bash
-
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/web_shortcuts/croshell.sh | sudo bash
-
-```
-short `curl bit.ly/cfgcroshelllinux -L | bash`
-
-
-## Repository management CLI
-
-The DevOps CLI now exposes rich subcommands for working with git repositories. Run `python -m machineconfig.scripts.python.devops repos --help` to explore the hierarchy:
-
-* Top-level actions: `push`, `pull`, `commit`, `all`, and `analyze`.
-	* These commands accept `--recursive/-r` and `--no-sync` to control nested repos and automatic `uv sync`.
-* Sync workflows live under `sync`:
-	* `record` captures the current machine state into a `repos.json`.
-	* `capture` clones repos from a specification without changing commits.
-	* `checkout` aligns repositories to commits stored in the spec.
-	* `checkout-to-branch` switches repositories to the tracked branch.
-	* Each sync subcommand accepts `--cloud/-c` for fetching/saving specs from remote storage.
-
-Example:
-
-```bash
-python -m machineconfig.scripts.python.devops repos sync record ~/code --cloud my_remote
-python -m machineconfig.scripts.python.devops repos pull ~/code --recursive
-```
-
-# Author
-Alex Al-Saffar. [email](mailto:programmer@usa.com)
-
-[![Alex's github activity graph](https://github-readme-activity-graph.vercel.app/graph?username=thisismygitrepo)](https://github.com/ashutosh00710/github-readme-activity-graph)
-