machineconfig 6.82__py3-none-any.whl → 8.51__py3-none-any.whl

machineconfig/scripts/python/helpers_devops/cli_config.py

@@ -1,120 +0,0 @@
-
-
-from typing import Literal, Annotated, Optional
-from pathlib import Path
-import typer
-
-
-
-def private(method: Annotated[Literal["symlink", "copy"], typer.Option(..., "--method", "-m", help="Method to use for linking files")],
-                             on_conflict: Annotated[Literal["throwError", "overwriteSelfManaged", "backupSelfManaged", "overwriteDefaultPath", "backupDefaultPath"], typer.Option(..., "--on-conflict", "-o", help="Action to take on conflict")] = "throwError",
-                             which: Annotated[Optional[str], typer.Option(..., "--which", "-w", help="Specific items to process")] = None,
-                             interactive: Annotated[bool, typer.Option(..., "--interactive", "-ia", help="Run in interactive mode")] = False):
-    """🔗 Manage private configuration files."""
-    import machineconfig.profile.create_links_export as create_links_export
-    create_links_export.main_private_from_parser(method=method, on_conflict=on_conflict, which=which, interactive=interactive)
-
-def public(method: Annotated[Literal["symlink", "copy"], typer.Option(..., "--method", "-m", help="Method to use for setting up the config file.")],
-                            on_conflict: Annotated[Literal["throwError", "overwriteDefaultPath", "backupDefaultPath"], typer.Option(..., "--on-conflict", "-o", help="Action to take on conflict")] = "throwError",
-                            which: Annotated[Optional[str], typer.Option(..., "--which", "-w", help="Specific items to process")] = None,
-                            interactive: Annotated[bool, typer.Option(..., "--interactive", "-ia", help="Run in interactive mode")] = False):
-    """🔗 Manage public configuration files."""
-    import machineconfig.profile.create_links_export as create_links_export
-    create_links_export.main_public_from_parser(method=method, on_conflict=on_conflict, which=which, interactive=interactive)
-
-def dotfile(file: Annotated[str, typer.Argument(help="file/folder path.")],
-    overwrite: Annotated[bool, typer.Option("--overwrite", "-o", help="Overwrite.")] = False,
-    dest: Annotated[str, typer.Option("--dest", "-d", help="destination folder")] = "",
-    ):
-    """🔗 Manage dotfiles."""
-    import machineconfig.scripts.python.helpers_devops.cli_config_dotfile as dotfile_module
-    dotfile_module.main(file=file, overwrite=overwrite, dest=dest)
-
-
-def shell():
-    """🔗 Configure your shell profile."""
-    from machineconfig.profile.create_shell_profile import create_default_shell_profile
-    create_default_shell_profile()
-
-
-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>=6.81")
-    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 pwsh_theme():
-    """🔗 Select powershell prompt theme."""
-    import machineconfig.scripts.python.helpers_devops.themes as themes
-    file = Path(themes.__file__).parent / "choose_pwsh_theme.ps1"
-    import subprocess
-    subprocess.run(["pwsh", "-File", str(file)])
-
-def starship_theme():
-    """🔗 Select starship prompt theme."""
-    import subprocess
-    from machineconfig.utils.code import run_shell_script
-    
-    presets: list[str] = ["catppuccin-powerline", "pastel-powerline", "tokyo-night", "gruvbox-rainbow", "jetpack"]
-    config_path: Path = Path.home() / ".config" / "starship.toml"
-    
-    typer.echo("\n🚀 Starship Theme Selector\n")
-    for idx, preset in enumerate(presets, start=1):
-        typer.echo(f"{idx}. {preset}")
-    
-    choice: str = typer.prompt("Select a preset")
-    
-    try:
-        choice_idx: int = int(choice)
-        if 1 <= choice_idx <= len(presets):
-            selected_preset: str = presets[choice_idx - 1]
-            typer.echo(f"\n✨ Applying {selected_preset}...")
-            run_shell_script(f"""starship preset {selected_preset} -o {config_path}""")
-            typer.echo("\n📋 Preview:")
-            subprocess.run(["starship", "module", "all"], check=False)
-            typer.echo(f"\n✅ {selected_preset} applied!")
-        else:
-            typer.echo("❌ Invalid selection")
-    except ValueError:
-        typer.echo("❌ Please enter a valid number")
-
-def copy_assets(which: Annotated[Literal["scripts", "settings", "both"], typer.Argument(..., help="Which assets to copy")]):
-    """🔗 Copy asset files from library to machine."""
-    import machineconfig.profile.create_helper as create_helper
-    match which:
-        case "both":
-            create_helper.copy_assets_to_machine(which="scripts")
-            create_helper.copy_assets_to_machine(which="settings")
-        case _:
-            create_helper.copy_assets_to_machine(which=which)
-
-
-def get_app():
-    config_apps = typer.Typer(help="⚙️ [c] configuration subcommands", no_args_is_help=True, add_help_option=False, add_completion=False)
-    config_apps.command("private", no_args_is_help=True, help="🔗  [v] Manage private configuration files.")(private)
-    config_apps.command("v", no_args_is_help=True, hidden=True)(private)
-    config_apps.command("public", no_args_is_help=True, help="🔗  [b] Manage public configuration files.")(public)
-    config_apps.command("b", no_args_is_help=True, help="Manage public configuration files.", hidden=True)(public)
-    config_apps.command("dotfile", no_args_is_help=True, help="🔗  [d] Manage dotfiles.")(dotfile)
-    config_apps.command("d", no_args_is_help=True,  hidden=True)(dotfile)
-    config_apps.command("shell", no_args_is_help=False, help="🔗  [s] Configure your shell profile.")(shell)
-    config_apps.command("s", no_args_is_help=False, help="Configure your shell profile.", hidden=True)(shell)
-    config_apps.command("path", no_args_is_help=False, help="📚  [p] NAVIGATE PATH variable with TUI")(path)
-    config_apps.command("p", no_args_is_help=False, help="NAVIGATE PATH variable with TUI", hidden=True)(path)
-    config_apps.command("starship-theme", no_args_is_help=False, help="🔗  [t] Select starship prompt theme.")(starship_theme)
-    config_apps.command("t", no_args_is_help=False, help="Select starship prompt theme.", hidden=True)(starship_theme)
-    config_apps.command("pwsh-theme", no_args_is_help=False, help="🔗  [T] Select powershell prompt theme.")(pwsh_theme)
-    config_apps.command("T", no_args_is_help=False, help="Select powershell prompt theme.", hidden=True)(pwsh_theme)
-
-    config_apps.command("copy-assets", no_args_is_help=True, help="🔗  [c] Copy asset files from library to machine.", hidden=False)(copy_assets)
-    config_apps.command("c", no_args_is_help=True, help="Copy asset files from library to machine.", hidden=True)(copy_assets)
-    return config_apps

