machineconfig 5.59__tar.gz → 5.60__tar.gz

{machineconfig-5.59/src/machineconfig.egg-info → machineconfig-5.60}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 5.59
+Version: 5.60
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0
@@ -27,6 +27,7 @@ Requires-Dist: pyjson5>=1.6.9
 Requires-Dist: questionary>=2.1.1
 Requires-Dist: typer-slim>=0.19.2
 Requires-Dist: typer>=0.19.2
+Requires-Dist: textual>=6.2.1
 Provides-Extra: windows
 Requires-Dist: pywin32; extra == "windows"
 Provides-Extra: plot

{machineconfig-5.59 → machineconfig-5.60}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "5.59"
+version = "5.60"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -36,6 +36,7 @@ dependencies = [
     "questionary>=2.1.1",
     "typer-slim>=0.19.2",
     "typer>=0.19.2",
+    "textual>=6.2.1",
 ]
 
 [project.optional-dependencies]

{machineconfig-5.59 → machineconfig-5.60}/src/machineconfig/scripts/python/devops_helpers/cli_config.py

@@ -41,6 +41,14 @@ def shell():
     from machineconfig.profile.create_shell_profile import create_default_shell_profile
     create_default_shell_profile()
 
+@config_apps.command(no_args_is_help=False)
+def path():
+    """📚 NAVIGATE PATH variable with TUI"""
+    from machineconfig.scripts.python import env_manager as navigator
+    from pathlib import Path
+    path = Path(navigator.__file__).resolve().parent.joinpath("path_manager_tui.py")
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(f"uv run --no-dev --with machineconfig,textual {path}")
 
 @config_apps.command(no_args_is_help=False)
 def pwsh_theme():

{machineconfig-5.59 → machineconfig-5.60}/src/machineconfig/scripts/python/devops_helpers/cli_self.py

@@ -42,7 +42,7 @@ def navigate():
     from pathlib import Path
     path = Path(navigator.__file__).resolve().parent.joinpath("devops_navigator.py")
     from machineconfig.utils.code import run_shell_script
-    run_shell_script(f"uv run --with machineconfig {path}")
+    run_shell_script(f"uv run --no-dev --with machineconfig,textual {path}")
 
 
 @cli_app.command(no_args_is_help=True)

machineconfig-5.60/src/machineconfig/scripts/python/env_manager/__init__.py

@@ -0,0 +1 @@
+a = 2

machineconfig-5.60/src/machineconfig/scripts/python/env_manager/path_manager_backend.py

@@ -0,0 +1,47 @@
+"""Cross-platform PATH explorer backend."""
+
+import os
+import platform
+from pathlib import Path
+from typing import Literal
+
+
+PlatformType = Literal["Windows", "Linux", "Darwin"]
+
+
+def get_platform() -> PlatformType:
+    """Get the current platform."""
+    return platform.system()  # type: ignore[return-value]
+
+
+def get_path_entries() -> list[str]:
+    """Get all PATH entries for the current platform."""
+    path_str = os.environ.get("PATH", "")
+    separator = ";" if get_platform() == "Windows" else ":"
+    return [entry for entry in path_str.split(separator) if entry.strip()]
+
+
+def get_directory_contents(directory: str, max_items: int = 50) -> list[str]:
+    """Get contents of a directory, limited to max_items."""
+    try:
+        path = Path(directory)
+        if not path.exists():
+            return ["⚠️  Directory does not exist"]
+        if not path.is_dir():
+            return ["⚠️  Not a directory"]
+        
+        items = []
+        for item in sorted(path.iterdir(), key=lambda p: (not p.is_dir(), p.name.lower())):
+            if len(items) >= max_items:
+                items.append(f"... and {sum(1 for _ in path.iterdir()) - max_items} more items")
+                break
+            prefix = "📁 " if item.is_dir() else "📄 "
+            items.append(f"{prefix}{item.name}")
+        
+        if not items:
+            return ["📭 Empty directory"]
+        return items
+    except PermissionError:
+        return ["⚠️  Permission denied"]
+    except Exception as e:
+        return [f"⚠️  Error: {e!s}"]

