machineconfig 5.15__py3-none-any.whl → 7.66__py3-none-any.whl

machineconfig/jobs/installer/linux_scripts/timescaledb.sh

@@ -1,85 +0,0 @@
-#!/bin/bash
-#=======================================================================
-# ⏱️ TIMESCALEDB INSTALLATION SCRIPT ⏱️
-#=======================================================================
-# This script installs TimescaleDB on Ubuntu/Debian-based Linux distributions
-# Reference: https://docs.timescale.com/self-hosted/latest/install/installation-linux/
-
-echo """#=======================================================================
-🔍 DETECTING SYSTEM | Identifying OS distribution version
-#=======================================================================
-"""
-
-get_ubuntu_base_version() {
-    local os_codename=$(lsb_release -cs)
-    case "$os_codename" in
-        "wilma")
-            echo "noble"  # Map Mint Wilma to the base image Ubuntu 24.04 LTS
-            ;;
-        "virginia")
-            echo "jammy"  # Map Mint Virginia to the base image Ubuntu 22.04 LTS
-            ;;
-        *)
-            echo "$os_codename"
-            ;;
-    esac
-}
-
-ubuntu_version=$(get_ubuntu_base_version)
-echo "📋 Detected distribution: $ubuntu_version"
-
-echo """#=======================================================================
-🐘 INSTALLING POSTGRESQL | Setting up PostgreSQL dependencies
-#=======================================================================
-"""
-
-# Add PostgreSQL repository setup
-echo "🔧 Setting up PostgreSQL repository..."
-sudo nala install postgresql-common -y
-sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh -y
-
-echo """#=======================================================================
-🔑 ADDING REPOSITORY KEYS | Setting up TimescaleDB repository
-#=======================================================================
-"""
-
-# Add TimescaleDB repository
-echo "📝 Adding TimescaleDB repository to sources list..."
-echo "deb https://packagecloud.io/timescale/timescaledb/ubuntu/ $ubuntu_version main" | sudo tee /etc/apt/sources.list.d/timescaledb.list
-
-echo "🔐 Adding TimescaleDB GPG key..."
-wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/timescaledb.gpg
-
-echo """#=======================================================================
-📦 INSTALLING TIMESCALEDB | Updating and installing packages
-#=======================================================================
-"""
-
-# Update package lists
-echo "🔄 Updating package lists..."
-sudo nala update
-
-# Install TimescaleDB with PostgreSQL 16
-echo "📥 Installing PostgreSQL 16 and TimescaleDB..."
-sudo nala install -y postgresql-16 postgresql-client-16 timescaledb-2-postgresql-16
-
-echo """#=======================================================================
-⚙️ CONFIGURING TIMESCALEDB | Optimizing database settings
-#=======================================================================
-"""
-
-# Run TimescaleDB tuning tool
-echo "🔧 Running TimescaleDB tuning utility..."
-sudo timescaledb-tune
-
-# Restart PostgreSQL service
-echo "🔄 Restarting PostgreSQL service..."
-sudo systemctl restart postgresql
-
-echo """#=======================================================================
-✅ INSTALLATION COMPLETE | TimescaleDB has been installed successfully
-#=======================================================================
-"""
-echo "🚀 To connect to PostgreSQL, run: sudo -u postgres psql"
-echo "💡 To enable TimescaleDB in a database, run: CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;"
-echo "ℹ️ For more information, visit: https://docs.timescale.com/self-hosted/latest/install/"

machineconfig/jobs/linux/msc/cli_agents.sh

@@ -1,16 +0,0 @@
-#!/bin/bash
-
-
-# Vscode extensions for AI-assisted coding.
-# Github copilot
-# Roo
-# Cline
-# Kilocode
-# Continue
-# CodeGPT
-# qodo (and cli)
-
-# Editors based on AI
-# Kiro
-# Cursor
-# Warp

machineconfig/jobs/python/python_ve_symlink.py

@@ -1,37 +0,0 @@
-"""Symlinks"""
-
-from rich import box
-from rich.console import Console
-from rich.panel import Panel
-
-from machineconfig.utils.path_extended import PathExtended
-
-
-def main() -> None:
-    console = Console()
-    console.print(
-        Panel.fit(
-            "\n".join(["Create symlinks for virtual environments"]),
-            title="🔗 Symlink Creator",
-            border_style="cyan",
-            box=box.ROUNDED,
-        )
-    )
-    target = PathExtended(input("🎯 Symlink to which target? ")).expanduser().absolute()
-    source = input(f"📍 Symlink from which source? [default to: CWD/{target.name}] ") or PathExtended.cwd().joinpath(target.name)
-    if isinstance(source, str):
-        source = PathExtended(source).expanduser().absolute()
-    source.symlink_to(target, overwrite=True)
-    console.print(
-        Panel.fit(
-            "\n".join([f"📍 Source: {source}", f"🎯 Target: {target}"]),
-            title="✅ Symlink Created",
-            border_style="green",
-            box=box.ROUNDED,
-        )
-    )
-    console.print("🔗 Finished creating symlink.", style="bold cyan")
-
-
-if __name__ == "__main__":
-    pass