machineconfig/scripts/python/helpers_devops/cli_config_dotfile.py

@@ -1,77 +0,0 @@
-"""Like yadm and dotter."""
-
-from typing import Annotated
-
-import typer
-
-
-def main(
-    file: Annotated[str, typer.Argument(help="file/folder path.")],
-    overwrite: Annotated[bool, typer.Option("--overwrite", "-o", help="Overwrite.")] = False,
-    dest: Annotated[str, typer.Option("--dest", "-d", help="destination folder")] = "",
-) -> None:
-
-    from rich.console import Console
-    from rich.panel import Panel
-
-    from machineconfig.utils.links import symlink_map
-    from machineconfig.utils.path_extended import PathExtended
-    from machineconfig.utils.source_of_truth import CONFIG_ROOT
-    console = Console()
-    orig_path = PathExtended(file).expanduser().absolute()
-    if dest == "":
-        if "Local" in str(orig_path):
-            junction = orig_path.split(at="Local", sep=-1)[1]
-        elif "Roaming" in str(orig_path):
-            junction = orig_path.split(at="Roaming", sep=-1)[1]
-        elif ".config" in str(orig_path):
-            junction = orig_path.split(at=".config", sep=-1)[1]
-        else:
-            junction = orig_path.rel2home()
-        new_path = PathExtended(CONFIG_ROOT).parent.parent.joinpath(junction)
-    else:
-        dest_path = PathExtended(dest).expanduser().absolute()
-        dest_path.mkdir(parents=True, exist_ok=True)
-        new_path = dest_path.joinpath(orig_path.name)
-
-    symlink_map(config_file_default_path=orig_path, self_managed_config_file_path=new_path, on_conflict="throwError")
-
-    console.print(
-        Panel(
-            "\n".join(
-                [
-                    "✅ Symbolic link created successfully!",
-                    "🔄 Add the following snippet to mapper.toml to persist this mapping:",
-                ]
-            ),
-            title="Symlink Created",
-            border_style="green",
-            padding=(1, 2),
-        )
-    )
-
-    mapper_snippet = "\n".join(
-        [
-            f"[bold]📝 Edit configuration file:[/] [cyan]nano {PathExtended(CONFIG_ROOT)}/symlinks/mapper.toml[/cyan]",
-            "",
-            f"[{new_path.parent.name}]",
-            f"{orig_path.name.split('.')[0]} = {{ this = '{orig_path.collapseuser().as_posix()}', to_this = '{new_path.collapseuser().as_posix()}' }}",
-        ]
-    )
-
-    console.print(
-        Panel(
-            mapper_snippet,
-            title="Mapper Entry",
-            border_style="cyan",
-            padding=(1, 2),
-        )
-    )
-
-
-def arg_parser() -> None:
-    typer.run(main)
-
-
-if __name__ == "__main__":
-    arg_parser()

