machineconfig 6.23__py3-none-any.whl → 8.12__py3-none-any.whl

machineconfig/scripts/python/{helpers_fire → helpers_agents}/fire_agents_help_launch.py

@@ -2,25 +2,30 @@
 import random
 import shlex
 from pathlib import Path
-from machineconfig.scripts.python.helpers_fire.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER, HOST, PROVIDER, MODEL
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER, HOST, PROVIDER, AI_SPEC, API_SPEC
 
 
-def get_api_keys(provider: PROVIDER) -> list[str]:
+def get_api_keys(provider: PROVIDER) -> list[API_SPEC]:
     from machineconfig.utils.io import read_ini
     config = read_ini(Path.home().joinpath(f"dotfiles/creds/llm/{provider}/api_keys.ini"))
-    res: list[str] = []
+    res: list[API_SPEC] = []
     for a_section_name in list(config.sections()):
         a_section = config[a_section_name]
         if "api_key" in a_section:
             api_key = a_section["api_key"].strip()
             if api_key:
-                res.append(api_key)
+                res.append(API_SPEC(
+                    api_key=api_key,
+                    api_name=a_section.get("api_name", ""),
+                    api_label=a_section_name,
+                    api_account=a_section.get("email", "")
+                ))
     print(f"Found {len(res)} {provider} API keys configured.")
     return res
 
 
 def prep_agent_launch(repo_root: Path, agents_dir: Path, prompts_material: list[str], prompt_prefix: str, keep_material_in_separate_file: bool,
-                      machine: HOST, model: MODEL, provider: PROVIDER, agent: AGENTS, *, job_name: str) -> None:
+                      machine: HOST, model: str, provider: PROVIDER, agent: AGENTS, *, job_name: str) -> None:
     agents_dir.mkdir(parents=True, exist_ok=True)
     prompt_folder = agents_dir / "prompts"
     prompt_folder.mkdir(parents=True, exist_ok=True)
@@ -55,6 +60,7 @@ export FIRE_AGENTS_PROMPT_FILE="{prompt_path}"
 export FIRE_AGENTS_MATERIAL_FILE="{prompt_material_path}"
 export FIRE_AGENTS_AGENT_LAUNCHER="{agent_cmd_launch_path}"
 
+
 echo "Sleeping for {random_sleep_time:.2f} seconds to stagger agent startups..."
 sleep {random_sleep_time:.2f}
 echo "--------START OF AGENT OUTPUT--------"
@@ -65,24 +71,37 @@ sleep 0.1
             case "gemini":
                 assert provider == "google", "Gemini agent only works with google provider."
                 api_keys = get_api_keys(provider="google")
-                api_key = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
-                from machineconfig.scripts.python.helpers_fire.agentic_frameworks.fire_gemini import fire_gemini
-                cmd = fire_gemini(api_key=api_key, prompt_path=prompt_path, machine=machine, model="gemini-2.5-pro", provider="google", repo_root=repo_root)
+                api_spec = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
+                if api_spec is None:
+                    raise ValueError("No API keys found for Google Gemini. Please configure them in dotfiles/creds/llm/google/api_keys.ini")
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model="gemini-2.5-pro", agent=agent, machine=machine, api_spec=api_spec)
+                from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_gemini import fire_gemini
+                cmd = fire_gemini(ai_spec=ai_spec, prompt_path=prompt_path, repo_root=repo_root)
             case "cursor-agent":
-                from machineconfig.scripts.python.helpers_fire.agentic_frameworks.fire_cursor_agents import fire_cursor
-                cmd = fire_cursor(prompt_path=prompt_path, machine=machine, api_key=None)
+                api_spec = API_SPEC(api_key=None, api_name="", api_label="", api_account="")
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model=model, agent=agent, machine=machine, api_spec=api_spec)
+                from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_cursor_agents import fire_cursor
+                cmd = fire_cursor(ai_spec=ai_spec, prompt_path=prompt_path)
                 raise NotImplementedError("Cursor agent is not implemented yet, api key missing")
             case "crush":
-                from machineconfig.scripts.python.helpers_fire.agentic_frameworks.fire_crush import fire_crush
                 api_keys = get_api_keys(provider=provider)