machineconfig-5.60/src/machineconfig/scripts/python/env_manager/path_manager_tui.py

@@ -0,0 +1,219 @@
+"""Cross-platform PATH explorer with Textual TUI."""
+
+from pathlib import Path
+
+from textual import on
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.containers import Horizontal, Vertical
+from textual.widgets import Footer, Header, Label, ListItem, ListView, Static
+
+from machineconfig.scripts.python.env_manager.path_manager_backend import get_directory_contents, get_path_entries, get_platform
+
+
+class DirectoryPreview(Static):
+    """Widget to display directory contents."""
+
+    def __init__(self, *args, **kwargs) -> None:  # type: ignore[no-untyped-def]
+        super().__init__(*args, **kwargs)
+        self.border_title = "📂 Directory Preview"
+
+    def update_preview(self, directory: str) -> None:
+        """Update the preview with directory contents."""
+        if not directory:
+            self.update("Select a PATH entry to preview its contents")
+            return
+
+        contents = get_directory_contents(directory, max_items=30)
+        preview_text = f"[bold cyan]{directory}[/bold cyan]\n\n"
+        preview_text += "\n".join(contents)
+        self.update(preview_text)
+
+
+class StatusBar(Static):
+    """Status bar to show messages."""
+
+    def __init__(self, *args, **kwargs) -> None:  # type: ignore[no-untyped-def]
+        super().__init__(*args, **kwargs)
+        self.border_title = "ℹ️  Status"
+
+    def show_message(self, message: str, message_type: str = "info") -> None:
+        """Display a status message."""
+        color = {"info": "cyan", "success": "green", "error": "red", "warning": "yellow"}.get(message_type, "white")
+        self.update(f"[{color}]{message}[/{color}]")
+
+
+class PathExplorerApp(App[None]):
+    """A Textual app to explore PATH entries."""
+
+    CSS = """
+    Screen {
+        background: $surface;
+    }
+
+    Header {
+        background: $primary;
+        color: $text;
+    }
+
+    Footer {
+        background: $panel;
+    }
+
+    #main-container {
+        height: 100%;
+    }
+
+    #left-panel {
+        width: 50%;
+        height: 100%;
+        border: solid $primary;
+        padding: 1;
+    }
+
+    #right-panel {
+        width: 50%;
+        height: 100%;
+        border: solid $accent;
+        padding: 1;
+    }
+
+    ListView {
+        height: 1fr;
+        border: solid $accent;
+        background: $surface;
+    }
+
+    ListView > ListItem {
+        padding: 0 1;
+    }
+
+    ListView > ListItem.--highlight {
+        background: $accent 20%;
+    }
+
+    DirectoryPreview {
+        height: 1fr;
+        border: solid $primary;
+        background: $surface;
+        padding: 1;
+        overflow-y: auto;
+    }
+
+    StatusBar {
+        height: 3;
+        border: solid $success;
+        background: $surface;
+        padding: 1;
+    }
+
+    Label {
+        padding: 0 1;
+        height: auto;
+    }
+    """
+
+    BINDINGS = [
+        Binding("q", "quit", "Quit", show=True),
+        Binding("r", "refresh", "Refresh", show=True),
+        Binding("c", "copy_path", "Copy Path", show=True),
+    ]
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.selected_path: str = ""
+
+    def compose(self) -> ComposeResult:
+        """Create child widgets for the app."""
+        platform_name = get_platform()
+        yield Header(show_clock=True)
+        
+        with Horizontal(id="main-container"):
+            with Vertical(id="left-panel"):
+                yield Label(f"🔧 PATH Entries ({platform_name})")
+                yield ListView(id="path-list")
+                
+            with Vertical(id="right-panel"):
+                yield DirectoryPreview(id="preview")
+                yield StatusBar(id="status")
+
+        yield Footer()
+
+    def on_mount(self) -> None:
+        """Initialize the app when mounted."""
+        self.title = "PATH Explorer"
+        self.sub_title = f"Platform: {get_platform()}"
+        self.refresh_path_list()
+        self.query_one("#status", StatusBar).show_message("Ready. Select a PATH entry to preview its contents.", "info")
+
+    def refresh_path_list(self) -> None:
+        """Refresh the list of PATH entries."""
+        list_view = self.query_one("#path-list", ListView)
+        list_view.clear()
+        
+        entries = get_path_entries()
+        for entry in entries:
+            path = Path(entry)
+            exists = path.exists()
+            icon = "✅" if exists else "❌"
+            item = ListItem(Label(f"{icon} {entry}"))
+            item.set_class(exists, "--valid")
+            list_view.append(item)
+        
+        self.query_one("#status", StatusBar).show_message(f"Loaded {len(entries)} PATH entries", "success")
+
+    @on(ListView.Highlighted)
+    def handle_highlight(self, event: ListView.Highlighted) -> None:
+        """Handle highlighting of a PATH entry (scroll preview)."""
+        if event.item is None:
+            return
+        label = event.item.query_one(Label)
+        text = label.render()
+        # Remove the icon prefix
+        highlighted_path = str(text).split(" ", 1)[1] if " " in str(text) else str(text)
+        
+        preview = self.query_one("#preview", DirectoryPreview)
+        preview.update_preview(highlighted_path)
+        
+        self.query_one("#status", StatusBar).show_message(f"Previewing: {highlighted_path}", "info")
+
+    @on(ListView.Selected)
+    def handle_selection(self, event: ListView.Selected) -> None:
+        """Handle selection of a PATH entry (Enter key)."""
+        label = event.item.query_one(Label)
+        text = label.render()
+        # Remove the icon prefix
+        self.selected_path = str(text).split(" ", 1)[1] if " " in str(text) else str(text)
+        
+        preview = self.query_one("#preview", DirectoryPreview)
+        preview.update_preview(self.selected_path)
+        
+        self.query_one("#status", StatusBar).show_message(f"Selected: {self.selected_path}", "success")
+
+    def action_refresh(self) -> None:
+        """Refresh the PATH list."""
+        self.refresh_path_list()
+
+    def action_copy_path(self) -> None:
+        """Copy selected path to clipboard."""
+        if not self.selected_path:
+            self.query_one("#status", StatusBar).show_message("No PATH entry selected", "warning")
+            return
+        
+        # Try to copy to clipboard
+        try:
+            import pyperclip
+            pyperclip.copy(self.selected_path)
+            self.query_one("#status", StatusBar).show_message(f"Copied to clipboard: {self.selected_path}", "success")
+        except ImportError:
+            self.query_one("#status", StatusBar).show_message("pyperclip not available. Install it to enable clipboard support.", "warning")
+
+
+def main() -> None:
+    """Run the PATH Explorer TUI."""
+    app = PathExplorerApp()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

