machineconfig 7.49__py3-none-any.whl → 7.64__py3-none-any.whl

machineconfig/scripts/python/fire_jobs.py

@@ -8,11 +8,9 @@ fire
 """
 
 from machineconfig.utils.ve import get_ve_path_and_ipython_profile
-from machineconfig.utils.options import choose_from_options
-from machineconfig.utils.path_helper import match_file_name, sanitize_path
-from machineconfig.utils.path_extended import PathExtended
 from machineconfig.utils.accessories import get_repo_root, randstr
 from machineconfig.scripts.python.helpers_fire_command.fire_jobs_args_helper import FireJobArgs, extract_kwargs, parse_fire_args_from_context
+from machineconfig.utils.path_helper import get_choice_file
 
 import platform
 from typing import Optional, Annotated
@@ -21,25 +19,12 @@ import typer
 
 
 def route(args: FireJobArgs, fire_args: str = "") -> None:
-    path_obj = sanitize_path(args.path)
-    if not path_obj.exists():
-        suffixes = {".py", ".sh", ".ps1"}
-        choice_file = match_file_name(sub_string=args.path, search_root=PathExtended.cwd(), suffixes=suffixes)
-    elif path_obj.is_dir():
-        from machineconfig.scripts.python.helpers_fire_command.file_wrangler import search_for_files_of_interest
-        print(f"🔍 Searching recursively for Python, PowerShell and Shell scripts in directory `{path_obj}`")
-        files = search_for_files_of_interest(path_obj)
-        print(f"🔍 Got #{len(files)} results.")
-        choice_file = choose_from_options(multi=False, options=files, fzf=True, msg="Choose one option")
-        choice_file = PathExtended(choice_file)
-    else:
-        choice_file = path_obj
-
+    choice_file = get_choice_file(args.path, suffixes=None)
     repo_root = get_repo_root(Path(choice_file))
     print(f"💾 Selected file: {choice_file}.\nRepo root: {repo_root}")
     if args.marimo:
         print(f"🧽 Preparing to launch Marimo notebook for `{choice_file}`...")
-        tmp_dir = PathExtended.tmp().joinpath(f"tmp_scripts/marimo/{choice_file.stem}_{randstr()}")
+        tmp_dir = Path.home().joinpath(f"tmp_results/tmp_scripts/marimo/{choice_file.stem}_{randstr()}")
         tmp_dir.mkdir(parents=True, exist_ok=True)
         script = f"""
 cd {tmp_dir}
@@ -53,7 +38,6 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
 
     # =========================  preparing kwargs_dict
     if choice_file.suffix == ".py":
-        
         kwargs_dict = extract_kwargs(args)  # This now returns empty dict, but kept for compatibility
     else:
         kwargs_dict = {}
@@ -62,17 +46,20 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
     choice_function: Optional[str] = None  # Initialize to avoid unbound variable
     if args.choose_function:
         from machineconfig.scripts.python.helpers_fire_command.fire_jobs_route_helper import choose_function_or_lines
+
         choice_function, choice_file, kwargs_dict = choose_function_or_lines(choice_file, kwargs_dict)
     else:
         choice_function = args.function
 
     if choice_file.suffix == ".py":
         from machineconfig.scripts.python.helpers_fire_command.fire_jobs_route_helper import get_command_streamlit
+
         with_project = f"--project {repo_root} " if repo_root is not None else ""
         if args.streamlit:
             exe = get_command_streamlit(choice_file=choice_file, environment=args.environment, repo_root=repo_root)
             exe = f"uv run {with_project} {exe} "
-        elif args.jupyter: exe = f"uv run {with_project} jupyter-lab"
+        elif args.jupyter:
+            exe = f"uv run {with_project} jupyter-lab"
         else:
             if args.interactive:
                 _ve_root_from_file, ipy_profile = get_ve_path_and_ipython_profile(choice_file)
@@ -81,20 +68,38 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
                 exe = f"uv run {with_project} ipython -i --no-banner --profile {ipy_profile} "
             else:
                 exe = f"uv run {with_project} python "
-    elif choice_file.suffix == ".ps1" or choice_file.suffix == ".sh": exe = "."
-    elif choice_file.suffix == "": exe = ""
-    else: raise NotImplementedError(f"File type {choice_file.suffix} not supported, in the sense that I don't know how to fire it.")
+    elif choice_file.suffix == ".ps1" or choice_file.suffix == ".sh":
+        exe = "."
+    elif choice_file.suffix == "":
+        exe = ""
+    else:
+        raise NotImplementedError(f"File type {choice_file.suffix} not supported, in the sense that I don't know how to fire it.")
 
