machineconfig 5.13__tar.gz → 5.15__tar.gz

{machineconfig-5.13/src/machineconfig.egg-info → machineconfig-5.15}/PKG-INFO

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

{machineconfig-5.13 → machineconfig-5.15}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "5.13"
+version = "5.15"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -85,6 +85,7 @@ where = ["src"]
 dev = [
     "aider>=0.2.6",
     "cleanpy>=0.5.1",
+    "cowsay>=6.1",
     "ipdb>=0.13.13",
     "ipykernel>=6.30.1",
     "ipython>=9.5.0",
@@ -112,8 +113,15 @@ docs = [
     "pdoc>=15.0.2",
 ]
 plot = [
+    "duckdb-engine>=0.17.0",
+    "ipykernel>=6.30.1",
+    "jupyterlab>=4.4.9",
     "kaleido>=1.1.0",
+    "matplotlib>=3.10.6",
+    "nbformat>=5.10.4",
     "numpy>=2.3.3",
     "plotly>=6.3.0",
     "polars>=1.33.1",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.43",
 ]

machineconfig-5.15/src/machineconfig/scripts/python/count_lines_frontend.py

@@ -0,0 +1,16 @@
+
+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__)
+    # --project $HOME/code/machineconfig 
+    cmd = f"""uv run --python 3.13 --with machineconfig[plot] {count_lines_path} analyze-over-time {repo_path}"""
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(cmd)
+
+
+if __name__ == "__main__":
+    pass

{machineconfig-5.13 → machineconfig-5.15}/src/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_shell_script
+    run_shell_script(fire_line)
 
 
 def arg_parser() -> None:

{machineconfig-5.13 → machineconfig-5.15}/src/machineconfig/scripts/python/fire_jobs.py

@@ -221,8 +221,8 @@ python -m machineconfig.cluster.templates.cli_click --file {choice_file} """
             command = "$ErrorActionPreference = 'SilentlyContinue';\n" + command + "\nStart-Sleep -Seconds 0.5"
         else:
             raise NotImplementedError(f"Platform {platform.system()} not supported.")
-    from machineconfig.utils.code import run_script
-    run_script(command)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(command)
 
 
 def main(

{machineconfig-5.13 → machineconfig-5.15}/src/machineconfig/scripts/python/interactive.py

@@ -27,27 +27,23 @@ from questionary import Choice
 from rich.console import Console
 from rich.panel import Panel
 from rich.text import Text
-from machineconfig.utils.code import run_script as run_command
+from machineconfig.utils.code import run_shell_script
 
 _ = cast
 console = Console()
 
 
 def display_header() -> None:
-    """Display the script header."""
     header_text = Text("MACHINE CONFIGURATION", style="bold magenta")
     subtitle_text = Text("Interactive Installation Script", style="italic cyan")
     console.print(Panel(f"📦 {header_text}\n{subtitle_text}", border_style="blue", padding=(1, 2)))
 def display_completion_message() -> None:
-    """Display completion message."""
     completion_text = Text("INSTALLATION COMPLETE", style="bold green")
     subtitle_text = Text("System setup finished successfully", style="italic green")
     console.print(Panel(f"✨ {completion_text}\n{subtitle_text}\n\n🎉 Your system has been configured successfully!\n🔄 You may need to reboot to apply all changes.", border_style="green", padding=(1, 2)))
 def display_dotfiles_instructions() -> None:
-    """Display instructions for dotfiles migration."""
     header_text = Text("DOTFILES MIGRATION", style="bold yellow")
     subtitle_text = Text("Configuration transfer options", style="italic yellow")
-
     instructions = """
 🖱️  [bold blue]Method 1: USING MOUSE WITHOUT KB OR BROWSER SHARE[/bold blue]
     On original machine, run:
@@ -65,32 +61,9 @@ def display_dotfiles_instructions() -> None:
     [dim]cd ~
     cloud_copy SHARE_URL . --config ss[/dim]
     (requires symlinks to be created first)"""
-
     console.print(Panel(f"📂 {header_text}\n{subtitle_text}\n\n{instructions}", border_style="yellow", padding=(1, 2)))
 
 
-def install_windows_desktop_apps() -> bool:
-    """Install Windows desktop applications using winget."""
-    if system() != "Windows":
-        console.print("❌ This function is only available on Windows systems.", style="bold red")
-        return False   
-    console.print("🔧 Installing Nerd Fonts", style="bold cyan")
-    try:
-        from machineconfig.jobs.installer.custom_dev.nerfont_windows_helper import install_nerd_fonts
-        install_nerd_fonts()
-        console.print("✅ Nerd Fonts installed successfully", style="bold green")
-    except Exception as e:
-        console.print(f"❌ Error installing Nerd Fonts: {e}", style="bold red")
-    console.print("🔧 Setting Windows Terminal settings", style="bold cyan")
-    try:
-        from machineconfig.setup_windows.wt_and_pwsh.set_wt_settings import main as set_wt_settings_main
-        set_wt_settings_main()
-        console.print("✅ Windows Terminal settings configured successfully", style="bold green")
-    except Exception as e:
-        console.print(f"❌ Error setting Windows Terminal settings: {e}", style="bold red")    
-    return True
-
-
 def get_installation_choices() -> list[str]:
     """Get user choices for installation options."""
     choices = [
@@ -114,11 +87,15 @@ def get_installation_choices() -> list[str]:
 
 
 def execute_installations(selected_options: list[str]) -> None:
-    """Execute the selected installation options."""
     if system() == "Windows":
-        run_command("$HOME/.local/bin/uv.exe self update")
+        from machineconfig import setup_windows as module
+        script_path = Path(module.__file__).parent / "ve.ps1"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
     else:
-        run_command("$HOME/.local/bin/uv self update")
+        from machineconfig import setup_linux as module
+        script_path = Path(module.__file__).parent / "ve.sh"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
+
     for maybe_a_group in selected_options:
         if maybe_a_group in ("ESSENTIAL", "DEV", "ESSENTIAL_SYSTEM", "DEV_SYSTEM", "TerminalEyeCandy"):
             console.print(Panel("⚡ [bold bright_yellow]CLI APPLICATIONS[/bold bright_yellow]\n[italic]Command-line tools installation[/italic]", border_style="bright_yellow"))
@@ -129,21 +106,25 @@ def execute_installations(selected_options: list[str]) -> None:
                 console.print("✅ CLI applications installed successfully", style="bold green")
             except Exception as e:
                 console.print(f"❌ Error installing CLI applications: {e}", style="bold red")
-            run_command(". $HOME/.bashrc")
+            run_shell_script(". $HOME/.bashrc")
 
     if "upgrade_system" in selected_options:
         if system() == "Windows":
             console.print("❌ System upgrade is not applicable on Windows via this script.", style="bold red")
         elif system() == "Linux":
             console.print(Panel("🔄 [bold magenta]SYSTEM UPDATE[/bold magenta]\n[italic]Package management[/italic]", border_style="magenta"))
-            run_command("sudo nala upgrade -y")
+            run_shell_script("sudo nala upgrade -y")
         else:
             console.print(f"❌ System upgrade not supported on {system()}.", style="bold red")
     if "install_repos" in selected_options:
         console.print(Panel("🐍 [bold green]PYTHON ENVIRONMENT[/bold green]\n[italic]Virtual environment setup[/italic]", border_style="green"))
-        from machineconfig import setup_linux as module
-        script = Path(module.__file__).parent / "repos.sh"
-        run_command(f"bash {script}")
+        if system() == "Windows":
+            from machineconfig import setup_windows as module
+            script_path = Path(module.__file__).parent / "repos.ps1"
+        else:
+            from machineconfig import setup_linux as module
+            script_path = Path(module.__file__).parent / "repos.sh"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
 
     if "install_ssh_server" in selected_options:
         console.print(Panel("🔒 [bold red]SSH SERVER[/bold red]\n[italic]Remote access setup[/italic]", border_style="red"))
@@ -152,9 +133,9 @@ def execute_installations(selected_options: list[str]) -> None:
 Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
 Start-Service sshd
 Set-Service -Name sshd -StartupType 'Automatic'"""
-            run_command(f'powershell -Command "{powershell_script}"')
+            run_shell_script(f'powershell -Command "{powershell_script}"')
         else:
-            run_command("sudo nala install openssh-server -y")
+            run_shell_script("sudo nala install openssh-server -y")
 
     if "install_shell_profile" in selected_options:
         console.print(Panel("🐚 [bold green]SHELL PROFILE[/bold green]\n[italic]Shell configuration setup[/italic]", border_style="green"))
