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

machineconfig/scripts/python/{devops_update_repos.py → helpers_devops/devops_update_repos.py}

@@ -1,5 +1,6 @@
 """Update repositories with fancy output"""
 
+from concurrent.futures import ThreadPoolExecutor, as_completed
 from pathlib import Path
 
 import git
@@ -8,7 +9,7 @@ from rich.panel import Panel
 from rich.table import Table
 from rich.text import Text
 
-from machineconfig.scripts.python.repos_helper_update import RepositoryUpdateResult, run_uv_sync, update_repository
+from machineconfig.scripts.python.helpers_repos.update import RepositoryUpdateResult, run_uv_sync, update_repository
 from machineconfig.utils.io import read_ini
 from machineconfig.utils.source_of_truth import DEFAULTS_PATH
 
@@ -16,6 +17,55 @@ from machineconfig.utils.source_of_truth import DEFAULTS_PATH
 console = Console()
 
 
+def _process_single_repo(expanded_path: Path, allow_password_prompt: bool) -> tuple[RepositoryUpdateResult, Path | None]:
+    """Process a single repository and return the result."""
+    try:
+        repo = git.Repo(str(expanded_path), search_parent_directories=True)
+        # Update repository and get detailed results
+        result = update_repository(repo, allow_password_prompt=allow_password_prompt, auto_uv_sync=True)
+        
+        # Keep track of repos with dependency changes for additional uv sync
+        repo_path = None
+        if result["dependencies_changed"] and not result["uv_sync_ran"]:
+            repo_path = Path(repo.working_dir)
+        
+        return result, repo_path
+
+    except Exception as ex:
+        # Create a result for failed repos
+        error_result: RepositoryUpdateResult = {
+            "repo_path": str(expanded_path),
+            "status": "error",
+            "had_uncommitted_changes": False,
+            "uncommitted_files": [],
+            "commit_before": "",
+            "commit_after": "",
+            "commits_changed": False,
+            "pyproject_changed": False,
+            "dependencies_changed": False,
+            "uv_sync_ran": False,
+            "uv_sync_success": False,
+            "remotes_processed": [],
+            "remotes_skipped": [],
+            "error_message": str(ex),
+            "is_machineconfig_repo": False,
+            "permissions_updated": False,
+        }
+        console.print(
+            Panel(
+                "\n".join(
+                    [
+                        f"❌ Repository error: {expanded_path}",
+                        f"Exception: {ex}",
+                    ]
+                ),
+                border_style="red",
+                padding=(1, 2),
+            )
+        )
+        return error_result, None
+
+
 def _display_summary(results: list[RepositoryUpdateResult]) -> None:
     """Display a comprehensive summary of all repository update operations."""
 
@@ -148,7 +198,7 @@ def _display_summary(results: list[RepositoryUpdateResult]) -> None:
 def main(verbose: bool = True, allow_password_prompt: bool = False) -> None:
     """Main function to update all configured repositories."""
     _ = verbose
-    repos: list[Path] = [Path.home() / "code/machineconfig", Path.home() / "code/crocodile"]
+    repos: list[Path] = []
     try:
         tmp = read_ini(DEFAULTS_PATH)["general"]["repos"].split(",")
         if tmp[-1] == "":
@@ -188,60 +238,29 @@ def main(verbose: bool = True, allow_password_prompt: bool = False) -> None:
                 padding=(1, 2),
             )
         )
+    update_repos(repos, allow_password_prompt)
 
-    # Process repositories
+
+def update_repos(repos: list[Path], allow_password_prompt: bool) -> None:
+    # Process repositories in parallel
     results: list[RepositoryUpdateResult] = []
     repos_with_changes = []
-
-    for expanded_path in repos:
-        try:
-            repo = git.Repo(str(expanded_path), search_parent_directories=True)
-            # Update repository and get detailed results
-            result = update_repository(repo, allow_password_prompt=allow_password_prompt, auto_sync=True)
+    with ThreadPoolExecutor(max_workers=min(len(repos), 8)) as executor:
+        # Submit all tasks
+        future_to_repo = {
+            executor.submit(_process_single_repo, expanded_path, allow_password_prompt): expanded_path 
+            for expanded_path in repos
+        }
+        
+        # Collect results as they complete
+        for future in as_completed(future_to_repo):
+            result, repo_path = future.result()
             results.append(result)