machineconfig/scripts/python/helpers_devops/cli_data.py

@@ -1,25 +0,0 @@
-
-import typer
-from typing import Annotated, Optional
-
-def backup(cloud: Annotated[Optional[str], typer.Option("--cloud", "-c", help="☁️  Cloud configuration name (rclone config name)")] = None,
-           which: Annotated[Optional[str], typer.Option("--which", "-w", help="📝 Comma-separated list of items to BACKUP (from backup.toml), or 'all' for all items")] = None):
-    """💾 BACKUP"""
-    from machineconfig.scripts.python.helpers_devops.devops_backup_retrieve import main_backup_retrieve
-    main_backup_retrieve(direction="BACKUP", which=which, cloud=cloud)
-
-
-def retrieve(cloud: Annotated[Optional[str], typer.Option("--cloud", "-c", help="☁️  Cloud configuration name (rclone config name)")] = None,
-             which: Annotated[Optional[str], typer.Option("--which", "-w", help="📝 Comma-separated list of items to RETRIEVE (from backup.toml), or 'all' for all items")] = None):
-    """📥 RETRIEVE"""
-    from machineconfig.scripts.python.helpers_devops.devops_backup_retrieve import main_backup_retrieve
-    main_backup_retrieve(direction="RETRIEVE", which=which, cloud=cloud)
-
-
-def get_app() -> typer.Typer:
-    app = typer.Typer(name="data", help="💾 [d] Backup and Retrieve configuration files and directories to/from cloud storage using rclone.", no_args_is_help=True)
-    app.command(name="backup", no_args_is_help=True, hidden=False, help="💾 [b] Backup files and directories to cloud storage using rclone.")(backup)
-    app.command(name="b", no_args_is_help=True, hidden=True,)(backup)
-    app.command(name="retrieve", no_args_is_help=True, hidden=False, help="📥 [r] Retrieve files and directories from cloud storage using rclone.")(retrieve)
-    app.command(name="r", no_args_is_help=True, hidden=True, )(retrieve)
-    return app

machineconfig/scripts/python/helpers_devops/cli_nw.py