@@ -179,8 +160,8 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
                 console.print("✅ Symlinks created successfully", style="bold green")
             except Exception as e:
                 console.print(f"❌ Error creating symlinks: {e}", style="bold red")
-            run_command("sudo chmod 600 $HOME/.ssh/*")
-            run_command("sudo chmod 700 $HOME/.ssh")
+            run_shell_script("sudo chmod 600 $HOME/.ssh/*")
+            run_shell_script("sudo chmod 700 $HOME/.ssh")
         else:
             console.print("⏭️  Skipping symlink creation - finish dotfiles transfer first", style="yellow")
 
@@ -200,7 +181,10 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
             console.print(f"❌ Error retrieving backup data: {e}", style="bold red")
 
     if "install_windows_desktop" in selected_options:
-        install_windows_desktop_apps()
+        from machineconfig.jobs.installer.custom_dev.nerfont_windows_helper import install_nerd_fonts
+        install_nerd_fonts()
+        from machineconfig.setup_windows.wt_and_pwsh.set_wt_settings import main as set_wt_settings_main
+        set_wt_settings_main()
 
 
 def main() -> None:
@@ -210,7 +194,7 @@ def main() -> None:
     if not selected_options:
         console.print("❌ No options selected. Exiting...", style="bold red")
         sys.exit(0)
-    console.print(f"\n✅ Selected options: {', '.join(selected_options)}", style="bold green")
+    console.print(f"\n✅ Selected options: {'\n'.join(selected_options)}", style="bold green")
     proceed = questionary.confirm("🚀 Proceed with installation?", default=True).ask()
     if not proceed:
         console.print("❌ Installation cancelled.", style="bold red")

{machineconfig-5.13 → machineconfig-5.15}/src/machineconfig/scripts/python/share_terminal.py

@@ -132,8 +132,8 @@ def main(
 #!/bin/bash
 ttyd --writable -t enableSixel=true {ssl_args} --port {port} --credential "{username}:{password}" -t 'theme={{"background": "black"}}' {start_command}
 """
-    from machineconfig.utils.code import run_script
-    run_script(code)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(code)
 
 
 def main_with_parser():

{machineconfig-5.13 → machineconfig-5.15}/src/machineconfig/setup_windows/web_shortcuts/interactive.ps1

@@ -10,3 +10,4 @@ Invoke-WebRequest -Uri "https://raw.githubusercontent.com/thisismygitrepo/machin
 rm ve.ps1
 
 uv run --python 3.13 --with machineconfig devops interactive
+# uv run --python 3.13 --with machineconfig https://raw.githubusercontent.com/thisismygitrepo/machineconfig/ee4f69e838e1acbb275bfb5a3d3faee23345f2a8/src/machineconfig/scripts/python/devops.py

{machineconfig-5.13 → machineconfig-5.15}/src/machineconfig/utils/code.py

@@ -98,7 +98,7 @@ def print_code(code: str, lexer: str, desc: str, subtitle: str = ""):
     console.print(Panel(Syntax(code=code, lexer=lexer), title=f"📄 {desc}", subtitle=subtitle), style="bold red")
 
 
-def run_script(program: str):
+def run_shell_script(program: str):
     import tempfile
     if platform.system() == "Windows":
         suffix = ".ps1"

machineconfig-5.15/src/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-5.15/src/machineconfig/utils/files/headers.py

@@ -0,0 +1,71 @@
+
+import glob
+import os
+import platform
+import random
+from pathlib import Path
+from rich import pretty
+from rich.console import Console
+from typing import Optional
+
+
+def print_header():
+    console = Console()
+    pretty.install()
+
+    # Environment Information Panel
+    from rich.panel import Panel
+    from rich.table import Table
+
+    table = Table(show_header=False, show_edge=False, pad_edge=False)
+    table.add_column("Label", style="cyan", no_wrap=True)
+    table.add_column("Value", style="white")
+
+    table.add_row("Python Version", platform.python_version())
+    table.add_row("Operating System", platform.system())
+    table.add_row("Virtual Environment", os.getenv('VIRTUAL_ENV', 'None'))
+    table.add_row("Running @", str(Path.cwd()))
+
+
+    console.print(Panel(table, title="[bold blue]✨ 🐊 Crocodile Shell 14.5 ✨ Made with 🐍 | Built with ❤️[/bold blue]", border_style="blue"))
+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())