-
-            # Keep track of repos with dependency changes for additional uv sync
-            if result["dependencies_changed"] and not result["uv_sync_ran"]:
-                repos_with_changes.append(Path(repo.working_dir))
-
-        except Exception as ex:
-            # Create a result for failed repos
-            error_result: RepositoryUpdateResult = {
-                "repo_path": str(expanded_path),
-                "status": "error",
-                "had_uncommitted_changes": False,
-                "uncommitted_files": [],
-                "commit_before": "",
-                "commit_after": "",
-                "commits_changed": False,
-                "pyproject_changed": False,
-                "dependencies_changed": False,
-                "uv_sync_ran": False,
-                "uv_sync_success": False,
-                "remotes_processed": [],
-                "remotes_skipped": [],
-                "error_message": str(ex),
-                "is_machineconfig_repo": False,
-                "permissions_updated": False,
-            }
-            results.append(error_result)
-            console.print(
-                Panel(
-                    "\n".join(
-                        [
-                            f"❌ Repository error: {expanded_path}",
-                            f"Exception: {ex}",
-                        ]
-                    ),
-                    border_style="red",
-                    padding=(1, 2),
-                )
-            )
-
+            if repo_path is not None:
+                repos_with_changes.append(repo_path)
     # Run uv sync for repositories where pyproject.toml changed but sync wasn't run yet
     for repo_path in repos_with_changes:
         run_uv_sync(repo_path)
-
     # Generate and display summary
     _display_summary(results)
 

machineconfig/scripts/python/helpers_devops/themes/choose_pwsh_theme.ps1

@@ -0,0 +1,81 @@
+# Requires: fzf, oh-my-posh
+# Purpose: Interactive Oh My Posh theme chooser with live preview
+
+# Path to your Oh My Posh themes directory
+$themesDir = "$env:LOCALAPPDATA\Programs\oh-my-posh\themes"
+
+if (-not (Test-Path $themesDir)) {
+    Write-Host "Themes directory not found at $themesDir" -ForegroundColor Red
+    exit 1
+}
+
+# Get all theme files and extract just the theme names for display
+$themes = Get-ChildItem $themesDir -Filter "*.omp.json" | ForEach-Object {
+    [PSCustomObject]@{
+        Name = $_.BaseName
+        Path = $_.FullName
+    }
+}
+
+# Create a simple preview command that shows theme name and a sample prompt
+$previewCommand = "pwsh -NoProfile -Command `"Write-Host 'Theme: ' -NoNewline -ForegroundColor Cyan; Write-Host (Split-Path '{}' -Leaf); Write-Host ''; oh-my-posh print primary --config '{}' 2>`$null`""
+
+# Run fzf with preview
+$selectedThemeName = $themes | ForEach-Object { $_.Path } |
+    fzf --height 80% --border --ansi --reverse `
+        --header "Select an Oh My Posh theme (Ctrl+C to cancel)" `
+        --preview $previewCommand `
+        --preview-window=right:60%:wrap
+
+# After fzf selection
+if ($selectedThemeName) {
+    Write-Host "`nYou selected:" -ForegroundColor Green
+    Write-Host (Split-Path $selectedThemeName -Leaf) -ForegroundColor Yellow
+    Write-Host "`nApplying theme..." -ForegroundColor Cyan
+    
+    # Apply the theme to current session
+    oh-my-posh init pwsh --config $selectedThemeName | Invoke-Expression
+    
+    Write-Host "`nTheme applied to current session!" -ForegroundColor Green
+    
+    # Safely update the PowerShell profile
+    $profilePath = $PROFILE
+    $ompLine = "oh-my-posh init pwsh --config '$selectedThemeName' | Invoke-Expression"
+    
+    # Create profile directory if it doesn't exist
+    $profileDir = Split-Path $profilePath -Parent
+    if (-not (Test-Path $profileDir)) {
+        New-Item -ItemType Directory -Path $profileDir -Force | Out-Null
+    }
+    
+    # Read existing profile content or create empty array
+    if (Test-Path $profilePath) {
+        $profileContent = Get-Content $profilePath -Raw
+    } else {
+        $profileContent = ""
+    }
+    
+    # Check if oh-my-posh line already exists and replace it
+    if ($profileContent -match "oh-my-posh init pwsh[^\r\n]*") {
+        # Replace existing oh-my-posh line
+        $profileContent = $profileContent -replace "oh-my-posh init pwsh[^\r\n]*", $ompLine
+    } else {
+        # Add the oh-my-posh line with proper newlines
+        if ($profileContent.Length -gt 0 -and -not $profileContent.EndsWith("`n")) {
+            $profileContent += "`n"
+        }
+        if ($profileContent.Length -gt 0) {
+            $profileContent += "`n"
+        }
+        $profileContent += $ompLine
+        $profileContent += "`n"
+    }
+    
+    # Write back to profile
+    $profileContent | Set-Content $profilePath -Encoding UTF8 -NoNewline
+    
+    Write-Host "Profile updated successfully!" -ForegroundColor Green
+    Write-Host "The theme will be applied automatically in future PowerShell sessions." -ForegroundColor Cyan
+} else {
+    Write-Host "`nNo theme selected." -ForegroundColor DarkGray
+}

