machineconfig 1.94__tar.gz → 1.95__tar.gz

{machineconfig-1.94/src/machineconfig.egg-info → machineconfig-1.95}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 1.94
+Version: 1.95
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0
@@ -9,7 +9,7 @@ Project-URL: Bug Tracker, https://github.com/thisismygitrepo/machineconfig/issue
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: crocodile
 Requires-Dist: rich>=14.0.0
@@ -27,6 +27,8 @@ Requires-Dist: pyfzf>=0.3.1
 Requires-Dist: call-function-with-timeout>=1.1.1
 Provides-Extra: windows
 Requires-Dist: pywin32; extra == "windows"
+Provides-Extra: docs
+Requires-Dist: pdoc>=15.0.2; extra == "docs"
 
 
 <p align="center">

{machineconfig-1.94 → machineconfig-1.95}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "1.94"
+version = "1.95"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -18,7 +18,7 @@ classifiers = [
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
 ]
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
     "crocodile",
     "rich>=14.0.0",
@@ -40,6 +40,10 @@ dependencies = [
 windows = [
     "pywin32"
 ]
+# docs extra for documentation generation
+docs = [
+    "pdoc>=15.0.2"
+]
 
 [project.urls]
 "Homepage" = "https://github.com/thisismygitrepo/machineconfig"

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/cluster/data_transfer.py

@@ -2,7 +2,8 @@
 """
 
 
-from crocodile.file_management import P, List as L
+from crocodile.file_management import P
+from crocodile.core import List as L
 from machineconfig.cluster.remote_machine import RemoteMachine, FileManager
 
 

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/cluster/job_params.py

@@ -126,7 +126,7 @@ workload_params = []
 for idx, x in enumerate(kwargs_workload):
     S(x).print(as_config=True, title=f"Instance {{idx}}")
     workload_params.append(WorkloadParams(**x))
-print("\\n" * 2)
+print("\n" * 2)
 res = L(workload_params).apply(lambda a_workload_params: func(workload_params=a_workload_params, **func_kwargs), jobs={workload_params.jobs})
 """
         else: base += """

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/cluster/script_execution.py

@@ -153,7 +153,7 @@ kwargs_path @ `{manager.kwargs_path.collapseuser()}`
 
 # print to execution console:
 exec_times.print(title="⏱️ Execution Times", as_config=True)
-print("\n" + "─" * 60 + "\n")
+console.rule(title="", characters="─", style="blue")
 ssh_repr_remote = params.ssh_repr_remote or f"{getpass.getuser()}@{platform.node()}"  # os.getlogin() can throw an error in non-login shells.
 console.print(Panel(Text(f'''
 ftprx {ssh_repr_remote} {res_folder.collapseuser()} -r

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/linux/msc/lid.sh

@@ -5,8 +5,7 @@
 # This script disables suspension when laptop lid is closed
 # Reference: https://askubuntu.com/questions/141866/keep-ubuntu-server-running-on-a-laptop-with-the-lid-closed/1426611#1426611
 
-echo """
-#=======================================================================
+echo """#=======================================================================
 🔧 CONFIGURING | Modifying lid close behavior
 #=======================================================================
 """
@@ -18,8 +17,7 @@ sudo sed -i 's/#HandleLidSwitch=suspend/HandleLidSwitch=ignore/g' /etc/systemd/l
 echo "📝 Updating HandleLidSwitchExternalPower parameter..."
 sudo sed -i 's/#HandleLidSwitchExternalPower=suspend/HandleLidSwitchExternalPower=ignore/g' /etc/systemd/logind.conf
 
-echo """
-#=======================================================================
+echo """#=======================================================================
 ✅ COMPLETE | Lid close configuration has been updated
 #=======================================================================
 """

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/linux/msc/network.sh

@@ -5,15 +5,13 @@
 # This script fixes the "A start job is running for wait for network to be configured" issue
 # Reference: https://askubuntu.com/questions/972215/a-start-job-is-running-for-wait-for-network-to-be-configured-ubuntu-server-17-1
 
-echo """
-#=======================================================================
+echo """#=======================================================================
 🔧 CONFIGURING NETWORK | Making network interfaces optional
 #=======================================================================
 """
 
 echo "📋 Original network config format from 'subiquity':"
-echo """
-# network:
+echo """# network:
 #   ethernets:
 #     enp0s31f6:
 #       dhcp4: true
@@ -24,8 +22,7 @@ echo """
 echo "🔄 Modifying netplan configuration..."
 sudo sed -i 's/dhcp4: true/dhcp4: true\n      optional: true/g' /etc/netplan/00-installer-config.yaml
 
-echo """
-#=======================================================================
+echo """#=======================================================================
 ✅ COMPLETE | Network configuration has been updated
 #=======================================================================
 """

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python/check_installations.py

@@ -83,9 +83,9 @@ def main() -> None:
         #     print(f"➡️ Found version `{tmp}` for {an_app.stem}.")
         #     app_versions.append(None)
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🔍 TOOL CHECK | Checking tools (#{len(apps_paths_tmp)}) collected from `{INSTALL_VERSION_ROOT}`
-{'=' * 70}
+{'=' * 150}
 """)
     apps_paths_raw.print()
     positive_pct: list[Optional[float]] = []
@@ -120,9 +120,9 @@ def main() -> None:
     res_df.to_csv(APP_SUMMARY_PATH.with_suffix(".csv").create(parents_only=True), index=False)
     APP_SUMMARY_PATH.with_suffix(".md").write_text(res_df.to_markdown())
     print(f"""
-{'=' * 70}
+{'=' * 150}
 📊 SAFETY REPORT | Summary of app scanning results
-{'=' * 70}
+{'=' * 150}
 """)
     print(res_df)
 
@@ -176,9 +176,9 @@ class PrecheckedCloudInstaller:
 
         if name == "AllEssentials":
             print(f"""
-{'=' * 70}
+{'=' * 150}
 📥 DOWNLOAD | Downloading {self.df.shape[0]} apps...
-{'=' * 70}
+{'=' * 150}
 """)
             print(self.df)
             _res = L(self.df.app_url).apply(PrecheckedCloudInstaller.install_cli_apps, jobs=20)

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python/checkout_version.py

@@ -69,9 +69,9 @@ python -m pip freeze {'--exclude-editable' if exclude_editable else ''} > requir
 """
     Terminal().run_script(pip_freeze_script, verbose=True, shell="default").print()
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ✅ SUCCESS | Requirements for version {version} installed successfully
-{'=' * 70}
+{'=' * 150}
 """)
 
 
@@ -81,9 +81,9 @@ def main():
     try:
         repo = Repo(P.cwd(), search_parent_directories=True)
         print(f"""
-{'=' * 70}
+{'=' * 150}
 🔍 GIT REPO | Found repository at {repo.working_dir}
-{'=' * 70}
+{'=' * 150}
 """)
     except InvalidGitRepositoryError as err:
         print(f"""

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python/python_cargo_build_share.py

@@ -21,10 +21,10 @@ cd {tool_name}
 cargo install --path .
 """
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🦀 CARGO BUILD | Building Rust project: {tool_name}
 📦 Source: {url}
-{'=' * 70}
+{'=' * 150}
 """)
     if platform.system() == "Windows":
         Terminal(stdout=None).run(f". {P.tmpfile(suffix='.ps1').write_text(script)}", shell="pwsh").print()

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python/python_ve_symlink.py

@@ -7,9 +7,9 @@ from crocodile.file_management import P
 
 def main():
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🔗 SYMLINK CREATOR | Create symlinks for virtual environments
-{'=' * 70}
+{'=' * 150}
 """)
     target = P(input("🎯 Symlink to which target? ")).expanduser().absolute()
     source = input(f"📍 Symlink from which source? [default to: CWD/{target.name}] ") or P.cwd().joinpath(target.name)
@@ -18,11 +18,11 @@ def main():
     # P('.gitignore').modify_text('venv', 'venv', replace_line=True)"
     source.symlink_to(target, overwrite=True)
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ✅ SUCCESS | Symlink created successfully
 📍 Source: {source}
 🎯 Target: {target}
-{'=' * 70}
+{'=' * 150}
 """)
     return "echo '🔗 Finished creating symlink.'"
 

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python/vscode/api.py