{machineconfig-5.59 → machineconfig-5.60}/src/machineconfig/utils/ssh.py

@@ -215,24 +215,36 @@ class SSH:  # inferior alternative: https://github.com/fabric/fabric
         self.terminal_responses.append(res)
         return res
     def run_py(self, cmd: str, desc: str = "", return_obj: bool = False, verbose: bool = True, strict_err: bool = False, strict_returncode: bool = False) -> Union[Any, Response]:
-        assert '"' not in cmd, 'Avoid using `"` in your command. I dont know how to handle this when passing is as command to python in pwsh command.'
+        from machineconfig.utils.accessories import randstr
+        from pathlib import Path
+        cmd_path = Path.home().joinpath(f"tmp_results/tmp_scripts/ssh/runpy_{randstr()}.py")
+        cmd_path.parent.mkdir(parents=True, exist_ok=True)
         if not return_obj:
+            cmd_path.write_text(cmd, encoding="utf-8")
+            self.copy_from_here(source=cmd_path, target=None)
             return self.run(
-                cmd=f"""$HOME/.local/bin/uv run --with machineconfig python -c "{cmd}\n""" + '"',
+                cmd=f"""$HOME/.local/bin/uv run --with machineconfig python {cmd_path.relative_to(Path.home())}""" + '"',
                 desc=desc or f"run_py on {self.get_remote_repr()}",
                 verbose=verbose,
                 strict_err=strict_err,
                 strict_returncode=strict_returncode,
             )
         assert "obj=" in cmd, "The command sent to run_py must have `obj=` statement if return_obj is set to True"
