machineconfig 7.50__py3-none-any.whl → 8.14__py3-none-any.whl

machineconfig/scripts/python/helpers_devops/cli_nw.py

@@ -1,23 +1,36 @@
 
 import machineconfig.scripts.python.helpers_devops.cli_share_file
-import machineconfig.scripts.python.helpers_devops.cli_terminal as cli_terminal
+import machineconfig.scripts.python.helpers_devops.cli_share_terminal as cli_share_terminal
 import machineconfig.scripts.python.helpers_devops.cli_share_server as cli_share_server
 import typer
 from typing import Optional, Annotated
 
 
+def switch_public_ip_address(
+    wait_seconds: Annotated[float, typer.Option(..., "--wait", "-w", help="Seconds to wait between steps")] = 2.0,
+    max_trials: Annotated[int, typer.Option(..., "--max-trials", "-m", help="Max number of switch attempts")] = 10,
+) -> None:
+    """🔁 Switch public IP address (Cloudflare WARP)"""
+    import machineconfig.scripts.python.helpers_network.address_switch as helper
+    helper.switch_public_ip_address(max_trials=max_trials, wait_seconds=wait_seconds)
+
 
 def install_ssh_server():
-    """📡 SSH install server"""
+    """📡 SSH install server"""  # VRPR66JD$X3FQ3
     import platform
     if platform.system() == "Windows":
         from machineconfig.setup_windows import SSH_SERVER
+        script = SSH_SERVER.read_text(encoding="utf-8")
     elif platform.system() == "Linux" or platform.system() == "Darwin":
-        from machineconfig.setup_linux import SSH_SERVER
+        script = """
+sudo nala install openssh-server -y || true  # try to install first
+# sudo nala purge openssh-server -y
+# sudo nala install openssh-server -y
+echo "✅ FINISHED installing openssh-server."""
     else:
         raise NotImplementedError(f"Platform {platform.system()} is not supported.")
     from machineconfig.utils.code import run_shell_script
