machineconfig 8.51__py3-none-any.whl → 8.61__py3-none-any.whl

machineconfig/jobs/installer/python_scripts/sysabc.py

@@ -56,52 +56,31 @@ echo "🔄 Updating Homebrew..."
 brew update || true
 
 curl -fsSL https://bun.com/install | bash
-
-# Note: git and nano are pre-installed on macOS, but we install via Homebrew to ensure latest versions
-# brew install git || true
-# brew install nano || true
-# brew install curl || true
-# nvm install node || true
-# brew install make
-# brew install ffmpeg
-# brew install openssl
-
-
+# brew install openssl ffmpeg make curl nano git
 echo "✅ Essential tools installation complete."
 """
 
 bash = r"""
+
 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
-sudo nala install build-essential python3-dev -y || true  # C build toolchain: Where build-essential brings gcc, make, etc., and python3-dev ensures headers for your Python version.
-# sudo nala install libssl-dev -y
-# sudo nala install libaa-bin -y
+sudo nala install curl wget gpg lsb-release apt-transport-https \
+  samba fuse3 nfs-common \
+  git net-tools htop nano \
+  build-essential \  # Where it brings gcc, make, etc.,
+  python3-dev \  # ensures headers for your Python version.
+  unzip \   # bun installer needs this to unzip files.
+  pkg-config \  
+  libssl-dev \  # essential for SSL/TLS support in many applications, compiling rust binaries will need them.
+    -y || true
 
-# curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
-# source ~/.bashrc || true
-# nvm install node || true
-
-sudo nala install unzip -y  # required by bun installer
 curl -fsSL https://bun.com/install | bash
 . ~/.bashrc || true
-# sudo ln -s $(which bun) /usr/local/bin/node  # trick programs that expect node to use bun runtime.
-sudo ln -s ~/.bun/bin/bun /usr/local/bin/node
-
-
-sudo nala install samba -y || true
-sudo nala install fuse3 -y || true
-sudo nala install nfs-common -y || true
+sudo ln -s ~/.bun/bin/bun /usr/local/bin/node  # trick programs that expect node to use bun runtime.
 
 # 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