-                api_key = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
-                cmd = fire_crush(api_key=api_key, prompt_path=prompt_path, machine=machine, repo_root=repo_root, model=model, provider=provider)
+                api_spec = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
+                if api_spec is None:
+                    raise ValueError("No API keys found for Crush. Please configure them in dotfiles/creds/llm/crush/api_keys.ini")
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model=model, agent=agent, machine=machine, api_spec=api_spec)
+                from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_crush import fire_crush
+                cmd = fire_crush(ai_spec=ai_spec, prompt_path=prompt_path, repo_root=repo_root)
             # case "q":
             #     from machineconfig.scripts.python.helpers_fire.fire_q import fire_q
             #     cmd = fire_q(api_key="", prompt_path=prompt_path, machine=machine)
             case _:
                 raise ValueError(f"Unsupported agent type: {agent}")
-
+        cmd_prefix += f"""
+echo "Running with api label:   {ai_spec['api_spec']['api_label']}"
+echo "Running with api acount:  {ai_spec['api_spec']['api_account']}"
+echo "Running with api name:    {ai_spec['api_spec']['api_name']}"
+echo "Running with api key:     {ai_spec['api_spec']['api_key']}"
+"""
         cmd_postfix = """
 sleep 0.1
 echo "---------END OF AGENT OUTPUT---------"
@@ -93,10 +112,13 @@ echo "---------END OF AGENT OUTPUT---------"
 
 def get_agents_launch_layout(session_root: Path):
     from machineconfig.utils.schemas.layouts.layout_types import TabConfig, LayoutConfig, LayoutsFile
-
     tab_config: list[TabConfig] = []
     prompt_root = session_root / "prompts"
     all_dirs_under_prompts = [d for d in prompt_root.iterdir() if d.is_dir()]
+
+    import re
+    all_dirs_under_prompts = sorted(all_dirs_under_prompts, key=lambda path: [int(text) if text.isdigit() else text.lower() for text in re.split(r'(\d+)', path.name)])
+    print(all_dirs_under_prompts)
     for a_prompt_dir in all_dirs_under_prompts:
         idx = a_prompt_dir.name.split("_")[-1]  # e.g., agent_0 -> 0
         agent_cmd_path = a_prompt_dir / AGENT_NAME_FORMATTER.format(idx=idx)

machineconfig/scripts/python/helpers_agents/fire_agents_helper_types.py

@@ -0,0 +1,41 @@
+
+from typing import Literal, TypeAlias, TypedDict
+
+
+# Vscode extensions for AI-assisted coding.
+# Github copilot
+# Roo
+# Cline
+# Kilocode
+# Continue
+# CodeGPT
+# qodo (and cli)
+
+# Editors based on AI
+# Kiro
+# Cursor
+# Warp
+
+AGENTS: TypeAlias = Literal["cursor-agent", "gemini", "qwen-code", "copilot", "crush", "q", "opencode", "kilocode", "cline", "auggie", "warp", "droid"]
+HOST: TypeAlias = Literal["local", "docker"]
+PROVIDER: TypeAlias = Literal["azure", "google", "aws", "openai", "anthropic", "openrouter", "xai"]
+
+
+class API_SPEC(TypedDict):
+    api_key: str | None
+    api_name: str
+    api_label: str
+    api_account: str
+
+
+class AI_SPEC(TypedDict):
+    provider: PROVIDER
+    model: str
+    agent: AGENTS
+    machine: HOST
+    api_spec: API_SPEC
+
+
+AGENT_NAME_FORMATTER = "agent_{idx}_cmd.sh"  # e.g., agent_0_cmd.sh
+SEARCH_STRATEGIES: TypeAlias = Literal["file_path", "keyword_search", "filename_pattern"]
+

machineconfig/scripts/python/helpers_agents/privacy/configs/aichat/config.yaml

@@ -0,0 +1,5 @@
+save: false
+save_session: false
+save_shell_history: false
+user_agent: "Mozilla/5.0"
+sync_models_url: ""

machineconfig/scripts/python/helpers_agents/privacy/configs/aider/.aider.conf.yml

@@ -0,0 +1,2 @@
+analytics: false
+check-update: false

machineconfig/scripts/python/helpers_agents/privacy/configs/copilot/config.yml

@@ -0,0 +1 @@
+optional_usage_analytics: false

machineconfig/scripts/python/helpers_agents/privacy/configs/crush/crush.json

@@ -0,0 +1,10 @@
+{
+  "options": {
+    "disable_metrics": true,
+    "disable_provider_auto_update": true,
+    "attribution": {
+      "trailer_style": "none",
+      "generated_with": false
+    }
+  }
+}

machineconfig/scripts/python/helpers_agents/privacy/configs/gemini/settings.json

@@ -0,0 +1,12 @@
+{
+  "telemetry": {
+    "enabled": false,
+    "logPrompts": false,
+    "useCollector": false,
+    "target": "local",
+    "outfile": null
+  },
+  "advanced": {
+    "bugCommand": null
+  }
+}

machineconfig/scripts/python/helpers_agents/privacy/privacy.py

@@ -0,0 +1,109 @@
+"""
+
+create 18 tasks one per cli
+in each one, you do comprehensive search on internet on how to set up the cli/extension or whatever so we get max privacy and security (nothing shared everything is declined and is on the safe side)
+this is a moving space, everyday, there are new versions, new configs, new settings, new policies, new rules, new terms of service, new eula, new privacy policies etc etc
+so please search for latest and don't be complacent with the work done so far.
+
+do it one by one, don't research and implement next before finishing the task before it.
+
+I provided gemini cli solution as a reference (feel free to make it more flexible if you need mroe room to implement something more complex than what I did, its just a guide)
+remember that other cli's have different names and configs and locations etc, read official docs
+
+in the following cli how to set it for maximal prviacy *turn off any telemetry, reject any use of data, etc etc, please think of everything and read all theird docs and fine print
+    "aider",
+    "aichat",  # rust cli
+    "copilot",  # cli from github copilot extension
+    "gemini",  # gemini cli 
+    "crush",  # cli from charm team
+    "mods",  # cli from same people as crush (not agent) @ https://github.com/charmbracelet/mods
+    "opencode-ai",
+    "chatgpt",
+    "q",  # from aws
+    "qwen-code",  # fork of gemini cli
+    "cursor-cli",
+    "droid",
+    "kilocode",
+    "cline",  # cli from cline ai extension
+    "auggie",
+    "codex",  # from openai
+
+"""
+
+from typing import Optional
+
+
+def apply_max_privacy_and_security_rules_and_configs(overwrite: bool, repo_root: Optional[str]) -> None:
+    from machineconfig.utils.source_of_truth import LIBRARY_ROOT
+    root = LIBRARY_ROOT / "scripts/python/helpers_agents/privacy/configs"
+    from pathlib import Path
+
+    # Gemini privacy settings
+    gemini_settings_source = root.joinpath("gemini/settings.json")
+    gemini_settings_target_global = Path.home().joinpath(".gemini/settings.json")
+    if not gemini_settings_target_global.exists() or overwrite:
+        gemini_settings_target_global.parent.mkdir(parents=True, exist_ok=True)
+        gemini_settings_target_global.write_text(gemini_settings_source.read_text())
+    if repo_root:
+        gemini_settings_target_repo = Path(repo_root).joinpath(".gemini/settings.json")
+        if not gemini_settings_target_repo.exists() or overwrite:
+            gemini_settings_target_repo.parent.mkdir(parents=True, exist_ok=True)
+            gemini_settings_target_repo.write_text(gemini_settings_source.read_text())
+
+    # Aider privacy settings
+    aider_settings_source = root.joinpath("aider/.aider.conf.yml")
+    aider_settings_target_global = Path.home().joinpath(".aider.conf.yml")
+    if not aider_settings_target_global.exists() or overwrite:
+        aider_settings_target_global.parent.mkdir(parents=True, exist_ok=True)
+        aider_settings_target_global.write_text(aider_settings_source.read_text())
+
+    if repo_root:
+        aider_settings_target_repo = Path(repo_root).joinpath(".aider.conf.yml")
+        if not aider_settings_target_repo.exists() or overwrite:
+            aider_settings_target_repo.parent.mkdir(parents=True, exist_ok=True)
+            aider_settings_target_repo.write_text(aider_settings_source.read_text())
+
+    # Aichat privacy settings
+    aichat_settings_source = root.joinpath("aichat/config.yaml")
+    aichat_settings_target_global = Path.home().joinpath(".config/aichat/config.yaml")
+    if not aichat_settings_target_global.exists() or overwrite:
+        aichat_settings_target_global.parent.mkdir(parents=True, exist_ok=True)
+        aichat_settings_target_global.write_text(aichat_settings_source.read_text())
+
+    if repo_root:
+        aichat_settings_target_repo = Path(repo_root).joinpath(".config/aichat/config.yaml")
+        if not aichat_settings_target_repo.exists() or overwrite:
+            aichat_settings_target_repo.parent.mkdir(parents=True, exist_ok=True)
+            aichat_settings_target_repo.write_text(aichat_settings_source.read_text())
+
+    # Copilot privacy settings
+    copilot_settings_source = root.joinpath("copilot/config.yml")
+    copilot_settings_target_global = Path.home().joinpath(".config/gh-copilot/config.yml")
+    if not copilot_settings_target_global.exists() or overwrite:
+        copilot_settings_target_global.parent.mkdir(parents=True, exist_ok=True)
+        copilot_settings_target_global.write_text(copilot_settings_source.read_text())
+
+    if repo_root:
+        copilot_settings_target_repo = Path(repo_root).joinpath(".config/gh-copilot/config.yml")
+        if not copilot_settings_target_repo.exists() or overwrite:
+            copilot_settings_target_repo.parent.mkdir(parents=True, exist_ok=True)
+            copilot_settings_target_repo.write_text(copilot_settings_source.read_text())
+
+    # Crush privacy settings
+    crush_settings_source = root.joinpath("crush/crush.json")
+    crush_settings_target_global = Path.home().joinpath(".config/crush/crush.json")
+    if not crush_settings_target_global.exists() or overwrite:
+        crush_settings_target_global.parent.mkdir(parents=True, exist_ok=True)
+        crush_settings_target_global.write_text(crush_settings_source.read_text())
+
+    if repo_root:
+        crush_settings_target_repo = Path(repo_root).joinpath(".crush.json")
+        if not crush_settings_target_repo.exists() or overwrite:
+            crush_settings_target_repo.parent.mkdir(parents=True, exist_ok=True)
+            crush_settings_target_repo.write_text(crush_settings_source.read_text())
+
+    # next, cursh cli
+
+
+if __name__ == "__main__":
+    pass

machineconfig/scripts/python/helpers_agents/templates/prompt.txt

@@ -0,0 +1,10 @@
+
+Please inspect the following python files, and document which methods of PathExtended class have been used (if the class is used at all)
+please create a file next to this file on same dir called result.md and put your results in it.
+Like this:
+* File_NAME
+    * method1
+    * method2
+
+* File_NAME
+    * method x

machineconfig/scripts/python/helpers_agents/templates/template.sh

@@ -0,0 +1,34 @@
+
+#!/bin/bash
+# set -e # Exit immediately if a command exits with a non-zero status.
+
+
+REPO_ROOT="$HOME/code/machineconfig"
+
+JOB_NAME="agentsTrial"
+CONTEXT_PATH="$REPO_ROOT/.ai/agents/files.md"
+PROMPT_PATH="$REPO_ROOT/.ai/agents/prompt.txt"
+AGENTS_DIR="$REPO_ROOT/.ai/agents/$JOB_NAME"
+rm -rfd "$AGENTS_DIR" || true
+
+agents create \
+    --agents gemini \
+    --host docker \
+    --model gemini-2.5-pro \
+    --provider google \
+    --agent-load 5 \
+    --context-path $CONTEXT_PATH \
+    --prompt-path $PROMPT_PATH \
+    --job-name $JOB_NAME \
+    --agents-dir $AGENTS_DIR
+
+sessions balance-load "$AGENTS_DIR/layout.json" \
+    --max-threshold 4 \
+    --breaking-method moreLayouts \
+    --threshold-type number \
+    --output-path "$AGENTS_DIR/layout_balanced.json"
+
+sessions run "$AGENTS_DIR/layout_balanced.json" --kill-upon-completion
+
+
+# agents collect $AGENTS_DIR "$REPO_ROOT/.ai/agents/$JOB_NAME/collected.txt"

machineconfig/scripts/python/{cloud_helpers → helpers_cloud}/cloud_copy.py

@@ -2,26 +2,24 @@
 CC
 """
 