machineconfig/jobs/python/vscode/api.py

@@ -1,57 +0,0 @@
-from pathlib import Path
-from typing import Annotated
-
-import typer
-from rich import box
-from rich.console import Console
-from rich.panel import Panel
-from rich.syntax import Syntax
-
-from machineconfig.utils.accessories import randstr
-
-
-def open_file_in_new_instance(file_path: str):
-    import git
-
-    repo = git.Repo(search_parent_directories=True)
-    repo_path = repo.working_tree_dir
-    # Ensure repo_path is not None before passing to Path
-    repo_name = Path(repo_path if repo_path is not None else ".").name
-    repo_copy_name = f"{repo_name}_{randstr(5)}"
-    copy_path = Path.home().joinpath(".config", "machingconfig", "vscode_api", repo_name, repo_copy_name)
-    copy_path.parent.mkdir(parents=True, exist_ok=True)
-    code = f"""
-ln -s {repo_path} {copy_path}
-cd {copy_path}
-code --profile bitProfile --new-window {file_path}
-"""
-    console = Console()
-    panel = Panel(
-        Syntax(code, lexer="bash"),
-        title="🔍 VS CODE API | Opening file in new instance",
-        subtitle=f"📂 {file_path}",
-        border_style="bright_blue",
-        box=box.DOUBLE,
-        padding=(1, 2),
-    )
-    console.print(panel)
-
-    code_path = Path.home().joinpath(".config", "machingconfig", "vscode_api", "code_temp")
-    code_path.parent.mkdir(parents=True, exist_ok=True)
-    code_path.write_text(code, encoding="utf-8")
-    code_path.chmod(0o755)
-    import subprocess
-
-    subprocess.run([str(code_path)], shell=True, check=True)
-
-
-def main(file_path: Annotated[str, typer.Argument(help="Path to the file to open")]) -> None:
-    open_file_in_new_instance(file_path)
-
-
-def arg_parser() -> None:
-    typer.run(main)
-
-
-if __name__ == "__main__":
-    arg_parser()

machineconfig/jobs/python/vscode/sync_code.py

@@ -1,73 +0,0 @@
-from pathlib import Path
-from configparser import SectionProxy
-from rich import box
-from rich.console import Console
-from rich.panel import Panel
-from rich.syntax import Syntax
-from machineconfig.utils.io import read_ini
-
-config = read_ini(Path.home().joinpath(".ssh", "config"))
-
-
-def sync_remote(machine_name: str) -> None:
-    console = Console()
-    console.print(
-        Panel.fit(
-            "\n".join([f"🖥️  Target machine: {machine_name}"]),
-            title="🔄 Sync Remote",
-            border_style="cyan",
-            box=box.ROUNDED,
-        )
-    )
-
-    machine_config: SectionProxy | None = None
-    if machine_name in config:
-        machine_config = config[machine_name]
-
-    if machine_config is None:
-        error_msg = f"Machine {machine_name} not found in SSH config."
-        console.print(
-            Panel.fit(
-                "\n".join([error_msg]),
-                title="❌ Error",
-                subtitle="⚠️ Unknown target machine",
-                border_style="red",
-                box=box.ROUNDED,
-            )
-        )
-        raise ValueError(error_msg)
-
-    code = f"""
-ssh -o "HostName={machine_config["HostName"]}" -o "User={machine_config["User"]}" -o "ProxyCommand=cloudflared access ssh --hostname %h" -o "Port={machine_config["Port"]}" -o "RequestTTY=yes" -o "RemoteCommand=devops --which update; bash" {machine_name}
-"""
-
-    syntax = Syntax(code, "bash", line_numbers=False, word_wrap=True)
-    console.print(
-        Panel(
-            syntax,
-            title=f"🔄 Sync Command | {machine_name}",
-            subtitle=f"🌐 Host: {machine_config['HostName']}",
-            border_style="blue",
-            box=box.ROUNDED,
-        )
-    )
-
-    code_path = Path.home().joinpath(".config", "machingconfig", "vscode_api", "code_temp")
-    code_path.parent.mkdir(parents=True, exist_ok=True)
-    code_path.write_text(code, encoding="utf-8")
-    code_path.chmod(0o755)
-
-    console.print(f"🚀 Executing sync command for {machine_name}...", style="bold yellow")
-
-    import subprocess
-
-    subprocess.run([str(code_path)], shell=True, check=True)
-
-    console.print(
-        Panel.fit(
-            "\n".join([f"🖥️  Machine: {machine_name}"]),
-            title="✅ Sync Completed",
-            border_style="green",
-            box=box.ROUNDED,
-        )
-    )