-        source_file = self.run_py(f"""{cmd}
-import pickle
-import tempfile
-from pathlib import Path
-path = tempfile.emkstemp(suffix=".pkl")[1]
-Path(path).write_bytes(pickle.dumps(obj))
-print(path)""", desc=desc, verbose=verbose, strict_err=True, strict_returncode=True).op.split("\n")[-1]
-        res = self.copy_to_here(source=source_file, target=PathExtended.tmpfile(suffix=".pkl"))
+        return_path = cmd_path.parent.joinpath(f"return_obj_{randstr()}.pkl")
+        def func(pkl_path_rel2_home: str) -> None:
+            pickle_path_obj = Path.home().joinpath(pkl_path_rel2_home).expanduser().absolute()
+            import pickle
+            obj = globals().get("obj", None)
+            pickle_path_obj.write_bytes(pickle.dumps(obj))
+        from machineconfig.utils.meta import function_to_script
+        cmd_complement = function_to_script(func=func, call_with_kwargs={"pkl_path_rel2_home": return_path.relative_to(Path.home()).as_posix()})
+        cmd_total = f"""{cmd}
+{cmd_complement}
+"""
+        cmd_path.write_text(cmd_total, encoding="utf-8")
+        self.copy_from_here(source=cmd_path, target=None)
+        _resp = self.run(f"""$HOME/.local/bin/uv run --with machineconfig python {cmd_path}""", desc=desc, verbose=verbose, strict_err=True, strict_returncode=True).op.split("\n")[-1]
+        res = self.copy_to_here(source=None, target=return_path)
         import pickle
         return pickle.loads(res.read_bytes())
 
@@ -344,28 +356,30 @@ obj=P(r'{source}').search(folders=False, r=True).collapseuser(strict=False)
         print("\n")
         return target_obj
 
-    def receieve(self, source: PLike, target: OPLike = None, z: bool = False, r: bool = False) -> PathExtended:
-        scout = self.run_py(cmd=f"obj=scout(r'{source}', z={z}, r={r})", desc=f"Scouting source `{source}` path on remote", return_obj=True, verbose=False)
-        assert isinstance(scout, Scout)
-        if not z and scout.is_dir and scout.files is not None:
-            if r:
-                tmp: list[PathExtended] = [self.receieve(source=file.as_posix(), target=PathExtended(target).joinpath(PathExtended(file).relative_to(source)) if target else None, r=False) for file in scout.files]
-                return tmp[0]
-            else:
-                print("Source is a directory! either set `r=True` for recursive sending or raise `zip_first=True` flag.")
-        if target:
-            target = PathExtended(target).expanduser().absolute()
-        else:
-            target = scout.source_rel2home.expanduser().absolute()
-        target.parent.mkdir(parents=True, exist_ok=True)
-        if z and ".zip" not in target.suffix:
-            target += ".zip"
-        source = scout.source_full
-        with self.tqdm_wrap(ascii=True, unit="b", unit_scale=True) as pbar:
-            self.sftp.get(remotepath=source.as_posix(), localpath=target.as_posix(), callback=pbar.view_bar)  # type: ignore # pylint: disable=E1129
-        if z:
-            target = target.unzip(inplace=True, content=True)
-            self.run_py(f"""
-            from machineconfig.utils.path_extended import PathExtended as P; P(r'{source.as_posix()}').delete(sure=True)""", desc="Cleaning temp zip files @ remote.", strict_returncode=True, strict_err=True)
-        print("\n")
-        return target
+#     def receieve(self, source: PLike, target: OPLike = None, z: bool = False, r: bool = False) -> PathExtended:
+#         scout = self.run_py(cmd=f"obj=scout(r'{source}', z={z}, r={r})", desc=f"Scouting source `{source}` path on remote", return_obj=True, verbose=False)
+#         assert isinstance(scout, Scout)
+#         if not z and scout.is_dir and scout.files is not None:
+#             if r:
+#                 tmp: list[PathExtended] = [self.receieve(source=file.as_posix(), target=PathExtended(target).joinpath(PathExtended(file).relative_to(source)) if target else None, r=False) for file in scout.files]
+#                 return tmp[0]
+#             else:
+#                 print("Source is a directory! either set `r=True` for recursive sending or raise `zip_first=True` flag.")
+#         if target:
+#             target = PathExtended(target).expanduser().absolute()
+#         else:
+#             target = scout.source_rel2home.expanduser().absolute()
+#         target.parent.mkdir(parents=True, exist_ok=True)
+#         if z and ".zip" not in target.suffix:
+#             target += ".zip"
+#         source = scout.source_full
+#         with self.tqdm_wrap(ascii=True, unit="b", unit_scale=True) as pbar:
+#             self.sftp.get(remotepath=source.as_posix(), localpath=target.as_posix(), callback=pbar.view_bar)  # type: ignore # pylint: disable=E1129
+#         if z:
+#             target = target.unzip(inplace=True, content=True)
+#             self.run_py(f"""
+# from machineconfig.utils.path_extended import PathExtended as P;
+# P(r'{source.as_posix()}').delete(sure=True)
+# """, desc="Cleaning temp zip files @ remote.", strict_returncode=True, strict_err=True)
+#         print("\n")
+#         return target