@@ -20,13 +20,13 @@ code --profile bitProfile --new-window {file_path}
     from rich.syntax import Syntax
     from rich.panel import Panel
     console = Console()
-    console.print(f"\n{'=' * 70}")
+    console.print(f"\n{'=' * 150}")
     console.print(Panel(
         Syntax(code, lexer="bash"),
         title="🔍 VS CODE API | Opening file in new instance",
         subtitle=f"📂 {file_path}"
     ), style="bold blue")
-    console.print(f"{'=' * 70}\n")
+    console.print(f"{'=' * 150}\n")
 
     code_path = Path.home().joinpath(".config", "machingconfig", "vscode_api", "code_temp")
     code_path.parent.mkdir(parents=True, exist_ok=True)

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python/vscode/link_ve.py

@@ -10,10 +10,10 @@ import argparse
 
 def select_interpreter(workspace_root: str):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🔗 VSCODE VE LINKER | Linking virtual environment for VS Code
 📂 Workspace: {workspace_root}
-{'=' * 70}
+{'=' * 150}
 """)
     
     path = Path(workspace_root).joinpath('.ve_path')
@@ -44,11 +44,11 @@ def select_interpreter(workspace_root: str):
     venv_link.symlink_to(target=ve_path.expanduser().absolute())
     
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ✅ SUCCESS | Virtual environment linked successfully
 🔗 Link: {venv_link}
 🎯 Target: {ve_path.expanduser().absolute()}
-{'=' * 70}
+{'=' * 150}
 """)
 
 

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python/vscode/select_interpreter.py