machineconfig/jobs/windows/archive/archive_pygraphviz.ps1

@@ -1,14 +0,0 @@
-
-# install https://visualstudio.microsoft.com/visual-cpp-build-tools/
-# include
-# winget install Microsoft.VisualStudio.2022.BuildTools
-# winget install Microsoft.VC++2015-2022Redist-x86
-
-
-. "$env:USERPROFILE\code\machineconfig\.venv\Scripts\Activate.ps1"
-Set-Location C:
-python -m pip install --global-option=build_ext --global-option="-IC:\Program Files\Graphviz\include" --global-option="-LC:\Program Files\Graphviz\lib" pygraphviz
-# not including the options as above (from https://pygraphviz.github.io/documentation/stable/install.html)
-# would result in an error like this: pygraphviz/graphviz_wrap.c(2711): fatal error C1083: Cannot open include file: 'graphviz/cgraph.h': No such file or directory
-
-

machineconfig/jobs/windows/start_terminal.ps1

@@ -1,6 +0,0 @@
-
- wt  --profile croshell -d . --title "MyTerminal" --tabColor "red"`; split-pane --vertical --size 0.55 pwsh machineconfig-workingdirectory ~/code/machineconfig -Command "pwd" `; split-pane -V PowerShell -NoExit -Command  "cd code/machineconfig" `; split-pane -H wsl.exe cmatrix`; split-pane -V wsl.exe sl
-# wt -p "Command Prompt" `; split-pane -p "Windows PowerShell" `; split-pane -H wsl.exe
-
-# See more settings here: https://docs.microsoft.com/en-us/windows/terminal/
-

machineconfig/jobs/windows/startup_file.cmd

@@ -1,2 +0,0 @@
-
-powershell %USERPROFILE%/code/machineconfig/src/machineconfig/jobs/windows/start_terminal.ps1

machineconfig/profile/create.py

