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

machineconfig/scripts/python/helpers_devops/cli_repos.py

@@ -1,215 +0,0 @@
-"""Repos CLI powered by Typer.
-
-# TODO use gh api user --jq '.login' to get the username and use it to clone the repos.
-in the event that username@github.com is not mentioned in the remote url.
-
-"""
-
-from pathlib import Path
-from typing import Annotated, Optional
-import typer
-from machineconfig.scripts.python.helpers_repos.cloud_repo_sync import main as secure_repo_main
-
-
-DirectoryArgument = Annotated[Optional[str], typer.Argument(help="📁 Directory containing repo(s).")]
-RecursiveOption = Annotated[bool, typer.Option("--recursive", "-r", help="🔍 Recurse into nested repositories.")]
-UVsyncOption = Annotated[bool, typer.Option("--uv-sync/--no-uv-sync", "-u/-ns", help="Automatic uv sync after pulls.")]
-CloudOption = Annotated[Optional[str], typer.Option("--cloud", "-c", help="☁️ Upload to or download from this cloud remote.")]
-
-
-def push(directory: DirectoryArgument = None, recursive: RecursiveOption = False, auto_uv_sync: UVsyncOption = False) -> None:
-    """🚀 Push changes across repositories."""
-    from machineconfig.scripts.python.helpers_repos.entrypoint import git_operations
-    git_operations(directory, pull=False, commit=False, push=True, recursive=recursive, auto_uv_sync=auto_uv_sync)
-
-
-def pull(directory: DirectoryArgument = None, recursive: RecursiveOption = False, auto_uv_sync: UVsyncOption = False) -> None:
-    """⬇️ Pull changes across repositories."""
-    from machineconfig.scripts.python.helpers_repos.entrypoint import git_operations
-
-    git_operations(directory, pull=True, commit=False, push=False, recursive=recursive, auto_uv_sync=auto_uv_sync)
-
-
-def commit(directory: DirectoryArgument = None, recursive: RecursiveOption = False, auto_uv_sync: UVsyncOption = False) -> None:
-    """💾 Commit changes across repositories."""
-    from machineconfig.scripts.python.helpers_repos.entrypoint import git_operations
-    git_operations(directory, pull=False, commit=True, push=False, recursive=recursive, auto_uv_sync=auto_uv_sync)
-
-
-def sync(directory: DirectoryArgument = None, recursive: RecursiveOption = False, auto_uv_sync: UVsyncOption = False) -> None:
-    """🔄 Pull, commit, and push changes across repositories."""
-    from machineconfig.scripts.python.helpers_repos.entrypoint import git_operations
-    git_operations(directory, pull=True, commit=True, push=True, recursive=recursive, auto_uv_sync=auto_uv_sync)
-
-
-def capture(directory: DirectoryArgument = None, cloud: CloudOption = None) -> None:
-    """📝 Record repositories into a repos.json specification."""
-    from machineconfig.scripts.python.helpers_repos.entrypoint import resolve_directory
-    repos_root = resolve_directory(directory)
-    from machineconfig.scripts.python.helpers_repos.record import main_record as record_repos
-    save_path = record_repos(repos_root=repos_root)
-    from machineconfig.utils.path_extended import PathExtended
-    if cloud is not None:
-        PathExtended(save_path).to_cloud(rel2home=True, cloud=cloud)
-
-
-def clone(directory: DirectoryArgument = None, cloud: CloudOption = None) -> None:
-    """📥 Clone repositories described by a repos.json specification."""
-    from machineconfig.scripts.python.helpers_repos.entrypoint import clone_from_specs
-    clone_from_specs(directory, cloud, checkout_branch_flag=False, checkout_commit_flag=False)
-
-
-def checkout_command(directory: DirectoryArgument = None, cloud: CloudOption = None) -> None:
-    """🔀 Check out specific commits listed in the specification."""
-    from machineconfig.scripts.python.helpers_repos.entrypoint import clone_from_specs    
-    clone_from_specs(directory, cloud, checkout_branch_flag=False, checkout_commit_flag=True)
-
-
-def checkout_to_branch_command(directory: DirectoryArgument = None, cloud: CloudOption = None) -> None:
-    """🔀 Check out to the main branch defined in the specification."""
-    from machineconfig.scripts.python.helpers_repos.entrypoint import clone_from_specs
-    clone_from_specs(directory, cloud, checkout_branch_flag=True, checkout_commit_flag=False)
-
-
-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>=7.98"])
-
-
-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]>=7.98"])
-
-
-def analyze_repo_development(repo_path: Annotated[str, typer.Argument(..., help="Path to the git repository")]):
-    # from machineconfig.scripts.python.helpers_repos import count_lines
-    # 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.98" {count_lines_path} analyze-over-time {repo_path}"""
-    # from machineconfig.utils.code import run_shell_script
-    # run_shell_script(cmd)
-    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]>=7.98"])
-
-
-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",
-    seconds_per_day: Annotated[float, typer.Option(..., "--seconds-per-day", "-spd", help="Speed of simulation (lower = faster)")] = 0.1,
-    auto_skip_seconds: Annotated[float, typer.Option(..., "--auto-skip-seconds", "-as", help="Skip to next entry if nothing happens for X seconds")] = 1.0,
-    title: Annotated[Optional[str], typer.Option(..., "--title", "-t", help="Title for the visualization")] = None,
-    hide_items: Annotated[list[str], typer.Option(..., "--hide", "-h", help="Items to hide: bloom, date, dirnames, files, filenames, mouse, progress, root, tree, users, usernames")] = [],
-    key_items: Annotated[bool, typer.Option(..., "--key", "-k", help="Show file extension key")] = False,
-    fullscreen: Annotated[bool, typer.Option(..., "--fullscreen", "-f", help="Run in fullscreen mode")] = False,
-    viewport: Annotated[Optional[str], typer.Option(..., "--viewport", "-v", help="Camera viewport (e.g., '1000x1000')")] = None,
-    start_date: Annotated[Optional[str], typer.Option(..., "--start-date", help="Start date (YYYY-MM-DD)")] = None,
-    stop_date: Annotated[Optional[str], typer.Option(..., "--stop-date", help="Stop date (YYYY-MM-DD)")] = None,
-    user_image_dir: Annotated[Optional[Path], typer.Option(..., "--user-image-dir", help="Directory with user avatar images")] = None,
-    max_files: Annotated[int, typer.Option(..., "--max-files", help="Maximum number of files to show (0 = no limit)")] = 0,
-    max_file_lag: Annotated[float, typer.Option(..., "--max-file-lag", help="Max time files remain on screen after last change")] = 5.0,
-    file_idle_time: Annotated[int, typer.Option(..., "--file-idle-time", help="Time in seconds files remain idle before being removed")] = 0,
-    framerate: Annotated[int, typer.Option(..., "--framerate", help="Frames per second for video output")] = 60,
-    background_color: Annotated[str, typer.Option(..., "--background-color", help="Background color in hex (e.g., 000000 for black)")] = "000000",
-    font_size: Annotated[int, typer.Option(..., "--font-size", help="Font size")] = 22,
-    camera_mode: Annotated[str, typer.Option(..., "--camera-mode", help="Camera mode: overview or track")] = "overview",
-        ) -> None:
-    """🎬 Visualize repository activity using Gource."""
-    from machineconfig.scripts.python.helpers_repos.grource import visualize
-    visualize(repo=repo, output_file=output_file, resolution=resolution, seconds_per_day=seconds_per_day,
-              auto_skip_seconds=auto_skip_seconds, title=title, hide_items=hide_items, key_items=key_items,
-              fullscreen=fullscreen, viewport=viewport, start_date=start_date, stop_date=stop_date,
-              user_image_dir=user_image_dir, max_files=max_files, max_file_lag=max_file_lag,
-              file_idle_time=file_idle_time, framerate=framerate, background_color=background_color,
-              font_size=font_size, camera_mode=camera_mode)
-
-
-def cleanup(repo: DirectoryArgument = None, recursive: RecursiveOption = False) -> None:
-    """🧹 Clean repository directories from cache files."""
-    if repo is None:
-        repo = Path.cwd().as_posix()
-    
-    arg_path = Path(repo).expanduser().absolute()
-    from git import Repo, InvalidGitRepositoryError
-    if not recursive:
-        # Check if the directory is a git repo
-        try:
-            Repo(str(arg_path), search_parent_directories=False)
-        except InvalidGitRepositoryError:
-            typer.echo(f"❌ {arg_path} is not a git repository. Use -r flag for recursive cleanup.")
-            return
-        # Run cleanup on this repo
-        repos_to_clean = [arg_path]
-    else:
-        # Find all git repos recursively under the directory
-        git_dirs = list(arg_path.rglob('.git'))
-        repos_to_clean = [git_dir.parent for git_dir in git_dirs if git_dir.is_dir()]
-        if not repos_to_clean:
-            typer.echo(f"❌ No git repositories found under {arg_path}")
-            return
-    
-    for repo_path in repos_to_clean:
-        typer.echo(f"🧹 Cleaning {repo_path}")
-        script = fr"""
-cd "{repo_path}"
-uv run --with cleanpy cleanpy .
-# mcinit .
-# find "." -type f \( -name "*.py" -o -name "*.md" -o -name "*.json" \) -not -path "*/\.*" -not -path "*/__pycache__/*" -print0 | xargs -0 sed -i 's/[[:space:]]*$//'
-"""
-        from machineconfig.utils.code import run_shell_script
-        run_shell_script(script)
-
-
-def get_app():
-    repos_apps = typer.Typer(help="📁 [r] Manage development repositories", no_args_is_help=True, add_help_option=False, add_completion=False)
-    mirror_app = typer.Typer(help="🔄 [m] Manage repository specifications and syncing", no_args_is_help=True, add_help_option=False, add_completion=False)
-    repos_apps.add_typer(mirror_app, name="mirror", help="🔄  [m] mirror repositories using saved specs")
-    repos_apps.add_typer(mirror_app, name="m", help="mirror repositories using saved specs", hidden=True)
-
-    repos_apps.command(name="push", help="🚀  [p] Push changes across repositories")(push)
-    repos_apps.command(name="p", help="Push changes across repositories", hidden=True)(push)
-    repos_apps.command(name="pull", help="⬇️  [P] Pull changes across repositories")(pull)
-    repos_apps.command(name="P", help="Pull changes across repositories", hidden=True)(pull)
-    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_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")(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)
-
-    return repos_apps
-