@@ -10,10 +10,10 @@ import platform
 
 def select_interpreter(workspace_root: str):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🐍 PYTHON INTERPRETER | Setting up VS Code Python interpreter
 📂 Workspace: {workspace_root}
-{'=' * 70}
+{'=' * 150}
 """)
     
     path = Path(workspace_root).joinpath('.ve_path')
@@ -64,11 +64,11 @@ def select_interpreter(workspace_root: str):
     Save.json(obj=settings, path=work_space_settings, indent=4)
     
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ✅ SUCCESS | Python interpreter configured successfully
 🐍 Interpreter: {python_path}
 📄 Settings: {work_space_settings}
-{'=' * 70}
+{'=' * 150}
 """)
 
 

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python/vscode/sync_code.py

@@ -8,10 +8,10 @@ if config is None:
 
 def sync_remote(machine_name: str):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🔄 SYNC REMOTE | Initiating remote code synchronization
 🖥️  Target machine: {machine_name}
-{'=' * 70}
+{'=' * 150}
 """)
     
     machine_config = config.get(machine_name)
@@ -33,13 +33,13 @@ ssh -o "HostName={machine_config['HostName']}" -o "User={machine_config['User']}
     from rich.panel import Panel
 
     console = Console()
-    console.print(f"\n{'=' * 70}")
+    console.print(f"\n{'=' * 150}")
     console.print(Panel(
         Syntax(code, lexer="bash"),
         title=f"🔄 SYNC COMMAND | Connecting to {machine_name}",
         subtitle=f"🌐 Host: {machine_config['HostName']}"
     ), style="bold blue")
-    console.print(f"{'=' * 70}\n")
+    console.print(f"{'=' * 150}\n")
 
     code_path = Path.home().joinpath(".config", "machingconfig", "vscode_api", "code_temp")
     code_path.parent.mkdir(parents=True, exist_ok=True)
@@ -52,9 +52,9 @@ ssh -o "HostName={machine_config['HostName']}" -o "User={machine_config['User']}
     subprocess.run([str(code_path)], shell=True, check=True)
     
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ✅ SUCCESS | Remote sync completed successfully
 🖥️  Machine: {machine_name}
-{'=' * 70}
+{'=' * 150}
 """)
 

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/archive/ngrok.py