-from machineconfig.utils.path_extended import PathExtended
-from tenacity import retry, stop_after_attempt, wait_chain, wait_fixed
-import getpass
-import os
 from typing import Optional, Annotated
-
 import typer
 
-from machineconfig.scripts.python.cloud_helpers.helpers2 import parse_cloud_source_target
-from machineconfig.scripts.python.cloud_helpers.cloud_helpers import ArgsDefaults, Args
-from rich.console import Console
-from rich.panel import Panel
-from rich.progress import Progress
-from machineconfig.utils.accessories import pprint
+from tenacity import retry, stop_after_attempt, wait_chain, wait_fixed
 
-console = Console()
 
 
 @retry(stop=stop_after_attempt(3), wait=wait_chain(wait_fixed(1), wait_fixed(4), wait_fixed(9)))
 def get_securely_shared_file(url: Optional[str] = None, folder: Optional[str] = None) -> None:
+    from rich.console import Console
+    from rich.panel import Panel
+    from rich.progress import Progress
+    import getpass
+    import os
+    from machineconfig.utils.path_extended import PathExtended
+
+    console = Console()
+
     console.print(Panel("🚀 Secure File Downloader", title="[bold blue]Downloader[/bold blue]", border_style="blue"))
 
     folder_obj = PathExtended.cwd() if folder is None else PathExtended(folder)
