machineconfig 7.67__tar.gz → 7.71__tar.gz

{machineconfig-7.67/src/machineconfig.egg-info → machineconfig-7.71}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 7.67
+Version: 7.71
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{machineconfig-7.67 → machineconfig-7.71}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "7.67"
+version = "7.71"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -114,6 +114,7 @@ dev = [
     "pyright>=1.1.405",
     "pytest>=8.4.2",
     "python-lsp-server[all]>=1.13.1",
+    "qrcode>=8.2",
     "ruff>=0.13.1",
     "ruff-lsp>=0.0.62",
     "sqlalchemy>=2.0.43",

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/jobs/installer/custom_dev/sysabc.py

@@ -8,7 +8,33 @@ from rich.panel import Panel
 from machineconfig.utils.schemas.installer.installer_types import InstallerData
 
 
+"""
+    {
+      "appName": "Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle",
+      "repoURL": "https://github.com/microsoft/winget-cli",
+      "doc": "📦 Windows Package Manager CLI",
+      "fileNamePattern": {
+        "amd64": {
+          "linux": null,
+          "windows": "Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle",
+          "macos": null
+        },
+        "arm64": {
+          "linux": null,
+          "windows": "Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle",
+          "macos": null
+        }
+      }
+
+"""
+
 ps1 = r"""
+
+# if windows is missing
+# download latest from cd $HOME/Downloads; d u "https://github.com/microsoft/winget-cli/releases/download/v1.12.170-preview/Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle"
+# this must be run in windows powershell, not in pwsh
+# Add-AppxPackage .\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle
+
 winget install --no-upgrade --name "Powershell"                   --Id "Microsoft.PowerShell"       --source winget --scope user --accept-package-agreements --accept-source-agreements  # powershell require admin
 winget install --no-upgrade --name "Windows Terminal"             --Id "Microsoft.WindowsTerminal"  --source winget --scope user --accept-package-agreements --accept-source-agreements  # Terminal is is installed by default on W 11
 winget install --no-upgrade --name "GNU Nano"                     --Id "GNU.Nano"                   --source winget --scope user --accept-package-agreements --accept-source-agreements

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/jobs/installer/installer_data.json

@@ -1854,6 +1854,23 @@
         }
       }
     },
+    {
+      "appName": "qrterminal",
+      "repoURL": "https://github.com/mdp/qrterminal",
+      "doc": "📷 qr code terminal from string",
+      "fileNamePattern": {
+        "amd64": {
+          "linux": "qrterminal_Linux_x86_64.tar.gz",
+          "macos": "qrterminal_Darwin_x86_64.tar.gz",
+          "windows": "qrterminal_Windows_x86_64.zip"
+        },
+        "arm64": {
+          "linux": "qrterminal_Linux_arm64.tar.gz",
+          "macos": "qrterminal_Darwin_arm64.tar.gz",
+          "windows": "qrterminal_Windows_arm64.zip"
+        }
+      }
+    },
     {
       "appName": "termscp",
       "repoURL": "https://github.com/veeso/termscp",

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/croshell.py

@@ -16,13 +16,15 @@ def croshell(
     jupyter: Annotated[bool, typer.Option("--jupyter", "-j", help="run in jupyter interactive console")] = False,
     vscode: Annotated[bool, typer.Option("--vscode", "-c", help="open the script in vscode")] = False,
     # streamlit_viewer: Annotated[bool, typer.Option("--streamlit", "-s", help="view in streamlit app")] = False,
+    uv_with: Annotated[Optional[str], typer.Option("--uv-with", "-w", help="specify uv with packages to use")] = None,
     visidata: Annotated[bool, typer.Option("--visidata", "-v", help="open data file in visidata")] = False,
     marimo: Annotated[bool, typer.Option("--marimo", "-m", help="open the notebook using marimo if available")] = False,
 ) -> None:
+    if uv_with is not None: user_uv_with_line = f"--with {uv_with} "
+    else: user_uv_with_line = ""
+
     from machineconfig.scripts.python.helpers_croshell.crosh import get_read_python_file_pycode, get_read_data_pycode
     from machineconfig.utils.meta import lambda_to_python_script
-    from machineconfig.utils.path_helper import get_choice_file
-    from machineconfig.utils.path_extended import PathExtended
     from pathlib import Path
     from machineconfig.utils.accessories import randstr
     import json
@@ -37,6 +39,7 @@ def croshell(
     ipython_profile: Optional[str] = profile
     file_obj = Path.cwd()  # initialization value, could be modified according to args.
     if path is not None:
+        from machineconfig.utils.path_helper import get_choice_file
         choice_file = get_choice_file(path=path, suffixes={".*"})
         if choice_file.suffix == ".py":
             program = choice_file.read_text(encoding="utf-8")
@@ -65,9 +68,9 @@ def croshell(
         return textwrap.dedent("\n".join(inspect.getsource(f).splitlines()[1:]))
     preprogram += get_body_simple_function_no_args(preprogram_func)
 
-    pyfile = PathExtended.tmp().joinpath(f"tmp_scripts/python/croshell/{randstr()}/script.py")
+    from pathlib import Path
+    pyfile = Path.home().joinpath(f"tmp_results/tmp_scripts/python/croshell/{randstr()}/script.py")
     pyfile.parent.mkdir(parents=True, exist_ok=True)
-
     title = "Reading Data"
     def_code = lambda_to_python_script(lambda: get_read_python_file_pycode(path=str(pyfile), title=title),
                                        in_global=False, import_module=False)
@@ -104,37 +107,37 @@ def croshell(
             pass
     if visidata:
         if file_obj.suffix == ".json":
-            fire_line = f"uv run --python 3.14 --with visidata vd {str(file_obj)}"
+            fire_line = f"uv run --python 3.14 {user_uv_with_line} --with visidata vd {str(file_obj)}"
         else:
-            fire_line = f"uv run --python 3.14 --with visidata,pyarrow vd {str(file_obj)}"
+            fire_line = f"uv run --python 3.14 {user_uv_with_line}--with visidata,pyarrow vd {str(file_obj)}"
     elif marimo:
-        if Path.home().joinpath("code/machineconfig").exists(): requirements = f"""--with marimo --project "{str(Path.home().joinpath("code/machineconfig"))}" """
-        else: requirements = """--python 3.14 --with "marimo,cowsay,machineconfig[plot]>=7.67" """
+        if Path.home().joinpath("code/machineconfig").exists(): requirements = f"""{user_uv_with_line} --with marimo --project "{str(Path.home().joinpath("code/machineconfig"))}" """
+        else: requirements = f"""--python 3.14 {user_uv_with_line} user_uv_with_line--with "marimo,cowsay,machineconfig[plot]>=7.71" """
         fire_line = f"""
 cd {str(pyfile.parent)}
 uv run --python 3.14 --with "marimo" marimo convert {pyfile.name} -o marimo_nb.py
 uv run {requirements} marimo edit --host 0.0.0.0 marimo_nb.py
 """
     elif jupyter:
-        if Path.home().joinpath("code/machineconfig").exists(): requirements = f"""--project "{str(Path.home().joinpath("code/machineconfig"))}" --with jupyterlab """
-        else: requirements = """--with "cowsay,machineconfig[plot]>=7.67" """
+        if Path.home().joinpath("code/machineconfig").exists(): requirements = f"""{user_uv_with_line}  --with jupyterlab --project "{str(Path.home().joinpath("code/machineconfig"))}" """
+        else: requirements = f"""{user_uv_with_line} --with "cowsay,machineconfig[plot]>=7.71" """
         fire_line = f"uv run {requirements} jupyter-lab {str(nb_target)}"
     elif vscode:
+        user_uv_add = f"uv add {uv_with}" if uv_with is not None else ""
         fire_line = f"""
 cd {str(pyfile.parent)}
 uv init --python 3.14
 uv venv
-uv add "cowsay,machineconfig[plot]>=7.67"
+uv add "cowsay,machineconfig[plot]>=7.71"
+uv add {user_uv_add}
 # code serve-web
 code --new-window {str(pyfile)}
 """
     else:
         if interpreter == "ipython": profile = f" --profile {ipython_profile} --no-banner"
         else: profile = ""
-        if Path.home().joinpath("code/machineconfig").exists(): ve_line = f"""--project "{str(Path.home().joinpath("code/machineconfig"))}" """
-        else: ve_line = """--python 3.14 --with "cowsay,machineconfig[plot]>=7.67" """
-        # ve_path_maybe, ipython_profile_maybe = get_ve_path_and_ipython_profile(Path.cwd())
-        # --python 3.14
+        if Path.home().joinpath("code/machineconfig").exists(): ve_line = f"""{user_uv_with_line} --project "{str(Path.home().joinpath("code/machineconfig"))}" """
+        else: ve_line = f"""--python 3.14 {user_uv_with_line} --with "cowsay,machineconfig[plot]>=7.71" """
         fire_line = f"uv run {ve_line} {interpreter} {interactivity} {profile} {str(pyfile)}"
 
     from machineconfig.utils.code import exit_then_run_shell_script

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/devops.py

@@ -16,7 +16,7 @@ def install(which: Annotated[Optional[str], typer.Argument(..., help="Comma-sepa
     ) -> None:
         """📦 Install packages"""
         import machineconfig.utils.installer_utils.installer_cli as installer_entry_point
-        installer_entry_point.main(which=which, group=group, interactive=interactive)
+        installer_entry_point.main_installer_cli(which=which, group=group, interactive=interactive)
 
 
 def get_app():

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/env_manager/path_manager_tui.py

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

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/fire_jobs.py

@@ -49,10 +49,9 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
         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:
+            from machineconfig.scripts.python.helpers_fire_command.fire_jobs_route_helper import get_command_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:
@@ -60,7 +59,7 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
         else:
             if args.interactive:
                 from machineconfig.utils.ve import get_ve_path_and_ipython_profile
-                _ve_root_from_file, ipy_profile = get_ve_path_and_ipython_profile(choice_file)
+                _ve_root_from_file, ipy_profile = get_ve_path_and_ipython_profile(init_path=choice_file)
                 if ipy_profile is None:
                     ipy_profile = "default"
                 exe = f"uv run {with_project} ipython -i --no-banner --profile {ipy_profile} "

machineconfig-7.71/src/machineconfig/scripts/python/helpers/qr_code.py

@@ -0,0 +1,166 @@
+
+
+from typing import Literal
+
+
+def generate_qrcode_grid(
+    strings: list[str],
+    output_path: str,
+    per_row: int = 3,
+    qr_size: int = 200,
+    label_height: int = 30,
+    padding: int = 20,
+    label_max_chars: int = 25,
+    format: Literal["svg", "png"] = "svg",
+) -> str:
+    from pathlib import Path
+    if not strings:
+        raise ValueError("strings list cannot be empty")
+
+    output_path_obj = Path(output_path)
+    output_path_obj.parent.mkdir(parents=True, exist_ok=True)
+
+    if format == "svg":
+        return _generate_svg(strings, output_path, per_row, qr_size, label_height, padding, label_max_chars)
+    elif format == "png":
+        return _generate_png(strings, output_path, per_row, qr_size, label_height, padding, label_max_chars)
+    else:
+        raise ValueError(f"Unsupported format: {format}")
+
+
+def _generate_svg(
+    strings: list[str],
+    output_path: str,
+    per_row: int,
+    qr_size: int,
+    label_height: int,
+    padding: int,
+    label_max_chars: int,
+) -> str:
+    num_items = len(strings)
+    num_rows = (num_items + per_row - 1) // per_row
+
+    cell_width = qr_size
+    cell_height = qr_size + label_height
+    total_width = per_row * cell_width + (per_row + 1) * padding
+    total_height = num_rows * cell_height + (num_rows + 1) * padding
+
+    from xml.etree import ElementTree as ET
+
+    import qrcode
+    svg_root = ET.Element(
+        "svg",
+        xmlns="http://www.w3.org/2000/svg",
+        width=str(total_width),
+        height=str(total_height),
+        viewBox=f"0 0 {total_width} {total_height}",
+    )
+
+    _bg_rect = ET.SubElement(svg_root, "rect", width=str(total_width), height=str(total_height), fill="white")
+
+    for idx, text in enumerate(strings):
+        row = idx // per_row
+        col = idx % per_row
+
+        x_offset = padding + col * (cell_width + padding)
+        y_offset = padding + row * (cell_height + padding)
+
+        qr = qrcode.QRCode(version=1, error_correction=qrcode.ERROR_CORRECT_L, box_size=10, border=2, image_factory=qrcode.image.svg.SvgPathImage)
+        qr.add_data(text)
+        qr.make(fit=True)
+
+        qr_img = qr.make_image()
+        qr_svg_string = qr_img.to_string(encoding="unicode")
+
+        qr_tree = ET.fromstring(qr_svg_string)
+
+        group = ET.SubElement(svg_root, "g", transform=f"translate({x_offset}, {y_offset})")
+
+        qr_group = ET.SubElement(group, "g")
+        for child in qr_tree:
+            qr_group.append(child)
+
+        label_text = text[:label_max_chars] if len(text) > label_max_chars else text
+        text_y = qr_size + label_height // 2
+
+        text_elem = ET.SubElement(
+            group,
+            "text",
+            x=str(qr_size // 2),
+            y=str(text_y),
+            fill="black",
+            attrib={
+                "font-family": "monospace",
+                "font-size": "12",
+                "text-anchor": "middle",
+                "dominant-baseline": "middle",
+            },
+        )
+        text_elem.text = label_text
+
+    tree = ET.ElementTree(svg_root)
+    ET.indent(tree, space="  ")
+    tree.write(output_path, encoding="unicode", xml_declaration=True)
+
+    return output_path
+
+
+def _generate_png(
+    strings: list[str],
+    output_path: str,
+    per_row: int,
+    qr_size: int,
+    label_height: int,
+    padding: int,
+    label_max_chars: int,
+) -> str:
+    num_items = len(strings)
+    num_rows = (num_items + per_row - 1) // per_row
+
+    cell_width = qr_size
+    cell_height = qr_size + label_height
+    total_width = per_row * cell_width + (per_row + 1) * padding
+    total_height = num_rows * cell_height + (num_rows + 1) * padding
+
+    import qrcode
+    import qrcode.image.pil
+    from PIL import Image, ImageDraw, ImageFont
+    img = Image.new("RGB", (total_width, total_height), color="white")
+    draw = ImageDraw.Draw(img)
+
+    try:
+        font = ImageFont.truetype("/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf", 12)
+    except OSError:
+        try:
+            font = ImageFont.truetype("arial.ttf", 12)
+        except OSError:
+            font = ImageFont.load_default()
+
+    for idx, text in enumerate(strings):
+        row = idx // per_row
+        col = idx % per_row
+
+        x_offset = padding + col * (cell_width + padding)
+        y_offset = padding + row * (cell_height + padding)
+
+        qr = qrcode.QRCode(version=1, error_correction=qrcode.ERROR_CORRECT_L, box_size=10, border=2, image_factory=qrcode.image.pil.PilImage)
+        qr.add_data(text)
+        qr.make(fit=True)
+
+        qr_img = qr.make_image(fill_color="black", back_color="white")
+        qr_img_resized = qr_img.resize((qr_size, qr_size), Image.Resampling.LANCZOS)
+
+        img.paste(qr_img_resized, (x_offset, y_offset))
+
+        label_text = text[:label_max_chars] if len(text) > label_max_chars else text
+
+        bbox = draw.textbbox((0, 0), label_text, font=font)
+        text_width = bbox[2] - bbox[0]
+        text_x = x_offset + (qr_size - text_width) // 2
+        text_y = y_offset + qr_size + label_height // 2 - 6
+
+        draw.text((text_x, text_y), label_text, fill="black", font=font)
+
+    img.save(output_path, format="PNG")
+
+    return output_path

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/helpers_devops/cli_self.py

@@ -53,9 +53,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.67" """)
+            run_shell_script(r"""& "$HOME\.local\bin\uv.exe" tool install --upgrade "machineconfig>=7.71" """)
         else:
-            run_shell_script("""$HOME/.local/bin/uv tool install --upgrade "machineconfig>=7.67" """)
+            run_shell_script("""$HOME/.local/bin/uv tool install --upgrade "machineconfig>=7.71" """)
     from machineconfig.profile.create_shell_profile import create_default_shell_profile
     if not no_copy_assets:
         create_default_shell_profile()   # involves copying assets too
@@ -80,7 +80,7 @@ def navigate():
     path = Path(navigator.__file__).resolve().parent.joinpath("devops_navigator.py")
     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.67,textual" """
+    else: executable = """--with "machineconfig>=7.71,textual" """
     exit_then_run_shell_script(f"""uv run {executable} {path}""")
 
 

{machineconfig-7.67 → machineconfig-7.71}/src/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_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)
+
+    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()
@@ -90,6 +88,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)

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/helpers_fire_command/fire_jobs_route_helper.py

@@ -100,6 +100,16 @@ def get_command_streamlit(choice_file: Path, environment: str, repo_root: Option
                 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)
     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

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/helpers_repos/cloud_repo_sync.py

@@ -105,7 +105,7 @@ git pull originEnc master
         uv_project_dir = f"""{str(Path.home().joinpath("code/machineconfig"))}"""
         uv_with = None
     else:
-        uv_with = ["machineconfig>=7.67"]
+        uv_with = ["machineconfig>=7.71"]
         uv_project_dir = None
 
     import tempfile

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/helpers_repos/count_lines_frontend.py

