machineconfig 2.1__py3-none-any.whl → 2.3__py3-none-any.whl

machineconfig/scripts/python/ai/generate_files.py

@@ -1,4 +1,3 @@
-
 #!/usr/bin/env python3
 """Script to generate a markdown table with checkboxes for all Python files in the repo."""
 
@@ -9,19 +8,19 @@ def get_python_files(repo_root: Path) -> list[str]:
     """Get all Python files relative to repo root."""
     # Get all .py files recursively
     py_files = list(repo_root.glob("**/*.py"))
-    
+
     # Filter out files in .venv and __pycache__ directories
     filtered_files = []
     for file_path in py_files:
         relative_path = file_path.relative_to(repo_root)
         path_parts = relative_path.parts
-        
+
         # Skip files in .venv or __pycache__ directories
         if any(part in {".venv", "__pycache__"} for part in path_parts):
             continue
-            
+
         filtered_files.append(str(relative_path))
-    
+
     return sorted(filtered_files)
 
 
@@ -29,12 +28,12 @@ def generate_markdown_table(files: list[str]) -> str:
     """Generate markdown table with checkboxes."""
     header = "# Python Files Checklist\n\n"
     table = "| Index | File Path | Status |\n|-------|-----------|--------|\n"
-    
+
     for index, file_path in enumerate(files, start=1):
         # Remove leading ./ if present
-        clean_path = file_path.lstrip('./')
+        clean_path = file_path.lstrip("./")
         table += f"| {index} | {clean_path} | - [ ] |\n"
-    
+
     return header + table
 
 
@@ -44,27 +43,28 @@ def main() -> None:
     if not repo_root.joinpath("pyproject.toml").exists():
         raise RuntimeError(f" {repo_root} Not a repo root")
     output_file = repo_root / ".ai" / "all_files_with_index.md"
-    
+
     print(f"Repo root: {repo_root}")
     print(f"Output file: {output_file}")
-    
+
     # Ensure output directory exists
     output_file.parent.mkdir(parents=True, exist_ok=True)
-    
+
     # Get Python files
     python_files = get_python_files(repo_root)
     print(f"Found {len(python_files)} Python files")
-    
+
     # Generate markdown
     markdown_content = generate_markdown_table(python_files)
     print(f"Generated markdown content length: {len(markdown_content)}")
-    
+
     # Write to file
     output_file.write_text(markdown_content)
     print(f"Generated {output_file} with {len(python_files)} Python files")
-    
+
     # Create 5 symlinks to repo_root at ~/code_copies/${repo_name}_copy_{i}
     import pathlib
+
     # import os
     repo_root = pathlib.Path.cwd().resolve()
     repo_name: str = pathlib.Path(repo_root).name
@@ -81,4 +81,3 @@ def main() -> None:
 
 if __name__ == "__main__":
     main()
-

machineconfig/scripts/python/ai/mcinit.py

@@ -1,5 +1,3 @@
-
-
 from pathlib import Path
 from typing import Optional
 
@@ -9,8 +7,10 @@ uv add --upgrade-package pylint pyright mypy pyrefly ty --dev  # linters and typ
 uv add --upgrade-package pytest --dev
 """
 
+
 def get_repo_root(path: Path) -> Optional[Path]:
     from git import Repo, InvalidGitRepositoryError
+
     try:
         repo = Repo(path, search_parent_directories=True)
         root = repo.working_tree_dir
@@ -20,12 +20,15 @@ def get_repo_root(path: Path) -> Optional[Path]:
         pass
     return None
 
+
 def add_ai_configs(repo_root: Path):
     import machineconfig as mc
+
     mc_root = Path(mc.__file__).parent
 
     repo_root_resolved = get_repo_root(repo_root)
-    if repo_root_resolved is not None: repo_root = repo_root_resolved  # this means you can run the command from any subdirectory of the repo.
+    if repo_root_resolved is not None:
+        repo_root = repo_root_resolved  # this means you can run the command from any subdirectory of the repo.
 
     if repo_root.joinpath("pyproject.toml").exists() is False:
         uv_init = input(f"{repo_root} does not seem to be a python project (no pyproject.toml found), would you like to initialize one? (y/n) ")
@@ -35,6 +38,7 @@ uv init --python 3.13
 uv venv
 """
             import subprocess