@@ -19,10 +19,10 @@ config_dict = {
 
 def main(version: Optional[str]):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🔄 NGROK INSTALLER | Setting up secure tunnels to localhost
 💻 Platform: {platform.system()}
-{'=' * 70}
+{'=' * 150}
 """)
     
     _ = version
@@ -50,10 +50,10 @@ sudo nala update && sudo nala install ngrok
         raise NotImplementedError(error_msg)
         
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ⚠️  SECURITY WARNING | ngrok has been flagged by some antivirus engines
 🛡️  Use at your own risk - flagged by 35% of antivirus engines
-{'=' * 70}
+{'=' * 150}
 """)
     return program
 

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/dev/aider.py

@@ -13,20 +13,20 @@ config_dict = {
 
 def main(version: Optional[str] = None):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🤖 AIDER INSTALLER | Installing AI code assistant
 💻 Platform: {platform.system()}
 🔄 Version: {'latest' if version is None else version}
-{'=' * 70}
+{'=' * 150}
 """)
     
     install_script = "uv tool install --force --python python3.12 aider-chat@latest"
     
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ✅ SUCCESS | Installation command prepared:
 📄 Command: {install_script}
-{'=' * 70}
+{'=' * 150}
 """)
     
     return install_script

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/dev/alacritty.py

@@ -17,11 +17,11 @@ config_dict = {
 
 def main(version: Optional[str]):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🖥️  ALACRITTY INSTALLER | Installing GPU-accelerated terminal emulator
 💻 Platform: {platform.system()}
 🔄 Version: {'latest' if version is None else version}
-{'=' * 70}
+{'=' * 150}
 """)
     
     _ = version
@@ -54,12 +54,12 @@ git clone https://github.com/alacritty/alacritty-theme ~/.config/alacritty/theme
         raise NotImplementedError(error_msg)
         
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ℹ️  INFO | Installation will proceed with the following steps:
 1️⃣  Install Alacritty using Cargo
 2️⃣  Create config directories
 3️⃣  Clone theme repository
-{'=' * 70}
+{'=' * 150}
 """)
     
     # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/dev/brave.py

@@ -18,11 +18,11 @@ config_dict = {
 
 def main(version: Optional[str]):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🦁 BRAVE BROWSER | Installing privacy-focused web browser
 💻 Platform: {platform.system()}
 🔄 Version: {'latest' if version is None else version}
-{'=' * 70}
+{'=' * 150}
 """)
     
     _ = version
@@ -48,13 +48,13 @@ winget install --Name "Brave Browser" --Id Brave.Brave --source winget --accept-
         raise NotImplementedError(error_msg)
     
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ℹ️  INFO | Brave Browser features:
 🔒 Built-in ad blocking
 🛡️ Privacy-focused browsing
 💨 Faster page loading
 🪙 Optional crypto rewards
-{'=' * 70}
+{'=' * 150}
 """)
     
     # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/dev/bypass_paywall.py

@@ -18,10 +18,10 @@ config_dict = {
 
 def main(version: Optional[str] = None):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🔓 BYPASS PAYWALL | Installing paywall bypass extension for Chrome
 🔄 Version: {'latest' if version is None else version}
-{'=' * 70}
+{'=' * 150}
 """)
     
     _ = version
@@ -33,14 +33,14 @@ def main(version: Optional[str] = None):
     extension_folder = P(folder).joinpath("bypass-paywalls-chrome-master")
     
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ✅ SUCCESS | Extension downloaded successfully
 📂 Location: {extension_folder}
 ℹ️  Next steps: 
 1️⃣  Open Chrome and navigate to chrome://extensions
 2️⃣  Enable Developer Mode (toggle in top right)
 3️⃣  Click "Load unpacked" and select the extension folder
-{'=' * 70}
+{'=' * 150}
 """)
     
     return ""

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/dev/code.py