@@ -8,7 +8,7 @@ def analyze_repo_development(repo_path: Annotated[str, typer.Argument(..., help=
     from pathlib import Path
     count_lines_path = Path(count_lines.__file__)
     # --project $HOME/code/ machineconfig --group plot
-    cmd = f"""uv run --python 3.14 --with "machineconfig[plot]>=7.67" {count_lines_path} analyze-over-time {repo_path}"""
+    cmd = f"""uv run --python 3.14 --with "machineconfig[plot]>=7.71" {count_lines_path} analyze-over-time {repo_path}"""
     from machineconfig.utils.code import run_shell_script
     run_shell_script(cmd)
 

machineconfig-7.71/src/machineconfig/scripts/python/helpers_utils/path.py

@@ -0,0 +1,139 @@
+
+
+
+import typer
+
+from typing import Optional
+from typing import Annotated, Literal, TypedDict
+
+
+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.71")
+    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 init_project(
+                 name: Annotated[Optional[str], typer.Option("--name", "-n", help="Name of the project.")]= None,
+                 tmp_directory: Annotated[bool, typer.Option("--tmp-directory/--no-tmp-directory", "-t/-nt", help="Use a temporary directory for the project initialization.")]= False,
+                 python: Annotated[Literal["3.13", "3.14"], typer.Option("--python", "-p", help="Python version for the uv virtual environment.")]= "3.13",
+                 packages: Annotated[Optional[str], typer.Option("--packages", "-p", help="Additional packages to include in the uv virtual environment.")]= None,
+                 group: Annotated[Optional[str], typer.Option("--group", "-g", help="Group name for the packages.")]= "plot",
+                 types_packages: Annotated[bool, typer.Option("--types-packages/--no-types-packages", "-T/-NT", help="Include types packages for better type hinting.")]= True,
+                    linting_debug_packages: Annotated[bool, typer.Option("--linting-debug-packages/--no-linting-debug-packages", "-L/-NL", help="Include linting and debugging packages.")]= True,
+                    ia_packages: Annotated[bool, typer.Option("--ia-packages/--no-ia-packages", "-I/-NI", help="Include interactive and IA packages.")]= True,
+                    plot_packages: Annotated[bool, typer.Option("--plot-packages/--no-plot-packages", "-P/-NP", help="Include plotting packages.")]= True,
+                    data_packages: Annotated[bool, typer.Option("--data-packages/--no-data-packages", "-D/-ND", help="Include data manipulation packages.")]= True,
+                 ) -> None:
+    if packages is not None:
+        packages_add_line = f"uv add {packages}"
+    else:
+        packages_add_line = ""
+    from pathlib import Path
+    if not tmp_directory:
+        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)
+        starting_code = ""
+    else:
+        if name is not None:
+            from machineconfig.utils.accessories import randstr
+            repo_root = Path.home().joinpath(f"tmp_results/tmp_projects/{name}")
+        else:
+            from machineconfig.utils.accessories import randstr
+            repo_root = Path.home().joinpath(f"tmp_results/tmp_projects/{randstr(6)}")
+        repo_root.mkdir(parents=True, exist_ok=True)
+        print(f"Using temporary directory for project initialization: {repo_root}")
+        starting_code = f"""
+cd {repo_root}
+uv init --python {python}
+uv venv
+"""
+    print(f"Adding group `{group}` with common data science and plotting packages...")
+    total_packages: list[str] = []
+
+    if types_packages:
+        total_packages.append("types-python-dateutil types-pyyaml types-requests types-tqdm types-mysqlclient types-paramiko types-pytz types-sqlalchemy types-toml types-urllib3")
+    if linting_debug_packages:
+        total_packages.append("mypy pyright ruff pylint pyrefly cleanpy ipdb pudb")
+    if ia_packages:
+        total_packages.append("ipython ipykernel jupyterlab nbformat marimo")
+    if plot_packages:
+        total_packages.append("python-magic matplotlib plotly kaleido")
+    if data_packages:
+        total_packages.append("numpy pandas polars duckdb-engine sqlalchemy  psycopg2-binary pyarrow tqdm openpyxl")
+    from machineconfig.utils.ve import get_ve_activate_line
+    script = f"""
+{starting_code}
+{packages_add_line}
+uv add --group {group} {" ".join(total_packages)}
+{get_ve_activate_line(ve_root=str(repo_root.joinpath(".venv")))}
+ls
+"""
+    from machineconfig.utils.code import exit_then_run_shell_script
+    exit_then_run_shell_script(script)
+
+
+def edit_file_with_hx(path: Annotated[Optional[str], typer.Argument(..., help="The root directory of the project to edit, or a file path.")] = None) -> None:
+    from pathlib import Path
+    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)
+
+
+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
+    from pathlib import Path
+    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
+

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/python/interactive.py

@@ -111,7 +111,7 @@ def execute_installations(selected_options: list[str]) -> None:
             console.print(Panel("⚡ [bold bright_yellow]CLI APPLICATIONS[/bold bright_yellow]\n[italic]Command-line tools installation[/italic]", border_style="bright_yellow"))
             console.print("🔧 Installing CLI applications", style="bold cyan")
             try:
-                from machineconfig.utils.installer_utils.installer_cli import main as devops_devapps_install_main
+                from machineconfig.utils.installer_utils.installer_cli import main_installer_cli as devops_devapps_install_main
                 devops_devapps_install_main(group=True, which=maybe_a_group, interactive=False)
                 console.print("✅ CLI applications installed successfully", style="bold green")
             except Exception as e:

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/scripts/windows/mounts/mount_ssh.ps1

@@ -7,7 +7,7 @@ $user = ''
 $sharePath = ''
 $driveLetter = ''
 
-uv run --python 3.14 --with "machineconfig>=7.67" python -m machineconfig.scripts.python.mount_ssh
+uv run --python 3.14 --with "machineconfig>=7.71" python -m machineconfig.scripts.python.mount_ssh
 
 net use T: \\sshfs.kr\$user@$host.local
 # this worked: net use T: \\sshfs\alex@alex-p51s-5.local

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/settings/lf/windows/lfcd.ps1

@@ -17,7 +17,7 @@
 
 function lfcd {
     $tmp = [System.IO.Path]::GetTempFileName()
-    ~\AppData\Local\Microsoft\WindowsApps\lf.exe -last-dir-path="$tmp" $args
+    & "$env:USERPROFILE\AppData\Local\Microsoft\WindowsApps\lf.exe" -last-dir-path="$tmp" $args
     if (Test-Path -PathType Leaf "$tmp")
     {
         $dir = Get-Content "$tmp"

{machineconfig-7.67 → machineconfig-7.71}/src/machineconfig/settings/shells/pwsh/init.ps1

@@ -15,6 +15,7 @@ function Add-ToPathIfNotAlready {
 }
 
 Add-ToPathIfNotAlready -Directories @(
+    "$HOME\.local\bin",
     "$CONFIG_ROOT\scripts",
     "$HOME\dotfiles\scripts\windows",
     "C:\Program Files (x86)\GnuWin32\bin",