@@ -62,21 +60,30 @@ def get_securely_shared_file(url: Optional[str] = None, folder: Optional[str] =
                 tmp_folder.delete()
 
 
+
 def main(
     source: Annotated[str, typer.Argument(help="📂 file/folder path to be taken from here.")],
     target: Annotated[str, typer.Argument(help="🎯 file/folder path to be be sent to here.")],
-    overwrite: Annotated[bool, typer.Option("--overwrite", "-o", help="✍️ Overwrite existing file.")] = ArgsDefaults.overwrite,
-    share: Annotated[bool, typer.Option("--share", "-s", help="🔗 Share file / directory")] = ArgsDefaults.share,
-    rel2home: Annotated[bool, typer.Option("--relative2home", "-r", help="🏠 Relative to `myhome` folder")] = ArgsDefaults.rel2home,
-    root: Annotated[Optional[str], typer.Option("--root", "-R", help="🌳 Remote root. None is the default, unless rel2home is raied, making the default `myhome`.")] = ArgsDefaults.root,
-    key: Annotated[Optional[str], typer.Option("--key", "-k", help="🔑 Key for encryption")] = ArgsDefaults.key,
-    pwd: Annotated[Optional[str], typer.Option("--password", "-p", help="🔒 Password for encryption")] = ArgsDefaults.pwd,
-    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="🔐 Encrypt before sending.")] = ArgsDefaults.encrypt,
-    zip_: Annotated[bool, typer.Option("--zip", "-z", help="📦 unzip after receiving.")] = ArgsDefaults.zip_,
-    os_specific: Annotated[bool, typer.Option("--os-specific", "-O", help="💻 choose path specific for this OS.")] = ArgsDefaults.os_specific,
+    overwrite: Annotated[bool, typer.Option("--overwrite", "-o", help="✍️ Overwrite existing file.")] = False,
+    share: Annotated[bool, typer.Option("--share", "-s", help="🔗 Share file / directory")] = False,
+    rel2home: Annotated[bool, typer.Option("--relative2home", "-r", help="🏠 Relative to `myhome` folder")] = False,
+    root: Annotated[Optional[str], typer.Option("--root", "-R", help="🌳 Remote root. None is the default, unless rel2home is raied, making the default `myhome`.")] = None,
+    key: Annotated[Optional[str], typer.Option("--key", "-k", help="🔑 Key for encryption")] = None,
+    pwd: Annotated[Optional[str], typer.Option("--password", "-p", help="🔒 Password for encryption")] = None,
+    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="🔐 Encrypt before sending.")] = False,
+    zip_: Annotated[bool, typer.Option("--zip", "-z", help="📦 unzip after receiving.")] = False,
+    os_specific: Annotated[bool, typer.Option("--os-specific", "-O", help="💻 choose path specific for this OS.")] = False,
     config: Annotated[Optional[str], typer.Option("--config", "-c", help="⚙️ path to cloud.json file.")] = None,
 ) -> None:
     """📤 Upload or 📥 Download files/folders to/from cloud storage services like Google Drive, Dropbox, OneDrive, etc."""