@@ -1,303 +0,0 @@
-"""
-This script Takes away all config files from the computer, place them in one directory
-`dotfiles`, and create symlinks to those files from thier original locations.
-
-"""
-
-from rich.console import Console
-from rich.panel import Panel
-from rich.pretty import Pretty
-from rich.text import Text
-from rich.table import Table
-
-from machineconfig.utils.path_extended import PathExtended
-from machineconfig.utils.links import symlink_func, symlink_copy
-from machineconfig.utils.options import choose_from_options
-from machineconfig.utils.source_of_truth import LIBRARY_ROOT, REPO_ROOT
-from machineconfig.profile.shell import create_default_shell_profile
-
-import platform
-import os
-import ctypes
-import subprocess
-import tomllib
-from typing import Optional, Any, TypedDict, Literal
-
-system = platform.system()  # Linux or Windows
-ERROR_LIST: list[Any] = []  # append to this after every exception captured.
-SYSTEM = system.lower()
-
-console = Console()
-
-
-def get_other_systems(current_system: str) -> list[str]:
-    all_systems = ["linux", "windows", "darwin"]
-    return [s for s in all_systems if s != current_system.lower()]
-
-
-OTHER_SYSTEMS = get_other_systems(SYSTEM)
-
-
-class SymlinkMapper(TypedDict):
-    this: str
-    to_this: str
-    contents: Optional[bool]
-
-
-class OperationRecord(TypedDict):
-    program: str
-    file_key: str
-    source: str
-    target: str
-    operation: str
-    action: Literal[
-        "already_linked",
-        "relinking", 
-        "fixing_broken_link",
-        "identical_files",
-        "backing_up_source",
-        "backing_up_target", 
-        "relinking_to_new_target",
-        "moving_to_target",
-        "new_link",
-        "new_link_and_target",
-        "linking",
-        "copying",
-        "error"
-    ]
-    details: str
-    status: str
-
-
-def apply_mapper(choice: Optional[str], prioritize_to_this: bool):
-    symlink_mapper: dict[str, dict[str, SymlinkMapper]] = tomllib.loads(LIBRARY_ROOT.joinpath("profile/mapper.toml").read_text(encoding="utf-8"))
-    exclude: list[str] = []  # "wsl_linux", "wsl_windows"
-    operation_records: list[OperationRecord] = []
-
-    program_keys_raw: list[str] = list(symlink_mapper.keys())
-    program_keys: list[str] = []
-    for program_key in program_keys_raw:
-        if program_key in exclude or any([another_system in program_key for another_system in OTHER_SYSTEMS]):
-            continue
-        else:
-            program_keys.append(program_key)
-
-    program_keys.sort()
-    if choice is None:
-        choice_selected = choose_from_options(msg="Which symlink to create?", options=program_keys + ["all", "none(EXIT)"], default="none(EXIT)", fzf=True, multi=True)
-        assert isinstance(choice_selected, list)
-        if len(choice_selected) == 1 and choice_selected[0] == "none(EXIT)":
-            return  # terminate function.
-        elif len(choice_selected) == 1 and choice_selected[0] == "all":
-            choice_selected = "all"  # i.e. program_keys = program_keys
-    else:
-        choice_selected = choice
-
-    if isinstance(choice_selected, str):
-        if str(choice_selected) == "all" and system == "Windows":
-            if os.name == "nt":
-                try:
-                    is_admin = ctypes.windll.shell32.IsUserAnAdmin()
-                except Exception:
-                    is_admin = False
-            else:
-                is_admin = False
-            if not is_admin:
-                warning_body = "\n".join([
-                    "[bold yellow]Administrator privileges required[/]",
-                    "Run the terminal as admin and try again to avoid repeated elevation prompts.",
-                ])
-                console.print(
-                    Panel.fit(
-                        warning_body,
-                        title="⚠️ Permission Needed",
-                        border_style="yellow",
-                        padding=(1, 2),
-                    )
-                )
-                raise RuntimeError("Run terminal as admin and try again, otherwise, there will be too many popups for admin requests and no chance to terminate the program.")
-        elif choice_selected == "all":
-            console.print(
-                Panel(
-                    Pretty(program_keys),
-                    title="🔍 Processing All Program Keys",
-                    border_style="cyan",
-                    padding=(1, 2),
-                )
-            )
-            pass  # i.e. program_keys = program_keys
-        else:
-            program_keys = [choice_selected]
-    else:
-        program_keys = choice_selected
-
-    for program_key in program_keys:
-        console.rule(f"🔄 Processing [bold]{program_key}[/] symlinks", style="cyan")
-        for file_key, file_map in symlink_mapper[program_key].items():
-            this = PathExtended(file_map["this"])
-            to_this = PathExtended(file_map["to_this"].replace("REPO_ROOT", REPO_ROOT.as_posix()).replace("LIBRARY_ROOT", LIBRARY_ROOT.as_posix()))
-            
-            if "contents" in file_map:
-                try:
-                    targets = list(to_this.expanduser().search("*"))
-                    for a_target in targets:
-                        result = symlink_func(this=this.joinpath(a_target.name), to_this=a_target, prioritize_to_this=prioritize_to_this)
-                        operation_records.append({
-                            "program": program_key,
-                            "file_key": file_key,
-                            "source": str(this.joinpath(a_target.name)),
-                            "target": str(a_target),
-                            "operation": "contents_symlink",
-                            "action": result["action"],
-                            "details": result["details"],
-                            "status": "success"
-                        })
-                except Exception as ex:
-                    console.print(f"❌ [red]Config error[/red]: {program_key} | {file_key} | missing keys 'this ==> to_this'. {ex}")
-                    operation_records.append({
-                        "program": program_key,
-                        "file_key": file_key,
-                        "source": str(this),
-                        "target": str(to_this),
-                        "operation": "contents_symlink",
-                        "action": "error",
-                        "details": f"Failed to process contents: {str(ex)}",
-                        "status": f"error: {str(ex)}"
-                    })
-                    
-            elif "copy" in file_map:
-                try:
-                    result = symlink_copy(this=this, to_this=to_this, prioritize_to_this=prioritize_to_this)
-                    operation_records.append({
-                        "program": program_key,
-                        "file_key": file_key,
-                        "source": str(this),
-                        "target": str(to_this),
-                        "operation": "copy",
-                        "action": result["action"],
-                        "details": result["details"],
-                        "status": "success"
-                    })
-                except Exception as ex:
-                    console.print(f"❌ [red]Config error[/red]: {program_key} | {file_key} | {ex}")
-                    operation_records.append({
-                        "program": program_key,
-                        "file_key": file_key,
-                        "source": str(this),
-                        "target": str(to_this),
-                        "operation": "copy",
-                        "action": "error",
-                        "details": f"Failed to copy: {str(ex)}",
-                        "status": f"error: {str(ex)}"
-                    })
-            else:
-                try:
-                    result = symlink_func(this=this, to_this=to_this, prioritize_to_this=prioritize_to_this)
-                    operation_records.append({
-                        "program": program_key,
-                        "file_key": file_key,
-                        "source": str(this),
-                        "target": str(to_this),
-                        "operation": "symlink",
-                        "action": result["action"],
-                        "details": result["details"],
-                        "status": "success"
-                    })
-                except Exception as ex:
-                    console.print(f"❌ [red]Config error[/red]: {program_key} | {file_key} | missing keys 'this ==> to_this'. {ex}")
-                    operation_records.append({
-                        "program": program_key,
-                        "file_key": file_key,
-                        "source": str(this),
-                        "target": str(to_this),
-                        "operation": "symlink",
-                        "action": "error",
-                        "details": f"Failed to create symlink: {str(ex)}",
-                        "status": f"error: {str(ex)}"
-                    })
-
-            if program_key == "ssh" and system == "Linux":  # permissions of ~/dotfiles/.ssh should be adjusted
-                try:
-                    console.print("\n[bold]🔒 Setting secure permissions for SSH files...[/bold]")
-                    subprocess.run("chmod 700 ~/.ssh/", check=True)
-                    subprocess.run("chmod 700 ~/dotfiles/creds/.ssh/", check=True)  # may require sudo
-                    subprocess.run("chmod 600 ~/dotfiles/creds/.ssh/*", check=True)
-                    console.print("[green]✅ SSH permissions set successfully[/green]")
-                except Exception as e:
-                    ERROR_LIST.append(e)
-                    console.print(f"❌ [red]Error setting SSH permissions[/red]: {e}")
-
-    if system == "Linux":
-        console.print("\n[bold]📜 Setting executable permissions for scripts...[/bold]")
-        subprocess.run(f"chmod +x {LIBRARY_ROOT.joinpath(f'scripts/{system.lower()}')} -R", shell=True, capture_output=True, text=True)
-        console.print("[green]✅ Script permissions updated[/green]")
-
-    # Display operation summary table
-    if operation_records:
-        table = Table(title="🔗 Symlink Operations Summary", show_header=True, header_style="bold magenta")
-        table.add_column("Program", style="cyan", no_wrap=True)
-        table.add_column("File Key", style="blue", no_wrap=True)
-        table.add_column("Source", style="green")
-        table.add_column("Target", style="yellow")
-        table.add_column("Operation", style="magenta", no_wrap=True)
-        table.add_column("Action", style="red", no_wrap=True)
-        table.add_column("Details", style="white")
-        table.add_column("Status", style="red", no_wrap=True)
-        
-        for record in operation_records:
-            status_style = "green" if record["status"] == "success" else "red"
-            action_style = "green" if record["action"] != "error" else "red"
-            table.add_row(
-                record["program"],
-                record["file_key"],
-                record["source"],
-                record["target"],
-                record["operation"],
-                f"[{action_style}]{record['action']}[/{action_style}]",
-                record["details"],
-                f"[{status_style}]{record['status']}[/{status_style}]"
-            )
-        
-        console.print("\n")
-        console.print(table)
-
-    if len(ERROR_LIST) > 0:
-        console.print(
-            Panel(
-                Pretty(ERROR_LIST),
-                title="❗ Errors Encountered During Processing",
-                border_style="red",
-                padding=(1, 2),
-            )
-        )
-    else:
-        console.print(
-            Panel.fit(
-                Text("✅ All symlinks created successfully!", justify="center"),
-                title="Symlink Creation Complete",
-                border_style="green",
-            )
-        )
-
-
-def main_symlinks():
-    console.print("")
-    console.rule("[bold blue]🔗 CREATING SYMLINKS 🔗")
-    apply_mapper(choice="all", prioritize_to_this=True)
-
-
-def main_profile():
-    console.print("")
-    console.rule("[bold green]🐚 CREATING SHELL PROFILE 🐚")
-    create_default_shell_profile()
-    console.print(
-        Panel.fit(
-            Text("✨ Configuration setup complete! ✨", justify="center"),
-            title="Profile Setup",
-            border_style="green",
-        )
-    )
-
-
-if __name__ == "__main__":
-    pass