-
-# 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 DEBIAN_FRONTEND=noninteractive nala install cmatrix hollywood ffmpeg -y  make || true
 
 """
 

machineconfig/profile/mapper_dotfiles.toml

@@ -207,9 +207,9 @@ config = {original = '~/mprocs.yaml', self_managed = 'CONFIG_ROOT/settings/mproc
 
 
 [zellij_linux]
-config = { original = '~/.config/zellij', self_managed = 'CONFIG_ROOT/settings/zellij' , os = 'linux,darwin'}
-#themes = { original = '~/.config/zellij/themes', self_managed = 'CONFIG_ROOT/settings/zellij/themes' }
-#layouts = { original = '~/.config/zellij/layouts', self_managed = 'CONFIG_ROOT/settings/zellij/layouts' }
+config = { original = '~/.config/zellij', self_managed = 'CONFIG_ROOT/settings/zellij', os = 'linux,darwin'}
+themes = { original = '~/.config/zellij/themes', self_managed = 'CONFIG_ROOT/settings/zellij/themes', os = 'linux,darwin' }
+layouts = { original = '~/.config/zellij/layouts', self_managed = 'CONFIG_ROOT/settings/zellij/layouts', os = 'linux,darwin' }
 
 
 # ===================== IDEs ============================

machineconfig/scripts/python/devops.py

@@ -60,7 +60,7 @@ def get_app() -> typer.Typer:
     cli_app = typer.Typer(help="🛠️ DevOps operations", no_args_is_help=True, add_help_option=True, add_completion=False)
     ctx_settings: dict[str, object] = {"allow_extra_args": True, "allow_interspersed_args": True, "ignore_unknown_options": True, "help_option_names": []}
 
-    cli_app.command("install", no_args_is_help=True, help=install.__doc__, short_help="🛠️ [i] Install essential packages")(install)
+    cli_app.command("install", no_args_is_help=True, help=install.__doc__, short_help="🛠️  [i] Install essential packages")(install)
     cli_app.command("i", no_args_is_help=True, help=install.__doc__, hidden=True)(install)
 
     cli_app.command("repos", help="📁 [r] Manage development repositories", context_settings=ctx_settings)(repos)

machineconfig/scripts/python/devops_navigator.py

@@ -2,7 +2,7 @@
 # /// script
 # requires-python = ">=3.13"
 # dependencies = [
-#     "machineconfig>=8.51",
+#     "machineconfig>=8.61",
 #     "textual",
 # ]
 # ///

machineconfig/scripts/python/helper_env/path_manager_tui.py

@@ -2,7 +2,7 @@
 # /// script
 # requires-python = ">=3.13"
 # dependencies = [
-#     "machineconfig>=8.51",
+#     "machineconfig>=8.61",
 #     "textual",
 #     "pyperclip",
 # ]

machineconfig/scripts/python/helpers/helper_env/env_manager_tui.py

@@ -2,7 +2,7 @@
 # /// script
 # requires-python = ">=3.13"
 # dependencies = [
-#     "machineconfig>=8.51",
+#     "machineconfig>=8.61",
 #     "textual",
 #     "pyperclip",
 # ]

machineconfig/scripts/python/helpers/helper_env/path_manager_tui.py

@@ -2,7 +2,7 @@
 # /// script
 # requires-python = ">=3.13"
 # dependencies = [
-#     "machineconfig>=8.51",
+#     "machineconfig>=8.61",
 #     "textual",
 #     "pyperclip",
 # ]

machineconfig/scripts/python/helpers/helpers_croshell/croshell_impl.py

@@ -24,12 +24,16 @@ def croshell(
                 user_uv_with_line = f"--with {uv_with},ipython"
             case "python":
                 user_uv_with_line = f"--with {uv_with}"
+            case _:
+                raise ValueError(f"Unknown interpreter: {interpreter}")
     else:
         match interpreter:
             case "ipython":
                 user_uv_with_line = "--with ipython"
             case "python":
                 user_uv_with_line = ""
+            case _:
+                raise ValueError(f"Unknown interpreter: {interpreter}")
 
     if project_path is not None:
         uv_project_line = f'--project {project_path}'
@@ -188,7 +192,7 @@ def _build_fire_line(
         if Path.home().joinpath("code/machineconfig").exists():
             requirements = f"""{user_uv_with_line} {uv_project_line} --with marimo,sqlglot  """
         else:
-            requirements = f"""{uv_python_line} {user_uv_with_line} {uv_project_line} --with "marimo,sqlglot,cowsay,machineconfig[plot]>=8.51" """
+            requirements = f"""{uv_python_line} {user_uv_with_line} {uv_project_line} --with "marimo,sqlglot,cowsay,machineconfig[plot]>=8.61" """
         fire_line = f"""
 cd {str(pyfile.parent)}
 uv run {uv_python_line} --with "marimo" marimo convert {pyfile.name} -o marimo_nb.py
@@ -198,7 +202,7 @@ uv run {requirements} marimo edit --host 0.0.0.0 marimo_nb.py
         if Path.home().joinpath("code/machineconfig").exists():
             requirements = f"""{user_uv_with_line}  {uv_project_line}  --with jupyterlab """
         else:
-            requirements = f"""{user_uv_with_line} {uv_project_line} --with "cowsay,machineconfig[plot]>=8.51" """
+            requirements = f"""{user_uv_with_line} {uv_project_line} --with "cowsay,machineconfig[plot]>=8.61" """
         fire_line = f"uv run {requirements} {uv_project_line}  jupyter-lab {str(nb_target)}"
     elif vscode:
         user_uv_add = f"uv add {uv_with}" if uv_with is not None else ""
@@ -206,7 +210,7 @@ uv run {requirements} marimo edit --host 0.0.0.0 marimo_nb.py
 cd {str(pyfile.parent)}
 uv init {uv_python_line}
 uv venv
-uv add "cowsay,machineconfig[plot]>=8.51"
+uv add "cowsay,machineconfig[plot]>=8.61"
 uv add {user_uv_add}
 # code serve-web
 code --new-window {str(pyfile)}
@@ -219,7 +223,7 @@ code --new-window {str(pyfile)}
         if Path.home().joinpath("code/machineconfig").exists():
             ve_line = f"""{user_uv_with_line}  {uv_project_line} """
         else:
-            ve_line = f"""{uv_python_line} {user_uv_with_line} {uv_project_line} --with "cowsay,machineconfig[plot]>=8.51" """
+            ve_line = f"""{uv_python_line} {user_uv_with_line} {uv_project_line} --with "cowsay,machineconfig[plot]>=8.61" """
         fire_line = f"uv run {ve_line} {interpreter} {interactivity} {profile} {str(pyfile)}"
 
     return fire_line

machineconfig/scripts/python/helpers/helpers_devops/cli_config.py

@@ -25,7 +25,11 @@ def configure_shell_profile(which: Annotated[Literal["default", "d", "nushell",
 def pwsh_theme():
     """🔗 Select powershell prompt theme."""
     import machineconfig.scripts.python.helpers.helpers_devops.themes as themes
-    file = Path(themes.__file__).parent / "choose_pwsh_theme.ps1"
+    file_path = themes.__file__
+    # if file_path is None:
+    #     typer.echo("❌ ERROR: Could not locate themes module file.", err=True)
+    #     raise typer.Exit(code=1)
+    file = Path(file_path).parent / "choose_pwsh_theme.ps1"
     import subprocess
     subprocess.run(["pwsh", "-File", str(file)])
 
@@ -71,6 +75,29 @@ def copy_assets(which: Annotated[Literal["scripts", "s", "settings", "t", "both"
     typer.echo(msg)
 
 
+def list_devices() -> None:
+    """🔗 List available mountable devices."""
+    import machineconfig.scripts.python.helpers.helpers_devops.cli_config_mount as mount_module
+    mount_module.list_devices()
+
+
+def mount_device(
+    device_query: Annotated[str | None, typer.Option("--device", "-d", help="Device query (path, key, or label).")] = None,
+    mount_point: Annotated[str | None, typer.Option("--mount-point", "-p", help="Mount point (use '-' for default on macOS).")] = None,
+    interactive: Annotated[bool, typer.Option("--interactive", "-i", help="Pick device and mount point interactively.")] = False,
+) -> None:
+    """🔗 Mount a device to a mount point."""
+    import machineconfig.scripts.python.helpers.helpers_devops.cli_config_mount as mount_module
+    if interactive:
+        mount_module.mount_interactive()
+        return
+    if device_query is None or mount_point is None:
+        msg = typer.style("Error: ", fg=typer.colors.RED) + "--device and --mount-point are required unless --interactive is set"
+        typer.echo(msg)
+        raise typer.Exit(2)
+    mount_module.mount_device(device_query=device_query, mount_point=mount_point)
+
+
 def get_app():
     config_apps = typer.Typer(help="⚙️ [c] configuration subcommands", no_args_is_help=True, add_help_option=True, add_completion=False)
     config_apps.command("sync", no_args_is_help=True, help="🔗 [s] Sync dotfiles.")(create_links_export.main_from_parser)
@@ -94,5 +121,10 @@ def get_app():
     config_apps.command("copy-assets", no_args_is_help=True, help="🔗 [c] Copy asset files from library to machine.", hidden=False)(copy_assets)
     config_apps.command("c", no_args_is_help=True, help="Copy asset files from library to machine.", hidden=True)(copy_assets)
 
+    config_apps.command("list-devices", no_args_is_help=False, help="🔗 [l] List available devices for mounting.")(list_devices)
+    config_apps.command("l", no_args_is_help=False, help="List available devices for mounting.", hidden=True)(list_devices)
+    config_apps.command("mount", no_args_is_help=True, help="🔗 [m] Mount a device to a mount point.")(mount_device)
+    config_apps.command("m", no_args_is_help=True, help="Mount a device to a mount point.", hidden=True)(mount_device)
+
 
     return config_apps

machineconfig/scripts/python/helpers/helpers_devops/cli_config_mount.py

@@ -0,0 +1,77 @@
+
+import platform
+from typing import Annotated
+
+import typer
+
+from machineconfig.scripts.python.helpers.helpers_devops.mount_helpers.devices import list_devices as list_devices_internal
+from machineconfig.scripts.python.helpers.helpers_devops.mount_helpers.linux import mount_linux, select_linux_partition
+from machineconfig.scripts.python.helpers.helpers_devops.mount_helpers.macos import mount_macos
+from machineconfig.scripts.python.helpers.helpers_devops.mount_helpers.selection import pick_device, resolve_device
+from machineconfig.scripts.python.helpers.helpers_devops.mount_helpers.utils import format_device
+from machineconfig.scripts.python.helpers.helpers_devops.mount_helpers.windows import mount_windows
+
+
+def list_devices() -> None:
+	entries = list_devices_internal()
+	if not entries:
+		typer.echo("No devices found")
+		return
+	for entry in entries:
+		typer.echo(format_device(entry))
+
+
+def mount_device(
+	device_query: Annotated[str, typer.Argument(...)],
+	mount_point: Annotated[str, typer.Argument(...)],
+) -> None:
+	try:
+		entries = list_devices_internal()
+		if not entries:
+			typer.echo("No devices found")
+			raise typer.Exit(1)
+		entry = resolve_device(entries, device_query)
+		platform_name = platform.system()
+		if platform_name == "Linux":
+			selected = select_linux_partition(entries, entry)
+			mount_linux(selected, mount_point)
+		elif platform_name == "Darwin":
+			mount_macos(entry, mount_point)
+		elif platform_name == "Windows":
+			mount_windows(entry, mount_point)
+		else:
+			typer.echo(f"Unsupported platform: {platform_name}")
+			raise typer.Exit(1)
+		typer.echo("Mount completed")
+	except RuntimeError as exc:
+		typer.echo(f"Mount failed: {exc}")
+		raise typer.Exit(1)
+
+
+def mount_interactive() -> None:
+	try:
+		entries = list_devices_internal()
+		if not entries:
+			typer.echo("No devices found")
+			raise typer.Exit(1)
+		entry = pick_device(entries, header="Available devices")
+		platform_name = platform.system()
+		if platform_name == "Darwin":
+			mount_point = typer.prompt("Mount point (use '-' for default)")
+		else:
+			mount_point = typer.prompt("Mount point")
+		if platform_name == "Linux":
+			selected = select_linux_partition(entries, entry)
+			mount_linux(selected, mount_point)
+		elif platform_name == "Darwin":
+			mount_macos(entry, mount_point)
+		elif platform_name == "Windows":
+			mount_windows(entry, mount_point)
+		else:
+			typer.echo(f"Unsupported platform: {platform_name}")
+			raise typer.Exit(1)
+		typer.echo("Mount completed")
+	except RuntimeError as exc:
+		typer.echo(f"Mount failed: {exc}")
+		raise typer.Exit(1)
+

machineconfig/scripts/python/helpers/helpers_devops/cli_data.py

@@ -1,3 +1,4 @@
+
 import typer
 from typing import Annotated, Optional, Literal
 from machineconfig.profile.create_links_export import REPO_LOOSE
@@ -18,6 +19,9 @@ def sync(
             direction_resolved = "BACKUP"
         case "down" | "d":
             direction_resolved = "RETRIEVE"
+        case _:
+            typer.echo("Error: Invalid direction. Use 'up' or 'down'.")
+            raise typer.Exit(code=1)
     main_backup_retrieve(direction=direction_resolved, which=which, cloud=cloud, repo=repo)
 
 

machineconfig/scripts/python/helpers/helpers_devops/cli_nw.py

@@ -3,8 +3,9 @@ import machineconfig.scripts.python.helpers.helpers_devops.cli_share_file
 import machineconfig.scripts.python.helpers.helpers_devops.cli_share_terminal as cli_share_terminal
 import machineconfig.scripts.python.helpers.helpers_devops.cli_share_server as cli_share_server
 import machineconfig.scripts.python.helpers.helpers_devops.cli_ssh as cli_ssh
+import machineconfig.scripts.python.helpers.helpers_devops.cli_share_temp as cli_share_temp
 import typer
-from typing import Annotated
+from typing import Annotated, Literal
 
 
 def switch_public_ip_address(
@@ -124,19 +125,95 @@ def wifi_select(
 
 
 
-def reset_cloudflare_tunnel():
+def reset_cloudflare_tunnel(task: Annotated[Literal["oneoff-shell-process", "oneoff-background-process", "as-service"], typer.Option(..., "--task", "-t", help="Task to perform", case_sensitive=False, show_choices=True)],
+                            tunnel_name: Annotated[str | None, typer.Option("--tunnel-name", "-n", help="Name of the Cloudflare tunnel to run")] = None,
+                    ):
     code = """
 # cloudflared tunnel route dns glenn  # creates CNAMES in Cloudflare dashboard
 # sudo systemctl stop cloudflared
-# test: cloudflared tunnel run glenn
+"""
+    match task:
+        case "oneoff-shell-process":
+            if tunnel_name is None: tunnel_name = ""
+            code = f"""cloudflared tunnel run {tunnel_name}  #  This is running like a normal command """
+        case "oneoff-background-process":
+            if tunnel_name is None: tunnel_name = ""
+            import getpass
+            user_name = getpass.getuser()
+            code = f"""
+# This verion runs like a deamon, but its not peristent across reboots
+sudo systemd-run \
+  --unit=cloudflared-tunnel \
+  --description="Cloudflared Tunnel (transient)" \
+  --property=Restart=on-failure \
+  --property=RestartSec=5 \
+  --property=User={user_name} \
+  --property=Group={user_name} \
+  --property=Environment=HOME=/home/{user_name} \
+  --property=WorkingDirectory=/home/{user_name} \
+  /home/{user_name}/.local/bin/cloudflared \
+    --config /home/{user_name}/.cloudflared/config.yml \
+    tunnel run {tunnel_name}
+"""
+        case "as-service":
+            code = """
 home_dir=$HOME
 cloudflared_path="$home_dir/.local/bin/cloudflared"
 sudo $cloudflared_path service uninstall
 sudo rm /etc/cloudflared/config.yml || true
 sudo $cloudflared_path --config $home_dir/.cloudflared/config.yml service install
 """
-    print(code)
-    print("NOTE: Please run the above commands in your terminal to apply the changes.")
+
+    from machineconfig.utils.code import exit_then_run_shell_script, print_code
+    print_code(code, lexer="bash", desc="code to achieve the goal")
+    yes = typer.confirm("Do you want to run the above commands now?", default=False)
+    if yes:
+        exit_then_run_shell_script(code)
+    
+
+
+def vscode_share(
+    action: Annotated[Literal["run", "install-service", "uninstall-service", "share-local"], typer.Option(..., "--action", "-a", help="Action to perform", case_sensitive=False, show_choices=True)],
+    name: Annotated[str | None, typer.Option("--name", "-n", help="Name for the tunnel/service")] = None,
+    path: Annotated[str | None, typer.Option("--path", "-p", help="Path to share locally (for share-local)")] = None,
+    extra_args: Annotated[str | None, typer.Option("--extra-args", "-e", help="Extra args to append to the code tunnel command")] = None,
+) -> None:
+    """🧑‍💻 Share workspace using VS Code Tunnels ("code tunnel")
+
+    Note: this helper prints recommended commands and optionally runs them.
+    If you need more functionality, consult VS Code Tunnels docs: https://code.visualstudio.com/docs/remote/tunnels
+    """
+    accept = "--accept-server-license-terms"
+    name_part = f"--name {name}" if name else ""
+    extra = extra_args or ""
+
+    if action == "run":
+        cmd = f"code tunnel {name_part} {accept} {extra}".strip()
+        desc = "Run a one-off VS Code tunnel (foreground)"
+    elif action == "install-service":
+        cmd = f"code tunnel service install {accept} {name_part}".strip()
+        desc = "Install code tunnel as a service"
+    elif action == "uninstall-service":
+        cmd = "code tunnel service uninstall"
+        desc = "Uninstall code tunnel service"
+    elif action == "share-local":
+        p = path or "."
+        # Some VS Code CLI integrations prefer starting a tunnel and then using the editor to expose resources.
+        cmd = f"code tunnel {name_part} {accept} {extra}".strip()
+        desc = f"Start tunnel and then share local path: {p} (use VS Code UI to forward ports / share files)"
+    else:
+        print(f"Unknown action: {action}")
+        return
+
+    from machineconfig.utils.code import print_code, exit_then_run_shell_script
+    print_code(cmd, lexer="bash", desc=desc)
+
+    if typer.confirm("Do you want to run the above command now?", default=False):
+        exit_then_run_shell_script(cmd)
+    else:
+        print("Command not executed. Use the printed command in your terminal when ready.")
+    
+
 
 def add_ip_exclusion_to_warp(ip: Annotated[str, typer.Option(..., "--ip", help="IP address(es) to exclude from WARP (Comma separated)")]):
     ips = ip.split(",")
@@ -173,6 +250,9 @@ def get_app():
     nw_apps.command(name="receive", no_args_is_help=True, hidden=False, help="📁 [rx] receive files to here.")(machineconfig.scripts.python.helpers.helpers_devops.cli_share_file.share_file_receive)
     nw_apps.command(name="rx", no_args_is_help=True, hidden=True, help="📁 [rx] receive files to here.")(machineconfig.scripts.python.helpers.helpers_devops.cli_share_file.share_file_receive)
 
+    nw_apps.command(name="share-temp-file", help="🌡️ [T] Share a file via temp.sh")(cli_share_temp.upload_file)
+    nw_apps.command(name="T", help="Share a file via temp.sh", hidden=True)(cli_share_temp.upload_file)
+
     nw_apps.add_typer(cli_ssh.get_app(), name="ssh", help="🔐 [S] SSH subcommands")
     nw_apps.add_typer(cli_ssh.get_app(), name="S", help="SSH subcommands", hidden=True)
 
@@ -193,9 +273,13 @@ def get_app():
     nw_apps.command(name="l", no_args_is_help=False, help="Link WSL home and Windows home directories.", hidden=True)(link_wsl_and_windows_home)
 
 
-    nw_apps.command(name="reset-cloudflare-tunnel", help="☁️  [r] Reset Cloudflare tunnel service")(reset_cloudflare_tunnel)
+    nw_apps.command(name="reset-cloudflare-tunnel", help="☁️ [r] Reset Cloudflare tunnel service")(reset_cloudflare_tunnel)
     nw_apps.command(name="r", help="Reset Cloudflare tunnel service", hidden=True)(reset_cloudflare_tunnel)
     nw_apps.command(name="add-ip-exclusion-to-warp", help="🚫 [p] Add IP exclusion to WARP")(add_ip_exclusion_to_warp)
     nw_apps.command(name="p", help="Add IP exclusion to WARP", hidden=True)(add_ip_exclusion_to_warp)
 
+    # VS Code Tunnels helper
+    nw_apps.command(name="vscode-share", no_args_is_help=True, help="🧑‍💻 [v] Share workspace via VS Code Tunnels")(vscode_share)
+    nw_apps.command(name="v", no_args_is_help=True, hidden=True, help="Share workspace via VS Code Tunnels")(vscode_share)
+
     return nw_apps

machineconfig/scripts/python/helpers/helpers_devops/cli_repos.py

@@ -125,7 +125,7 @@ def count_lines_in_repo(repo_path: Annotated[str, typer.Argument(..., help="Path
         # from machineconfig.scripts.python.helpers.helpers_repos import repo_analyzer_1
         # repo_analyzer_1.count_historical_line_edits(repo_path=repo_path)
     # from machineconfig.utils.code import run_lambda_function
-    # run_lambda_function(lambda: func(repo_path=repo_path), uv_project_dir=None, uv_with=["machineconfig>=8.51"])
+    # run_lambda_function(lambda: func(repo_path=repo_path), uv_project_dir=None, uv_with=["machineconfig>=8.61"])
     from machineconfig.scripts.python.helpers.helpers_repos import repo_analyzer_1
     try:
         repo_analyzer_1.count_historical_line_edits(repo_path=repo_path)
@@ -138,7 +138,7 @@ def print_python_files_by_size(repo_path: Annotated[str, typer.Argument(..., hel
     #     from machineconfig.scripts.python.helpers.helpers_repos.repo_analyzer_2 import print_python_files_by_size_impl
     #     print_python_files_by_size_impl(repo_path=repo_path)
     # from machineconfig.utils.code import run_lambda_function
-    # run_lambda_function(lambda: func(repo_path=repo_path), uv_project_dir=None, uv_with=["machineconfig[plot]>=8.51"])
+    # run_lambda_function(lambda: func(repo_path=repo_path), uv_project_dir=None, uv_with=["machineconfig[plot]>=8.61"])
     from machineconfig.scripts.python.helpers.helpers_repos.repo_analyzer_2 import print_python_files_by_size_impl
     print_python_files_by_size_impl(repo_path=repo_path)
 
@@ -148,7 +148,7 @@ def analyze_repo_development(repo_path: Annotated[str, typer.Argument(..., help=
     #     from machineconfig.scripts.python.helpers.helpers_repos.repo_analyzer_2 import analyze_over_time
     #     analyze_over_time(repo_path=repo_path)
     # from machineconfig.utils.code import run_lambda_function
-    # run_lambda_function(lambda: func(repo_path=repo_path), uv_project_dir=None, uv_with=["machineconfig[plot]>=8.51"])
+    # run_lambda_function(lambda: func(repo_path=repo_path), uv_project_dir=None, uv_with=["machineconfig[plot]>=8.61"])
     from machineconfig.scripts.python.helpers.helpers_repos.repo_analyzer_2 import analyze_over_time
     analyze_over_time(repo_path=repo_path)
 

machineconfig/scripts/python/helpers/helpers_devops/cli_self.py

@@ -177,21 +177,47 @@ def readme():
     console.print(md)
 
 
+def buid_docker(
+    variant: Annotated[Literal["slim", "ai"], typer.Argument(..., help="Variant to build: 'slim' or 'ai'")] = "slim",
+) -> None:
+    """🧱 `buid_docker` — wrapper for `jobs/shell/docker_build_and_publish.sh`"""
+    from pathlib import Path
+    import machineconfig
+    script_path = Path(machineconfig.__file__).resolve().parent.parent.parent.joinpath("jobs", "shell", "docker_build_and_publish.sh")
+    if not script_path.exists():
+        typer.echo(f"❌ Script not found: {str(script_path)}")
+        raise typer.Exit(code=1)
+
+    # shell_cmd = f'VARIANT="{variant}" && bash "{str(script_path)}"'\
+    from machineconfig.utils.source_of_truth import REPO_ROOT
+    shell_cmd = f"""
+export VARIANT="{variant}"
+cd "{str(REPO_ROOT)}"
+bash "{str(script_path)}"
+"""
+    # Use exit_then_run_shell_script for interactive runs (keeps tty), otherwise run shell script non-interactively
+    from machineconfig.utils.code import exit_then_run_shell_script
+    exit_then_run_shell_script(shell_cmd, strict=True)
+
+
 def get_app():
     cli_app = typer.Typer(help="🔄 [s] self operations subcommands", no_args_is_help=True, add_help_option=True, add_completion=False)
-    cli_app.command("update",      no_args_is_help=False, help="🔄 [u] UPDATE machineconfig")(update)
-    cli_app.command("u",           no_args_is_help=False, hidden=True)(update)
-    cli_app.command("interactive", no_args_is_help=False, help="🤖 [ia] INTERACTIVE configuration of machine.")(interactive)
-    cli_app.command("ia",           no_args_is_help=False, help="INTERACTIVE configuration of machine.", hidden=True)(interactive)
-    cli_app.command(name="init",         no_args_is_help=False, help="🦐 [t] Define and manage configurations")(init)
-    cli_app.command(name="t",            no_args_is_help=False, hidden=True)(init)
-    cli_app.command("status",      no_args_is_help=False, help="📊 [s] STATUS of machine, shell profile, apps, symlinks, dotfiles, etc.")(status)
-    cli_app.command("s",           no_args_is_help=False, help="STATUS of machine, shell profile, apps, symlinks, dotfiles, etc.", hidden=True)(status)
-    cli_app.command("install",     no_args_is_help=False, help="📋 [i] CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.")(install)
-    cli_app.command("i",           no_args_is_help=False, help="CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.", hidden=True)(install)
-    cli_app.command("navigate", no_args_is_help=False, help="📚 [n] NAVIGATE command structure with TUI")(navigate)
-    cli_app.command("n", no_args_is_help=False, help="NAVIGATE command structure with TUI", hidden=True)(navigate)
-
-    cli_app.command("readme", no_args_is_help=False, help="📚 [r] render readme markdown in terminal.")(readme)
-    cli_app.command("r", no_args_is_help=False, hidden=True)(readme)
+    cli_app.command(name= "update",      no_args_is_help=False, help="🔄 [u] UPDATE machineconfig")(update)
+    cli_app.command(name= "u",           no_args_is_help=False, hidden=True)(update)
+    cli_app.command(name= "interactive", no_args_is_help=False, help="🤖 [ia] INTERACTIVE configuration of machine.")(interactive)
+    cli_app.command(name= "ia",           no_args_is_help=False, help="INTERACTIVE configuration of machine.", hidden=True)(interactive)
+    cli_app.command(name= "init",         no_args_is_help=False, help="🦐 [t] Define and manage configurations")(init)
+    cli_app.command(name= "t",            no_args_is_help=False, hidden=True)(init)
+    cli_app.command(name= "status",      no_args_is_help=False, help="📊 [s] STATUS of machine, shell profile, apps, symlinks, dotfiles, etc.")(status)
+    cli_app.command(name= "s",           no_args_is_help=False, help="STATUS of machine, shell profile, apps, symlinks, dotfiles, etc.", hidden=True)(status)
+    cli_app.command(name= "install",     no_args_is_help=False, help="📋 [i] CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.")(install)
+    cli_app.command(name= "i",           no_args_is_help=False, help="CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.", hidden=True)(install)
+    cli_app.command(name= "navigate", no_args_is_help=False, help="📚 [n] NAVIGATE command structure with TUI")(navigate)
+    cli_app.command(name= "n", no_args_is_help=False, help="NAVIGATE command structure with TUI", hidden=True)(navigate)
+
+    cli_app.command(name= "buid_docker", no_args_is_help=False, help="🧱 [d] Build docker images (wraps jobs/shell/docker_build_and_publish.sh)")(buid_docker)
+    cli_app.command(name= "d", no_args_is_help=False, help="Build docker images (wraps jobs/shell/docker_build_and_publish.sh)", hidden=True)(buid_docker)
+
+    cli_app.command(name= "readme", no_args_is_help=False, help="📚 [r] render readme markdown in terminal.")(readme)
+    cli_app.command(name= "r", no_args_is_help=False, hidden=True)(readme)
     return cli_app

machineconfig/scripts/python/helpers/helpers_devops/cli_share_temp.py

@@ -0,0 +1,69 @@
+
+import json
+import sys
+from pathlib import Path
+from typing import Annotated
+
+import requests
+import typer
+
+
+TEMP_BASE_URL: str = "https://temp.sh"
+UPLOAD_ENDPOINT: str = f"{TEMP_BASE_URL}/upload"
+
+
+def _extract_url(response: requests.Response) -> str:
+	content_type = response.headers.get("content-type", "")
+	text = response.text.strip()
+	if "application/json" in content_type:
+		try:
+			data = response.json()
+		except (json.JSONDecodeError, ValueError):
+			data = None
+		if isinstance(data, dict):
+			url_value = data.get("url") or data.get("link") or data.get("download")
+			if isinstance(url_value, str) and url_value.strip() != "":
+				return url_value.strip()
+	for token in text.split():
+		if token.startswith("https://") or token.startswith("http://"):
+			return token
+	return text
+
+
+def _upload_file_handle(file_name: str, file_handle: object, content_type: str | None) -> str:
+	files: dict[str, tuple[str, object, str] | tuple[str, object]]
+	if content_type is None:
+		files = {"file": (file_name, file_handle)}
+	else:
+		files = {"file": (file_name, file_handle, content_type)}
+	response = requests.post(UPLOAD_ENDPOINT, files=files)  # type: ignore[reportArgumentType]
+	response.raise_for_status()
+	return _extract_url(response=response)
+
+
+def upload_file(
+	file_path: Annotated[Path, typer.Argument(..., exists=True, dir_okay=False, readable=True)],
+) -> None:
+	try:
+		with file_path.open("rb") as file_handle:
+			url = _upload_file_handle(file_name=file_path.name, file_handle=file_handle, content_type=None)
+	except requests.RequestException as exc:
+		typer.echo(f"Upload failed: {exc}")
+		raise typer.Exit(1)
+	typer.echo(url)
+
+
+def upload_text(
+	text: Annotated[str, typer.Argument(...)],
+) -> None:
+	text_value = text
+	if text == "-":
+		text_value = sys.stdin.read()
+	try:
+		payload = text_value.encode("utf-8")
+		url = _upload_file_handle(file_name="text.txt", file_handle=payload, content_type="text/plain; charset=utf-8")
+	except requests.RequestException as exc:
+		typer.echo(f"Upload failed: {exc}")
+		raise typer.Exit(1)
+	typer.echo(url)
+