+
             subprocess.run(command_to_run, shell=True, check=True)
         else:
             print("Terminating mcinit ...")
@@ -93,8 +97,7 @@ uv venv
     if dot_git_ignore_path.exists():
         dot_git_ignore_content = dot_git_ignore_path.read_text(encoding="utf-8")
         to_add: list[str] = []
-        to_check_for: list[str] = [".links", "notebooks", ".ai", ".scripts",
-                                   "GEMINI.md", "CLAUDE.md", ".cursor", ".github"]
+        to_check_for: list[str] = [".links", "notebooks", ".ai", ".scripts", "GEMINI.md", "CLAUDE.md", ".cursor", ".github"]
         for item in to_check_for:
             if item not in dot_git_ignore_content:
                 to_add.append(item)

machineconfig/scripts/python/archive/tmate_conn.py

@@ -13,16 +13,16 @@ console = Console()
 
 def get_conn_string(sess_name: str) -> str:
     creds = configparser.ConfigParser()
-    creds.read(Path.home().joinpath('dotfiles/creds/tmate/creds.ini'))
-    sess_name = creds['sessions_names'][sess_name]
-    user_name = creds['keys']['username']
+    creds.read(Path.home().joinpath("dotfiles/creds/tmate/creds.ini"))
+    sess_name = creds["sessions_names"][sess_name]
+    user_name = creds["keys"]["username"]
     return f"{user_name}/{sess_name}@sgp1.tmate.io"
 
 
 def main():
     console.print(Panel("🔌 Tmate Connection Manager", title="[bold]Welcome[/bold]"))
 
-    parser = argparse.ArgumentParser(description='Tmate launcher')
+    parser = argparse.ArgumentParser(description="Tmate launcher")
     parser.add_argument("sess_name", help="session name", default=random.choices(list(string.digits + string.ascii_letters), k=20))
     args = parser.parse_args()
 
@@ -37,5 +37,5 @@ def main():
     console.print("✅ Connection closed")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()

machineconfig/scripts/python/archive/tmate_start.py

@@ -1,5 +1,5 @@
-"""Tmate
-"""
+"""Tmate"""
+
 import argparse
 import configparser
 from pathlib import Path
@@ -17,10 +17,10 @@ def main():
 
     console.print("[bold yellow]Loading credentials...[/bold yellow]")
     creds = configparser.ConfigParser()
-    creds.read(Path.home().joinpath('dotfiles/creds/tmate/creds.ini'))
+    creds.read(Path.home().joinpath("dotfiles/creds/tmate/creds.ini"))
     console.print("[green]Credentials loaded[/green]")
 
-    parser = argparse.ArgumentParser(description='Tmate launcher')
+    parser = argparse.ArgumentParser(description="Tmate launcher")
     random_sess = random.choices(list(string.digits + string.ascii_letters), k=20)
     _ = random_sess
     parser.add_argument("sess_name", help="session name (new only with random string will be chosen if not passed)", default=None)
@@ -28,8 +28,8 @@ def main():
     args = parser.parse_args()
 
     console.print(f"🔍 Looking up session configuration: {args.sess_name}")
-    sess_name = creds['sessions_names'][args.sess_name]
-    api_key = creds['keys']['api_key']
+    sess_name = creds["sessions_names"][args.sess_name]
+    api_key = creds["keys"]["api_key"]
 
     console.print(Panel(f"🚀 Starting tmate session: {sess_name}", title="[bold green]Session Info[/bold green]"))
 
@@ -40,5 +40,5 @@ def main():
     console.print("[green]Tmate session ended[/green]")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()