machineconfig/scripts/python/helpers_devops/devops_backup_retrieve.py

@@ -1,80 +0,0 @@
-"""BR: Backup and Retrieve"""
-
-# import subprocess
-from machineconfig.utils.io import read_ini
-from machineconfig.utils.source_of_truth import LIBRARY_ROOT, DEFAULTS_PATH
-from machineconfig.utils.code import print_code
-from machineconfig.utils.options import choose_cloud_interactively, choose_from_options
-from machineconfig.scripts.python.helpers_cloud.helpers2 import ES
-from platform import system
-from typing import Any, Literal, Optional
-from rich.console import Console
-from rich.panel import Panel
-from pathlib import Path
-import tomllib
-
-
-OPTIONS = Literal["BACKUP", "RETRIEVE"]
-
-
-def main_backup_retrieve(direction: OPTIONS, which: Optional[str], cloud: Optional[str]) -> None:
-    console = Console()
-    try:
-        cloud = read_ini(DEFAULTS_PATH)["general"]["rclone_config_name"]
-        console.print(Panel(f"⚠️  DEFAULT CLOUD CONFIGURATION\n🌥️  Using default cloud: {cloud}", title="[bold blue]Cloud Configuration[/bold blue]", border_style="blue"))
-    except (FileNotFoundError, KeyError, IndexError):
-        console.print(Panel("🔍 DEFAULT CLOUD NOT FOUND\n🔄 Please select a cloud configuration from the options below", title="[bold red]Error: Cloud Not Found[/bold red]", border_style="red"))
-        cloud = choose_cloud_interactively()
-    bu_file: dict[str, Any] = tomllib.loads(LIBRARY_ROOT.joinpath("profile/backup.toml").read_text(encoding="utf-8"))
-    console.print(Panel(f"🧰 LOADING BACKUP CONFIGURATION\n📄 File: {LIBRARY_ROOT.joinpath('profile/backup.toml')}", title="[bold blue]Backup Configuration[/bold blue]", border_style="blue"))
-
-    if system() == "Linux":
-        bu_file = {key: val for key, val in bu_file.items() if "windows" not in key}
-        console.print(Panel(f"🐧 LINUX ENVIRONMENT DETECTED\n🔍 Filtering out Windows-specific entries\n✅ Found {len(bu_file)} applicable backup configuration entries", title="[bold blue]Linux Environment[/bold blue]", border_style="blue"))
-    elif system() == "Windows":
-        bu_file = {key: val for key, val in bu_file.items() if "linux" not in key}
-        console.print(Panel(f"🪟 WINDOWS ENVIRONMENT DETECTED\n🔍 Filtering out Linux-specific entries\n✅ Found {len(bu_file)} applicable backup configuration entries", title="[bold blue]Windows Environment[/bold blue]", border_style="blue"))
-
-    if which is None:
-        console.print(Panel(f"🔍 SELECT {direction} ITEMS\n📋 Choose which configuration entries to process", title="[bold blue]Select Items[/bold blue]", border_style="blue"))
-        choices = choose_from_options(multi=True, msg=f"WHICH FILE of the following do you want to {direction}?", options=["all"] + list(bu_file.keys()))
-    else:
-        choices = which.split(",") if which else []
-        console.print(Panel(f"🔖 PRE-SELECTED ITEMS\n📝 Using: {', '.join(choices)}", title="[bold blue]Pre-selected Items[/bold blue]", border_style="blue"))
-
-    if "all" in choices:
-        items = bu_file
-        console.print(Panel(f"📋 PROCESSING ALL ENTRIES\n🔢 Total entries to process: {len(bu_file)}", title="[bold blue]Process All Entries[/bold blue]", border_style="blue"))
-    else:
-        items = {key: val for key, val in bu_file.items() if key in choices}
-        console.print(Panel(f"📋 PROCESSING SELECTED ENTRIES\n🔢 Total entries to process: {len(items)}", title="[bold blue]Process Selected Entries[/bold blue]", border_style="blue"))
-    program = f"""$cloud = "{cloud}:{ES}" \n """ if system() == "Windows" else f"""cloud="{cloud}:{ES}" \n """
-    console.print(Panel(f"🚀 GENERATING {direction} SCRIPT\n🌥️  Cloud: {cloud}\n🗂️  Items: {len(items)}", title="[bold blue]Script Generation[/bold blue]", border_style="blue"))
-    for item_name, item in items.items():
-        flags = ""
-        flags += "z" if item["zip"] == "True" else ""
-        flags += "e" if item["encrypt"] == "True" else ""
-        flags += "r" if item["rel2home"] == "True" else ""
-        flags += "o" if system().lower() in item_name else ""
-        console.print(Panel(f"📦 PROCESSING: {item_name}\n📂 Path: {Path(item['path']).as_posix()}\n🏳️  Flags: {flags or 'None'}", title=f"[bold blue]Processing Item: {item_name}[/bold blue]", border_style="blue"))
-        if flags:
-            flags = "-" + flags
-        if direction == "BACKUP":
-            program += f"""\ncloud_copy "{Path(item["path"]).as_posix()}" $cloud {flags}\n"""
-        elif direction == "RETRIEVE":
-            program += f"""\ncloud_copy $cloud "{Path(item["path"]).as_posix()}" {flags}\n"""
-        else:
-            console.print(Panel('❌ ERROR: INVALID DIRECTION\n⚠️  Direction must be either "BACKUP" or "RETRIEVE"', title="[bold red]Error: Invalid Direction[/bold red]", border_style="red"))
-            raise RuntimeError(f"Unknown direction: {direction}")
-        if item_name == "dotfiles" and system() == "Linux":
-            program += """\nchmod 700 ~/.ssh/*\n"""
-            console.print(Panel("🔒 SPECIAL HANDLING: SSH PERMISSIONS\n🛠️  Setting secure permissions for SSH files\n📝 Command: chmod 700 ~/.ssh/*", title="[bold blue]Special Handling: SSH Permissions[/bold blue]", border_style="blue"))
-    print_code(program, lexer="shell", desc=f"{direction} script")
-    console.print(Panel(f"✅ {direction} SCRIPT GENERATION COMPLETE\n🚀 Ready to execute the operations", title="[bold green]Script Generation Complete[/bold green]", border_style="green"))
-    import subprocess
-
-    subprocess.run(program, shell=True, check=True)
-
-
-if __name__ == "__main__":
-    pass

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

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