@@ -1,73 +0,0 @@
-
-import machineconfig.scripts.python.helpers_devops.cli_terminal as cli_terminal
-import machineconfig.scripts.python.helpers_devops.cli_share_server as cli_share_server
-import typer
-from typing import Optional, Annotated
-
-
-
-def install_ssh_server():
-    """📡 SSH install server"""
-    import platform
-    if platform.system() == "Windows":
-        from machineconfig.setup_windows import SSH_SERVER
-    elif platform.system() == "Linux" or platform.system() == "Darwin":
-        from machineconfig.setup_linux import SSH_SERVER
-    else:
-        raise NotImplementedError(f"Platform {platform.system()} is not supported.")
-    from machineconfig.utils.code import run_shell_script
-    run_shell_script(script=SSH_SERVER.read_text(encoding="utf-8"))
-
-
-def add_ssh_key(path: Annotated[Optional[str], typer.Option(..., help="Path to the public key file")] = None,
-         choose: Annotated[bool, typer.Option(..., "--choose", "-c", help="Choose from available public keys in ~/.ssh/*.pub")] = False,
-         value: Annotated[bool, typer.Option(..., "--value", "-v", help="Paste the public key content manually")] = False,
-         github: Annotated[Optional[str], typer.Option(..., "--github", "-g", help="Fetch public keys from a GitHub username")] = None
-):
-    """🔑 SSH add pub key to this machine so its accessible by owner of corresponding private key."""
-    import machineconfig.scripts.python.nw.devops_add_ssh_key as helper
-    helper.main(pub_path=path, pub_choose=choose, pub_val=value, from_github=github)
-def add_ssh_identity():
-    """🗝️ SSH add identity (private key) to this machine"""
-    import machineconfig.scripts.python.nw.devops_add_identity as helper
-    helper.main()
-
-
-def show_address():
-    import socket
-    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-    s.connect(('8.8.8.8',80))
-    local_ip_v4 = s.getsockname()[0]
-    s.close()
-    print(f"This computer is @ {local_ip_v4}")
-
-
-def debug_ssh():
-    """🐛 SSH debug"""
-    from platform import system
-    if system() == "Linux" or system() == "Darwin":
-        import machineconfig.scripts.python.nw.ssh_debug_linux as helper
-        helper.ssh_debug_linux()
-    elif system() == "Windows":
-        import machineconfig.scripts.python.nw.ssh_debug_windows as helper
-        helper.ssh_debug_windows()
-    else:
-        raise NotImplementedError(f"Platform {system()} is not supported.")
-
-def get_app():
-    nw_apps = typer.Typer(help="🔐 [n] Network subcommands", no_args_is_help=True, add_help_option=False, add_completion=False)
-    nw_apps.command(name="share-terminal", help="📡  [t] Share terminal via web browser")(cli_terminal.main)
-    nw_apps.command(name="t", help="Share terminal via web browser", hidden=True)(cli_terminal.main)
-    nw_apps.command(name="share-server", help="🌐  [s] Start local/global server to share files/folders via web browser", no_args_is_help=True)(cli_share_server.main)
-    nw_apps.command(name="s", help="Start local/global server to share files/folders via web browser", hidden=True, no_args_is_help=True)(cli_share_server.main)
-    nw_apps.command(name="install-ssh-server", help="📡  [i] Install SSH server")(install_ssh_server)
-    nw_apps.command(name="i", help="Install SSH server", hidden=True)(install_ssh_server)
-    nw_apps.command(name="add-ssh-key", help="🔑  [k] Add SSH public key to this machine", no_args_is_help=True)(add_ssh_key)
-    nw_apps.command(name="k", help="Add SSH public key to this machine", hidden=True, no_args_is_help=True)(add_ssh_key)
-    nw_apps.command(name="add-ssh-identity", help="🗝️  [A] Add SSH identity (private key) to this machine")(add_ssh_identity)
-    nw_apps.command(name="A", help="Add SSH identity (private key) to this machine", hidden=True)(add_ssh_identity)
-    nw_apps.command(name="show-address", help="📌  [a] Show this computer addresses on network")(show_address)
-    nw_apps.command(name="a", help="Show this computer addresses on network", hidden=True)(show_address)
-    nw_apps.command(name="debug-ssh", help="🐛  [d] Debug SSH connection")(debug_ssh)
-    nw_apps.command(name="d", help="Debug SSH connection", hidden=True)(debug_ssh)
-    return nw_apps