@@ -17,11 +17,11 @@ config_dict = {
 
 def main(version: Optional[str] = None):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 💻 VS CODE INSTALLER | Setting up Visual Studio Code
 🖥️  Platform: {platform.system()}
 🔄 Version: {'latest' if version is None else version}
-{'=' * 70}
+{'=' * 150}
 """)
 
     if platform.system() == 'Linux':
@@ -45,14 +45,14 @@ def main(version: Optional[str] = None):
     _ = version
     
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ℹ️  INFO | VS Code features:
 📝 Powerful code editor with IntelliSense
 🧩 Thousands of extensions available
 🔍 Integrated debugging
 🔄 Git integration
 ⚙️  Highly customizable
-{'=' * 70}
+{'=' * 150}
 """)
     
     return install_script

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/dev/docker.py

@@ -18,11 +18,11 @@ config_dict = {
 
 def main(version: Optional[str]):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🐳 DOCKER INSTALLER | Setting up containerization platform
 💻 Platform: {platform.system()}
 🔄 Version: {'latest' if version is None else version}
-{'=' * 70}
+{'=' * 150}
 """)
     
     _ = version
@@ -50,14 +50,14 @@ def main(version: Optional[str]):
         raise NotImplementedError(error_msg)
         
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ℹ️  INFO | Docker features:
 📦 Container-based virtualization
 🚀 Simplified application deployment
 🔄 Consistent development environments
 🛡️ Isolated application environments
 📊 Efficient resource utilization
-{'=' * 70}
+{'=' * 150}
 """)
     
     # _res = Terminal(stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE).run_script(script=program, shell="default").print(desc="Running custom installer", capture=True)

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/dev/docker_desktop.py

@@ -26,11 +26,11 @@ config_dict = {
 
 def main(version: Optional[str]):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 🐳 DOCKER DESKTOP | Installing Docker Desktop for Ubuntu
 🔄 Version: {'latest' if version is None else version}
 📚 Source: https://docs.docker.com/desktop/install/ubuntu/
-{'=' * 70}
+{'=' * 150}
 """)
     
     _ = version
@@ -62,12 +62,12 @@ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin
 
 """
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ℹ️  INFO | After installation:
 🔹 Run 'sudo docker run hello-world' to verify installation
 🔹 Add your user to the docker group with 'sudo usermod -aG docker $USER'
 🔹 Log out and back in to apply group changes
-{'=' * 70}
+{'=' * 150}
 """)
     
     return code

{machineconfig-1.94 → machineconfig-1.95}/src/machineconfig/jobs/python_custom_installers/dev/espanso.py

@@ -18,11 +18,11 @@ config_dict = {
 
 def main(version: Optional[str]):
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ⚡ ESPANSO INSTALLER | Setting up text expansion tool
 🔄 Version: {'latest' if version is None else version}
 🔗 Source: https://github.com/espanso/espanso
-{'=' * 70}
+{'=' * 150}
 """)
     
     _ = version
@@ -35,18 +35,18 @@ def main(version: Optional[str]):
         env = os.environ["XDG_SESSION_TYPE"]
         if env == "wayland":
             print(f"""
-{'=' * 70}
+{'=' * 150}
 🖥️  DISPLAY SERVER | Wayland detected
 📦 Using Wayland-specific package
-{'=' * 70}
+{'=' * 150}
 """)
             config_dict["filename_template_linux_amd_64"] = "espanso-debian-wayland-amd64.deb"
         else:
             print(f"""
-{'=' * 70}
+{'=' * 150}
 🖥️  DISPLAY SERVER | X11 detected
 📦 Using X11-specific package
-{'=' * 70}
+{'=' * 150}
 """)
             config_dict["filename_template_linux_amd_64"] = "espanso-debian-x11-amd64.deb"
     else:
@@ -70,13 +70,13 @@ espanso install actually-all-emojis
     """
     
     print(f"""
-{'=' * 70}
+{'=' * 150}
 ✅ SUCCESS | Espanso installation completed
 📋 Post-installation steps:
 1️⃣  Register Espanso as a service
 2️⃣  Start the Espanso service
 3️⃣  Install the emoji package
-{'=' * 70}
+{'=' * 150}
 """)
     
     return config