+    from rich.console import Console
+    from rich.panel import Panel
+    from machineconfig.utils.path_extended import PathExtended
+    from machineconfig.scripts.python.helpers_cloud.helpers2 import parse_cloud_source_target
+    from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args
+    from machineconfig.utils.accessories import pprint
+
+    console = Console()
     console.print(Panel("☁️  Cloud Copy Utility", title="[bold blue]Cloud Copy[/bold blue]", border_style="blue", width=152))
     args_obj = Args(
         overwrite=overwrite,

machineconfig/scripts/python/{cloud_helpers → helpers_cloud}/cloud_mount.py

@@ -1,32 +1,27 @@
 """Cloud mount script"""
 
-from machineconfig.utils.options import choose_from_options
-from machineconfig.utils.io import read_ini
-from machineconfig.utils.path_extended import PathExtended
-
-import platform
-from typing import Optional, Annotated
 import typer
-from rich.console import Console
-from rich.panel import Panel
-
-console = Console()
-
-
-DEFAULT_MOUNT = "~/data/rclone"
+from typing import Optional, Annotated
 
 
 def get_rclone_config():
+    from machineconfig.utils.io import read_ini
+    from pathlib import Path
+    import platform
     if platform.system() == "Windows":
-        config = read_ini(PathExtended.home().joinpath("AppData/Roaming/rclone/rclone.conf"))
+        config = read_ini(Path.home().joinpath("AppData/Roaming/rclone/rclone.conf"))
     elif platform.system() in ["Linux", "Darwin"]:
-        config = read_ini(PathExtended.home().joinpath(".config/rclone/rclone.conf"))
+        config = read_ini(Path.home().joinpath(".config/rclone/rclone.conf"))
     else:
         raise ValueError("unsupported platform")
     return config
 
 
 def get_mprocs_mount_txt(cloud: str, rclone_cmd: str, cloud_brand: str):  # cloud_brand = config[cloud]["type"]
+    from machineconfig.utils.path_extended import PathExtended
+    import platform
+    DEFAULT_MOUNT = "~/data/rclone"
+
     header = f"{' ' + cloud + ' | ' + cloud_brand + ' '}".center(50, "=")
     if platform.system() == "Windows":
         sub_text_path = PathExtended.tmpfile(suffix=".ps1")
@@ -57,6 +52,13 @@ def mount(
     destination: Annotated[Optional[str], typer.Option(help="destination to mount")] = None,
     network: Annotated[Optional[str], typer.Option(help="mount network drive")] = None,
 ) -> None:
+    from machineconfig.utils.options import choose_from_options
+    from pathlib import Path
+    import platform
+    from rich.console import Console
+    from rich.panel import Panel
+    console = Console()
+    DEFAULT_MOUNT = "~/data/rclone"
 
     # draw header box dynamically
     title = "☁️  Cloud Mount Utility"
@@ -73,9 +75,9 @@ def mount(
 
     if network is None:
         if destination is None:
-            mount_loc = PathExtended(DEFAULT_MOUNT).expanduser().joinpath(cloud)
+            mount_loc = Path(DEFAULT_MOUNT).expanduser().joinpath(cloud)
         else:
-            mount_loc = PathExtended(destination)
+            mount_loc = Path(destination)
 
         mount_info = f"📂 Mount location: {mount_loc}"
         console.print(Panel(mount_info, border_style="blue"))

machineconfig/scripts/python/{cloud_helpers → helpers_cloud}/cloud_sync.py

@@ -2,16 +2,9 @@
 TODO: use typer or typed-argument-parser to parse args
 """
 
-from machineconfig.scripts.python.cloud_helpers.helpers2 import parse_cloud_source_target
-from machineconfig.scripts.python.cloud_helpers.cloud_helpers import Args
-from machineconfig.scripts.python.cloud_helpers.cloud_mount import get_mprocs_mount_txt
 
 from typing import Annotated, Optional
 import typer
-from rich.console import Console
-from rich.panel import Panel
-
-console = Console()
 
 
 def main(
@@ -27,6 +20,14 @@ def main(
     delete: Annotated[bool, typer.Option("--delete", "-D", help="Delete files in remote that are not in local.")] = False,
     verbose: Annotated[bool, typer.Option("--verbose", "-v", help="Verbosity of mprocs to show details of syncing.")] = False,
 ) -> None:
+
+    from machineconfig.scripts.python.helpers_cloud.helpers2 import parse_cloud_source_target
+    from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args
+    from machineconfig.scripts.python.helpers_cloud.cloud_mount import get_mprocs_mount_txt
+    from rich.console import Console
+    from rich.panel import Panel
+    console = Console()
+
     title = "☁️  Cloud Sync Utility"
     console.print(Panel(title, title_align="left", border_style="blue"))
 
@@ -73,8 +74,8 @@ def main(
     cmd_line = f"{rclone_cmd[:65]}..."
     console.print(Panel(f"{title}\n{cmd_line}", title="[bold blue]Command[/bold blue]", expand=False))
 
-    # PROGRAM_PATH.write_text(txt, encoding="utf-8")
-    import subprocess
-
-    subprocess.run(txt, shell=True, check=True)
+    # import subprocess
+    # subprocess.run(txt, shell=True, check=True)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(txt)
 

machineconfig/scripts/python/{cloud_helpers → helpers_cloud}/helpers2.py

@@ -1,4 +1,4 @@
-from machineconfig.scripts.python.cloud_helpers.cloud_helpers import Args, ArgsDefaults, absolute, find_cloud_config, get_secure_share_cloud_config
+from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args, ArgsDefaults, absolute, find_cloud_config, get_secure_share_cloud_config
 from machineconfig.utils.io import read_ini
 from machineconfig.utils.source_of_truth import DEFAULTS_PATH
 from machineconfig.utils.accessories import pprint

machineconfig/scripts/python/helpers_croshell/crosh.py

@@ -0,0 +1,39 @@
+
+
+def get_read_python_file_pycode(path: str, title: str):
+    from pathlib import Path
+    print("Reading code from path:", path)
+    pycode = Path(path).read_text(encoding="utf-8")
+    pycode = pycode.split("except Exception: print(pycode)")[2]
+    try:
+        # from rich.text import Text
+        from rich.panel import Panel
+        from rich.console import Console
+        from rich.syntax import Syntax
+        console = Console()
+        if pycode.strip() != "":
+            console.print(Panel(Syntax(pycode, lexer="python"), title=title), style="bold red")
+    except Exception: print(pycode)
+
+
+def get_read_data_pycode(path: str):
+    from rich.panel import Panel
+    from rich.text import Text
+    from rich.console import Console
+    from pathlib import Path
+    console = Console()
+    p = Path(path).absolute()
+    try:
+        from machineconfig.utils.files.read import Read
+        from machineconfig.utils.accessories import pprint
+        dat = Read.read(p)
+        if isinstance(dat, dict):
+            panel_title = f"📄 File Data: {p.name}"
+            console.print(Panel(Text(str(dat), justify="left"), title=panel_title, expand=False))
+            pprint(dat, p.name)
+        else:
+            panel_title = f"📄 Successfully read the file: {p.name}"
+            console.print(Panel(Text(str(dat), justify="left"), title=panel_title, expand=False))
+    except Exception as e:
+        error_message = f'''❌ ERROR READING FILE\nFile: {p.name}\nError: {e}'''
+        console.print(Panel(Text(error_message, justify="left"), title="Error", expand=False, border_style="red"))

machineconfig/scripts/python/{croshell_helpers → helpers_croshell}/start_slidev.py

@@ -95,13 +95,12 @@ def main(
     if md_file.name != "slides.md":
         SLIDEV_REPO.joinpath(md_file.name).with_name(name="slides.md", inplace=True, overwrite=True)
 
-    import socket
-
-    try:
-        local_ip_v4 = socket.gethostbyname(socket.gethostname() + ".local")
-    except Exception:
-        print("⚠️ Warning: Could not get local_ip_v4. This might be due to running in a WSL instance.")
-        local_ip_v4 = socket.gethostbyname(socket.gethostname())
+    import machineconfig.scripts.python.helpers_network.address as helper
+    res = helper.select_lan_ipv4(prefer_vpn=False)
+    if res is None:
+        print("❌ Error: Could not determine local LAN IPv4 address for presentation.")
+        raise typer.Exit(code=1)
+    local_ip_v4 = res
 
     print("🌐 Presentation will be served at:")
     print(f"   - http://{platform.node()}:{port}")