machineconfig 5.23__tar.gz → 5.24__tar.gz

machineconfig-5.24/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: machineconfig
+Version: 5.24
+Summary: Dotfiles management package
+Author-email: Alex Al-Saffar <programmer@usa.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/thisismygitrepo/machineconfig
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/machineconfig/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: cryptography>=44.0.2
+Requires-Dist: fire>=0.7.0
+Requires-Dist: joblib>=1.5.2
+Requires-Dist: paramiko>=3.5.1
+Requires-Dist: randomname>=0.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.0.0
+Requires-Dist: tenacity>=9.1.2
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: gitpython>=3.1.44
+Requires-Dist: pyfzf>=0.3.1
+Requires-Dist: rclone-python>=0.1.23
+Requires-Dist: pyjson5>=1.6.9
+Requires-Dist: typer-slim>=0.19.2
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: typer>=0.19.2
+Provides-Extra: windows
+Requires-Dist: pywin32; extra == "windows"
+Provides-Extra: docs
+Requires-Dist: pdoc>=15.0.2; extra == "docs"
+
+
+<p align="center">
+
+<a href="https://github.com/thisismygitrepo/machineconfig/commits">
+<img src="https://img.shields.io/github/commit-activity/m/thisismygitrepo/machineconfig" />
+</a>
+
+</p>
+
+
+# Welcome to machineconfig
+
+# Shortcuts
+* `bit.ly/cfgroot` is a shortcut to this repo.
+* `glow https://bit.ly/cfgread` OR `curl bit.ly/cfgread -L | bat -l md --style="header"` to get the readme file.
+
+Machineconfig is a package for managing configuration files (aka dotfiles). The idea is to collect those critical, time-consuming-files-to-setup in one directory and reference them via symbolic links from their original locations. Thus, when a new machine is to be setup, all that is required is to clone the repo in that machine and create the symbolic links.
+Dotfiles include, but are not limited to:
+* `~/.gitconfig`
+* `~/.ssh`
+* `~/.aws`
+* `~/.bash_profile`
+* `~/.bashrc`
+* `~/.config`
+* `$profile` in Windows Powershell
+* etc
+
+
+Additionally, files that contain data, sensitive information that should not be pushed to a repository are contained in a directory `~/dotfiles`. The files therein are encrypted before backedup.
+
+
+# Windows:
+```powershell
+iex (iwr bit.ly/cfgiawindows).Content
+```
+
+# Linux and MacOS
+```bash
+. <(curl -sL bit.ly/cfgialinux)
+```
+
+
+# Author
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+[![Alex's github activity graph](https://github-readme-activity-graph.vercel.app/graph?username=thisismygitrepo)](https://github.com/ashutosh00710/github-readme-activity-graph)
+

machineconfig-5.24/README.md

@@ -0,0 +1,47 @@
+
+<p align="center">
+
+<a href="https://github.com/thisismygitrepo/machineconfig/commits">
+<img src="https://img.shields.io/github/commit-activity/m/thisismygitrepo/machineconfig" />
+</a>
+
+</p>
+
+
+# Welcome to machineconfig
+
+# Shortcuts
+* `bit.ly/cfgroot` is a shortcut to this repo.
+* `glow https://bit.ly/cfgread` OR `curl bit.ly/cfgread -L | bat -l md --style="header"` to get the readme file.
+
+Machineconfig is a package for managing configuration files (aka dotfiles). The idea is to collect those critical, time-consuming-files-to-setup in one directory and reference them via symbolic links from their original locations. Thus, when a new machine is to be setup, all that is required is to clone the repo in that machine and create the symbolic links.
+Dotfiles include, but are not limited to:
+* `~/.gitconfig`
+* `~/.ssh`
+* `~/.aws`
+* `~/.bash_profile`
+* `~/.bashrc`
+* `~/.config`
+* `$profile` in Windows Powershell
+* etc
+
+
+Additionally, files that contain data, sensitive information that should not be pushed to a repository are contained in a directory `~/dotfiles`. The files therein are encrypted before backedup.
+
+
+# Windows:
+```powershell
+iex (iwr bit.ly/cfgiawindows).Content
+```
+
+# Linux and MacOS
+```bash
+. <(curl -sL bit.ly/cfgialinux)
+```
+
+
+# Author
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+[![Alex's github activity graph](https://github-readme-activity-graph.vercel.app/graph?username=thisismygitrepo)](https://github.com/ashutosh00710/github-readme-activity-graph)
+

{machineconfig-5.23 → machineconfig-5.24}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "5.23"
+version = "5.24"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}

{machineconfig-5.23 → machineconfig-5.24}/src/machineconfig/cluster/sessions_managers/zellij_utils/example_usage.py

@@ -30,15 +30,8 @@ def example_usage():
 
     try:
         # Create layout using the remote generator
-        generator = ZellijRemoteLayoutGenerator(remote_name=remote_name, session_name_prefix=session_name)
-
-        # Create layout file
-        import tempfile
-        with tempfile.NamedTemporaryFile(mode="w", suffix=".kdl", delete=False, prefix="zellij_example_") as tmp_file:
-            output_path = tmp_file.name
-        layout_path = generator.create_zellij_layout(sample_layout, output_path)
-        print(f"✅ Remote layout created successfully: {layout_path}")
-
+        generator = ZellijRemoteLayoutGenerator(remote_name=remote_name, session_name=session_name, layout_config=sample_layout)
+        generator.create_layout_file()
         # Preview the layout content
         preview = generator.layout_generator.generate_layout_content(sample_layout)
         print(f"📄 Layout preview:\n{preview}")

{machineconfig-5.23 → machineconfig-5.24}/src/machineconfig/scripts/python/interactive.py

@@ -35,9 +35,45 @@ console = Console()
 
 def display_header() -> None:
     from machineconfig.utils.installer import get_machineconfig_version
-    header_text = Text(f"MACHINE CONFIGURATION {get_machineconfig_version()}", 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)))
+    from rich.align import Align
+    from rich.padding import Padding
+
+    # Fancy ASCII art header
+    ascii_art = """
+    ╔═════════════════════════════════════════════════════════════════════════════════════════════════════════════╗
+    ║                                                                                                             ║
+    ║   ███╗   ███╗ █████╗  ██████╗██╗  ██╗██╗███╗   ██╗███████╗ ██████╗ ██████╗ ███╗   ██╗███████╗██╗ ██████╗    ║
+    ║   ████╗ ████║██╔══██╗██╔════╝██║  ██║██║████╗  ██║██╔════╝██╔════╝██╔═══██╗████╗  ██║██╔════╝██║██╔════╝    ║
+    ║   ██╔████╔██║███████║██║     ███████║██║██╔██╗ ██║█████╗  ██║     ██║   ██║██╔██╗ ██║█████╗  ██║██║  ███╗   ║
+    ║   ██║╚██╔╝██║██╔══██║██║     ██╔══██║██║██║╚██╗██║██╔══╝  ██║     ██║   ██║██║╚██╗██║██╔══╝  ██║██║   ██║   ║
+    ║   ██║ ╚═╝ ██║██║  ██║╚██████╗██║  ██║██║██║ ╚████║███████╗╚██████╗╚██████╔╝██║ ╚████║██║     ██║╚██████╔╝   ║
+    ║   ╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚══════╝ ╚═════╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝     ╚═╝ ╚═════╝    ║
+    ║                                                                                                             ║
+    ╚═════════════════════════════════════════════════════════════════════════════════════════════════════════════╝
+    """
+
+    version = get_machineconfig_version()
+    title = f"✨ MACHINE CONFIGURATION v{version} ✨"
+    subtitle = "🎯 Your digital life manager. Dotfiles, data, code and more."
+    bug_report = "🐛 Please report bugs to Alex Al-Saffar @ https://github.com/thisismygitrepo/machineconfig"
+
+    # Create styled texts
+    ascii_text = Text(ascii_art, style="bold cyan")
+    title_text = Text(title, style="bold bright_magenta")
+    subtitle_text = Text(subtitle, style="italic bright_blue")
+    bug_text = Text(bug_report, style="dim white")
+
+    # Create panel content with proper alignment
+    with console.capture() as capture:
+        console.print(ascii_text)
+        console.print()
+        console.print(Align.center(title_text))
+        console.print(Align.center(subtitle_text))
+        console.print()
+        console.print(Align.center(bug_text))
+
+    panel_content = capture.get()
+    console.print(Panel(Padding(panel_content, (1, 2)), border_style="bright_cyan", padding=(1, 2)))
 def display_completion_message() -> None:
     completion_text = Text("INSTALLATION COMPLETE", style="bold green")
     subtitle_text = Text("System setup finished successfully", style="italic green")

{machineconfig-5.23 → machineconfig-5.24}/src/machineconfig/setup_linux/ve.sh

@@ -8,13 +8,8 @@ else
     echo """🔄 Updating uv package manager..."""
     $HOME/.local/bin/uv self update
 fi
-# Add uv to PATH if not already there
 if ! command -v uv &> /dev/null; then
-    echo """🔍 uv command not found in PATH
-   ➕ Adding uv to system PATH...
-"""
+    echo """🔍 uv command not found in PATH ➕ Adding uv to system PATH..."""
     export PATH="$HOME/.local/bin:$PATH"
 fi
-echo """✅ uv is installed and ready to use."""
-
 $HOME/.local/bin/uv python install 3.13

machineconfig-5.24/src/machineconfig/setup_linux/web_shortcuts/interactive.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+. <( curl -sSL "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/ve.sh")
+$HOME/.local/bin/uv run --python 3.13 --with machineconfig devops self interactive

{machineconfig-5.23 → machineconfig-5.24}/src/machineconfig/setup_windows/ve.ps1

@@ -7,5 +7,4 @@ if (-not (Test-Path -Path "$HOME\.local\bin\uv.exe")) {
     Write-Output "uv binary found, updating..."
     & "$HOME\.local\bin\uv.exe" self update
 }
-
 & "$HOME\.local\bin\uv.exe" python install 3.13

machineconfig-5.24/src/machineconfig/setup_windows/web_shortcuts/interactive.ps1

@@ -0,0 +1,5 @@
+
+
+Write-Host "ℹ️  If you have execution policy issues, run: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser"
+iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/ve.ps1").Content
+uv run --python 3.13 --with machineconfig devops self interactive

machineconfig-5.24/src/machineconfig.egg-info/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: machineconfig
+Version: 5.24
+Summary: Dotfiles management package
+Author-email: Alex Al-Saffar <programmer@usa.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/thisismygitrepo/machineconfig
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/machineconfig/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: cryptography>=44.0.2
+Requires-Dist: fire>=0.7.0
+Requires-Dist: joblib>=1.5.2
+Requires-Dist: paramiko>=3.5.1
+Requires-Dist: randomname>=0.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.0.0
+Requires-Dist: tenacity>=9.1.2
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: gitpython>=3.1.44
+Requires-Dist: pyfzf>=0.3.1
+Requires-Dist: rclone-python>=0.1.23
+Requires-Dist: pyjson5>=1.6.9
+Requires-Dist: typer-slim>=0.19.2
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: typer>=0.19.2
+Provides-Extra: windows
+Requires-Dist: pywin32; extra == "windows"
+Provides-Extra: docs
+Requires-Dist: pdoc>=15.0.2; extra == "docs"
+
+
+<p align="center">
+
+<a href="https://github.com/thisismygitrepo/machineconfig/commits">
+<img src="https://img.shields.io/github/commit-activity/m/thisismygitrepo/machineconfig" />
+</a>
+
+</p>
+
+
+# Welcome to machineconfig
+
+# Shortcuts
+* `bit.ly/cfgroot` is a shortcut to this repo.
+* `glow https://bit.ly/cfgread` OR `curl bit.ly/cfgread -L | bat -l md --style="header"` to get the readme file.
+
+Machineconfig is a package for managing configuration files (aka dotfiles). The idea is to collect those critical, time-consuming-files-to-setup in one directory and reference them via symbolic links from their original locations. Thus, when a new machine is to be setup, all that is required is to clone the repo in that machine and create the symbolic links.
+Dotfiles include, but are not limited to:
+* `~/.gitconfig`
+* `~/.ssh`
+* `~/.aws`
+* `~/.bash_profile`
+* `~/.bashrc`
+* `~/.config`
+* `$profile` in Windows Powershell
+* etc
+
+
+Additionally, files that contain data, sensitive information that should not be pushed to a repository are contained in a directory `~/dotfiles`. The files therein are encrypted before backedup.
+
+
+# Windows:
+```powershell
+iex (iwr bit.ly/cfgiawindows).Content
+```
+
+# Linux and MacOS
+```bash
+. <(curl -sL bit.ly/cfgialinux)
+```
+
+
+# Author
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+[![Alex's github activity graph](https://github-readme-activity-graph.vercel.app/graph?username=thisismygitrepo)](https://github.com/ashutosh00710/github-readme-activity-graph)
+

machineconfig-5.23/PKG-INFO

@@ -1,188 +0,0 @@
-Metadata-Version: 2.4
-Name: machineconfig
-Version: 5.23
-Summary: Dotfiles management package
-Author-email: Alex Al-Saffar <programmer@usa.com>
-License: Apache 2.0
-Project-URL: Homepage, https://github.com/thisismygitrepo/machineconfig
-Project-URL: Bug Tracker, https://github.com/thisismygitrepo/machineconfig/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.13
-Description-Content-Type: text/markdown
-Requires-Dist: cryptography>=44.0.2
-Requires-Dist: fire>=0.7.0
-Requires-Dist: joblib>=1.5.2
-Requires-Dist: paramiko>=3.5.1
-Requires-Dist: randomname>=0.2.1
-Requires-Dist: requests>=2.32.5
-Requires-Dist: rich>=14.0.0
-Requires-Dist: tenacity>=9.1.2
-Requires-Dist: psutil>=7.0.0
-Requires-Dist: gitpython>=3.1.44
-Requires-Dist: pyfzf>=0.3.1
-Requires-Dist: rclone-python>=0.1.23
-Requires-Dist: pyjson5>=1.6.9
-Requires-Dist: typer-slim>=0.19.2
-Requires-Dist: questionary>=2.1.1
-Requires-Dist: typer>=0.19.2
-Provides-Extra: windows
-Requires-Dist: pywin32; extra == "windows"
-Provides-Extra: docs
-Requires-Dist: pdoc>=15.0.2; extra == "docs"
-
-
-<p align="center">
-
-<a href="https://github.com/thisismygitrepo/machineconfig/commits">
-<img src="https://img.shields.io/github/commit-activity/m/thisismygitrepo/machineconfig" />
-</a>
-
-</p>
-
-
-# Welcome to machineconfig
-
-# Shortcuts
-* `bit.ly/cfgroot` is a shortcut to this repo.
-* `glow https://bit.ly/cfgread` OR `curl bit.ly/cfgread -L | bat -l md --style="header"` to get the readme file.
-
-Machineconfig is a package for managing configuration files (aka dotfiles). The idea is to collect those critical, time-consuming-files-to-setup in one directory and reference them via symbolic links from their original locations. Thus, when a new machine is to be setup, all that is required is to clone the repo in that machine and create the symbolic links.
-Dotfiles include, but are not limited to:
-* `~/.gitconfig`
-* `~/.ssh`
-* `~/.aws`
-* `~/.bash_profile`
-* `~/.bashrc`
-* `~/.config`
-* `$profile` in Windows Powershell
-* etc
-
-
-Additionally, files that contain data, sensitive information that should not be pushed to a repository are contained in a directory `~/dotfiles`. The files therein are encrypted before backedup.
-
-
-## Windows Setup
-With elevated `PowerShell`, run the following: (short `curl bit.ly/cfgallwindows -L | iex`)
-
-**You have to have `winget` first. If its not available in the your terminal, try those resources:**
-
-* https://github.com/asheroto/winget-install
-* https://github.com/microsoft/winget-cli
-* https://github.com/microsoft/winget-cli/discussions/3258
-
-
-```shell
-# apps  # short: `(iwr bit.ly/cfgappswindows).Content | iex`
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/apps.ps1 | Invoke-Expression
-# virtual enviornment  # short (iwr bit.ly/cfgvewindows).Content | iex OR `curl bit.ly/cfgvewindows -L | iex`
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/ve.ps1 | Invoke-Expression
-# symlinks # short `(iwr bit.ly/cfgsymlinkswindows).Content | iex` OR `curl bit.ly/cfgsymlinkswindows -L | iex`
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-# devapps:
-$HOME/code/machineconfig/src/machineconfig/setup_windows/devapps.ps1
-# pwsh and wt settings: (iwr bit.ly/cfgwt).Content | iex
-iwr https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/wt_and_pwsh.ps1 | iex
-
-```
-
-```shell
-
-(iwr bit.ly/cfgappswindows).Content | iex
-(iwr bit.ly/cfgvewindows).Content | iex
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/devapps.ps1
-(iwr bit.ly/cfgwt).Content | iex
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-
-& "$HOME\code\machineconfig\.venv\Scripts\activate.ps1"
-python -m fire machineconfig.profile.create main2 --choice=all
-deactivate
-
-```
-
-###### Setup SSH connection:
-```shell
-# CHANGE pubkey_string APPROPRIATELY
-$pubkey_string=(Invoke-WebRequest 'https://github.com/thisismygitrepo.keys').Content
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/openssh_all.ps1 | Invoke-Expression
-```
-short `(iwr bit.ly/cfgsshwindows).Content | iex` OR `curl bit.ly/cfgsshwindows -L | iex`
-
-###### Install Croshell Terminal Directly,
-```shell
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/web_shortcuts/croshell.ps1 | Invoke-Expression
-```
-short: `curl bit.ly/cfgcroshellwindows -L | iex` OR `(iwr bit.ly/cfgcroshellwindows).Content | iex`
-
-
-# Linux Setup
-With `sudo` access, run the following: (short `curl bit.ly/cfgalllinux -L | bash`)
-```bash
-export package_manager="nala"
-export package_manager="nix"
-
-# apps  # short: `curl bit.ly/cfgappslinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps.sh | bash
-# Optionally: curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps_dev.sh | bash
-
-# virtual enviornment  # short `curl bit.ly/cfgvelinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/ve.sh | bash
-
-# repos  # short `curl bit.ly/cfgreposlinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/repos.sh | bash
-# symlinks and bash profile: # short `curl bit.ly/cfgsymlinkslinux -L | bash`
-source ~/code/machineconfig/src/machineconfig/setup_linux/symlinks.sh  # requires sudo since it invloves chmod of dotfiles/.ssh, however sudo doesn't work with source. best to have sudo -s earlier.
-
-# devapps
-source <(sudo cat ~/code/machineconfig/src/machineconfig/setup_linux/devapps.sh)
-```
-
-###### Setup SSH connection:
-```bash
-pubkey_url='https://github.com/thisismygitrepo.keys'  # (CHANGE APPROPRIATELY)
-export pubkey_string=$(curl --silent $pubkey_url)
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_all.sh | sudo bash
-# For WSL only, also run the following:
-export port=2223
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_wsl.sh | sudo bash
-# don't forget to run `wsl_ssh_windows_port_forwarding -p 2223` from Windows using the designated port with
-```
-short `curl bit.ly/cfgsshlinux -L | bash`
-
-
-###### Install Croshell Terminal Directly
-
-```bash
-
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/web_shortcuts/croshell.sh | sudo bash
-
-```
-short `curl bit.ly/cfgcroshelllinux -L | bash`
-
-
-## Repository management CLI
-
-The DevOps CLI now exposes rich subcommands for working with git repositories. Run `python -m machineconfig.scripts.python.devops repos --help` to explore the hierarchy:
-
-* Top-level actions: `push`, `pull`, `commit`, `all`, and `analyze`.
-	* These commands accept `--recursive/-r` and `--no-sync` to control nested repos and automatic `uv sync`.
-* Sync workflows live under `sync`:
-	* `record` captures the current machine state into a `repos.json`.
-	* `capture` clones repos from a specification without changing commits.
-	* `checkout` aligns repositories to commits stored in the spec.
-	* `checkout-to-branch` switches repositories to the tracked branch.
-	* Each sync subcommand accepts `--cloud/-c` for fetching/saving specs from remote storage.
-
-Example:
-
-```bash
-python -m machineconfig.scripts.python.devops repos sync record ~/code --cloud my_remote
-python -m machineconfig.scripts.python.devops repos pull ~/code --recursive
-```
-
-# Author
-Alex Al-Saffar. [email](mailto:programmer@usa.com)
-
-[![Alex's github activity graph](https://github-readme-activity-graph.vercel.app/graph?username=thisismygitrepo)](https://github.com/ashutosh00710/github-readme-activity-graph)
-

machineconfig-5.23/README.md

@@ -1,154 +0,0 @@
-
-<p align="center">
-
-<a href="https://github.com/thisismygitrepo/machineconfig/commits">
-<img src="https://img.shields.io/github/commit-activity/m/thisismygitrepo/machineconfig" />
-</a>
-
-</p>
-
-
-# Welcome to machineconfig
-
-# Shortcuts
-* `bit.ly/cfgroot` is a shortcut to this repo.
-* `glow https://bit.ly/cfgread` OR `curl bit.ly/cfgread -L | bat -l md --style="header"` to get the readme file.
-
-Machineconfig is a package for managing configuration files (aka dotfiles). The idea is to collect those critical, time-consuming-files-to-setup in one directory and reference them via symbolic links from their original locations. Thus, when a new machine is to be setup, all that is required is to clone the repo in that machine and create the symbolic links.
-Dotfiles include, but are not limited to:
-* `~/.gitconfig`
-* `~/.ssh`
-* `~/.aws`
-* `~/.bash_profile`
-* `~/.bashrc`
-* `~/.config`
-* `$profile` in Windows Powershell
-* etc
-
-
-Additionally, files that contain data, sensitive information that should not be pushed to a repository are contained in a directory `~/dotfiles`. The files therein are encrypted before backedup.
-
-
-## Windows Setup
-With elevated `PowerShell`, run the following: (short `curl bit.ly/cfgallwindows -L | iex`)
-
-**You have to have `winget` first. If its not available in the your terminal, try those resources:**
-
-* https://github.com/asheroto/winget-install
-* https://github.com/microsoft/winget-cli
-* https://github.com/microsoft/winget-cli/discussions/3258
-
-
-```shell
-# apps  # short: `(iwr bit.ly/cfgappswindows).Content | iex`
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/apps.ps1 | Invoke-Expression
-# virtual enviornment  # short (iwr bit.ly/cfgvewindows).Content | iex OR `curl bit.ly/cfgvewindows -L | iex`
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/ve.ps1 | Invoke-Expression
-# symlinks # short `(iwr bit.ly/cfgsymlinkswindows).Content | iex` OR `curl bit.ly/cfgsymlinkswindows -L | iex`
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-# devapps:
-$HOME/code/machineconfig/src/machineconfig/setup_windows/devapps.ps1
-# pwsh and wt settings: (iwr bit.ly/cfgwt).Content | iex
-iwr https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/wt_and_pwsh.ps1 | iex
-
-```
-
-```shell
-
-(iwr bit.ly/cfgappswindows).Content | iex
-(iwr bit.ly/cfgvewindows).Content | iex
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/devapps.ps1
-(iwr bit.ly/cfgwt).Content | iex
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-
-& "$HOME\code\machineconfig\.venv\Scripts\activate.ps1"
-python -m fire machineconfig.profile.create main2 --choice=all
-deactivate
-
-```
-
-###### Setup SSH connection:
-```shell
-# CHANGE pubkey_string APPROPRIATELY
-$pubkey_string=(Invoke-WebRequest 'https://github.com/thisismygitrepo.keys').Content
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/openssh_all.ps1 | Invoke-Expression
-```
-short `(iwr bit.ly/cfgsshwindows).Content | iex` OR `curl bit.ly/cfgsshwindows -L | iex`
-
-###### Install Croshell Terminal Directly,
-```shell
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/web_shortcuts/croshell.ps1 | Invoke-Expression
-```
-short: `curl bit.ly/cfgcroshellwindows -L | iex` OR `(iwr bit.ly/cfgcroshellwindows).Content | iex`
-
-
-# Linux Setup
-With `sudo` access, run the following: (short `curl bit.ly/cfgalllinux -L | bash`)
-```bash
-export package_manager="nala"
-export package_manager="nix"
-
-# apps  # short: `curl bit.ly/cfgappslinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps.sh | bash
-# Optionally: curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps_dev.sh | bash
-
-# virtual enviornment  # short `curl bit.ly/cfgvelinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/ve.sh | bash
-
-# repos  # short `curl bit.ly/cfgreposlinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/repos.sh | bash
-# symlinks and bash profile: # short `curl bit.ly/cfgsymlinkslinux -L | bash`
-source ~/code/machineconfig/src/machineconfig/setup_linux/symlinks.sh  # requires sudo since it invloves chmod of dotfiles/.ssh, however sudo doesn't work with source. best to have sudo -s earlier.
-
-# devapps
-source <(sudo cat ~/code/machineconfig/src/machineconfig/setup_linux/devapps.sh)
-```
-
-###### Setup SSH connection:
-```bash
-pubkey_url='https://github.com/thisismygitrepo.keys'  # (CHANGE APPROPRIATELY)
-export pubkey_string=$(curl --silent $pubkey_url)
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_all.sh | sudo bash
-# For WSL only, also run the following:
-export port=2223
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_wsl.sh | sudo bash
-# don't forget to run `wsl_ssh_windows_port_forwarding -p 2223` from Windows using the designated port with
-```
-short `curl bit.ly/cfgsshlinux -L | bash`
-
-
-###### Install Croshell Terminal Directly
-
-```bash
-
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/web_shortcuts/croshell.sh | sudo bash
-
-```
-short `curl bit.ly/cfgcroshelllinux -L | bash`
-
-
-## Repository management CLI
-
-The DevOps CLI now exposes rich subcommands for working with git repositories. Run `python -m machineconfig.scripts.python.devops repos --help` to explore the hierarchy:
-
-* Top-level actions: `push`, `pull`, `commit`, `all`, and `analyze`.
-	* These commands accept `--recursive/-r` and `--no-sync` to control nested repos and automatic `uv sync`.
-* Sync workflows live under `sync`:
-	* `record` captures the current machine state into a `repos.json`.
-	* `capture` clones repos from a specification without changing commits.
-	* `checkout` aligns repositories to commits stored in the spec.
-	* `checkout-to-branch` switches repositories to the tracked branch.
-	* Each sync subcommand accepts `--cloud/-c` for fetching/saving specs from remote storage.
-
-Example:
-
-```bash
-python -m machineconfig.scripts.python.devops repos sync record ~/code --cloud my_remote
-python -m machineconfig.scripts.python.devops repos pull ~/code --recursive
-```
-
-# Author
-Alex Al-Saffar. [email](mailto:programmer@usa.com)
-
-[![Alex's github activity graph](https://github-readme-activity-graph.vercel.app/graph?username=thisismygitrepo)](https://github.com/ashutosh00710/github-readme-activity-graph)
-