machineconfig/scripts/python/choose_wezterm_theme.py

@@ -2,7 +2,8 @@
 Choose a theme for Wezterm
 """
 
-from machineconfig.utils.utils import choose_one_option, PathExtended
+from machineconfig.utils.options import choose_one_option
+from machineconfig.utils.path_reduced import PathExtended
 from typing import Any
 import time
 from rich.panel import Panel
@@ -13,32 +14,32 @@ console = Console()
 
 
 schemes_list = [
-    'Pro',
-    'Spiderman',
-    'shades-of-purple',
-    'synthwave',
-    'Symfonic',
-    'PaulMillr',
-    'Neon',
-    'LiquidCarbonTransparentInverse',
-    'Laser',
-    'IR_Black',
-    'Hurtado',
-    'Homebrew',
-    'Hipster Green',
-    'Firefly Traditional',
-    'Elementary',
-    'deep',
-    'Dark Pastel',
-    'Bright Lights',
-    'Adventure',
-    'Nancy (terminal.sexy)',
-    'Bim (Gogh)',
-    'BlueDolphin',
-    'Borland',
-    'Grass (Gogh)',
-    'Greenscreen (light) (terminal.sexy)',
-    'Grayscale (dark) (terminal.sexy)',
+    "Pro",
+    "Spiderman",
+    "shades-of-purple",
+    "synthwave",
+    "Symfonic",
+    "PaulMillr",
+    "Neon",
+    "LiquidCarbonTransparentInverse",
+    "Laser",
+    "IR_Black",
+    "Hurtado",
+    "Homebrew",
+    "Hipster Green",
+    "Firefly Traditional",
+    "Elementary",
+    "deep",
+    "Dark Pastel",
+    "Bright Lights",
+    "Adventure",
+    "Nancy (terminal.sexy)",
+    "Bim (Gogh)",
+    "BlueDolphin",
+    "Borland",
+    "Grass (Gogh)",
+    "Greenscreen (light) (terminal.sexy)",
+    "Grayscale (dark) (terminal.sexy)",
 ]
 
 
@@ -54,10 +55,11 @@ def set_theme(theme: str):
     txt_lines = PathExtended("~/.config/wezterm/wezterm.lua").expanduser().read_text(encoding="utf-8").splitlines()
     res_lines = []
     for line in txt_lines:
-        if 'config.color_scheme = ' in line:
+        if "config.color_scheme = " in line:
             res_lines.append(f"config.color_scheme = '{theme}'")
-        else: res_lines.append(line)
-    PathExtended("~/.config/wezterm/wezterm.lua").expanduser().write_text('\n'.join(res_lines), encoding="utf-8")
+        else:
+            res_lines.append(line)
+    PathExtended("~/.config/wezterm/wezterm.lua").expanduser().write_text("\n".join(res_lines), encoding="utf-8")
     time.sleep(0.1)
     print("💾 Configuration saved")
 
@@ -70,6 +72,7 @@ def main():
     curses.wrapper(accessory)
     console.print(Panel("✅ Theme selection completed", title_align="left", border_style="green"))
 
+
 def accessory(stdscr: Any):
     options = schemes_list
     current_option = 0
@@ -90,7 +93,7 @@ def accessory(stdscr: Any):
                 stdscr.addstr(i, 0, f"  {option}")
 
         # Display status line
-        status_line = f"🔍 Theme {current_option+1}/{len(options)} | ↑/↓: Navigate | Enter: Select"
+        status_line = f"🔍 Theme {current_option + 1}/{len(options)} | ↑/↓: Navigate | Enter: Select"
         stdscr.addstr(page_size, 0, status_line)
 
         # Get key press
@@ -101,6 +104,6 @@ def accessory(stdscr: Any):
             current_option -= 1
         elif key == curses.KEY_DOWN and current_option < len(options) - 1:
             current_option += 1
-        elif key == ord('\n'):  # Enter key
+        elif key == ord("\n"):  # Enter key
             break  # Exit the loop
         set_theme(options[current_option])

machineconfig/scripts/python/cloud_copy.py

@@ -18,6 +18,7 @@ from machineconfig.utils.utils2 import pprint
 
 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:
     console.print(Panel("🚀 Secure File Downloader", title="[bold blue]Downloader[/bold blue]", border_style="blue"))
@@ -63,7 +64,7 @@ def get_securely_shared_file(url: Optional[str] = None, folder: Optional[str] =
 def arg_parser() -> None:
     console.print(Panel("☁️  Cloud Copy Utility", title="[bold blue]Cloud Copy[/bold blue]", border_style="blue", width=152))
 
-    parser = argparse.ArgumentParser(description='🚀 Cloud CLI. It wraps rclone with sane defaults for optimum type time.')
+    parser = argparse.ArgumentParser(description="🚀 Cloud CLI. It wraps rclone with sane defaults for optimum type time.")
 
     # positional argument
     parser.add_argument("source", help="📂 file/folder path to be taken from here.")
@@ -80,7 +81,7 @@ def arg_parser() -> None:
     parser.add_argument("--zip", "-z", help="📦 unzip after receiving.", action="store_true", default=ArgsDefaults.zip_)
     parser.add_argument("--os_specific", "-o", help="💻 choose path specific for this OS.", action="store_true", default=ArgsDefaults.os_specific)
 
-    parser.add_argument("--config", "-c",  help="⚙️ path to cloud.json file.", default=None)
+    parser.add_argument("--config", "-c", help="⚙️ path to cloud.json file.", default=None)
 
     args = parser.parse_args()
     args_dict = vars(args)
@@ -117,26 +118,34 @@ def arg_parser() -> None:
     if cloud in source:
         console.print(Panel(f"📥 DOWNLOADING FROM CLOUD\n☁️  Cloud: {cloud}\n📂 Source: {source.replace(cloud + ':', '')}\n🎯 Target: {target}", title="[bold blue]Download[/bold blue]", border_style="blue", width=152))
 
-        PathExtended(target).from_cloud(cloud=cloud, remotepath=source.replace(cloud + ":", ""),
-                            unzip=args_obj.zip, decrypt=args_obj.encrypt, pwd=args_obj.pwd,
-                            overwrite=args_obj.overwrite,
-                            rel2home=args_obj.rel2home, os_specific=args_obj.os_specific, root=args_obj.root, strict=False,
-                            )
+        PathExtended(target).from_cloud(
+            cloud=cloud,
+            remotepath=source.replace(cloud + ":", ""),
+            unzip=args_obj.zip,
+            decrypt=args_obj.encrypt,
+            pwd=args_obj.pwd,
+            overwrite=args_obj.overwrite,
+            rel2home=args_obj.rel2home,
+            os_specific=args_obj.os_specific,
+            root=args_obj.root,
+            strict=False,
+        )
         console.print(Panel("✅ Download completed successfully", title="[bold green]Success[/bold green]", border_style="green", width=152))
 
     elif cloud in target:
         console.print(Panel(f"📤 UPLOADING TO CLOUD\n☁️  Cloud: {cloud}\n📂 Source: {source}\n🎯 Target: {target.replace(cloud + ':', '')}", title="[bold blue]Upload[/bold blue]", border_style="blue", width=152))
 
-        res = PathExtended(source).to_cloud(cloud=cloud, remotepath=target.replace(cloud + ":", ""),
-                                    zip=args_obj.zip, encrypt=args_obj.encrypt, pwd=args_obj.pwd,
-                                    rel2home=args_obj.rel2home, root=args_obj.root, os_specific=args_obj.os_specific, strict=False,
-                                    share=args_obj.share)
+        res = PathExtended(source).to_cloud(
+            cloud=cloud, remotepath=target.replace(cloud + ":", ""), zip=args_obj.zip, encrypt=args_obj.encrypt, pwd=args_obj.pwd, rel2home=args_obj.rel2home, root=args_obj.root, os_specific=args_obj.os_specific, strict=False, share=args_obj.share
+        )
         console.print(Panel("✅ Upload completed successfully", title="[bold green]Success[/bold green]", border_style="green", width=152))
 
         if args_obj.share:
             fname = f".share_url_{cloud}"
-            if PathExtended(source).is_dir(): share_url_path = PathExtended(source).joinpath(fname)
-            else: share_url_path = PathExtended(source).with_suffix(fname)
+            if PathExtended(source).is_dir():
+                share_url_path = PathExtended(source).joinpath(fname)
+            else:
+                share_url_path = PathExtended(source).with_suffix(fname)
             share_url_path.write_text(res.as_url_str(), encoding="utf-8")
             console.print(Panel(f"🔗 SHARE URL GENERATED\n📝 URL file: {share_url_path}\n🌍 {res.as_url_str()}", title="[bold blue]Share[/bold blue]", border_style="blue", width=152))
     else:

machineconfig/scripts/python/cloud_mount.py

@@ -1,8 +1,7 @@
-"""Cloud mount script
-"""
-
+"""Cloud mount script"""
 
-from machineconfig.utils.utils import PROGRAM_PATH, choose_one_option
+from machineconfig.utils.source_of_truth import PROGRAM_PATH
+from machineconfig.utils.options import choose_one_option
 from machineconfig.utils.utils2 import read_ini
 from machineconfig.utils.path_reduced import PathExtended as PathExtended
 
@@ -19,9 +18,12 @@ DEFAULT_MOUNT = "~/data/rclone"
 
 
 def get_rclone_config():
-    if platform.system() == "Windows": config = read_ini(PathExtended.home().joinpath("AppData/Roaming/rclone/rclone.conf"))
-    elif platform.system() in ["Linux", "Darwin"]: config = read_ini(PathExtended.home().joinpath(".config/rclone/rclone.conf"))
-    else: raise ValueError("unsupported platform")
+    if platform.system() == "Windows":
+        config = read_ini(PathExtended.home().joinpath("AppData/Roaming/rclone/rclone.conf"))
+    elif platform.system() in ["Linux", "Darwin"]:
+        config = read_ini(PathExtended.home().joinpath(".config/rclone/rclone.conf"))
+    else:
+        raise ValueError("unsupported platform")
     return config
 
 
@@ -30,18 +32,22 @@ def get_mprocs_mount_txt(cloud: str, rclone_cmd: str, cloud_brand: str):  # clou
     if platform.system() == "Windows":
         sub_text_path = PathExtended.tmpfile(suffix=".ps1")
         sub_text_path.parent.mkdir(parents=True, exist_ok=True)
-        sub_text_path.write_text(f"""
+        sub_text_path.write_text(
+            f"""
 echo "{header}"
 iex 'rclone about {cloud}:'
 echo 'See {DEFAULT_MOUNT}/{cloud} for the mounted cloud'
 
 echo ''
-""", encoding="utf-8")
+""",
+            encoding="utf-8",
+        )
         txt = f"""
 cd ~
 mprocs "powershell {sub_text_path}" "{rclone_cmd}" "btm" "timeout 2 & cd {DEFAULT_MOUNT} & lf" "timeout 2 & cd {DEFAULT_MOUNT} & pwsh" "pwsh" --names "info,service,monitor,explorer,main,terminal"
 """
-    else: txt = f"""
+    else:
+        txt = f"""
 mprocs "echo 'see {DEFAULT_MOUNT}/{cloud} for the mounted cloud'; rclone about {cloud}:" "{rclone_cmd}" "btm" "cd {DEFAULT_MOUNT}; lf" "bash" "bash" --names "about,service,monitor,explorer,main,shell"
 """
     return txt