{machineconfig-5.59 → machineconfig-5.60/src/machineconfig.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 5.59
+Version: 5.60
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0
@@ -27,6 +27,7 @@ Requires-Dist: pyjson5>=1.6.9
 Requires-Dist: questionary>=2.1.1
 Requires-Dist: typer-slim>=0.19.2
 Requires-Dist: typer>=0.19.2
+Requires-Dist: textual>=6.2.1
 Provides-Extra: windows
 Requires-Dist: pywin32; extra == "windows"
 Provides-Extra: plot

{machineconfig-5.59 → machineconfig-5.60}/src/machineconfig.egg-info/SOURCES.txt

@@ -134,7 +134,6 @@ src/machineconfig/scripts/python/cloud.py
 src/machineconfig/scripts/python/croshell.py
 src/machineconfig/scripts/python/devops.py
 src/machineconfig/scripts/python/devops_navigator.py
-src/machineconfig/scripts/python/devops_navigator.py.backup
 src/machineconfig/scripts/python/fire_jobs.py
 src/machineconfig/scripts/python/ftpx.py
 src/machineconfig/scripts/python/interactive.py
@@ -196,6 +195,9 @@ src/machineconfig/scripts/python/devops_helpers/devops_update_repos.py
 src/machineconfig/scripts/python/devops_helpers/themes/__init__.py
 src/machineconfig/scripts/python/devops_helpers/themes/choose_pwsh_theme.ps1
 src/machineconfig/scripts/python/devops_helpers/themes/choose_wezterm_theme.py
+src/machineconfig/scripts/python/env_manager/__init__.py
+src/machineconfig/scripts/python/env_manager/path_manager_backend.py
+src/machineconfig/scripts/python/env_manager/path_manager_tui.py
 src/machineconfig/scripts/python/helpers_fire/__init__.py
 src/machineconfig/scripts/python/helpers_fire/fire_agents_help_launch.py
 src/machineconfig/scripts/python/helpers_fire/fire_agents_help_search.py

{machineconfig-5.59 → machineconfig-5.60}/src/machineconfig.egg-info/requires.txt

@@ -14,6 +14,7 @@ pyjson5>=1.6.9
 questionary>=2.1.1
 typer-slim>=0.19.2
 typer>=0.19.2
+textual>=6.2.1
 
 [plot]
 duckdb-engine>=0.17.0