machineconfig/scripts/python/helpers_devops/themes/choose_starship_theme.bash

@@ -0,0 +1,3 @@
+
+
+

machineconfig/scripts/python/{choose_wezterm_theme.py → helpers_devops/themes/choose_wezterm_theme.py}

@@ -45,21 +45,21 @@ schemes_list = [
 
 def main2():
     console.print(Panel("🎨 WezTerm Theme Selector", title_align="left", border_style="green"))
-    option = choose_from_options(multi=False, options=schemes_list, header="Choose a theme for Wezterm", fzf=True, msg="Use arrow keys to navigate, Enter to select a theme")
+    option = choose_from_options(multi=False, options=schemes_list, header="Choose a theme for Wezterm", tv=True, msg="Use arrow keys to navigate, Enter to select a theme")
     set_theme(option)
     print(f"✅ Theme set to: {option}")
 
 
 def set_theme(theme: str):
     print(f"🔄 Setting WezTerm theme to: {theme}")
-    txt_lines = PathExtended("~/.config/wezterm/wezterm.lua").expanduser().read_text(encoding="utf-8").splitlines()
+    txt_lines = PathExtended.home().joinpath(".config/wezterm/wezterm.lua").expanduser().read_text(encoding="utf-8").splitlines()
     res_lines = []
     for line in txt_lines:
         if "config.color_scheme = " in line:
             res_lines.append(f"config.color_scheme = '{theme}'")
         else:
             res_lines.append(line)
-    PathExtended("~/.config/wezterm/wezterm.lua").expanduser().write_text("\n".join(res_lines), encoding="utf-8")
+    PathExtended.home().joinpath(".config/wezterm/wezterm.lua").expanduser().write_text("\n".join(res_lines), encoding="utf-8")
     time.sleep(0.1)
     print("💾 Configuration saved")
 

machineconfig/scripts/python/{helpers/helpers4.py → helpers_fire_command/file_wrangler.py}

@@ -1,24 +1,7 @@
-
 from typing import Optional
 import os
-from machineconfig.utils.path_extended import PathExtended
-
-
-def search_for_files_of_interest(path_obj: PathExtended):
-    if path_obj.joinpath(".venv").exists():
-        path_objects = path_obj.search("*", not_in=[".venv"])
-        files: list[PathExtended] = []
-        for a_path_obj in path_objects:
-            files += search_for_files_of_interest(path_obj=a_path_obj)
-        return files
-    if path_obj.is_file():
-        return [path_obj]
-    py_files = path_obj.search(pattern="*.py", not_in=["__init__.py"], r=True)
-    ps_files = path_obj.search(pattern="*.ps1", r=True)
-    sh_files = path_obj.search(pattern="*.sh", r=True)
-    files = py_files + ps_files + sh_files
-    return files
-
+from pathlib import Path
+import platform
 
 
 def parse_pyfile(file_path: str):
@@ -29,7 +12,7 @@ def parse_pyfile(file_path: str):
     func_args: list[list[args_spec]] = [[]]  # this firt prepopulated dict is for the option 'RUN AS MAIN' which has no args
     import ast
 
-    parsed_ast = ast.parse(PathExtended(file_path).read_text(encoding="utf-8"))
+    parsed_ast = ast.parse(Path(file_path).read_text(encoding="utf-8"))
     functions = [node for node in ast.walk(parsed_ast) if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef))]
     module__doc__ = ast.get_docstring(parsed_ast)
     main_option = f"RUN AS MAIN -- {module__doc__ if module__doc__ is not None else 'NoDocs'}"