@@ -55,8 +61,10 @@ def mount(cloud: Optional[str], network: Optional[str], destination: Optional[st
     config = get_rclone_config()
     if cloud is None:
         res = choose_one_option(msg="which cloud", options=config.sections(), header="CLOUD MOUNT", default=None)
-        if type(res) is str: cloud = res
-        else: raise ValueError("no cloud selected")
+        if type(res) is str:
+            cloud = res
+        else:
+            raise ValueError("no cloud selected")
         print(f"🌩️  Selected cloud: {cloud}")
 
     if network is None:
@@ -74,30 +82,33 @@ def mount(cloud: Optional[str], network: Optional[str], destination: Optional[st
         elif platform.system() in ["Linux", "Darwin"]:
             system_name = "Linux" if platform.system() == "Linux" else "macOS"
             print(f"🐧 Creating mount directory on {system_name}...")
-            try: mount_loc.mkdir(parents=True, exist_ok=True)
+            try:
+                mount_loc.mkdir(parents=True, exist_ok=True)
             except (FileExistsError, OSError) as err:
                 # We need a umount command here.
                 warning_line = "⚠️  WARNING: Mount directory issue"
                 err_line = f"{err}"
                 console.print(Panel(f"{warning_line}\n{err_line}", title="Warning", border_style="yellow"))
                 pass
-        else: raise ValueError("unsupported platform")
+        else:
+            raise ValueError("unsupported platform")
 
     elif network and platform.system() == "Windows":
         mount_loc = "X: --network-mode"
         print(f"🔌 Setting up network mount at {mount_loc}")
-    else: raise ValueError("network mount only supported on windows")
+    else:
+        raise ValueError("network mount only supported on windows")
 
     mount_cmd = f"rclone mount {cloud}: {mount_loc} --vfs-cache-mode full --file-perms=0777"
     console.print(Panel(f"🚀 Preparing mount command:\n{mount_cmd}", border_style="blue"))
 
     # txt = get_mprocs_mount_txt(cloud, mount_cmd)
     if platform.system() == "Windows":
-
         txt = f"""
 wt --window 0 --profile "Windows PowerShell" --startingDirectory "$HOME/data/rclone" `; split-pane --horizontal  --profile "Command Prompt" --size 0.2 powershell -Command "{mount_cmd}" `; split-pane --vertical --profile "Windows PowerShell" --size 0.2 powershell -NoExit -Command "rclone about {cloud}:"  `; move-focus up
 """
-    elif platform.system() in ["Linux", "Darwin"]: txt = f"""
+    elif platform.system() in ["Linux", "Darwin"]:
+        txt = f"""
 
 ZJ_SESSIONS=$(zellij list-sessions)
 
@@ -130,7 +141,8 @@ zellij run --direction up -- btm --default_widget_type net --expanded
 zellij run --in-place --cwd $HOME/data/rclone/{cloud} -- bash
 zellij action move-focus up
 """
-    else: raise ValueError("unsupported platform")
+    else:
+        raise ValueError("unsupported platform")
     # print(f"running command: \n{txt}")
     PROGRAM_PATH.write_text(txt, encoding="utf-8")
     # draw success box dynamically
@@ -144,13 +156,13 @@ def main():
     main_title = "☁️  RCLONE CLOUD MOUNT"
     console.print(Panel(main_title, title_align="left", border_style="blue"))
 
-    parser = argparse.ArgumentParser(description='mount cloud')
-    parser.add_argument('cloud', nargs='?', type=str, default=None, help='cloud to mount')
-    parser.add_argument('destination', nargs='?', type=str, default=None, help='destination to mount')
-    parser.add_argument('--network', type=str, default=None, help='mount network drive')
+    parser = argparse.ArgumentParser(description="mount cloud")
+    parser.add_argument("cloud", nargs="?", type=str, default=None, help="cloud to mount")
+    parser.add_argument("destination", nargs="?", type=str, default=None, help="destination to mount")
+    parser.add_argument("--network", type=str, default=None, help="mount network drive")
     args = parser.parse_args()
     mount(cloud=args.cloud, network=args.network, destination=args.destination)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()