machineconfig/scripts/python/helpers_devops/cli_repos.py

@@ -1,181 +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.secure_repo 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.")]
-NO_UVsyncOption = Annotated[bool, typer.Option("--no-uv-sync", "-ns", help="🚫 Disable 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, no_uv_sync: NO_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=not no_uv_sync)
-
-
-def pull(directory: DirectoryArgument = None, recursive: RecursiveOption = False, no_uv_sync: NO_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=not no_uv_sync)
-
-
-def commit(directory: DirectoryArgument = None, recursive: RecursiveOption = False, no_uv_sync: NO_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=not no_uv_sync)
-
-
-def sync(directory: DirectoryArgument = None, recursive: RecursiveOption = False, no_uv_sync: NO_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=not no_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 analyze(directory: DirectoryArgument = None) -> None:
-    """📊 Analyze repository development over time."""
-    repo_path = directory if directory is not None else "."
-    from machineconfig.scripts.python.helpers_repos.count_lines_frontend import analyze_repo_development
-    analyze_repo_development(repo_path=repo_path)
-
-
-def viz(
-    repo: Annotated[str, typer.Option(..., "--repo", "-r", help="Path to git repository to visualize")] = Path.cwd().__str__(),
-    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)
-    repos_apps.command(name="a", help="Analyze repository development over time", hidden=True)(analyze)
-    repos_apps.command(name="secure", help="🔐  [s] Securely sync git repository to/from cloud with encryption")(secure_repo_main)
-    repos_apps.command(name="s", help="Securely sync git repository to/from cloud with encryption", hidden=True)(secure_repo_main)
-    repos_apps.command(name="viz", help="🎬  [v] Visualize repository activity using Gource")(viz)
-    repos_apps.command(name="v", help="Visualize repository activity using Gource", hidden=True)(viz)
-    repos_apps.command(name="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/cli_self.py

@@ -1,122 +0,0 @@
-
-import typer
-from typing import Optional, Annotated
-
-
-def update(no_copy_assets: Annotated[bool, typer.Option("--no-assets-copy", "-na", help="Copy (overwrite) assets to the machine after the update")] = False):
-    """🔄 UPDATE uv and machineconfig"""
-    # from machineconfig.utils.source_of_truth import LIBRARY_ROOT
-    # repo_root = LIBRARY_ROOT.parent.parent
-    from pathlib import Path
-    if Path.home().joinpath("code", "machineconfig").exists():
-        code = """
-uv self update
-cd ~/code/machineconfig
-git pull
-uv tool install --upgrade --editable $HOME/code/machineconfig
-    """
-    else:
-        code = """
-uv self update
-uv tool install --upgrade machineconfig
-    """
-    import platform
-    if platform.system() == "Windows":
-        # from machineconfig.utils.code import run_shell_script_after_exit
-        # run_shell_script_after_exit(code)
-        print(f'please run {code} in powershell to update machineconfig')
-    else:
-        from machineconfig.utils.code import run_shell_script
-        run_shell_script(code)
-    if not no_copy_assets:
-        import machineconfig.profile.create_helper as create_helper
-        create_helper.copy_assets_to_machine(which="scripts")
-        create_helper.copy_assets_to_machine(which="settings")
-def install(no_copy_assets: Annotated[bool, typer.Option("--no-assets-copy", "-na", help="Copy (overwrite) assets to the machine after the update")] = False):
-    """📋 CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates."""
-    from machineconfig.utils.code import run_shell_script
-    from pathlib import Path
-    if Path.home().joinpath("code/machineconfig").exists():
-        run_shell_script(f"""$HOME/.local/bin/uv tool install --upgrade --editable "{str(Path.home().joinpath("code/machineconfig"))}" """)
-    else:
-        import platform
-        if platform.system() == "Windows":
-            run_shell_script(r"""& "$HOME\.local\bin\uv.exe" tool install --upgrade "machineconfig>=6.81" """)
-        else:
-            run_shell_script("""$HOME/.local/bin/uv tool install --upgrade "machineconfig>=6.81" """)
-    from machineconfig.profile.create_shell_profile import create_default_shell_profile
-    if not no_copy_assets:
-        create_default_shell_profile()   # involves copying assets too
-
-
-
-def interactive():
-    """🤖 INTERACTIVE configuration of machine."""
-    from machineconfig.scripts.python.interactive import main
-    main()
-
-def status():
-    """📊 STATUS of machine, shell profile, apps, symlinks, dotfiles, etc."""
-    import machineconfig.scripts.python.helpers_devops.devops_status as helper
-    helper.main()
-
-
-def navigate():
-    """📚 NAVIGATE command structure with TUI"""
-    import machineconfig.scripts.python as navigator
-    from pathlib import Path
-    path = Path(navigator.__file__).resolve().parent.joinpath("devops_navigator.py")
-    from machineconfig.utils.code import run_shell_script
-    if Path.home().joinpath("code/machineconfig").exists(): executable = f"""--project "{str(Path.home().joinpath("code/machineconfig"))}" --with textual"""
-    else: executable = """--with "machineconfig>=6.81,textual" """
-    run_shell_script(f"""uv run {executable} {path}""")
-
-
-def run_python(ip: Annotated[str, typer.Argument(..., help="Python command to run in the machineconfig environment")],
-               command: Annotated[Optional[bool], typer.Option(..., "--command", "-c", help="Run as command")] = False):
-    """🐍 RUN python command/file in the machineconfig environment"""
-    if command:
-        exec(ip)
-        return
-    import machineconfig
-    import subprocess
-    import sys
-    subprocess.run([sys.executable, ip], cwd=machineconfig.__path__[0])
-def readme():
-    from rich.console import Console
-    from rich.markdown import Markdown
-    import requests
-
-    # URL of the raw README.md file
-    url_readme = "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/refs/heads/main/README.md"
-
-    # Fetch the content
-    response = requests.get(url_readme)
-    response.raise_for_status()  # Raise an error for bad responses
-
-    # Parse markdown
-    md = Markdown(response.text)
-
-    # Render in terminal
-    console = Console()
-    console.print(md)
-
-
-def get_app():
-    cli_app = typer.Typer(help="🔄 [s] self operations subcommands", no_args_is_help=True, add_help_option=False, add_completion=False)
-    cli_app.command("update", no_args_is_help=False, help="🔄  [u] UPDATE machineconfig")(update)
-    cli_app.command("u", no_args_is_help=False, hidden=True)(update)
-    cli_app.command("interactive", no_args_is_help=False, help="🤖  [i] INTERACTIVE configuration of machine.")(interactive)
-    cli_app.command("i", no_args_is_help=False, help="INTERACTIVE configuration of machine.", hidden=True)(interactive)
-    cli_app.command("status", no_args_is_help=False, help="📊  [s] STATUS of machine, shell profile, apps, symlinks, dotfiles, etc.")(status)
-    cli_app.command("s", no_args_is_help=False, help="STATUS of machine, shell profile, apps, symlinks, dotfiles, etc.", hidden=True)(status)
-    cli_app.command("install", no_args_is_help=False, help="📋  [I] CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.")(install)
-    cli_app.command("I", no_args_is_help=False, help="CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.", hidden=True)(install)
-    cli_app.command("navigate", no_args_is_help=False, help="📚  [n] NAVIGATE command structure with TUI")(navigate)
-    cli_app.command("n", no_args_is_help=False, help="NAVIGATE command structure with TUI", hidden=True)(navigate)
-    cli_app.command("python", no_args_is_help=False, help="🐍  [c] python command/file in the machineconfig environment", context_settings={"show_help_on_error": True})(run_python)
-    cli_app.command("c", no_args_is_help=False, help="RUN python command/file in the machineconfig environment", hidden=True)(run_python)
-    cli_app.command("readme", no_args_is_help=False, help="📚  [r] render readme markdown in terminal.")(readme)
-    cli_app.command("r", no_args_is_help=False, hidden=True)(readme)
-    return cli_app
-