@@ -110,3 +93,56 @@ def get_import_module_code(module_path: str):
         module_name = "IncorrectModuleName"
     # TODO: use py_compile to check if the statement is valid code to avoid syntax errors that can't be caught.
     return f"from {module_name} import *"
+
+
+def wrap_import_in_try_except(import_line: str, pyfile: str, repo_root: Optional[str] = None) -> None:
+    try:
+        exec(import_line)  # type: ignore
+    except (ImportError, ModuleNotFoundError) as ex:
+        print(fr"❌ Failed to import `{pyfile}` as a module: {ex} ")
+        print("⚠️ Attempting import with ad-hoc `$PATH` manipulation. DO NOT pickle any objects in this session as correct deserialization cannot be guaranteed.")
+        import sys
+        sys.path.append(str(Path(pyfile).parent))
+        if repo_root is not None:
+            sys.path.append(repo_root)
+        exec(f"from {Path(pyfile).stem} import *")
+        print(fr"✅ Successfully imported `{pyfile}`")
+
+
+def add_to_path(path_variable: str, directory: str) -> str:
+    """
+    Generate shell script to add directory to path_variable.
+    Handles both Windows (cmd) and Unix-like systems (bash/zsh).
+    Checks if variable exists before appending, otherwise creates it.
+    """
+    system = platform.system()
+    
+    if system == "Windows":
+        script = f"""# Check if {path_variable} is defined
+if (Test-Path env:{path_variable}) {{
+    Write-Host "Adding {directory} to existing {path_variable}"
+    $currentValue = [Environment]::GetEnvironmentVariable("{path_variable}", "User")
+    $newValue = "$currentValue;{directory}"
+    [Environment]::SetEnvironmentVariable("{path_variable}", $newValue, "User")
+    $env:{path_variable} = $newValue
+}} else {{
+    Write-Host "Creating new {path_variable} variable"
+    [Environment]::SetEnvironmentVariable("{path_variable}", "{directory}", "User")
+    $env:{path_variable} = "{directory}"
+}}
+Write-Host "{path_variable} is now: $env:{path_variable}\""""
+        return script
+    else:
+        script = f"""#!/bin/bash
+# Check if {path_variable} is defined and not empty
+if [ -z "${{{path_variable}}}" ]; then
+    echo "Creating new {path_variable} variable"
+    export {path_variable}="{directory}"
+else
+    echo "Adding {directory} to existing {path_variable}"
+    export {path_variable}="${{{path_variable}}}:{directory}"
+fi
+echo "{path_variable} is now: ${{{path_variable}}}"
+"""
+        return script
+

machineconfig/scripts/python/{fire_jobs_args_helper.py → helpers_fire_command/fire_jobs_args_helper.py}

@@ -15,6 +15,7 @@ class FireJobArgs:
     choose_function: bool = False
     loop: bool = False
     jupyter: bool = False
+    marimo: bool = False
     submit_to_cloud: bool = False
     remote: bool = False
     module: bool = False
