machineconfig 5.12__py3-none-any.whl → 5.14__py3-none-any.whl

machineconfig/jobs/python/check_installations.py

@@ -1,19 +1,6 @@
-# """CI
-# """
 
-
-# import time
 import platform
-
-# from typing import Any
-# from rich.console import Console
-# from machineconfig.utils.utils2 import pprint
-# # from rich.progress import track
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT
-# from machineconfig.utils.installer import get_installed_cli_apps
-# from typing import Optional
-# from datetime import datetime
-# import csv
 
 
 APP_SUMMARY_PATH = LIBRARY_ROOT.joinpath(f"profile/records/{platform.system().lower()}/apps_summary_report.csv")

machineconfig/profile/create.py

@@ -8,6 +8,7 @@ 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
@@ -20,7 +21,7 @@ import os
 import ctypes
 import subprocess
 import tomllib
-from typing import Optional, Any, TypedDict
+from typing import Optional, Any, TypedDict, Literal
 
 system = platform.system()  # Linux or Windows
 ERROR_LIST: list[Any] = []  # append to this after every exception captured.
@@ -43,10 +44,35 @@ class SymlinkMapper(TypedDict):
     contents: Optional[bool]
 
 
-def apply_mapper(choice: Optional[str] = None):
+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"))
-    prioritize_to_this = True
     exclude: list[str] = []  # "wsl_linux", "wsl_windows"
+    operation_records: list[OperationRecord] = []
 
     program_keys_raw: list[str] = list(symlink_mapper.keys())
     program_keys: list[str] = []
@@ -64,10 +90,6 @@ def apply_mapper(choice: Optional[str] = None):
             return  # terminate function.
         elif len(choice_selected) == 1 and choice_selected[0] == "all":
             choice_selected = "all"  # i.e. program_keys = program_keys
-        # overwrite = choose_from_options(msg="Overwrite existing source file?", options=["yes", "no"], default="yes") == "yes"
-        from rich.prompt import Confirm
-
-        prioritize_to_this = Confirm.ask("Overwrite existing source file?", default=True)
     else:
         choice_selected = choice
 
@@ -114,22 +136,85 @@ def apply_mapper(choice: Optional[str] = None):
         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:
-                    for a_target in to_this.expanduser().search("*"):
-                        symlink_func(this=this.joinpath(a_target.name), to_this=a_target, prioritize_to_this=prioritize_to_this)
+                    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}")
-            if "copy" in file_map:
+                    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:
-                    symlink_copy(this=this, to_this=to_this, prioritize_to_this=prioritize_to_this)
+                    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:
-                    symlink_func(this=this, to_this=to_this, prioritize_to_this=prioritize_to_this)
+                    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:
@@ -147,6 +232,35 @@ def apply_mapper(choice: Optional[str] = None):
         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(
@@ -169,7 +283,7 @@ def apply_mapper(choice: Optional[str] = None):
 def main_symlinks():
     console.print("")
     console.rule("[bold blue]🔗 CREATING SYMLINKS 🔗")
-    apply_mapper(choice="all")
+    apply_mapper(choice="all", prioritize_to_this=True)
 
 
 def main_profile():

machineconfig/scripts/python/count_lines.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 
 from typing import TYPE_CHECKING
 from git import Repo
@@ -7,15 +6,12 @@ from datetime import datetime
 
 from pathlib import Path
 from rich.progress import track
-import polars as pl
-import plotly.graph_objects as go
-
-import plotly.express as px
 import typer
 
 
 if TYPE_CHECKING:
     from typing import Any, Dict, List, Optional, Union
+    import polars as pl
 
 
 app = typer.Typer()
@@ -110,6 +106,10 @@ def analyze_over_time(repo_path: str = typer.Argument(..., help="Path to the git
     except Exception as e:
         print(f"❌ Error analyzing commits: {str(e)}")
         return
+
+    import polars as pl
+    import plotly.graph_objects as go
+
     df = pl.DataFrame(commit_data)
     df = df.sort("dtmExit")
     # Create interactive plotly figure with dark theme and all bells and whistles
@@ -184,6 +184,10 @@ def analyze_over_time(repo_path: str = typer.Argument(..., help="Path to the git
 
 
 def _print_python_files_by_size_impl(repo_path: str) -> "Union[pl.DataFrame, Exception]":
+    import polars as pl
+    import plotly.graph_objects as go
+    import plotly.express as px
+
     try:
         import os
         if not os.path.exists(repo_path):

machineconfig/scripts/python/count_lines_frontend.py

@@ -5,9 +5,9 @@ import typer
 def analyze_repo_development(repo_path: str = typer.Argument(..., help="Path to the git repository")):
     from machineconfig.scripts.python import count_lines
     from pathlib import Path
-    count_lines_path = Path(count_lines.__file__).resolve().parent.joinpath("count_lines.py")
+    count_lines_path = Path(count_lines.__file__)
     # --project $HOME/code/machineconfig 
-    cmd = f"""uv run --python 3.13 --with machineconfig--group plot {count_lines_path} analyze-over-time {repo_path}"""
+    cmd = f"""uv run --python 3.13 --with machineconfig[plot] {count_lines_path} analyze-over-time {repo_path}"""
     from machineconfig.utils.code import run_script
     run_script(cmd)
 

machineconfig/scripts/python/croshell.py

@@ -40,8 +40,6 @@ except Exception: print(pycode)
 
 
 def get_read_data_pycode(path: str):
-    # We need to be careful here since we're generating Python code as a string
-    # that will use f-strings itself
     return f"""
 from rich.panel import Panel
 from rich.text import Text
@@ -49,7 +47,8 @@ from rich.console import Console
 console = Console()
 p = PathExtended(r'{path}').absolute()
 try:
-    dat = p.readit()
+    from machineconfig.utils.files.read import Read
+    dat = Read.read(p)
     if isinstance(dat, dict):
         panel_title = f"📄 File Data: {{p.name}}"
         console.print(Panel(Text(str(dat), justify="left"), title=panel_title, expand=False))
@@ -63,53 +62,25 @@ except Exception as e:
 """
 
 
-def get_read_pyfile_pycode(path: PathExtended, as_module: bool, cmd: str = ""):
-    if as_module:
-        pycode = rf"""
-import sys
-sys.path.append(r'{path.parent}')
-from {path.stem} import *
-{cmd}
-"""
-    else:
-        pycode = f"""
-__file__ = PathExtended(r'{path}')
-{path.read_text(encoding="utf-8")}
-"""
-    return pycode
-
 
 def main(
-    module: Annotated[bool, typer.Option("--module", "-m", help="flag to run the file as a module as opposed to main.")] = False,
-    newWindow: Annotated[bool, typer.Option("--newWindow", "-w", help="flag for running in new window.")] = False,
-    nonInteratctive: Annotated[bool, typer.Option("--nonInteratctive", "-N", help="flag for a non-interactive session.")] = False,
     python: Annotated[bool, typer.Option("--python", "-p", help="flag to use python over IPython.")] = False,
     fzf: Annotated[bool, typer.Option("--fzf", "-F", help="search with fuzzy finder for python scripts and run them")] = False,
     ve: Annotated[Optional[str], typer.Option("--ve", "-v", help="virtual enviroment to use, defaults to activated ve, if existed, else ve.")] = None,
     profile: Annotated[Optional[str], typer.Option("--profile", "-P", help="ipython profile to use, defaults to default profile.")] = None,
     read: Annotated[str, typer.Option("--read", "-r", help="read a binary file.")] = "",
-    file: Annotated[str, typer.Option("--file", "-f", help="python file path to interpret")] = "",
-    cmd: Annotated[str, typer.Option("--cmd", "-c", help="python command to interpret")] = "",
-    terminal: Annotated[str, typer.Option("--terminal", "-t", help="specify which terminal to be used. Default console host.")] = "",
-    shell: Annotated[str, typer.Option("--shell", "-S", help="specify which shell to be used. Defaults to CMD.")] = "",
     jupyter: Annotated[bool, typer.Option("--jupyter", "-j", help="run in jupyter interactive console")] = False,
     streamlit_viewer: Annotated[bool, typer.Option("--stViewer", "-s", help="view in streamlit app")] = False,
+    visidata: Annotated[bool, typer.Option("--visidata", "-V", help="open data file in visidata")] = False,
 ) -> None:
     # ==================================================================================
     # flags processing
-    interactivity = "" if nonInteratctive else "-i"
+    interactivity = "-i"
     interpreter = "python" if python else "ipython"
     ipython_profile: Optional[str] = profile
     file_obj = PathExtended.cwd()  # initialization value, could be modified according to args.
 
-    if cmd != "":
-        text = "🖥️  Executing command from CLI argument"
-        console.print(Panel(text, title="[bold blue]Info[/bold blue]"))
-        import textwrap
-
-        program = textwrap.dedent(cmd)
-
-    elif fzf:
+    if fzf:
         text = "🔍 Searching for Python files..."
         console.print(Panel(text, title="[bold blue]Info[/bold blue]"))
         options = [str(item) for item in PathExtended.cwd().search("*.py", r=True)]
@@ -119,13 +90,6 @@ def main(
         text = f"📄 Selected file: {PathExtended(file_selected).name}"
         console.print(Panel(text, title="[bold blue]Info[/bold blue]"))
 
-    elif file != "":
-        file_obj = PathExtended(file.lstrip()).expanduser().absolute()
-        program = get_read_pyfile_pycode(file_obj, as_module=module, cmd=cmd)
-        text1 = f"📄 Loading file: {file_obj.name}"
-        text2 = f"🔄 Mode: {'Module' if module else 'Script'}"
-        console.print(Panel(f"{text1}\n{text2}", title="[bold blue]Info[/bold blue]"))
-
     elif read != "":
         if streamlit_viewer:
             #             text = "📊 STARTING STREAMLIT VIEWER"
@@ -154,46 +118,35 @@ def main(
     preprogram = """
 
 #%%
-try:
-    from crocodile.croshell import *
-    print_header()
-    print_logo(logo="crocodile")
-except ImportError:
-    print("Crocodile not found, skipping import.")
+
+from machineconfig.utils.files.headers import print_header, print_logo
+print_header()
+print_logo("CROCODILE")
 from pathlib import Path
-print(f"🐊 Crocodile Shell | Running @ {Path.cwd()}")
+
 """
 
     pyfile = PathExtended.tmp().joinpath(f"tmp_scripts/python/croshell/{randstr()}.py")
     pyfile.parent.mkdir(parents=True, exist_ok=True)
 
-    if read != "":
-        title = "Reading Data"
-    elif file != "":
-        title = "Running Python File"
-    else:
-        title = "Executed code"
+    title = "Reading Data"
     python_program = preprogram + add_print_header_pycode(str(pyfile), title=title) + program
     pyfile.write_text(python_program, encoding="utf-8")
     # ve_root_from_file, ipython_profile = get_ve_path_and_ipython_profile(PathExtended(file))
     ipython_profile = ipython_profile if ipython_profile is not None else "default"
     # ve_activateion_line = get_ve_activate_line(ve_name=args.ve or ve_profile_suggested, a_path=str(PathExtended.cwd()))
-    shell_program = """
-#!/bin/bash
 
-"""
-    if jupyter:
+    if visidata:
+        fire_line = f"uv run --with visidata,pyarrow vd {str(file_obj)}"
+    elif jupyter:
         fire_line = f"code --new-window {str(pyfile)}"
     else:
-        fire_line = f"uv run --project $HOME/code/machineconfig/.venv {interpreter} {interactivity} "
-        if interpreter == "ipython": fire_line += f" --profile {ipython_profile} --no-banner"
-        fire_line += " " + str(pyfile)
-    shell_program += fire_line
-    from rich.syntax import Syntax
-    console.print(Syntax(shell_program, lexer="bash"))
-    print()
-    import subprocess
-    subprocess.run(shell_program, shell=True, check=True)
+        if interpreter == "ipython": profile = f" --profile {ipython_profile} --no-banner"
+        else: profile = ""
+        fire_line = f"uv run --python 3.13 --with machineconfig[plot] {interpreter} {interactivity} {profile} {str(pyfile)}"
+
+    from machineconfig.utils.code import run_script
+    run_script(fire_line)
 
 
 def arg_parser() -> None:

machineconfig/scripts/python/interactive.py

@@ -186,8 +186,8 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
 
     if "retrieve_repositories" in selected_options:
         console.print(Panel("📚 [bold bright_magenta]REPOSITORIES[/bold bright_magenta]\n[italic]Project code retrieval[/italic]", border_style="bright_magenta"))
-        from machineconfig.scripts.python import repos as module
-        module.main(directory=str(Path.home() / "code"), capture=True, cloud="odg1")
+        from machineconfig.scripts.python import repos
+        repos.clone(directory=str(Path.home() / "code"), cloud="odg1")
 
     if "retrieve_data" in selected_options:
         console.print(Panel("💾 [bold bright_cyan]DATA RETRIEVAL[/bold bright_cyan]\n[italic]Backup restoration[/italic]", border_style="bright_cyan"))

machineconfig/scripts/python/repos.py

@@ -73,7 +73,7 @@ def all(
 
 
 @sync_app.command()
-def record(
+def capture(
     directory: DirectoryArgument = None,
     cloud: CloudOption = None,
 ) -> None:
@@ -87,7 +87,7 @@ def record(
     if cloud is not None:
         PathExtended(save_path).to_cloud(rel2home=True, cloud=cloud)
 @sync_app.command()
-def capture(
+def clone(
     directory: DirectoryArgument = None,
     cloud: CloudOption = None,
 ) -> None:

machineconfig/utils/files/ascii_art.py

@@ -0,0 +1,118 @@
+"""Ascii art
+"""
+
+import os
+import random
+import textwrap
+import subprocess
+from pathlib import Path
+import tempfile
+import platform
+from typing import Optional, Literal
+
+# https://github.com/sepandhaghighi/art
+
+
+BOX_OR_CHAR = Literal['boxes', 'cowsay']
+
+
+class ArtLib:
+    @staticmethod
+    def cowsay(text: str):
+        import cowsay
+        char = random.choice(cowsay.char_names)
+        return cowsay.get_output_string(char, text=text)
+
+
+class BoxStyles:
+    language = ['ada-box', 'caml', 'boxquote', 'stone', 'tex-box', 'shell', 'simple', 'c', 'cc', 'html']
+    scene = ['whirly', 'xes', 'columns', 'parchment', 'scroll', 'scroll-akn', 'diamonds', 'headline', 'nuke', 'spring', 'stark1']  # , 'important3'
+    character = ['capgirl', 'cat', 'boy', 'girl', 'dog', 'mouse', 'santa', 'face', 'ian_jones', 'peek', 'unicornsay']
+
+
+class CowStyles:
+    eyes = ['-b', '-d', '-g', '-h', '-l', '-L', '-n', '-N', '-p', '-s', '-t', '-w', '-y']
+    # this one for the package installed with sudo apt install cowsay and is located at /usr/games/cowsay. See cowsay -l
+    figures = ['apt', 'bunny', 'cheese', 'cock', 'cower', 'daemon', 'default', 'dragon',
+               'dragon-and-cow', 'duck', 'elephant', 'elephant-in-snake', 'eyes', 'fox', 'ghostbusters',
+               'gnu', 'kangaroo', 'kiss', 'milk',
+               'moose', 'pony', 'pony-smaller', 'sheep', 'skeleton', 'snowman', 'stegosaurus',  # 'suse',
+               'three-eyes', 'turkey', 'turtle', 'tux', 'unipony', 'unipony-smaller', 'vader', 'vader']  # 'hellokitty' 'mech-and-cow'  # 'moofasa', 'stimpy', 'calvin', , 'ren', 'koala', 'flaming-sheep' , 'bud-frogs' , 'kosh' , 'luke-koala'
+
+
+FIGLET_FONTS = ['banner', 'big', 'standard']
+
+FIGJS_FONTS = ['3D Diagonal', '3D-ASCII', '4Max', '5 Line Oblique', 'Acrobatic', 'ANSI Regular', 'ANSI Shadow',
+               'Avatar', 'Banner', 'Banner3-D', 'Banner4',
+               'Basic', 'Big Money-ne', 'Big Money-nw', 'Big Money-se', 'Big Money-sw', 'Big', 'Bloody', 'Bolger', 'Braced', 'Bright',
+               'DOS Rebel',
+               'Elite', 'Epic', 'Flower Power',
+               'Fraktur',  # 'Isometric4'. 'AMC Tubes', 'Banner3', Alligator2
+               'Star Wars',
+               'Sub-Zero', 'The Edge', 'USA Flag', 'Varsity', "Doom"
+               ]  # too large  Crazy 'Sweet', 'Electronic', 'Swamp Land', Crawford, Alligator
+
+
+def get_art(comment: Optional[str] = None, artlib: Optional[BOX_OR_CHAR] = None, style: Optional[str] = None, super_style: str = 'scene', prefix: str = ' ', file: Optional[str] = None, verbose: bool = True):
+    """ takes in a comment and does the following wrangling:
+    * text => figlet font => boxes => lolcat
+    * text => cowsay => lolcat
+    """
+    if comment is None:
+        try:
+            comment = subprocess.run("fortune", shell=True, capture_output=True, text=True, check=True).stdout
+        except Exception:
+            comment = "crocodile"
+    if artlib is None: artlib = random.choice(['boxes', 'cowsay'])
+    to_file = '' if not file else f'> {file}'
+    if artlib == 'boxes':
+        if style is None: style = random.choice(BoxStyles.__dict__[super_style or random.choice(['language', 'scene', 'character'])])
+        fonting = f'figlet -f {random.choice(FIGLET_FONTS)}'
+        cmd = f"""echo "{comment}" | {fonting} | boxes -d {style} {to_file}"""
+    else:
+        if style is None: style = random.choice(CowStyles.figures)
+        cmd = f"""echo "{comment}" | /usr/games/cowsay -f {style} {to_file}"""
+    try:
+        res = subprocess.run(cmd, text=True, capture_output=True, shell=True, check=True).stdout
+    except subprocess.CalledProcessError as ex:
+        print(ex)
+        return ""
+    res = textwrap.indent(res, prefix=prefix)
+    if verbose:
+        print(f'Using style: {style} from {artlib}', '\n' * 3)
+        print(f'{cmd=}')
+        print('Results:\n', res)
+    return res
+
+
+def font_box_color(logo: str):
+    font = random.choice(FIGJS_FONTS)
+    # print(f"{font}\n")
+    box_style = random.choice(['whirly', 'xes', 'columns', 'parchment', 'scroll', 'scroll-akn', 'diamonds', 'headline', 'nuke', 'spring', 'stark1'])
+    _cmd = f'figlet -f "{font}" "{logo}" | boxes -d "{box_style}" | lolcatjs'
+    # print(_cmd)
+    os.system(_cmd)  # | lolcat
+    # print("after")
+
+
+def character_color(logo: str):
+    assert platform.system() == 'Windows', 'This function is only for Windows.'
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.txt', delete=False) as f:
+        f.write(ArtLib.cowsay(logo))
+        _new_art = f.name
+    os.system(f'type {_new_art} | lolcatjs')  # | lolcat
+
+
+def character_or_box_color(logo: str):
+    assert platform.system() in {'Linux', 'Darwin'}, 'This function is only for Linux and macOS.'
+    with tempfile.NamedTemporaryFile(mode='w', suffix='.txt', delete=False) as f:
+        _new_art = f.name
+    get_art(logo, artlib=None, file=_new_art, verbose=False)
+    # Prefer bat on mac if available, fallback to cat
+    pager = "bat" if (platform.system() == "Darwin" and any((Path(p).joinpath("bat").exists() for p in os.environ.get("PATH", "").split(os.pathsep)))) else "cat"
+    command = f"{pager} {_new_art} | lolcat"
+    os.system(command)
+
+
+if __name__ == '__main__':
+    pass

machineconfig/utils/files/headers.py

@@ -0,0 +1,64 @@
+
+import glob
+import os
+import platform
+import random
+from pathlib import Path
+from rich import pretty
+from rich.console import Console
+from rich.text import Text
+from typing import Optional
+
+
+def print_header():
+    console = Console()
+    pretty.install()
+    _header = f"🐍 Python {platform.python_version()} in VE `{os.getenv('VIRTUAL_ENV')}` On {platform.system()} 🐍"
+    _header = Text(_header)
+    _header.stylize("bold blue")
+    console.rule(_header, style="bold red", align="center")
+    version = "14.5"
+    _ = Text(f"✨ 🐊 Crocodile Shell {version} ✨" + f" Made with 🐍 | Built with ❤️. Running @ {Path.cwd()}")
+    _.stylize("#05f8fc on #293536")
+    console.print(_)
+def print_logo(logo: str):
+    from machineconfig.utils.files.ascii_art import font_box_color, character_color, character_or_box_color
+    if platform.system() == "Windows":
+        _1x = Path.home().joinpath(r"AppData/Roaming/npm/figlet").exists()
+        _2x = Path.home().joinpath(r"AppData/Roaming/npm/lolcatjs").exists()
+        _3x = Path.home().joinpath(r"AppData/Local/Microsoft/WindowsApps/boxes.exe").exists()
+        if _1x and _2x and _3x:
+            if random.choice([True, True, False]): font_box_color(logo)
+            else: character_color(logo)
+        else:
+            print("\n" + "🚫 " + "-" * 70 + " 🚫")
+            print("🔍 Missing ASCII art dependencies. Install with: iwr bit.ly/cfgasciiartwindows | iex")
+            print("🚫 " + "-" * 70 + " 🚫\n")
+            _default_art = Path(random.choice(glob.glob(str(Path(__file__).parent.joinpath("art", "*")))))
+            print(_default_art.read_text())
+    elif platform.system() in ["Linux", "Darwin"]:  # Explicitly handle both Linux and macOS
+        def is_executable_in_path(executable_name: str) -> Optional[str]:
+            path_dirs = os.environ['PATH'].split(os.pathsep)
+            for path_dir in path_dirs:
+                path_to_executable = os.path.join(path_dir, executable_name)
+                if os.path.isfile(path_to_executable) and os.access(path_to_executable, os.X_OK): return path_to_executable
+            return None
+        avail_cowsay = is_executable_in_path("cowsay")
+        avail_lolcat = is_executable_in_path("lolcat")
+        avail_boxes = is_executable_in_path("boxes")
+        avail_figlet = is_executable_in_path("figlet")
+        if avail_cowsay and avail_lolcat and avail_boxes and avail_figlet:
+            _dynamic_art = random.choice([True, True, True, True, False])
+            if _dynamic_art: character_or_box_color(logo=logo)
+            else: print(Path(random.choice(glob.glob(str(Path(__file__).parent.joinpath("art", "*"))))).read_text())
+        else:
+            print("\n" + "🚫 " + "-" * 70 + " 🚫")
+            install_cmd = "devops install --group TerminalEyeCandy" if platform.system() == "Linux" else "brew install cowsay lolcat boxes figlet"
+            print(f"🔍 Missing ASCII art dependencies. Install with: {install_cmd}")
+            print("🚫 " + "-" * 70 + " 🚫\n")
+            _default_art = Path(random.choice(glob.glob(str(Path(__file__).parent.joinpath("art", "*")))))
+            print(_default_art.read_text())
+    else:
+        print(f"⚠️ Platform {platform.system()} not supported for ASCII art. Using default art.")
+        _default_art = Path(random.choice(glob.glob(str(Path(__file__).parent.joinpath("art", "*")))))
+        print(_default_art.read_text())

machineconfig/utils/files/read.py

@@ -0,0 +1,103 @@
+
+
+
+from pathlib import Path
+from typing import Any, Optional
+
+
+class Read:
+    @staticmethod
+    def read(path: 'Path', **kwargs: Any) -> Any:
+        if Path(path).is_dir(): raise IsADirectoryError(f"Path is a directory, not a file: {path}")
+        suffix = Path(path).suffix[1:]
+        if suffix == "": raise ValueError(f"File type could not be inferred from suffix. Suffix is empty. Path: {path}")
+        if suffix in ("sqlite", "sqlite3", "db", "duckdb"):
+            # from crocodile.database import DBMS
+            # if suffix == "duckdb": pass
+            # res = DBMS.from_local_db(path=path)
+            # print(res.describe_db())
+            # return res
+            raise NotImplementedError("Reading database files is not implemented yet. Use `crocodile.database.DBMS` to connect to the database file.")
+        try: return getattr(Read, suffix)(str(path), **kwargs)
+        except AttributeError as err:
+            if "type object 'Read' has no attribute" not in str(err): raise AttributeError(err) from err
+            if suffix in ('eps', 'jpg', 'jpeg', 'pdf', 'pgf', 'png', 'ps', 'raw', 'rgba', 'svg', 'svgz', 'tif', 'tiff'):
+                import matplotlib.pyplot as pyplot
+                return pyplot.imread(path, **kwargs)  # from: plt.gcf().canvas.get_supported_filetypes().keys():
+            if suffix == "parquet":
+                import polars as pl
+                return pl.read_parquet(path, **kwargs)
+            elif suffix == "csv":
+                import polars as pl
+                return pl.read_csv(path, **kwargs)
+            try:
+                # guess = install_n_import('magic', 'python-magic').from_file(path)
+                guess = "IDKm"
+                raise AttributeError(f"Unknown file type. failed to recognize the suffix `{suffix}`. According to libmagic1, the file seems to be: {guess}") from err
+            except ImportError as err2:
+                print(f"💥 Unknown file type. failed to recognize the suffix `{suffix}` of file {path} ")
+                raise ImportError(err) from err2
+    @staticmethod
+    def json(path: 'Path', r: bool = False, **kwargs: Any) -> Any:  # return could be list or dict etc
+        import json
+        try:
+            mydict = json.loads(Path(path).read_text(encoding='utf-8'), **kwargs)
+        except Exception:
+            import pyjson5
+            mydict = pyjson5.loads(Path(path).read_text(encoding='utf-8'), **kwargs)  # file has C-style comments.
+        _ = r
+        return mydict
+    @staticmethod
+    def yaml(path: 'Path', r: bool = False) -> Any:  # return could be list or dict etc
+        import yaml  # type: ignore
+        with open(str(path), "r", encoding="utf-8") as file:
+            mydict = yaml.load(file, Loader=yaml.FullLoader)
+        _ = r
+        return mydict
+    @staticmethod
+    def ini(path: 'Path', encoding: Optional[str] = None):
+        if not Path(path).exists() or Path(path).is_dir(): raise FileNotFoundError(f"File not found or is a directory: {path}")
+        import configparser
+        res = configparser.ConfigParser()
+        res.read(filenames=[str(path)], encoding=encoding)
+        return res
+    @staticmethod
+    def toml(path: 'Path'):
+        import toml
+        return toml.loads(Path(path).read_text(encoding='utf-8'))
+    @staticmethod
+    def npy(path: 'Path', **kwargs: Any):
+        import numpy as np
+        data = np.load(str(path), allow_pickle=True, **kwargs)
+        # data = data.item() if data.dtype == np.object else data
+        return data
+    @staticmethod
+    def pickle(path: 'Path', **kwargs: Any):
+        import pickle
+        try: return pickle.loads(Path(path).read_bytes(), **kwargs)
+        except BaseException as ex:
+            print(f"💥 Failed to load pickle file `{path}` with error:\n{ex}")
+            raise ex
+    @staticmethod
+    def pkl(path: 'Path', **kwargs: Any): return Read.pickle(path, **kwargs)
+    # @staticmethod
+    # def dill(path: 'Path', **kwargs: Any) -> Any:
+    #     """handles imports automatically provided that saved object was from an imported class (not in defined in __main__)"""
+    #     import dill
+    #     obj = dill.loads(str=Path(path).read_bytes(), **kwargs)
+    #     return obj
+    @staticmethod
+    def py(path: 'Path', init_globals: Optional[dict[str, Any]] = None, run_name: Optional[str] = None):
+        import runpy
+        return runpy.run_path(str(path), init_globals=init_globals, run_name=run_name)
+    @staticmethod
+    def txt(path: 'Path', encoding: str = 'utf-8') -> str: return Path(path).read_text(encoding=encoding)
+    @staticmethod
+    def parquet(path: 'Path', **kwargs: Any):
+        import polars as pl
+        return pl.read_parquet(path, **kwargs)
+
+
+
+if __name__ == '__main__':
+    pass

machineconfig/utils/installer_utils/installer_abc.py

@@ -124,6 +124,13 @@ def check_tool_exists(tool_name: str) -> bool:
         return any([Path("/usr/local/bin").joinpath(tool_name).is_file(), Path("/usr/bin").joinpath(tool_name).is_file(), root_path.joinpath(tool_name).is_file()])
     else:
         raise NotImplementedError(f"platform {platform.system()} not implemented")
+def is_executable_in_path(executable_name: str) -> bool:
+    import os
+    path_dirs = os.environ['PATH'].split(os.pathsep)
+    for path_dir in path_dirs:
+        path_to_executable = os.path.join(path_dir, executable_name)
+        if os.path.isfile(path_to_executable) and os.access(path_to_executable, os.X_OK): return True
+    return False
 
 
 def check_if_installed_already(exe_name: str, version: Optional[str], use_cache: bool) -> tuple[str, str, str]:

machineconfig/utils/links.py

@@ -2,11 +2,62 @@ from machineconfig.utils.path_extended import PathExtended, PLike
 from machineconfig.utils.accessories import randstr
 from rich.console import Console
 from rich.panel import Panel
-
+import hashlib
+from typing import TypedDict, Literal
 
 console = Console()
 
 
+class SymlinkResult(TypedDict):
+    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",
+        "error"
+    ]
+    details: str
+
+
+class CopyResult(TypedDict):
+    action: Literal[
+        "already_linked",
+        "relinking",
+        "fixing_broken_link", 
+        "backing_up_source",
+        "backing_up_target",
+        "relinking_to_new_target",
+        "moving_to_target",
+        "new_link",
+        "new_link_and_target",
+        "copying",
+        "error"
+    ]
+    details: str
+
+
+def files_are_identical(file1: PathExtended, file2: PathExtended) -> bool:
+    """Check if two files are identical by comparing their SHA256 hashes."""
+    def get_file_hash(path: PathExtended) -> str:
+        hash_sha256 = hashlib.sha256()
+        with open(path, "rb") as f:
+            for chunk in iter(lambda: f.read(4096), b""):
+                hash_sha256.update(chunk)
+        return hash_sha256.hexdigest()
+    
+    try:
+        return get_file_hash(file1) == get_file_hash(file2)
+    except (OSError, IOError):
+        return False
+
+
 def build_links(target_paths: list[tuple[PLike, str]], repo_root: PLike):
     """Build symboic links from various relevant paths (e.g. data) to `repo_root/links/<name>` to facilitate easy access from
     tree explorer of the IDE.
@@ -33,12 +84,14 @@ def build_links(target_paths: list[tuple[PLike, str]], repo_root: PLike):
         links_path.symlink_to(target=a_target_path)
 
 
-def symlink_func(this: PathExtended, to_this: PathExtended, prioritize_to_this: bool):
+def symlink_func(this: PathExtended, to_this: PathExtended, prioritize_to_this: bool) -> SymlinkResult:
     """helper function. creates a symlink from `this` to `to_this`.
 
+    Returns a dict with 'action' and 'details' keys describing what was done.
+
     this: exists           AND    to_this exists            AND this is a symlink pointing to to_this              ===> Resolution: AUTO: do nothing, already linked correctly.
     this: exists           AND    to_this exists            AND this is a symlink pointing to somewhere else       ===> Resolution: AUTO: delete this symlink, create symlink to to_this
-    this: exists           AND    to_this exists            AND this is a concrete path                            ===> Resolution: DANGER: require user input to decide (param prioritize_to_this). Give two options: 1) prioritize `this`: to_this is backed up as to_this.orig_<randstr()>, to_this is deleted,  and symlink is created from this to to_this as normal; 2) prioritize `to_this`: `this` is backed up as this.orig_<randstr()>, `this` is deleted, and symlink is created from this to to_this as normal.
+    this: exists           AND    to_this exists            AND this is a concrete path                            ===> Resolution: DANGER: If files are identical (same hash), delete `this` and create symlink to `to_this`. Otherwise, two options: 1) prioritize `this`: to_this is backed up as to_this.orig_<randstr()>, to_this is deleted,  and symlink is created from this to to_this as normal; 2) prioritize `to_this`: `this` is backed up as this.orig_<randstr()>, `this` is deleted, and symlink is created from this to to_this as normal.
 
     this: exists           AND    to_this doesn't exist     AND this is a symlink pointing to somewhere else       ===> Resolution: AUTO: delete this symlink, create symlink to to_this (touch to_this)
     this: exists           AND    to_this doesn't exist     AND this is a symlink pointing to to_this              ===> Resolution: AUTO: delete this symlink, create symlink to to_this (touch to_this)
@@ -50,6 +103,9 @@ def symlink_func(this: PathExtended, to_this: PathExtended, prioritize_to_this:
     """
     this = PathExtended(this).expanduser().absolute()
     to_this = PathExtended(to_this).expanduser().absolute()
+    action_taken = ""
+    details = ""
+    
     # Case analysis based on docstring
     if this.exists():
         if to_this.exists():
@@ -58,33 +114,53 @@ def symlink_func(this: PathExtended, to_this: PathExtended, prioritize_to_this:
                 try:
                     if this.readlink().resolve() == to_this.resolve():
                         # Case: this exists AND to_this exists AND this is a symlink pointing to to_this
+                        action_taken = "already_linked"
+                        details = "Symlink already correctly points to target"
                         console.print(Panel(f"✅ ALREADY LINKED | {this} ➡️  {to_this}", title="Already Linked", expand=False))
-                        return
+                        return {"action": action_taken, "details": details}
                     else:
                         # Case: this exists AND to_this exists AND this is a symlink pointing to somewhere else
+                        action_taken = "relinking"
+                        details = "Updated existing symlink to point to new target"
                         console.print(Panel(f"🔄 RELINKING | Updating symlink from {this} ➡️  {to_this}", title="Relinking", expand=False))
                         this.delete(sure=True)
                 except OSError:
                     # Broken symlink case
+                    action_taken = "fixing_broken_link"
+                    details = "Removed broken symlink and will create new one"
                     console.print(Panel(f"🔄 FIXING BROKEN LINK | Fixing broken symlink from {this} ➡️  {to_this}", title="Fixing Broken Link", expand=False))
                     this.delete(sure=True)
             else:
                 # Case: this exists AND to_this exists AND this is a concrete path
-                if prioritize_to_this:
-                    # prioritize `to_this`: `this` is backed up, `this` is deleted, symlink created
-                    backup_name = f"{this}.orig_{randstr()}"
-                    console.print(Panel(f"📦 BACKING UP | Moving {this} to {backup_name}, prioritizing {to_this}", title="Backing Up", expand=False))
-                    this.move(path=backup_name)
+                if files_are_identical(this, to_this):
+                    # Files are identical, just delete this and create symlink
+                    action_taken = "identical_files"
+                    details = "Files identical, removed source and will create symlink"
+                    console.print(Panel(f"🔗 IDENTICAL FILES | Files are identical, deleting {this} and creating symlink to {to_this}", title="Identical Files", expand=False))
+                    this.delete(sure=True)
                 else:
-                    # prioritize `this`: to_this is backed up, to_this is deleted, this content moved to to_this location
-                    backup_name = f"{to_this}.orig_{randstr()}"
-                    console.print(Panel(f"📦 BACKING UP | Moving {to_this} to {backup_name}, prioritizing {this}", title="Backing Up", expand=False))
-                    to_this.move(path=backup_name)
-                    this.move(path=to_this)
+                    # Files are different, use prioritization logic
+                    if prioritize_to_this:
+                        # prioritize `to_this`: `this` is backed up, `this` is deleted, symlink created
+                        backup_name = f"{this}.orig_{randstr()}"
+                        action_taken = "backing_up_source"
+                        details = f"Backed up source to {backup_name}, prioritizing target"
+                        console.print(Panel(f"📦 BACKING UP | Moving {this} to {backup_name}, prioritizing {to_this}", title="Backing Up", expand=False))
+                        this.move(path=backup_name)
+                    else:
+                        # prioritize `this`: to_this is backed up, to_this is deleted, this content moved to to_this location
+                        backup_name = f"{to_this}.orig_{randstr()}"
+                        action_taken = "backing_up_target"
+                        details = f"Backed up target to {backup_name}, prioritizing source"
+                        console.print(Panel(f"📦 BACKING UP | Moving {to_this} to {backup_name}, prioritizing {this}", title="Backing Up", expand=False))
+                        to_this.move(path=backup_name)
+                        this.move(path=to_this)
         else:
             # to_this doesn't exist
             if this.is_symlink():
                 # Case: this exists AND to_this doesn't exist AND this is a symlink (pointing anywhere)
+                action_taken = "relinking_to_new_target"
+                details = "Removed existing symlink, will create target and new symlink"
                 console.print(Panel(f"🔄 RELINKING | Updating symlink from {this} ➡️  {to_this}", title="Relinking", expand=False))
                 this.delete(sure=True)
                 # Create to_this
@@ -92,70 +168,111 @@ def symlink_func(this: PathExtended, to_this: PathExtended, prioritize_to_this:
                 to_this.touch()
             else:
                 # Case: this exists AND to_this doesn't exist AND this is a concrete path
+                action_taken = "moving_to_target"
+                details = "Moved source to target location, will create symlink"
                 console.print(Panel(f"📁 MOVING | Moving {this} to {to_this}, then creating symlink", title="Moving", expand=False))
                 this.move(path=to_this)
     else:
         # this doesn't exist
         if to_this.exists():
             # Case: this doesn't exist AND to_this exists
+            action_taken = "new_link"
+            details = "Creating new symlink to existing target"
             console.print(Panel(f"🆕 NEW LINK | Creating new symlink from {this} ➡️  {to_this}", title="New Link", expand=False))
         else:
             # Case: this doesn't exist AND to_this doesn't exist
+            action_taken = "new_link_and_target"
+            details = "Creating target file and new symlink"
             console.print(Panel(f"🆕 NEW LINK & TARGET | Creating {to_this} and symlink from {this} ➡️  {to_this}", title="New Link & Target", expand=False))
             to_this.parent.mkdir(parents=True, exist_ok=True)
             to_this.touch()
+    
     # Create the symlink
     try:
+        action_taken = action_taken or "linking"
+        details = details or "Creating symlink"
         console.print(Panel(f"🔗 LINKING | Creating symlink from {this} ➡️  {to_this}", title="Linking", expand=False))
         PathExtended(this).symlink_to(target=to_this, verbose=True, overwrite=True)
+        return {"action": action_taken, "details": details}
     except Exception as ex:
+        action_taken = "error"
+        details = f"Failed to create symlink: {str(ex)}"
         console.print(Panel(f"❌ ERROR | Failed at linking {this} ➡️  {to_this}. Reason: {ex}", title="Error", expand=False))
+        return {"action": action_taken, "details": details}
 
 
-def symlink_copy(this: PathExtended, to_this: PathExtended, prioritize_to_this: bool):
+def symlink_copy(this: PathExtended, to_this: PathExtended, prioritize_to_this: bool) -> CopyResult:
     this = PathExtended(this).expanduser().absolute()
     to_this = PathExtended(to_this).expanduser().absolute()
+    action_taken = ""
+    details = ""
+    
     if this.exists():
         if to_this.exists():
             if this.is_symlink():
                 try:
                     if this.readlink().resolve() == to_this.resolve():
+                        action_taken = "already_linked"
+                        details = "Symlink already correctly points to target"
                         console.print(Panel(f"✅ ALREADY LINKED | {this} ➡️  {to_this}", title="Already Linked", expand=False))
-                        return
+                        return {"action": action_taken, "details": details}
                     else:
+                        action_taken = "relinking"
+                        details = "Updated existing symlink to point to new target"
                         console.print(Panel(f"🔄 RELINKING | Updating symlink from {this} ➡️  {to_this}", title="Relinking", expand=False))
                         this.delete(sure=True)
                 except OSError:
+                    action_taken = "fixing_broken_link"
+                    details = "Removed broken symlink and will create new one"
                     console.print(Panel(f"🔄 FIXING BROKEN LINK | Fixing broken symlink from {this} ➡️  {to_this}", title="Fixing Broken Link", expand=False))
                     this.delete(sure=True)
             else:
                 if prioritize_to_this:
                     backup_name = f"{this}.orig_{randstr()}"
+                    action_taken = "backing_up_source"
+                    details = f"Backed up source to {backup_name}, prioritizing target"
                     console.print(Panel(f"📦 BACKING UP | Moving {this} to {backup_name}, prioritizing {to_this}", title="Backing Up", expand=False))
                     this.move(path=backup_name)
                 else:
                     backup_name = f"{to_this}.orig_{randstr()}"
+                    action_taken = "backing_up_target"
+                    details = f"Backed up target to {backup_name}, prioritizing source"
                     console.print(Panel(f"📦 BACKING UP | Moving {to_this} to {backup_name}, prioritizing {this}", title="Backing Up", expand=False))
                     to_this.move(path=backup_name)
                     this.move(path=to_this)
         else:
             if this.is_symlink():
+                action_taken = "relinking_to_new_target"
+                details = "Removed existing symlink, will create target and new symlink"
                 console.print(Panel(f"🔄 RELINKING | Updating symlink from {this} ➡️  {to_this}", title="Relinking", expand=False))
                 this.delete(sure=True)
                 to_this.parent.mkdir(parents=True, exist_ok=True)
                 to_this.touch()
             else:
+                action_taken = "moving_to_target"
+                details = "Moved source to target location, will copy"
                 console.print(Panel(f"📁 MOVING | Moving {this} to {to_this}, then copying", title="Moving", expand=False))
                 this.move(path=to_this)
     else:
         if to_this.exists():
+            action_taken = "new_link"
+            details = "Copying existing target to source location"
             console.print(Panel(f"🆕 NEW LINK | Copying {to_this} to {this}", title="New Link", expand=False))
         else:
+            action_taken = "new_link_and_target"
+            details = "Creating target file and copying to source"
             console.print(Panel(f"🆕 NEW LINK & TARGET | Creating {to_this} and copying to {this}", title="New Link & Target", expand=False))
             to_this.parent.mkdir(parents=True, exist_ok=True)
             to_this.touch()
+    
     try:
+        action_taken = action_taken or "copying"
+        details = details or "Copying file"
         console.print(Panel(f"📋 COPYING | Copying {to_this} to {this}", title="Copying", expand=False))
         to_this.copy(path=this, overwrite=True, verbose=True)
+        return {"action": action_taken, "details": details}
     except Exception as ex:
+        action_taken = "error"
+        details = f"Failed to copy file: {str(ex)}"
         console.print(Panel(f"❌ ERROR | Failed at copying {to_this} to {this}. Reason: {ex}", title="Error", expand=False))
+        return {"action": action_taken, "details": details}

machineconfig/utils/options.py

@@ -6,31 +6,6 @@ from rich.console import Console
 import subprocess
 from typing import Optional, Union, Iterable, overload, Literal
 
-
-    # _ = cmd
-    #     cmd = "where.exe"
-    #     cmd = "which"
-    # try:  # talking to terminal is too slow.
-    #     _tmp = subprocess.check_output([cmd, tool_name], stderr=subprocess.DEVNULL)
-    #     res: bool = True
-    # except (subprocess.CalledProcessError, FileNotFoundError):
-    #     res = False
-    # return res
-    # return root_path.joinpath(tool_name).is_file()
-
-
-# def choose_from_options[T](options: Iterable[T], header: str = "", tail: str = "", prompt: str = "", msg: str = "", default: Optional[T] = None, fzf: bool = False, custom_input: bool = False) -> T:
-#     choice_key = choose_from_options(msg=msg, options=options, header=header, tail=tail, prompt=prompt, default=default, fzf=fzf, multi=False, custom_input=custom_input)
-#     assert not isinstance(choice_key, list)
-#     return choice_key
-
-
-# def choose_from_options[T](options: Iterable[T], header: str = "", tail: str = "", prompt: str = "", msg: str = "", default: Optional[T] = None, custom_input: bool = False) -> list[T]:
-#     choice_key = choose_from_options(msg=msg, options=options, header=header, tail=tail, prompt=prompt, default=default, fzf=True, multi=True, custom_input=custom_input)
-#     if isinstance(choice_key, list):
-#         return choice_key
-#     return [choice_key]
-
 @overload
 def choose_from_options[T](msg: str, options: Iterable[T], multi: Literal[False], custom_input: bool = False, header: str = "", tail: str = "", prompt: str = "", default: Optional[T] = None, fzf: bool = False) -> T: ...
 @overload

{machineconfig-5.12.dist-info → machineconfig-5.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 5.12
+Version: 5.14
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{machineconfig-5.12.dist-info → machineconfig-5.14.dist-info}/RECORD

@@ -78,11 +78,8 @@ machineconfig/jobs/linux/msc/cli_agents.sh,sha256=MMa_cd4yijI69c7tztTY1b0tl9I1EC
 machineconfig/jobs/linux/msc/lid.sh,sha256=09LeoSaXCGjCn7YxPcIFQpHroYdglJlEtFU2agarh3I,1302
 machineconfig/jobs/linux/msc/network.sh,sha256=dmISsh0hioDheinqee3qHfo2k7ClFx6G_GfGDxuflmc,1796
 machineconfig/jobs/python/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-machineconfig/jobs/python/check_installations.py,sha256=ksuENfJg0NAo1mWLRnsj1MpZw7Ee7eKw1nWyUQeO7fg,11096
-machineconfig/jobs/python/create_bootable_media.py,sha256=KKtcPk0rFLQc4eNVP6nbeYX-P7Gpqi0HvfIcUM6rVVs,827
-machineconfig/jobs/python/python_cargo_build_share.py,sha256=vy1v32-7Tui4NK4wG5XC5hxavQ4BeMpKprUtqzBjut0,2081
+machineconfig/jobs/python/check_installations.py,sha256=wOtvWzyJSxbuFueFfcOc4gX_UbTRWv6tWpRcG-3Ml_8,10780
 machineconfig/jobs/python/python_ve_symlink.py,sha256=Mw2SK_TDLK5Ct_mEESh_Pd-Rn-B1oBSp7a_9y_eZbqw,1140
-machineconfig/jobs/python/tasks.py,sha256=hrBDQOnBmcXtauTkicVgC8J2AOGcfdFfyx0K8eI6Coc,150
 machineconfig/jobs/python/vscode/api.py,sha256=Et0G-VUj13D1rshYMdDrw_CUYSO7Q6XRrEQO0WjVIKU,1683
 machineconfig/jobs/python/vscode/sync_code.py,sha256=f9hxMg_nkIsC0xvfQMboJbc-Jhap9YQrV7k7a5YSI1c,2333
 machineconfig/jobs/windows/start_terminal.ps1,sha256=wy0fGwgb4U7xaHsONDrR4V5u9JEkG5vtt4NZUBx0ro8,473
@@ -93,7 +90,7 @@ machineconfig/jobs/windows/archive/openssh-server_copy-ssh-id.ps1,sha256=-7pElYi
 machineconfig/jobs/windows/msc/cli_agents.bat,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/jobs/windows/msc/cli_agents.ps1,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/profile/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-machineconfig/profile/create.py,sha256=-BsFb-5-4ZweLGirRtTshBTtGuTtl1hCAC3tD12xgMQ,7745
+machineconfig/profile/create.py,sha256=QtPOj0aXLTd7XoAu-jBOQyZ_UM0Axc-OC-LCPMZ1Q7U,12390
 machineconfig/profile/shell.py,sha256=eAAmYoROXX1V3vk9-jcRSnv03P2Wx3_N4UgFtUDLtKU,9199
 machineconfig/profile/records/generic/shares.toml,sha256=FduDztfyQtZcr5bfx-RSKhEEweweQSWfVXkKWnx8hCY,143
 machineconfig/profile/records/linux/apps_summary_report.csv,sha256=pw9djvaRUPalKDLn2sl3odcbD2_Zx3aEupsQ8UPfaaY,2738
@@ -145,9 +142,9 @@ machineconfig/scripts/python/cloud_manager.py,sha256=YN0DYLzPKtMBaks-EAVwFmkCu3X
 machineconfig/scripts/python/cloud_mount.py,sha256=GwcXbd5ohoHGESfX5edtCEl2-umDDxH_AZapmFSzc9E,6740
 machineconfig/scripts/python/cloud_repo_sync.py,sha256=8dnlHbQqRymPRU0v01pNIuaIvFeY4fReP7ewNSSCt34,9765
 machineconfig/scripts/python/cloud_sync.py,sha256=RWGpAfJ9fnN18yNBSgN44dzA38Hmd4879JL5r2pcyrM,3514
-machineconfig/scripts/python/count_lines.py,sha256=BoIR9B5l-Yb1UtCkR1iBp7zCD8jxXw8BAgOnmiFG9es,15895
-machineconfig/scripts/python/count_lines_frontend.py,sha256=Kl2sLS8Cwy_7vx5DuTbb0V45_Z-j43g2dP-lRi9c5uI,571
-machineconfig/scripts/python/croshell.py,sha256=parFHSL859H00ExDpDBPHBFe_E_DrfVq6P8CpCGVK9A,8571
+machineconfig/scripts/python/count_lines.py,sha256=ZexMRsV70pe9fhLbGuens9EP5gCf078EwTDRHRZo5A0,15960
+machineconfig/scripts/python/count_lines_frontend.py,sha256=tqUiJggHC8_uy5ZV81i_ycxM1x0j-2nJin3e3FJqLXs,521
+machineconfig/scripts/python/croshell.py,sha256=ggLy1X45Dqo8AV8qUY2-O74r7yQNc9nnRhzt8RisMX8,6535
 machineconfig/scripts/python/devops.py,sha256=JB4_M6S-nO3yqas8wtAlU2r6jsmHu_nlq7aoEOH-54Y,3486
 machineconfig/scripts/python/devops_add_identity.py,sha256=wvjNgqsLmqD2SxbNCW_usqfp0LI-TDvcJJKGOWt2oFw,3775
 machineconfig/scripts/python/devops_add_ssh_key.py,sha256=BXB-9RvuSZO0YTbnM2azeABW2ngLW4SKhhAGAieMzfw,6873
@@ -165,13 +162,13 @@ machineconfig/scripts/python/fire_jobs_streamlit_helper.py,sha256=47DEQpj8HBSa-_
 machineconfig/scripts/python/ftpx.py,sha256=QfQTp-6jQP6yxfbLc5sKxiMtTgAgc8sjN7d17_uLiZc,9400
 machineconfig/scripts/python/get_zellij_cmd.py,sha256=e35-18hoXM9N3PFbvbizfkNY_-63iMicieWE3TbGcCQ,576
 machineconfig/scripts/python/gh_models.py,sha256=3BLfW25mBRiPO5VKtVm-nMlKLv-PaZDw7mObajq6F6M,5538
-machineconfig/scripts/python/interactive.py,sha256=Tmqes57K0Z1svEcxM6uOd6nSivwwQCthrupToeubDAo,11793
+machineconfig/scripts/python/interactive.py,sha256=wjxwxU5KtCh8MgujCQjEQctZPpKfPc71lMVFLhODQFE,11769
 machineconfig/scripts/python/mount_nfs.py,sha256=aECrL64j9g-9rF49sVJAjGmzaoGgcMnl3g9v17kQF4c,3239
 machineconfig/scripts/python/mount_nw_drive.py,sha256=iru6AtnTyvyuk6WxlK5R4lDkuliVpPV5_uBTVVhXtjQ,1550
 machineconfig/scripts/python/mount_ssh.py,sha256=k2fKq3f5dKq_7anrFOlqvJoI_3U4EWNHLRZ1o3Lsy6M,2268
 machineconfig/scripts/python/onetimeshare.py,sha256=bmGsNnskym5OWfIhpOfZG5jq3m89FS0a6dF5Sb8LaZM,2539
 machineconfig/scripts/python/pomodoro.py,sha256=SPkfeoZGv8rylGiOyzQ7UK3aXZ3G2FIOuGkSuBUggOI,2019
-machineconfig/scripts/python/repos.py,sha256=n7LUG_SPZ_i-moYjz3QHPhsBM_cFpm3cZ-tjztplDfc,4918
+machineconfig/scripts/python/repos.py,sha256=IidAfUx6jFs4dB8Wjq8ems8mS8X8jYFgvEhtCYdLs-A,4917
 machineconfig/scripts/python/repos_helper.py,sha256=3jLdnNf1canpzi3JXiz5VA6UTUmLeNHuhjOWVl_thP0,3006
 machineconfig/scripts/python/repos_helper_action.py,sha256=sXeOw5uHaK2GJixYW8qU_PD24mruGcQ59uf68ELC76A,14846
 machineconfig/scripts/python/repos_helper_clone.py,sha256=9vGb9NCXT0lkerPzOJjmFfhU8LSzE-_1LDvjkhgnal0,5461
@@ -382,9 +379,9 @@ machineconfig/utils/accessories.py,sha256=W_9dLzjwNTW5JQk_pe3B2ijQ1nA2-8Kdg2r7VB
 machineconfig/utils/code.py,sha256=S7uY5kLPxLcLlR7B2KHeYkenlysAYSPcxFiUYHXSxX8,5646
 machineconfig/utils/installer.py,sha256=xYM6tyctqLmr2lLXUKWgobTRufGIua31uspMXP4HGjY,9945
 machineconfig/utils/io.py,sha256=ZXB3aataS1IZ_0WMcCRSmoN1nbkvEO-bWYcs-TpngqU,2872
-machineconfig/utils/links.py,sha256=CndE3K0dRtEjp8qfjffs-DE3WzwNUJLRHikZE_dkWm0,10237
+machineconfig/utils/links.py,sha256=S0XICdbcFESUqm5RINDrOf3O8G1b7QEADncXXcC8IQc,15520
 machineconfig/utils/notifications.py,sha256=vvdsY5IX6XEiILTnt5lNyHxhCi0ljdGX2T_67VRfrG4,9009
-machineconfig/utils/options.py,sha256=8pG-apcc28xxJ5BQiACsGNTKwWtkQyH3hCtzBEhokK8,8366
+machineconfig/utils/options.py,sha256=vUO4Kej-vDOv64wHr2HNDyu6PATURpjd7xp6N8OOoJg,7083
 machineconfig/utils/path_extended.py,sha256=Xjdn2AVnB8p1jfNMNe2kJutVa5zGnFFJVGZbw-Bp_hg,53200
 machineconfig/utils/path_helper.py,sha256=0e3Xh3BAEv27oqcezNeVLHJllGmLEgLH4T1l90m-650,8014
 machineconfig/utils/procs.py,sha256=Bm-yopmj19yiBO9tywJHEcs9rZmeRyJqbgTSe216LTU,11349
@@ -399,17 +396,20 @@ machineconfig/utils/ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 machineconfig/utils/ai/generate_file_checklist.py,sha256=ajbmhcBToRugl75c_KZRq2XJumxKgIqQhyf7_YtF5q4,2729
 machineconfig/utils/cloud/onedrive/setup_oauth.py,sha256=ZTVkqgrwbV_EoPvyT8dyOTUE0ur3BW4sa9o6QYtt5Bo,2341
 machineconfig/utils/cloud/onedrive/transaction.py,sha256=m-aNcnWj_gfZVvJOSpkdIqjZxU_3nXx2CA-qKbQgP3I,26232
+machineconfig/utils/files/ascii_art.py,sha256=cNJaJC07vx94fS44-tzgfbfBeCwXVrgpnWGBLUnfC38,5212
+machineconfig/utils/files/headers.py,sha256=crnjWt5R0rmZOQ45KhF6HtFpsUm1oeCPoYeptR4o-U0,3437
+machineconfig/utils/files/read.py,sha256=dyf-DDkLnCKgwmRH0Af4UtBIZh6iMUaYmjgJtdSGRFg,4744
 machineconfig/utils/installer_utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 machineconfig/utils/installer_utils/github_release_bulk.py,sha256=WJf_qZlF02SmIc6C7o1h4Gy4gAaJAfeAS8O9s2Itj-k,6535
 machineconfig/utils/installer_utils/installer.py,sha256=_XcatwArhwRepMYfaGYpjd-lqNGfijnjeZB8l4uKd-c,9266
-machineconfig/utils/installer_utils/installer_abc.py,sha256=9qtFt0_gz_VgaDCCVoXNiOgR42dRF1zU9054o135vs4,10797
+machineconfig/utils/installer_utils/installer_abc.py,sha256=VTHe5O3jA6k6rnUnXhgnEf6mVvkVQlEuXjzYLEDgEAs,11140
 machineconfig/utils/installer_utils/installer_class.py,sha256=fN4Nfqn4tlSfQGW52A_Ipi6GT6utC30ZuSj5WM_yxIY,20252
 machineconfig/utils/schemas/fire_agents/fire_agents_input.py,sha256=pTxvLzIpD5RF508lUUBBkWcc4V1B10J4ylvVgVGkcM0,2037
 machineconfig/utils/schemas/installer/installer_types.py,sha256=QClRY61QaduBPJoSpdmTIdgS9LS-RvE-QZ-D260tD3o,1214
 machineconfig/utils/schemas/layouts/layout_types.py,sha256=TcqlZdGVoH8htG5fHn1KWXhRdPueAcoyApppZsPAPto,2020
 machineconfig/utils/schemas/repos/repos_types.py,sha256=ECVr-3IVIo8yjmYmVXX2mnDDN1SLSwvQIhx4KDDQHBQ,405
-machineconfig-5.12.dist-info/METADATA,sha256=bcbdbTMVjgLU4e-XinDcInPPj0ELaL4i1jJYkM2_5BA,8030
-machineconfig-5.12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-machineconfig-5.12.dist-info/entry_points.txt,sha256=2afE1mw-o4MUlfxyX73SV02XaQI4SV_LdL2r6_CzhPU,1074
-machineconfig-5.12.dist-info/top_level.txt,sha256=porRtB8qms8fOIUJgK-tO83_FeH6Bpe12oUVC670teA,14
-machineconfig-5.12.dist-info/RECORD,,
+machineconfig-5.14.dist-info/METADATA,sha256=mFhObJHO12yrWPAN5ujBFZSEscyXA61ekpyxdMlytj0,8030
+machineconfig-5.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+machineconfig-5.14.dist-info/entry_points.txt,sha256=2afE1mw-o4MUlfxyX73SV02XaQI4SV_LdL2r6_CzhPU,1074
+machineconfig-5.14.dist-info/top_level.txt,sha256=porRtB8qms8fOIUJgK-tO83_FeH6Bpe12oUVC670teA,14
+machineconfig-5.14.dist-info/RECORD,,

machineconfig/jobs/python/create_bootable_media.py

@@ -1,16 +0,0 @@
-# try ventory or netboot.xyz
-
-# # one can either install rufus: https://rufus.ie/en/
-# # however, to create bootable media with multiple OSs to choose from:
-
-# PathExtended(r'https://github.com/ventoy/Ventoy/archive/refs/tags/v1.0.78.zip').download().unzip().search[0]()
-# download_folder = PathExtended.home().joinpath("Downloads/os")
-# download_folder.mkdir(parents=True, exist_ok=True)
-# PathExtended(r'https://mirrors.layeronline.com/linuxmint/stable/21/linuxmint-21-cinnamon-64bit.iso').download(folder=download_folder)
-# download_folder2 = PathExtended.home().joinpath("Downloads/os")
-# download_folder2.mkdir(parents=True, exist_ok=True)
-# PathExtended(r'https://download.manjaro.org/kde/21.3.7/manjaro-kde-21.3.7-minimal-220816-linux515.iso').download(folder=download_folder2)
-
-
-# if __name__ == '__main__':
-#     pass

machineconfig/jobs/python/python_cargo_build_share.py

@@ -1,58 +0,0 @@
-"""
-cargo install
-"""
-
-# from machineconfig.utils.path_reduced import P as PathExtended
-# import platform
-
-
-# def build_rust_executable(url: str=r"https://github.com/atanunq/viu"):
-#     tool_name = url.split('/')[-1]
-
-#     # move command is not required since tool will go to .cargo/bin which is in PATH by default.
-#     # move_command = f"mv {exe} {tb.get_env().WindowsApps.as_posix()}/" if platform.platform() == "Windows" else f"sudo mv {exe} /usr/local/bin/"
-#     # {move_command}
-
-#     script = f"""
-# cd ~
-# git clone --depth 1 {url}
-# cd {tool_name}
-# cargo install --path .
-# """
-#     print(f"""
-# {'=' * 150}
-# 🦀 CARGO BUILD | Building Rust project: {tool_name}
-# 📦 Source: {url}
-# {'=' * 150}
-# """)
-#     if platform.system() == "Windows":
-#         Terminal(stdout=None).run(f". {PathExtended.tmpfile(suffix='.ps1').write_text(script, encoding="utf-8")}", shell="pwsh").print()
-#     else:
-#         Terminal(stdout=None).run(script, shell="pwsh")
-
-#     exe = PathExtended.home().joinpath(f".cargo/bin/{tool_name}" + (".exe" if platform.system() == "Windows" else ""))
-
-#     try:
-#         PathExtended.home().joinpath(tool_name).delete(sure=True)
-#     except PermissionError:
-#         print(f"""
-# {'⚠️' * 20}
-# ⚠️  WARNING | Permission error when cleaning up
-# 📂 Path: {PathExtended.home().joinpath(tool_name)}
-# {'⚠️' * 20}
-# """)
-
-#     if platform.system() == "Windows":
-#         exe = exe.move(folder=PathExtended.get_env().WindowsPaths().WindowsApps)
-#     elif platform.system() in ["Linux", "Darwin"]:
-#         Terminal().run(f"sudo mv {exe} /usr/local/bin")
-#         exe = PathExtended(r"/usr/local/bin").joinpath(exe.name)
-#     else:
-#         raise NotImplementedError(f"🚫 Platform {platform.system()} not supported.")
-#     share_link = exe.to_cloud("gdpo", share=True)
-#     return share_link
-
-
-# after cargo install diskonaut
-# then mv ~/.cargo/bin/diskonaut.exe ~/AppData/Local/Microsoft/WindowsApps/
-# then bu_gdrive_sx.ps1 .\diskonaut.exe -sRz  # zipping is vital to avoid security layers and keep file metadata.

machineconfig/jobs/python/tasks.py

@@ -1,3 +0,0 @@
-from machineconfig.scripts.python.devops_backup_retrieve import main_backup_retrieve
-
-program = main_backup_retrieve(direction="BACKUP", which="all")