machineconfig/scripts/python/helpers_navigator/__init__.py

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

machineconfig/scripts/python/helpers_navigator/command_detail.py

@@ -1,44 +0,0 @@
-"""
-Command detail widget for displaying command information.
-"""
-
-from typing import Optional
-from textual.widgets import Static
-from rich.panel import Panel
-from rich.text import Text
-from machineconfig.scripts.python.helpers_navigator.data_models import CommandInfo
-
-
-class CommandDetail(Static):
-    """Widget for displaying command details."""
-
-    def __init__(self, *, id: str) -> None:  # type: ignore
-        super().__init__(id=id)
-        self.command_info: Optional[CommandInfo] = None
-
-    def update_command(self, command_info: Optional[CommandInfo]) -> None:
-        """Update displayed command information."""
-        self.command_info = command_info
-        if command_info is None:
-            self.update("Select a command to view details")
-            return
-
-        content = Text()
-        content.append(f"{'🗂️  Group' if command_info.is_group else '⚡ Command'}: ", style="bold cyan")
-        content.append(f"{command_info.name}\n\n", style="bold yellow")
-
-        content.append("Description: ", style="bold green")
-        content.append(f"{command_info.description}\n\n", style="white")
-
-        content.append("Command: ", style="bold blue")
-        content.append(f"{command_info.command}\n\n", style="bold white")
-
-        if command_info.help_text:
-            content.append("Usage: ", style="bold magenta")
-            content.append(f"{command_info.help_text}\n\n", style="white")
-
-        if command_info.module_path:
-            content.append("Module: ", style="bold red")
-            content.append(f"{command_info.module_path}\n", style="white")
-
-        self.update(Panel(content, title=f"[bold]{command_info.name}[/bold]", border_style="blue"))