@@ -24,7 +25,6 @@ class FireJobArgs:
     PathExport: bool = False
     git_pull: bool = False
     optimized: bool = False
-    Nprocess: int = 1
     zellij_tab: Optional[str] = None
     watch: bool = False
 
@@ -96,6 +96,10 @@ def _convert_value_type(value: str) -> object:
     elif value.lower() in ('false', '0', 'no', 'off'):
         return False
     
+    # Try to convert None
+    if value.lower() == 'none':
+        return None
+    
     # Try to parse as list (comma-separated values)
     if ',' in value:
         items = [_convert_value_type(item.strip()) for item in value.split(',')]

machineconfig/scripts/python/helpers_fire_command/fire_jobs_route_helper.py

@@ -0,0 +1,121 @@
+
+
+import platform
+from typing import Optional
+import tomllib
+from pathlib import Path
+from machineconfig.utils.accessories import randstr
+from machineconfig.utils.options import choose_from_options
+
+
+def choose_function_or_lines(choice_file: Path, kwargs_dict: dict[str, object]) -> tuple[Optional[str], Path, dict[str, object]]:
+    """
+    Choose a function to run from a Python file or lines from a shell script.
+    
+    Returns:
+        tuple: (choice_function, choice_file, kwargs_dict)
+        - choice_function: The selected function name or None
+        - choice_file: The file path (potentially modified for shell scripts)
+        - kwargs_dict: Updated kwargs dictionary with user-provided arguments
+    """
+    choice_function: Optional[str] = None
+    
+    if choice_file.suffix == ".py":
+        from machineconfig.scripts.python.helpers_fire_command.file_wrangler import parse_pyfile
+        options, func_args = parse_pyfile(file_path=str(choice_file))
+        choice_function_tmp = choose_from_options(msg="Choose a function to run", options=options, tv=True, multi=False)
+        assert isinstance(choice_function_tmp, str), f"choice_function must be a string. Got {type(choice_function_tmp)}"
+        choice_index = options.index(choice_function_tmp)
+        choice_function = choice_function_tmp.split(" -- ")[0]
+        choice_function_args = func_args[choice_index]
+
+        if choice_function == "RUN AS MAIN":
+            choice_function = None
+        if len(choice_function_args) > 0 and len(kwargs_dict) == 0:
+            for item in choice_function_args:
+                kwargs_dict[item.name] = input(f"Please enter a value for argument `{item.name}` (type = {item.type}) (default = {item.default}) : ") or item.default
+    elif choice_file.suffix == ".sh":
+        options = []
+        for line in choice_file.read_text(encoding="utf-8").splitlines():
+            if line.startswith("#"):
+                continue
+            if line == "":
+                continue
+            if line.startswith("echo"):
+                continue
+            options.append(line)
+        chosen_lines = choose_from_options(msg="Choose a line to run", options=options, tv=True, multi=True)
+        choice_file = Path.home().joinpath(f"tmp_results/tmp_scripts/shell/{randstr(10)}.sh")
+        choice_file.parent.mkdir(parents=True, exist_ok=True)
+        choice_file.write_text("\n".join(chosen_lines), encoding="utf-8")
+        choice_function = None
+    
+    return choice_function, choice_file, kwargs_dict
+
+
+def get_command_streamlit(choice_file: Path, environment: str, repo_root: Optional[Path]) -> str:
+    # from machineconfig.scripts.python.helpers_utils.path import get_machine_specs
+    from machineconfig.scripts.python.helpers_network.address import select_lan_ipv4
+    res = select_lan_ipv4(prefer_vpn=False)
+    if res is None:
+        raise RuntimeError("Could not determine local LAN IPv4 address for streamlit app.")
+    local_ip_v4 = res
+
+    computer_name = platform.node()
+    port = 8501
+    toml_path: Optional[Path] = None
+    toml_path_maybe = choice_file.parent.joinpath(".streamlit/config.toml")
+    if toml_path_maybe.exists():
+        toml_path = toml_path_maybe
+    elif choice_file.parent.name == "pages":
+        toml_path_maybe = choice_file.parent.parent.joinpath(".streamlit/config.toml")
+        if toml_path_maybe.exists():
+            toml_path = toml_path_maybe
+    if toml_path is not None:
+        print(f"📄 Reading config.toml @ {toml_path}")
+        config = tomllib.loads(toml_path.read_text(encoding="utf-8"))
+        if "server" in config:
+            if "port" in config["server"]:
+                port = config["server"]["port"]
+        secrets_path = toml_path.with_name("secrets.toml")
+        if repo_root is not None:
+            secrets_template_path = Path.home().joinpath(f"dotfiles/creds/streamlit/{Path(repo_root).name}/{choice_file.name}/secrets.toml")
+            if environment != "" and not secrets_path.exists() and secrets_template_path.exists():
+                secrets_template = tomllib.loads(secrets_template_path.read_text(encoding="utf-8"))
+                if environment == "ip":
+                    host_url = f"http://{local_ip_v4}:{port}/oauth2callback"
+                elif environment == "localhost":
+                    host_url = f"http://localhost:{port}/oauth2callback"
+                elif environment == "hostname":
+                    host_url = f"http://{computer_name}:{port}/oauth2callback"
+                else:
+                    host_url = f"http://{environment}:{port}/oauth2callback"
+                try:
+                    secrets_template["auth"]["redirect_uri"] = host_url
+                    secrets_template["auth"]["cookie_secret"] = randstr(35)
+                    secrets_template["auth"]["auth0"]["redirect_uri"] = host_url
+                    # save_toml(obj=secrets_template, path=secrets_path)
+                except Exception as ex:
+                    print(ex)
+                    raise ex
+    from machineconfig.utils.installer_utils.installer_cli import install_if_missing
+    install_if_missing("qrterminal")
+    script = f"""
+qrterminal "http://{local_ip_v4}:{port}"
+echo "http://{local_ip_v4}:{port}"
+qrterminal "http://{computer_name}:{port}"
+echo "http://{computer_name}:{port}"
+"""
+    # from machineconfig.utils.code import run_shell_script
+    # run_shell_script(script)
+    from machineconfig.utils.code import print_code
+    print_code(code=script, lexer="shell", desc="Streamlit QR Codes and URLs")
+
+    message = f"🚀 Streamlit app is running @:\n1- http://{local_ip_v4}:{port}\n2- http://{computer_name}:{port}\n3- http://localhost:{port}"
+    from rich.panel import Panel
+    from rich import print as rprint
+
+    rprint(Panel(message))
+    exe = f"streamlit run --server.address 0.0.0.0 --server.headless true --server.port {port}"
+    # exe = f"cd '{choice_file.parent}'; " + exe
+    return exe