-    run_shell_script(script=SSH_SERVER.read_text(encoding="utf-8"))
+    run_shell_script(script=script)
 
 
 def add_ssh_key(path: Annotated[Optional[str], typer.Option(..., help="Path to the public key file")] = None,
@@ -26,31 +39,70 @@ def add_ssh_key(path: Annotated[Optional[str], typer.Option(..., help="Path to t
          github: Annotated[Optional[str], typer.Option(..., "--github", "-g", help="Fetch public keys from a GitHub username")] = None
 ):
     """🔑 SSH add pub key to this machine so its accessible by owner of corresponding private key."""
-    import machineconfig.scripts.python.nw.devops_add_ssh_key as helper
+    import machineconfig.scripts.python.helpers_network.ssh_add_ssh_key as helper
     helper.main(pub_path=path, pub_choose=choose, pub_val=value, from_github=github)
 def add_ssh_identity():
     """🗝️ SSH add identity (private key) to this machine"""
-    import machineconfig.scripts.python.nw.devops_add_identity as helper
+    import machineconfig.scripts.python.helpers_network.ssh_add_identity as helper
     helper.main()
 
 
-def show_address():
-    import socket
-    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-    s.connect(('8.8.8.8',80))
-    local_ip_v4 = s.getsockname()[0]
-    s.close()
-    print(f"This computer is @ {local_ip_v4}")
+def show_address() -> None:
+    """📌 Show this computer addresses on network"""
+    import machineconfig.scripts.python.helpers_network.address as helper
+    loaded_json = helper.get_public_ip_address()
+    from rich import print_json
+    print_json(data=loaded_json)
+
+    from rich.table import Table
+    from rich.console import Console
+    res = helper.get_all_ipv4_addresses()
+    res.append( ("Public IP", loaded_json.get("ip", "N/A")))
+    
+    # loc = loaded_json["loc"]
+    # cmd = f"""curl "https://maps.geoapify.com/v1/staticmap?style=osm-bright&width=600&height=300&center=lonlat:{loc}&zoom=6&marker=lonlat:{loc};color:%23ff0000;size:medium&apiKey=$GEOAPIFY_API_KEY" -o map.png && chafa map.png"""
+    # from machineconfig.utils.code import run_shell_script
+    # run_shell_script(script=cmd)
+
+    table = Table(title="Network Interfaces")
+    table.add_column("Interface", style="cyan")
+    table.add_column("IP Address", style="green")
+    
+    for iface, ip in res:
+        table.add_row(iface, ip)
+    
+    console = Console()
+    console.print(table)
+    
+    res = helper.select_lan_ipv4(prefer_vpn=False)
+    if res is not None:
+        # ip, iface = res
+        # print(f"Selected IP: {ip} on interface: {iface}")
+        print(f"LAN IPv4: {res}")
+    else:
+        print("No network interfaces found.")
+
+
+
+def bind_wsl_port(port: Annotated[int, typer.Option(..., "--port", "-p", help="Port number to bind")]):
+    code = f"""
+
+$wsl_ip = (wsl.exe hostname -I).Trim().Split(' ')[0]
+netsh interface portproxy add v4tov4 listenport={port} listenaddress=0.0.0.0 connectport={port} connectaddress=$wsl_ip
+
+"""
+    from machineconfig.utils.code import exit_then_run_shell_script
+    exit_then_run_shell_script(code)
 
 
 def debug_ssh():
     """🐛 SSH debug"""
     from platform import system
     if system() == "Linux" or system() == "Darwin":
-        import machineconfig.scripts.python.nw.ssh_debug_linux as helper
+        import machineconfig.scripts.python.helpers_network.ssh_debug_linux as helper
         helper.ssh_debug_linux()
     elif system() == "Windows":
-        import machineconfig.scripts.python.nw.ssh_debug_windows as helper
+        import machineconfig.scripts.python.helpers_network.ssh_debug_windows as helper
         helper.ssh_debug_windows()
     else:
         raise NotImplementedError(f"Platform {system()} is not supported.")
@@ -64,7 +116,7 @@ def wifi_select(
     from rich.panel import Panel
     from rich.prompt import Confirm
     from rich.console import Console
-    from machineconfig.scripts.python.nw.wifi_conn import try_config_connection, manual_network_selection, display_available_networks
+    from machineconfig.scripts.python.helpers_network.wifi_conn import try_config_connection, manual_network_selection, display_available_networks
     console = Console()
     console.print(Panel("📶 Welcome to the WiFi Connector Tool", title="[bold blue]WiFi Connection[/bold blue]", border_style="blue"))
 
@@ -101,34 +153,69 @@ def wifi_select(
         console.print("[blue]👋 Goodbye![/blue]")
 
 
+
+def reset_cloudflare_tunnel():
+    code = """
+# cloudflared tunnel route dns glenn  # creates CNAMES in Cloudflare dashboard
+# sudo systemctl stop cloudflared
+# test: cloudflared tunnel run glenn
+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)
+def add_ip_exclusion_to_warp(ip: Annotated[str, typer.Option(..., "--ip", help="IP address to exclude from WARP")]):
+    code = f"""
+sudo warp-cli tunnel ip add {ip}
+sudo warp-cli disconnect
+sudo warp-cli connect
+"""
+    print(code)
+
+
 def get_app():
     nw_apps = typer.Typer(help="🔐 [n] Network subcommands", no_args_is_help=True, add_help_option=False, add_completion=False)
-    nw_apps.command(name="share-terminal", help="📡  [t] Share terminal via web browser")(cli_terminal.main)
-    nw_apps.command(name="t", help="Share terminal via web browser", hidden=True)(cli_terminal.main)
+    nw_apps.command(name="share-terminal", help="📡 [t] Share terminal via web browser")(cli_share_terminal.share_terminal)
+    nw_apps.command(name="t", help="Share terminal via web browser", hidden=True)(cli_share_terminal.share_terminal)
 
-    nw_apps.command(name="share-server", help="🌐  [s] Start local/global server to share files/folders via web browser", no_args_is_help=True)(cli_share_server.web_file_explorer)
+    nw_apps.command(name="share-server", help="🌐 [s] Start local/global server to share files/folders via web browser", no_args_is_help=True)(cli_share_server.web_file_explorer)
     nw_apps.command(name="s", help="Start local/global server to share files/folders via web browser", hidden=True, no_args_is_help=True)(cli_share_server.web_file_explorer)
 
     # app = cli_share_server.get_share_file_app()
-    # nw_apps.add_typer(app, name="share-file", help="📁  [f] Share a file via relay server", no_args_is_help=True)
+    # nw_apps.add_typer(app, name="share-file", help="📁 [f] Share a file via relay server", no_args_is_help=True)
     # nw_apps.add_typer(app, name="f", help="Share a file via relay server", hidden=True, no_args_is_help=True)
     nw_apps.command(name="send", no_args_is_help=True, hidden=False, help="📁 [sx] send files from here.")(machineconfig.scripts.python.helpers_devops.cli_share_file.share_file_send)
     nw_apps.command(name="sx", no_args_is_help=True, hidden=True, help="📁 [sx] send files from here.")(machineconfig.scripts.python.helpers_devops.cli_share_file.share_file_send)
     nw_apps.command(name="receive", no_args_is_help=True, hidden=False, help="📁 [rx] receive files to here.")(machineconfig.scripts.python.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_devops.cli_share_file.share_file_receive)
 
-    nw_apps.command(name="install-ssh-server", help="📡  [i] Install SSH server")(install_ssh_server)
+    nw_apps.command(name="install-ssh-server", help="📡 [i] Install SSH server")(install_ssh_server)
     nw_apps.command(name="i", help="Install SSH server", hidden=True)(install_ssh_server)
-    nw_apps.command(name="add-ssh-key", help="🔑  [k] Add SSH public key to this machine", no_args_is_help=True)(add_ssh_key)
+    nw_apps.command(name="add-ssh-key", help="🔑 [k] Add SSH public key to this machine", no_args_is_help=True)(add_ssh_key)
     nw_apps.command(name="k", help="Add SSH public key to this machine", hidden=True, no_args_is_help=True)(add_ssh_key)
-    nw_apps.command(name="add-ssh-identity", help="🗝️  [A] Add SSH identity (private key) to this machine")(add_ssh_identity)
+    nw_apps.command(name="add-ssh-identity", help="🗝️ [A] Add SSH identity (private key) to this machine")(add_ssh_identity)
     nw_apps.command(name="A", help="Add SSH identity (private key) to this machine", hidden=True)(add_ssh_identity)
-    nw_apps.command(name="show-address", help="📌  [a] Show this computer addresses on network")(show_address)
+
+    nw_apps.command(name="show-address", help="📌 [a] Show this computer addresses on network")(show_address)
     nw_apps.command(name="a", help="Show this computer addresses on network", hidden=True)(show_address)
-    nw_apps.command(name="debug-ssh", help="🐛  [d] Debug SSH connection")(debug_ssh)
+
+    nw_apps.command(name="switch-public-ip", help="🔁 [c] Switch public IP address (Cloudflare WARP)")(switch_public_ip_address)
+    nw_apps.command(name="c", help="Switch public IP address (Cloudflare WARP)", hidden=True)(switch_public_ip_address)
+
+    nw_apps.command(name="debug-ssh", help="🐛 [d] Debug SSH connection")(debug_ssh)
     nw_apps.command(name="d", help="Debug SSH connection", hidden=True)(debug_ssh)
 
-    nw_apps.command(name="wifi-select", no_args_is_help=True, help="📶 WiFi connection utility.")(wifi_select)
+    nw_apps.command(name="wifi-select", no_args_is_help=True, help="📶 [w] WiFi connection utility.")(wifi_select)
     nw_apps.command(name="w", no_args_is_help=True, hidden=True)(wifi_select)
 
+    nw_apps.command(name="bind-wsl-port", help="🔌 [b] Bind WSL port to Windows host", no_args_is_help=True)(bind_wsl_port)
+    nw_apps.command(name="b", help="Bind WSL port to Windows host", hidden=True, no_args_is_help=True)(bind_wsl_port)
+
+    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)
+
     return nw_apps

machineconfig/scripts/python/helpers_devops/cli_repos.py

@@ -71,14 +71,31 @@ def checkout_to_branch_command(directory: DirectoryArgument = None, cloud: Cloud
     clone_from_specs(directory, cloud, checkout_branch_flag=True, checkout_commit_flag=False)
 
 
-def analyze(directory: DirectoryArgument = None) -> None:
-    """📊 Analyze repository development over time."""
-    repo_path = directory if directory is not None else "."
-    from machineconfig.scripts.python.helpers_repos.count_lines_frontend import analyze_repo_development
-    analyze_repo_development(repo_path=repo_path)
+def count_lines_in_repo(repo_path: Annotated[str, typer.Argument(..., help="Path to the git repository")]):
+    def func(repo_path: str):
+        from machineconfig.scripts.python.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.14"])
 
 
-def viz(
+def print_python_files_by_size(repo_path: Annotated[str, typer.Argument(..., help="Path to the git repository")]):
+    def func(repo_path: str):
+        from machineconfig.scripts.python.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.14"])
+
+
+def analyze_repo_development(repo_path: Annotated[str, typer.Argument(..., help="Path to the git repository")]):
+    def func(repo_path: str):
+        from machineconfig.scripts.python.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.14"])
+
+
+def gource_viz(
     repo: Annotated[str, typer.Option(..., "--repo", "-r", help="Path to git repository to visualize")] = ".",
     output_file: Annotated[Optional[Path], typer.Option(..., "--output", "-o", help="Output video file (e.g., output.mp4). If specified, gource will render to video.")] = None,
     resolution: Annotated[str, typer.Option(..., "--resolution", "-res", help="Video resolution (e.g., 1920x1080, 1280x720)")] = "1920x1080",
@@ -159,22 +176,31 @@ def get_app():
     repos_apps.command(name="commit", help="💾  [c] Commit changes across repositories")(commit)
     repos_apps.command(name="c", help="Commit changes across repositories", hidden=True)(commit)
     repos_apps.command(name="sync", help="🔄  [y] Pull, commit, and push changes across repositories")(sync)
-    repos_apps.command(name="s", help="Pull, commit, and push changes across repositories", hidden=True)(sync)
-    repos_apps.command(name="analyze", help="📊  [a] Analyze repository development over time")(analyze)
-    repos_apps.command(name="a", help="Analyze repository development over time", hidden=True)(analyze)
+    repos_apps.command(name="y", help="Pull, commit, and push changes across repositories", hidden=True)(sync)
+    repos_apps.command(name="analyze", help="📊  [a] Analyze repository development over time")(analyze_repo_development)
+    repos_apps.command(name="a", help="Analyze repository development over time", hidden=True)(analyze_repo_development)
+
     repos_apps.command(name="secure", help="🔐  [s] Securely sync git repository to/from cloud with encryption")(secure_repo_main)
     repos_apps.command(name="s", help="Securely sync git repository to/from cloud with encryption", hidden=True)(secure_repo_main)
-    repos_apps.command(name="viz", help="🎬  [v] Visualize repository activity using Gource")(viz)
-    repos_apps.command(name="v", help="Visualize repository activity using Gource", hidden=True)(viz)
+
+    repos_apps.command(name="viz", help="🎬  [v] Visualize repository activity using Gource")(gource_viz)
+    repos_apps.command(name="v", help="Visualize repository activity using Gource", hidden=True)(gource_viz)
+
+    repos_apps.command(name="count-lines", help="📄  [l] Count python lines of code in current repo + historical edits.")(count_lines_in_repo)
+    repos_apps.command(name="l", help="Count python lines of code in current repo + historical edits.", hidden=True)(count_lines_in_repo)
+
     repos_apps.command(name="cleanup", help="🧹  [n] Clean repository directories from cache files")(cleanup)
     repos_apps.command(name="n", help="Clean repository directories from cache files", hidden=True)(cleanup)
 
     mirror_app.command(name="capture", help="📝  [cap] Record repositories into a repos.json specification")(capture)
     mirror_app.command(name="cap", help="Record repositories into a repos.json specification", hidden=True)(capture)
+
     mirror_app.command(name="clone", help="📥  [clo] Clone repositories described by a repos.json specification")(clone)
     mirror_app.command(name="clo", help="Clone repositories described by a repos.json specification", hidden=True)(clone)
+
     mirror_app.command(name="checkout-to-commit", help="🔀  [ctc] Check out specific commits listed in the specification")(checkout_command)
     mirror_app.command(name="ctc", help="Check out specific commits listed in the specification", hidden=True)(checkout_command)
+
     mirror_app.command(name="checkout-to-branch", help="🔀  [ctb] Check out to the main branch defined in the specification")(checkout_to_branch_command)
     mirror_app.command(name="ctb", help="Check out to the main branch defined in the specification", hidden=True)(checkout_to_branch_command)
 

machineconfig/scripts/python/helpers_devops/cli_self.py

@@ -1,6 +1,6 @@
 
 import typer
-from typing import Optional, Annotated
+from typing import Annotated, Literal
 
 
 def copy_both_assets():
@@ -9,7 +9,59 @@ 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 init(which: Annotated[Literal["init", "ia", "live", "wrap"], typer.Argument(..., help="Comma-separated list of script names to run all initialization scripts.")] = "init",
+         run: Annotated[bool, typer.Option("--run/--no-run", "-r/-nr", help="Run the script after displaying it.")] = False,
+                        ) -> None:
+    import platform
+    if platform.system() == "Linux" or platform.system() == "Darwin":
+        match which:
+            case "init":
+                import machineconfig.settings as module
+                from pathlib import Path
+                if platform.system() == "Darwin":
+                    init_path = Path(module.__file__).parent.joinpath("shells", "zsh", "init.sh")
+                else: init_path = Path(module.__file__).parent.joinpath("shells", "bash", "init.sh")
+                script = init_path.read_text(encoding="utf-8")
+            case "ia":
+                from machineconfig.setup_linux import INTERACTIVE as script_path
+                script = script_path.read_text(encoding="utf-8")
+            case "live":
+                from machineconfig.setup_linux import LIVE as script_path
+                script = script_path.read_text(encoding="utf-8")
+            case _:
+                typer.echo("Unsupported shell script for Linux.")
+                raise typer.Exit(code=1)
+
+    elif platform.system() == "Windows":
+        match which:
+            case "init":
+                import machineconfig.settings as module
+                from pathlib import Path
+                init_path = Path(module.__file__).parent.joinpath("shells", "powershell", "init.ps1")
+                script = init_path.read_text(encoding="utf-8")
+            case "ia":
+                from machineconfig.setup_windows import INTERACTIVE as script_path
+                script = script_path.read_text(encoding="utf-8")
+            case "live":
+                from machineconfig.setup_windows import LIVE as script_path
+                script = script_path.read_text(encoding="utf-8")
+            case _:
+                typer.echo("Unsupported shell script for Windows.")
+                raise typer.Exit(code=1)
+    else:
+        # raise NotImplementedError("Unsupported platform")
+        typer.echo("Unsupported platform for init scripts.")
+        raise typer.Exit(code=1)
+    if run:
+        from machineconfig.utils.code import exit_then_run_shell_script
+        exit_then_run_shell_script(script, strict=True)
+    else:
+        print(script)
+
+
+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():
@@ -28,29 +80,40 @@ uv tool install --upgrade machineconfig
     if platform.system() == "Windows":
         from machineconfig.utils.code import exit_then_run_shell_script, get_uv_command_executing_python_script
         from machineconfig.utils.meta import lambda_to_python_script
-        python_script = lambda_to_python_script(lambda: copy_both_assets(), in_global=True, import_module=False)
+        python_script = lambda_to_python_script(lambda: copy_both_assets(),
+                                                in_global=True, import_module=False)
         uv_command, _py_file = get_uv_command_executing_python_script(python_script=python_script, uv_with=["machineconfig"], uv_project_dir=None)
         exit_then_run_shell_script(shell_script + "\n" + uv_command, strict=True)
     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):
+
+def install(copy_assets: Annotated[bool, typer.Option("--copy-assets/--no-assets-copy", "-a/-na", help="Copy (overwrite) assets to the machine after the update")] = True,
+            dev: Annotated[bool, typer.Option("--dev", "-d", help="Install from local development code instead of PyPI")] = False,
+            ):
     """📋 CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates."""
-    from machineconfig.utils.code import run_shell_script
+    from machineconfig.utils.code import run_shell_script, get_uv_command
     from pathlib import Path
+    import platform
+    if dev and not Path.home().joinpath("code/machineconfig").exists():
+        # clone: https://github.com/thisismygitrepo/machineconfig.git
+        import git
+        repo_parent = Path.home().joinpath("code")
+        repo_parent.mkdir(parents=True, exist_ok=True)
+        git.Repo.clone_from("https://github.com/thisismygitrepo/machineconfig.git", str(repo_parent.joinpath("machineconfig")))
+    uv_command = get_uv_command(platform=platform.system())
     if Path.home().joinpath("code/machineconfig").exists():
-        run_shell_script(f"""$HOME/.local/bin/uv tool install --upgrade --editable "{str(Path.home().joinpath("code/machineconfig"))}" """)
+        run_shell_script(f""" {uv_command} tool install --upgrade --editable "{str(Path.home().joinpath("code/machineconfig"))}" """)
     else:
-        import platform
-        if platform.system() == "Windows":
-            run_shell_script(r"""& "$HOME\.local\bin\uv.exe" tool install --upgrade "machineconfig>=7.50" """)
-        else:
-            run_shell_script("""$HOME/.local/bin/uv tool install --upgrade "machineconfig>=7.50" """)
-    from machineconfig.profile.create_shell_profile import create_default_shell_profile
-    if not no_copy_assets:
+        run_shell_script(rf""" {uv_command} tool install --upgrade "machineconfig>=8.14" """)
+    if copy_assets:
+        from machineconfig.profile.create_shell_profile import create_default_shell_profile
         create_default_shell_profile()   # involves copying assets too
 
 
@@ -71,22 +134,11 @@ def navigate():
     import machineconfig.scripts.python as navigator
     from pathlib import Path
     path = Path(navigator.__file__).resolve().parent.joinpath("devops_navigator.py")
-    from machineconfig.utils.code import run_shell_script
+    from machineconfig.utils.code import exit_then_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.50,textual" """
-    run_shell_script(f"""uv run {executable} {path}""")
-
-
-def run_python(ip: Annotated[str, typer.Argument(..., help="Python command to run in the machineconfig environment")],
-               command: Annotated[Optional[bool], typer.Option(..., "--command", "-c", help="Run as command")] = False):
-    """🐍 RUN python command/file in the machineconfig environment"""
-    if command:
-        exec(ip)
-        return
-    import machineconfig
-    import subprocess
-    import sys
-    subprocess.run([sys.executable, ip], cwd=machineconfig.__path__[0])
+    else: executable = """--with "machineconfig>=8.14,textual" """
+    exit_then_run_shell_script(f"""uv run {executable} {path}""")
+
 def readme():
     from rich.console import Console
     from rich.markdown import Markdown
@@ -109,19 +161,20 @@ def readme():
 
 def get_app():
     cli_app = typer.Typer(help="🔄 [s] self operations subcommands", no_args_is_help=True, add_help_option=False, 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="🤖  [i] INTERACTIVE configuration of machine.")(interactive)
-    cli_app.command("i", no_args_is_help=False, help="INTERACTIVE configuration of machine.", hidden=True)(interactive)
-    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("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="🤖 [i] INTERACTIVE configuration of machine.")(interactive)
+    cli_app.command("i",           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("python", no_args_is_help=False, help="🐍  [c] python command/file in the machineconfig environment", context_settings={"show_help_on_error": True})(run_python)
-    cli_app.command("c", no_args_is_help=False, help="RUN python command/file in the machineconfig environment", hidden=True)(run_python)
-    cli_app.command("readme", no_args_is_help=False, help="📚  [r] render readme markdown in terminal.")(readme)
+
+    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)
     return cli_app
 

machineconfig/scripts/python/helpers_devops/cli_share_file.py

@@ -1,6 +1,5 @@
+
 import typer
-# import platform
-# import sys
 from typing import Annotated
 
 
@@ -12,7 +11,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,15 +99,16 @@ 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
+    import machineconfig.scripts.python.helpers_network.address as helper
+    res = helper.select_lan_ipv4(prefer_vpn=False)
+    if res is None:
+        typer.echo("❌ Error: Could not determine local LAN IPv4 address for relay.", err=True)
+        raise typer.Exit(code=1)
+    local_ip_v4 = res
     import platform
-    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-    s.connect(('8.8.8.8',80))
-    local_ip_v4 = s.getsockname()[0]
-    s.close()
     relay_port = "443"
     is_windows = platform.system() == "Windows"
 

machineconfig/scripts/python/helpers_devops/cli_share_server.py

@@ -38,18 +38,16 @@ def web_file_explorer(
     username: Annotated[Optional[str], typer.Option("--username", "-u", help="Username for share access (default: current user)")] = None,
     password: Annotated[Optional[str], typer.Option("--password", "-w", help="Password for share access (default: from ~/dotfiles/creds/passwords/quick_password)")] = None,
     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"
+    backend: Annotated[str, typer.Option("--backend", "-b", help="Backend to use: filebrowser (default), miniserve, qrcp, or easy-sharing")] = "miniserve",
 ) -> None:
-    from machineconfig.utils.installer_utils.installer 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)
+    from machineconfig.utils.installer_utils.installer_cli import install_if_missing
+
+    if backend not in ["filebrowser", "miniserve", "qrcp", "easy-sharing"]:
+        typer.echo(f"❌ ERROR: Invalid backend '{backend}'. Must be one of: filebrowser, miniserve, qrcp, easy-sharing", err=True)
         raise typer.Exit(code=1)
-    
     install_if_missing(which=backend)
     if over_internet:
         install_if_missing(which="ngrok")
-    
     if username is None:
         import getpass
         username = getpass.getuser()
@@ -65,11 +63,12 @@ def web_file_explorer(
     if port is None:
         port = 8080
 
-    import socket
-    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-    s.connect(('8.8.8.8', 80))
-    local_ip_v4 = s.getsockname()[0]
-    s.close()
+    import machineconfig.scripts.python.helpers_network.address as helper
+    res = helper.select_lan_ipv4(prefer_vpn=False)
+    if res is None:
+        typer.echo("❌ ERROR: Could not determine local LAN IPv4 address for share server.", err=True)
+        raise typer.Exit(code=1)
+    local_ip_v4 = res
 
     protocol = "http"
     display_share_url(local_ip_v4, port, protocol)
@@ -90,6 +89,8 @@ filebrowser --address 0.0.0.0 --port {port} --root "{path_obj}" --database {db_p
         command = f"""miniserve --port {port} --interfaces 0.0.0.0 --auth {username}:{password} --upload-files --mkdir --enable-tar --enable-tar-gz --enable-zip --qrcode "{path_obj}" """
     elif backend == "easy-sharing":
         command = f"""easy-sharing --port {port} --username {username} --password "{password}" "{path_obj}" """
+    elif backend == "qrcp":
+        command = f"""qrcp "{path_obj}" """
     else:
         typer.echo(f"❌ ERROR: Unknown backend '{backend}'", err=True)
         raise typer.Exit(code=1)