-    if args.module or (args.debug and args.choose_function):  # because debugging tools do not support choosing functions and don't interplay with fire module. So the only way to have debugging and choose function options is to import the file as a module into a new script and run the function of interest there and debug the new script.
+    if args.module or (args.debug and args.choose_function):
+        # because debugging tools do not support choosing functions and don't interplay with fire module. So the only way to have debugging and choose function options is to import the file as a module into a new script and run the function of interest there and debug the new script.
         assert choice_file.suffix == ".py", f"File must be a python file to be imported as a module. Got {choice_file}"
         from machineconfig.scripts.python.helpers_fire_command.file_wrangler import get_import_module_code, wrap_import_in_try_except
         from machineconfig.utils.meta import lambda_to_python_script
         from machineconfig.utils.code import print_code
+
         import_code = get_import_module_code(str(choice_file))
-        import_code_robust = lambda_to_python_script(lambda: wrap_import_in_try_except(import_line=import_code, pyfile=str(choice_file), repo_root=str(repo_root) if repo_root is not None else None), in_global=True, import_module=False)
-        code_printing = lambda_to_python_script(lambda: print_code(code=import_code_robust, lexer="python", desc="import code"), in_global=True, import_module=False)
-        if choice_function is not None: calling = f"""res = {choice_function}({("**" + str(kwargs_dict)) if kwargs_dict else ""})"""
-        else: calling = """# No function selected to call. You can add your code here."""
+        import_code_robust = lambda_to_python_script(
+            lambda: wrap_import_in_try_except(
+                import_line=import_code, pyfile=str(choice_file), repo_root=str(repo_root) if repo_root is not None else None
+            ),
+            in_global=True,
+            import_module=False,
+        )
+        # print(f"🧩 Preparing import code for module import:\n{import_code}")
+        code_printing = lambda_to_python_script(
+            lambda: print_code(code=import_code_robust, lexer="python", desc="import as module code"),
+            in_global=True, import_module=False
+        )
+        print(f"🧩 Preparing import code for module import:\n{import_code}")
+        if choice_function is not None:
+            calling = f"""res = {choice_function}({("**" + str(kwargs_dict)) if kwargs_dict else ""})"""
+        else:
+            calling = """# No function selected to call. You can add your code here."""
         choice_file = Path.home().joinpath(f"tmp_results/tmp_scripts/python/{Path(choice_file).parent.name}_{Path(choice_file).stem}_{randstr()}.py")
         choice_file.parent.mkdir(parents=True, exist_ok=True)
         choice_file.write_text(import_code_robust + "\n" + code_printing + "\n" + calling, encoding="utf-8")
@@ -117,15 +122,17 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
         if args.holdDirectory:
             command = f"{exe} {choice_file}"
         else:
-            command = f"cd {choice_file.parent}\n{exe} {choice_file.name}\ncd {PathExtended.cwd()}"
+            command = f"cd {choice_file.parent}\n{exe} {choice_file.name}\ncd {Path.cwd()}"
     elif args.cmd:
         command = rf""" cd /d {choice_file.parent} & {exe} {choice_file.name} """
     else:
-        if choice_file.suffix == "": command = f"{exe} {choice_file} {fire_args}"
-        else: command = f"{exe} {choice_file} "
-
+        if choice_file.suffix == "":
+            command = f"{exe} {choice_file} {fire_args}"
+        else:
+            command = f"{exe} {choice_file} "
 
-    if not args.cmd: pass
+    if not args.cmd:
+        pass
     else:
         new_line = "\n"
         command = rf"""start cmd -Argument "/k {command.replace(new_line, " & ")} " """  # this works from powershell
@@ -134,23 +141,27 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
         if choice_function is not None:
             command += f"--function {choice_function} "
 
-    if args.optimized: command = command.replace("python ", "python -OO ")
+    if args.optimized:
+        command = command.replace("python ", "python -OO ")
 
     from rich.panel import Panel
     from rich.console import Console
     from rich.syntax import Syntax
+
     console = Console()
     if args.zellij_tab is not None:
-        comman_path__ = PathExtended.tmpfile(suffix=".sh")
+        comman_path__ = Path.home().joinpath(f"tmp_results/tmp_scripts/zellij_commands/{choice_file.stem}_{randstr()}.sh")
         comman_path__.parent.mkdir(parents=True, exist_ok=True)
         comman_path__.write_text(command, encoding="utf-8")
         console.print(Panel(Syntax(command, lexer="shell"), title=f"🔥 fire command @ {comman_path__}: "), style="bold red")
         import subprocess
+
         existing_tab_names = subprocess.run(["zellij", "action", "query-tab-names"], capture_output=True, text=True, check=True).stdout.splitlines()
         if args.zellij_tab in existing_tab_names:
             print(f"⚠️ Tab name `{args.zellij_tab}` already exists. Please choose a different name.")
             args.zellij_tab += f"_{randstr(3)}"
         from machineconfig.cluster.sessions_managers.zellij_local import run_command_in_zellij_tab
+
         command = run_command_in_zellij_tab(command=str(comman_path__), tab_name=args.zellij_tab, cwd=None)
     if args.watch:
         command = "watchexec --restart --exts py,sh,ps1 " + command
@@ -158,6 +169,7 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
         command = f"\ngit -C {choice_file.parent} pull\n" + command
     if args.PathExport:
         from machineconfig.scripts.python.helpers_fire_command.file_wrangler import add_to_path
+
         export_line = add_to_path(path_variable="PYTHONPATH", directory=str(repo_root))
         command = export_line + "\n" + command
     if args.loop:
@@ -169,6 +181,7 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
             raise NotImplementedError(f"Platform {platform.system()} not supported.")
 
     from machineconfig.utils.code import exit_then_run_shell_script
+
     exit_then_run_shell_script(script=command, strict=False)
 
 
@@ -187,15 +200,14 @@ def fire(
     module: Annotated[bool, typer.Option("--module", "-m", help="Launch the main file")] = False,
     optimized: Annotated[bool, typer.Option("--optimized", "-O", help="Run the optimized version of the function")] = False,
     zellij_tab: Annotated[Optional[str], typer.Option("--zellij-tab", "-z", help="Open in a new zellij tab")] = None,
-    
     submit_to_cloud: Annotated[bool, typer.Option("--submit-to-cloud", "-C", help="Submit to cloud compute")] = False,
     remote: Annotated[bool, typer.Option("--remote", "-r", help="Launch on a remote machine")] = False,
-
     streamlit: Annotated[bool, typer.Option("--streamlit", "-S", help="Run as streamlit app")] = False,
     environment: Annotated[str, typer.Option("--environment", "-E", help="Choose ip, localhost, hostname or arbitrary url")] = "",
-    holdDirectory: Annotated[bool, typer.Option("--holdDirectory", "-D", help="Hold current directory and avoid cd'ing to the script directory")] = False,
+    holdDirectory: Annotated[
+        bool, typer.Option("--holdDirectory", "-D", help="Hold current directory and avoid cd'ing to the script directory")
+    ] = False,
     PathExport: Annotated[bool, typer.Option("--PathExport", "-P", help="Augment the PYTHONPATH with repo root")] = False,
-
     git_pull: Annotated[bool, typer.Option("--git-pull", "-g", help="Start by pulling the git repo")] = False,
     watch: Annotated[bool, typer.Option("--watch", "-w", help="Watch the file for changes")] = False,
 ) -> None:
@@ -235,12 +247,14 @@ def fire(
     except Exception as e:
         # For other exceptions, print clean error message and exit
         import sys
+
         print(f"❌ Error: {e}", file=sys.stderr)
         sys.exit(1)
 
 
 def get_app():
     from typer import Typer
+
     app = Typer(add_completion=False)
     app.command(context_settings={"allow_extra_args": True, "allow_interspersed_args": False})(fire)
     return app

machineconfig/scripts/python/ftpx.py

@@ -145,8 +145,10 @@ def ftpx(
         received_file = PathExtended(resolved_target)  # type: ignore
     else:
         if source_is_remote:
-            assert resolved_source is not None, """
-❌ Path Error: Source must be a remote path (machine:path)"""
+            if resolved_source is None:
+                typer.echo("""❌ Path Error: Source must be a remote path (machine:path)""")
+                typer.Exit(code=1)
+                return                
             target_display = resolved_target or "<auto>"
             console.print(
                 Panel(

machineconfig/scripts/python/helpers_agents/agentic_frameworks/fire_qwen.py

@@ -5,22 +5,10 @@ from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import
 
 
 def fire_qwen(ai_spec: AI_SPEC, prompt_path: Path, repo_root: Path, config_dir: str | None) -> str:
-    # assert model == "qwen", "Only qwen is supported currently."
-    # assert provider == "qwen", "Only qwen is supported currently."
-    # model = "qwen"
-    # model = "gemini-2.5-flash-lite"
-    # model = None  # auto-select
-    # if model is None:
-    #     model_arg = ""
-    # else:
     _ = ai_spec["provider"]
-    # model_arg = f"--model {shlex.quote(model)}"
-    # Need a real shell for the pipeline; otherwise '| gemini ...' is passed as args to 'cat'
     safe_path = shlex.quote(str(prompt_path))
-
     match ai_spec["machine"]:
         case "local":
-            # Export the environment variable so it's available to subshells
             cmd = f"""
 qwen --yolo --prompt {safe_path}
     """

machineconfig/scripts/python/helpers_croshell/crosh.py

@@ -1,6 +1,6 @@
 
 
-def code(path: str, title: str):
+def get_read_python_file_pycode(path: str, title: str):
     from pathlib import Path
     print("Reading code from path:", path)
     pycode = Path(path).read_text(encoding="utf-8")
@@ -20,9 +20,9 @@ def get_read_data_pycode(path: str):
     from rich.panel import Panel
     from rich.text import Text
     from rich.console import Console
-    from machineconfig.utils.path_extended import PathExtended
+    from pathlib import Path
     console = Console()
-    p = PathExtended(path).absolute()
+    p = Path(path).absolute()
     try:
         from machineconfig.utils.files.read import Read
         from machineconfig.utils.accessories import pprint

machineconfig/scripts/python/helpers_devops/cli_config.py

@@ -7,7 +7,7 @@ import machineconfig.scripts.python.helpers_devops.cli_config_dotfile as dotfile
 import machineconfig.profile.create_links_export as create_links_export
 
 
-def shell(which: Annotated[Literal["default", "d", "nushell", "n"], typer.Option(..., "--which", "-w", help="Which shell profile to create/configure")]="default"):
+def configure_shell_profile(which: Annotated[Literal["default", "d", "nushell", "n"], typer.Option(..., "--which", "-w", help="Which shell profile to create/configure")]="default"):
     """🔗 Configure your shell profile."""
     from machineconfig.profile.create_shell_profile import create_default_shell_profile,  create_nu_shell_profile
     match which:
@@ -20,20 +20,6 @@ def shell(which: Annotated[Literal["default", "d", "nushell", "n"], typer.Option
     typer.echo(f"[red]Error:[/] Unknown shell profile type: {which}")
 
 
-def path():
-    """📚 NAVIGATE PATH variable with TUI"""
-    from machineconfig.scripts.python import env_manager as navigator
-    from pathlib import Path
-    path = Path(navigator.__file__).resolve().parent.joinpath("path_manager_tui.py")
-    from machineconfig.utils.code import run_shell_script, get_uv_command_executing_python_script
-    uv_with = ["textual"]
-    uv_project_dir = None
-    if not Path.home().joinpath("code/machineconfig").exists():
-        uv_with.append("machineconfig>=7.49")
-    else:
-        uv_project_dir = str(Path.home().joinpath("code/machineconfig"))
-    run_shell_script(get_uv_command_executing_python_script(python_script=path.read_text(encoding="utf-8"), uv_with=uv_with, uv_project_dir=uv_project_dir)[0])
-
 
 def pwsh_theme():
     """🔗 Select powershell prompt theme."""
@@ -97,10 +83,8 @@ def get_app():
     config_apps.command("b", no_args_is_help=True, help="Manage public configuration files.", hidden=True)(create_links_export.main_public_from_parser)
     config_apps.command("dotfile", no_args_is_help=True, help="🔗  [d] Manage dotfiles.")(dotfile_module.main)
     config_apps.command("d", no_args_is_help=True,  hidden=True)(dotfile_module.main)
-    config_apps.command("shell", no_args_is_help=False, help="🔗  [s] Configure your shell profile.")(shell)
-    config_apps.command("s", no_args_is_help=False, help="Configure your shell profile.", hidden=True)(shell)
-    config_apps.command("path", no_args_is_help=False, help="📚  [p] NAVIGATE PATH variable with TUI")(path)
-    config_apps.command("p", no_args_is_help=False, help="NAVIGATE PATH variable with TUI", hidden=True)(path)
+    config_apps.command("shell", no_args_is_help=False, help="🔗  [s] Configure your shell profile.")(configure_shell_profile)
+    config_apps.command("s", no_args_is_help=False, help="Configure your shell profile.", hidden=True)(configure_shell_profile)
     config_apps.command("starship-theme", no_args_is_help=False, help="🔗  [t] Select starship prompt theme.")(starship_theme)
     config_apps.command("t", no_args_is_help=False, help="Select starship prompt theme.", hidden=True)(starship_theme)
     config_apps.command("pwsh-theme", no_args_is_help=False, help="🔗  [T] Select powershell prompt theme.")(pwsh_theme)

machineconfig/scripts/python/helpers_devops/cli_config_dotfile.py

@@ -12,7 +12,9 @@ def main(
     method: Annotated[Literal["symlink", "s", "copy", "c"], typer.Option(..., "--method", "-m", help="Method to use for linking files")] = "copy",
     on_conflict: Annotated[ON_CONFLICT_LOOSE, typer.Option(..., "--on-conflict", "-o", help="Action to take on conflict")] = "throw-error",
     sensitivity: Annotated[Literal["private", "v", "public", "b"], typer.Option(..., "--sensitivity", "-s", help="Sensitivity of the config file.")] = "private",
-    destination: Annotated[str, typer.Option("--destination", "-d", help="destination folder (override the default, use at your own risk)")] = "",) -> None:
+    destination: Annotated[str, typer.Option("--destination", "-d", help="destination folder (override the default, use at your own risk)")] = "",
+    shared: Annotated[bool, typer.Option("--shared", "-sh", help="Whether the config file is shared across destinations directory.")] = False,
+    ) -> None:
     from rich.console import Console
     from rich.panel import Panel
     from machineconfig.utils.links import symlink_map, copy_map
@@ -27,26 +29,33 @@ def main(
     console = Console()
     orig_path = Path(file).expanduser().absolute()
     if destination == "":
-        new_path = backup_root.joinpath(orig_path.relative_to(Path.home()))
-        new_path.parent.mkdir(parents=True, exist_ok=True)
+        if shared:
+            new_path = backup_root.joinpath("shared").joinpath(orig_path.name)
+            new_path.parent.mkdir(parents=True, exist_ok=True)
+        else:
+            new_path = backup_root.joinpath(orig_path.relative_to(Path.home()))
+            new_path.parent.mkdir(parents=True, exist_ok=True)
     else:
-        dest_path = Path(destination).expanduser().absolute()
-        dest_path.mkdir(parents=True, exist_ok=True)
-        new_path = dest_path.joinpath(orig_path.name)
-
-
-    from machineconfig.utils.path_extended import PathExtended
+        if shared:
+            dest_path = Path(destination).expanduser().absolute()
+            dest_path.mkdir(parents=True, exist_ok=True)
+            new_path = dest_path.joinpath("shared").joinpath(orig_path.name)
+            new_path.parent.mkdir(parents=True, exist_ok=True)
+        else:
+            dest_path = Path(destination).expanduser().absolute()
+            dest_path.mkdir(parents=True, exist_ok=True)
+            new_path = dest_path.joinpath(orig_path.name)
     match method:
         case "copy" | "c":
             try:
-                copy_map(config_file_default_path=PathExtended(orig_path), self_managed_config_file_path=PathExtended(new_path), on_conflict=ON_CONFLICT_MAPPER[on_conflict])
+                copy_map(config_file_default_path=orig_path, self_managed_config_file_path=new_path, on_conflict=ON_CONFLICT_MAPPER[on_conflict])  # type: ignore[arg-type]
             except Exception as e:
                 typer.echo(f"[red]Error:[/] {e}")
                 typer.Exit(code=1)
                 return
         case "symlink" | "s":
             try:
-                symlink_map(config_file_default_path=PathExtended(orig_path), self_managed_config_file_path=PathExtended(new_path), on_conflict=ON_CONFLICT_MAPPER[on_conflict])
+                symlink_map(config_file_default_path=orig_path, self_managed_config_file_path=new_path, on_conflict=ON_CONFLICT_MAPPER[on_conflict])  # type: ignore[arg-type]
             except Exception as e:
                 typer.echo(f"[red]Error:[/] {e}")
                 typer.Exit(code=1)
@@ -56,10 +65,10 @@ def main(
 
     # mapper_snippet = "\n".join(
     #     [
-    #         f"[bold]📝 Edit configuration file:[/] [cyan]nano {PathExtended(CONFIG_ROOT)}/symlinks/mapper.toml[/cyan]",
+    #         f"[bold]📝 Edit configuration file:[/] [cyan]nano {Path(CONFIG_ROOT)}/symlinks/mapper.toml[/cyan]",
     #         "",
     #         f"[{new_path.parent.name}]",
-    #         f"{orig_path.name.split('.')[0]} = {{ this = '{orig_path.collapseuser().as_posix()}', to_this = '{new_path.collapseuser().as_posix()}' }}",
+    #         f"{orig_path.name.split('.')[0]} = {{ this = '{orig_path.as_posix()}', to_this = '{new_path.as_posix()}' }}",
     #     ]
     # )
     # console.print(

machineconfig/scripts/python/helpers_devops/cli_self.py

@@ -9,7 +9,9 @@ def copy_both_assets():
     create_helper.copy_assets_to_machine(which="settings")
 
 
-def update(copy_assets: Annotated[bool, typer.Option("--assets-copy/--no-assets-copy", "-a/-na", help="Copy (overwrite) assets to the machine after the update")] = True):
+def update(copy_assets: Annotated[bool, typer.Option("--assets-copy/--no-assets-copy", "-a/-na", help="Copy (overwrite) assets to the machine after the update")] = True,
+           link_public_configs: Annotated[bool, typer.Option("--link-public-configs/--no-link-public-configs", "-b/-nb", help="Link public configs after update (overwrites your configs!)")] = False,
+           ):
     """🔄 UPDATE uv and machineconfig"""
     from pathlib import Path
     if Path.home().joinpath("code", "machineconfig").exists():
@@ -34,8 +36,12 @@ uv tool install --upgrade machineconfig
     else:
         from machineconfig.utils.code import run_shell_script
         run_shell_script(shell_script)
-    if copy_assets:
-        copy_both_assets()
+        if copy_assets:
+            copy_both_assets()
+        if link_public_configs:
+            import machineconfig.profile.create_links_export as create_links_export
+            create_links_export.main_public_from_parser(method="copy", on_conflict="overwrite-default-path", which="all", interactive=False)
+
 
 def install(no_copy_assets: Annotated[bool, typer.Option("--no-assets-copy", "-na", help="Copy (overwrite) assets to the machine after the update")] = False):
     """📋 CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates."""
@@ -46,9 +52,9 @@ def install(no_copy_assets: Annotated[bool, typer.Option("--no-assets-copy", "-n
     else:
         import platform
         if platform.system() == "Windows":
-            run_shell_script(r"""& "$HOME\.local\bin\uv.exe" tool install --upgrade "machineconfig>=7.49" """)
+            run_shell_script(r"""& "$HOME\.local\bin\uv.exe" tool install --upgrade "machineconfig>=7.64" """)
         else:
-            run_shell_script("""$HOME/.local/bin/uv tool install --upgrade "machineconfig>=7.49" """)
+            run_shell_script("""$HOME/.local/bin/uv tool install --upgrade "machineconfig>=7.64" """)
     from machineconfig.profile.create_shell_profile import create_default_shell_profile
     if not no_copy_assets:
         create_default_shell_profile()   # involves copying assets too
@@ -73,7 +79,7 @@ def navigate():
     path = Path(navigator.__file__).resolve().parent.joinpath("devops_navigator.py")
     from machineconfig.utils.code import run_shell_script
     if Path.home().joinpath("code/machineconfig").exists(): executable = f"""--project "{str(Path.home().joinpath("code/machineconfig"))}" --with textual"""
-    else: executable = """--with "machineconfig>=7.49,textual" """
+    else: executable = """--with "machineconfig>=7.64,textual" """
     run_shell_script(f"""uv run {executable} {path}""")
 
 

machineconfig/scripts/python/helpers_devops/cli_share_file.py

@@ -12,7 +12,7 @@ Usage examples:
     devops network receive -- --relay 10.17.62.206:443 7121-donor-olympic-bicycle
     devops network receive -- croc --relay 10.17.62.206:443 7121-donor-olympic-bicycle
 """
-    from machineconfig.utils.installer_utils.installer import install_if_missing
+    from machineconfig.utils.installer_utils.installer_cli import install_if_missing
     install_if_missing(which="croc")
     import platform
     import sys
@@ -100,7 +100,7 @@ def share_file_send(path: Annotated[str, typer.Argument(help="Path to the file o
                     qrcode: Annotated[bool, typer.Option("--qrcode", "--qr", help="Show receive code as a qrcode")] = False,
                     ) -> None:
     """Send a file using croc with relay server."""
-    from machineconfig.utils.installer_utils.installer import install_if_missing
+    from machineconfig.utils.installer_utils.installer_cli import install_if_missing
     install_if_missing(which="croc")
     # Get relay server IP from environment or use default
     import socket

machineconfig/scripts/python/helpers_devops/cli_share_server.py

@@ -40,7 +40,7 @@ def web_file_explorer(
     over_internet: Annotated[bool, typer.Option("--over-internet", "-i", help="Expose the share server over the internet using ngrok")] = False,
     backend: Annotated[str, typer.Option("--backend", "-b", help="Backend to use: filebrowser (default), miniserve, or easy-sharing")] = "filebrowser"
 ) -> None:
-    from machineconfig.utils.installer_utils.installer import install_if_missing
+    from machineconfig.utils.installer_utils.installer_cli import install_if_missing
     
     if backend not in ["filebrowser", "miniserve", "easy-sharing"]:
         typer.echo(f"❌ ERROR: Invalid backend '{backend}'. Must be one of: filebrowser, miniserve, easy-sharing", err=True)

machineconfig/scripts/python/helpers_devops/cli_terminal.py

@@ -60,7 +60,7 @@ def main(
     ssl_ca: Annotated[Optional[str], typer.Option("--ssl-ca", "-A", help="SSL CA file path for client certificate verification")] = None,
     over_internet: Annotated[bool, typer.Option("--over-internet", "-i", help="Expose the terminal over the internet using ngrok")] = False
 ) -> None:
-    from machineconfig.utils.installer_utils.installer import install_if_missing
+    from machineconfig.utils.installer_utils.installer_cli import install_if_missing
     install_if_missing("ttyd")
     if over_internet: install_if_missing("ngrok")
 

machineconfig/scripts/python/helpers_devops/cli_utils.py

@@ -1,79 +1,7 @@
 
 
 import typer
-from typing import Annotated, Literal, Optional, TypedDict
-from pathlib import Path
-
-def download(
-    url: Annotated[Optional[str], typer.Argument(..., help="The URL to download the file from.")] = None,
-    decompress: Annotated[bool, typer.Option("--decompress", "-d", help="Decompress the file if it's an archive.")] = False,
-    output: Annotated[Optional[str], typer.Option("--output", "-o", help="The output file path.")] = None,
-) -> None:
-    if url is None:
-        typer.echo("❌ Error: URL is required.", err=True)
-        raise typer.Exit(code=1)
-    typer.echo(f"📥 Downloading from: {url}")    
-    download_path = Path(output) if output else Path(url.split("/")[-1])
-    import requests
-    import subprocess
-    try:
-        response = requests.get(url, allow_redirects=True, stream=True, timeout=60)
-        response.raise_for_status()
-        
-        total_size = int(response.headers.get('content-length', 0))
-        
-        with open(download_path, 'wb') as f:
-            if total_size == 0:
-                f.write(response.content)
-            else:
-                downloaded = 0
-                chunk_size = 8192
-                for chunk in response.iter_content(chunk_size=chunk_size):
-                    if chunk:
-                        f.write(chunk)
-                        downloaded += len(chunk)
-                        progress = (downloaded / total_size) * 100
-                        typer.echo(f"\r⏬ Progress: {progress:.1f}% ({downloaded}/{total_size} bytes)", nl=False)
-                typer.echo()
-        
-        typer.echo(f"✅ Downloaded to: {download_path}")
-    except requests.exceptions.RequestException as e:
-        typer.echo(f"❌ Download failed: {e}", err=True)
-        raise typer.Exit(code=1)
-    except OSError as e:
-        typer.echo(f"❌ File write error: {e}", err=True)
-        raise typer.Exit(code=1)
-    
-    if decompress:
-        typer.echo(f"📦 Decompressing: {download_path}")
-        
-        base_name = download_path.name
-        parts = base_name.split('.')
-        base_name = parts[0] if parts else download_path.stem
-        
-        extract_dir = download_path.parent / base_name
-        extract_dir.mkdir(parents=True, exist_ok=True)
-        
-        try:
-            subprocess.run(
-                ["ouch", "decompress", str(download_path), "--dir", str(extract_dir)],
-                check=True,
-                capture_output=True,
-                text=True
-            )
-            typer.echo(f"✅ Decompressed to: {extract_dir}")
-            
-            if download_path.exists():
-                download_path.unlink()
-                typer.echo(f"🗑️  Removed archive: {download_path}")
-                
-        except subprocess.CalledProcessError as e:
-            typer.echo(f"❌ Decompression failed: {e.stderr}", err=True)
-            raise typer.Exit(code=1)
-        except FileNotFoundError:
-            typer.echo("❌ Error: ouch command not found. Please install ouch.", err=True)
-            typer.echo("💡 Install with: cargo install ouch", err=True)
-            raise typer.Exit(code=1)
+from typing import Annotated, Optional
 
 
 def merge_pdfs(
@@ -165,82 +93,3 @@ def compress_pdf(
     uv_command, _py_file = get_uv_command_executing_python_script(python_script=code, uv_with=["pymupdf"], uv_project_dir=None)
     run_shell_script(uv_command)
 
-
-class MachineSpecs(TypedDict):
-    system: str
-    distro: str
-    home_dir: str
-def get_machine_specs() -> MachineSpecs:
-    """Write print and return the local machine specs."""
-    import platform
-    UV_RUN_CMD = "$HOME/.local/bin/uv run" if platform.system() != "Windows" else """& "$env:USERPROFILE/.local/bin/uv" run"""
-    command = f"""{UV_RUN_CMD} --with distro python -c "import distro; print(distro.name(pretty=True))" """
-    import subprocess
-    distro = subprocess.run(command, shell=True, capture_output=True, text=True).stdout.strip()
-    specs: MachineSpecs = {
-        "system": platform.system(),
-        "distro": distro,
-        "home_dir": str(Path.home()),
-    }
-    print(specs)
-    from machineconfig.utils.source_of_truth import CONFIG_ROOT
-    path = CONFIG_ROOT.joinpath("machine_specs.json")
-    CONFIG_ROOT.mkdir(parents=True, exist_ok=True)
-    import json
-    path.write_text(json.dumps(specs, indent=4), encoding="utf-8")
-    return specs
-
-
-def init_project(python: Annotated[Literal["3.13", "3.14"], typer.Option("--python", "-p", help="Python version for the uv virtual environment.")]= "3.13") -> None:
-    _ = python
-    repo_root = Path.cwd()
-    if not (repo_root / "pyproject.toml").exists():
-        typer.echo("❌ Error: pyproject.toml not found.", err=True)
-        raise typer.Exit(code=1)
-    print("Adding group `plot` with common data science and plotting packages...")
-    script = """
-uv add --group plot \
-    # Data & computation
-    numpy pandas polars duckdb-engine python-magic \
-    # Plotting / visualization
-    matplotlib plotly kaleido \
-    # Notebooks / interactive
-    ipython ipykernel jupyterlab nbformat marimo \
-    # Code analysis / type checking / linting
-    mypy pyright ruff pylint pyrefly \
-    # Packaging / build / dev
-    cleanpy \
-    # CLI / debugging / utilities
-    ipdb pudb \
-    # Type hints for packages
-    types-python-dateutil types-pyyaml types-requests types-tqdm \
-    types-mysqlclient types-paramiko types-pytz types-sqlalchemy types-toml types-urllib3 \
-
-"""
-    from machineconfig.utils.code import run_shell_script
-    run_shell_script(script)
-
-
-def edit(path: Annotated[Optional[str], typer.Argument(..., help="The root directory of the project to edit, or a file path.")] = None) -> None:
-    if path is None:
-        root_path = Path.cwd()
-        print(f"No path provided. Using current working directory: {root_path}")
-    else:
-        root_path = Path(path).expanduser().resolve()
-        print(f"Using provided path: {root_path}")
-    from machineconfig.utils.accessories import get_repo_root
-    repo_root = get_repo_root(root_path)
-    if repo_root is not None and repo_root.joinpath("pyproject.toml").exists():
-        code = f"""
-cd {repo_root}
-uv add --dev pylsp-mypy python-lsp-server[all] pyright ruff-lsp  # for helix editor.
-source ./.venv/bin/activate
-"""
-    else:
-        code = ""
-    if root_path.is_file():
-        code += f"hx {root_path}"
-    else:
-        code += "hx"
-    from machineconfig.utils.code import exit_then_run_shell_script
-    exit_then_run_shell_script(code)