machineconfig/scripts/python/helpers_msearch/__init__.py

@@ -0,0 +1,5 @@
+
+from pathlib import Path
+
+FZFG_LINUX_PATH = Path(__file__).parent.joinpath("scripts_linux", "fzfg")
+FZFG_WINDOWS_PATH = Path(__file__).parent.joinpath("scripts_windows", "fzfg.ps1")

machineconfig/scripts/{linux → python/helpers_msearch/scripts_linux}/fzfg

@@ -13,11 +13,11 @@ IFS=: read -ra selected < <(
       --bind "change:reload:sleep 0.1; $RG_PREFIX {q} || true" \
       --bind "ctrl-f:unbind(change,ctrl-f)+change-prompt(2. fzf> )+enable-search+clear-query+rebind(ctrl-r)" \
       --bind "ctrl-r:unbind(ctrl-r)+change-prompt(1. ripgrep> )+disable-search+reload($RG_PREFIX {q} || true)+rebind(change,ctrl-f)" \
-      --prompt '1. Ripgrep> ' \
+      --prompt '1. ripgrep> ' \
       --delimiter : \
-      --header '╱ CTRL-R (Ripgrep mode) ╱ CTRL-F (fzf mode) ╱' \
+      --header '╱ CTRL-R (ripgrep mode) ╱ CTRL-F (fzf mode) ╱' \
       --preview 'bat --color=always {1} --highlight-line {2}' \
       --preview-window 'up,60%,border-bottom,+{2}+3/3,~3'
 )
-[ -n "${selected[0]}" ] && lvim "${selected[0]}" "+${selected[1]}
+[ -n "${selected[0]}" ] && hx "${selected[0]}:${selected[1]}:${selected[2]}"
 "

machineconfig/scripts/python/helpers_msearch/scripts_windows/fzfg.ps1

@@ -0,0 +1,59 @@
+#!/usr/bin/env pwsh
+[CmdletBinding()]
+param(
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [string[]]$QueryTokens
+)
+
+if ($null -eq $QueryTokens) {
+    $QueryTokens = @()
+}
+
+$initialQuery = if ($QueryTokens.Count -gt 0) { [string]::Join(' ', $QueryTokens) } else { '' }
+$rgPrefix = 'rg --column --line-number --no-heading --color=always --smart-case '
+
+$escapedDefault = if ($initialQuery.Length -gt 0) {
+    $rgPrefix + '"' + $initialQuery.Replace('"', '""') + '" || type nul'
+} else {
+    'type nul'
+}
+
+$previousDefault = $env:FZF_DEFAULT_COMMAND
+$env:FZF_DEFAULT_COMMAND = $escapedDefault
+
+$reloadBinding = "change:reload:$rgPrefix{q} || type nul"
+$ctrlFBinding = 'ctrl-f:unbind(change,ctrl-f)+change-prompt(2. fzf> )+enable-search+clear-query+rebind(ctrl-r)'
+$ctrlRBinding = "ctrl-r:unbind(ctrl-r)+change-prompt(1. ripgrep> )+disable-search+reload($rgPrefix{q} || type nul)+rebind(change,ctrl-f)"
+
+try {
+    $selectionRaw = & fzf --ansi `
+        --color 'hl:-1:underline,hl+:-1:underline:reverse' `
+        --disabled `
+        --query $initialQuery `
+        --bind $reloadBinding `
+        --bind $ctrlFBinding `
+        --bind $ctrlRBinding `
+        --prompt '1. ripgrep> ' `
+        --delimiter ':' `
+        --header 'CTRL-R (ripgrep mode) | CTRL-F (fzf mode)' `
+        --preview 'bat --color=always {1} --highlight-line {2}' `
+        --preview-window 'up,60%,border-bottom,+{2}+3/3,~3'
+}
+finally {
+    if ($null -ne $previousDefault) {
+        $env:FZF_DEFAULT_COMMAND = $previousDefault
+    } else {
+        Remove-Item Env:FZF_DEFAULT_COMMAND -ErrorAction SilentlyContinue
+    }
+}
+
+if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrWhiteSpace($selectionRaw)) {
+    exit
+}
+
+if ($selectionRaw -match '^(?<path>.+?):(?<line>\d+):(?<column>\d+):') {
+    $path = $Matches['path']
+    $line = [int]$Matches['line']
+    $column = [int]$Matches['column']
+    & hx ("{0}:{1}:{2}" -f $path,$line,$column)
+}

machineconfig/scripts/python/helpers_navigator/__init__.py

@@ -0,0 +1,20 @@
+"""
+Helper modules for the devops navigator TUI application.
+"""
+
+from machineconfig.scripts.python.helpers_navigator.data_models import CommandInfo, ArgumentInfo
+from machineconfig.scripts.python.helpers_navigator.command_builder import CommandBuilderScreen
+from machineconfig.scripts.python.helpers_navigator.command_tree import CommandTree
+from machineconfig.scripts.python.helpers_navigator.command_detail import CommandDetail
+from machineconfig.scripts.python.helpers_navigator.search_bar import SearchBar
+from machineconfig.scripts.python.helpers_navigator.main_app import CommandNavigatorApp
+
+__all__ = [
+    "CommandInfo",
+    "ArgumentInfo",
+    "CommandBuilderScreen",
+    "CommandTree",
+    "CommandDetail",
+    "SearchBar",
+    "CommandNavigatorApp",
+]