machineconfig 1.91__tar.gz → 1.93__tar.gz

machineconfig-1.93/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: machineconfig
+Version: 1.93
+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.9
+Description-Content-Type: text/markdown
+Requires-Dist: crocodile
+Requires-Dist: rich
+Requires-Dist: paramiko
+Requires-Dist: gitpython
+Requires-Dist: pudb
+Requires-Dist: pyfzf
+Requires-Dist: clipboard
+Requires-Dist: psutil
+Requires-Dist: pydantic
+Requires-Dist: fire
+Requires-Dist: call-function-with-timeout
+Requires-Dist: openai
+Requires-Dist: nbformat
+Requires-Dist: streamlit
+Provides-Extra: windows
+Requires-Dist: pywin32; extra == "windows"
+
+
+<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\venvs\ve\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`
+
+
+# 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-1.93/README.md

@@ -0,0 +1,134 @@
+
+<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\venvs\ve\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`
+
+
+# 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-1.93/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=62", "wheel"]
+build-backend = "setuptools.build_meta"
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+[project]
+name = "machineconfig"
+version = "1.93"
+description = "Dotfiles management package"
+readme = "README.md"
+license = {text = "Apache 2.0"}
+authors = [
+    {name = "Alex Al-Saffar", email = "programmer@usa.com"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "crocodile",
+    "rich",
+    "paramiko",
+    "gitpython",
+    "pudb",
+    "pyfzf",
+    "clipboard",
+    "psutil",
+    "pydantic",
+    "fire",
+    "call-function-with-timeout",
+    "openai",
+    "nbformat",
+    "streamlit",
+]
+
+[project.optional-dependencies]
+windows = [
+    "pywin32"
+]
+
+[project.urls]
+"Homepage" = "https://github.com/thisismygitrepo/machineconfig"
+"Bug Tracker" = "https://github.com/thisismygitrepo/machineconfig/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+license-files = []
+
+[tool.setuptools.packages.find]
+where = ["src"]

machineconfig-1.93/src/machineconfig/__init__.py

@@ -0,0 +1,8 @@
+
+"""DS
+"""
+
+__version__ = "1.92"
+release_notes = """
+included settings
+"""

machineconfig-1.93/src/machineconfig/jobs/linux/msc/lid.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+#=======================================================================
+# 💻 LAPTOP LID CONFIGURATION 🔌
+#=======================================================================
+# 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 """
+#=======================================================================
+🔧 CONFIGURING | Modifying lid close behavior
+#=======================================================================
+"""
+
+# Edit file: /etc/systemd/logind.conf and adjust lid handling parameters
+echo "📝 Updating HandleLidSwitch parameter..."
+sudo sed -i 's/#HandleLidSwitch=suspend/HandleLidSwitch=ignore/g' /etc/systemd/logind.conf
+
+echo "📝 Updating HandleLidSwitchExternalPower parameter..."
+sudo sed -i 's/#HandleLidSwitchExternalPower=suspend/HandleLidSwitchExternalPower=ignore/g' /etc/systemd/logind.conf
+
+echo """
+#=======================================================================
+✅ COMPLETE | Lid close configuration has been updated
+#=======================================================================
+"""
+echo "ℹ️ You may need to restart the systemd-logind service or reboot for changes to take effect"

machineconfig-1.93/src/machineconfig/jobs/linux/msc/network.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+#=======================================================================
+# 🌐 NETWORK CONFIGURATION SCRIPT 🌐
+#=======================================================================
+# 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 """
+#=======================================================================
+🔧 CONFIGURING NETWORK | Making network interfaces optional
+#=======================================================================
+"""
+
+echo "📋 Original network config format from 'subiquity':"
+echo """
+# network:
+#   ethernets:
+#     enp0s31f6:
+#       dhcp4: true
+#       optional: true
+#   version: 2
+"""
+
+echo "🔄 Modifying netplan configuration..."
+sudo sed -i 's/dhcp4: true/dhcp4: true\n      optional: true/g' /etc/netplan/00-installer-config.yaml
+
+echo """
+#=======================================================================
+✅ COMPLETE | Network configuration has been updated
+#=======================================================================
+"""
+echo "ℹ️ You may need to run 'sudo netplan apply' for changes to take effect"
+
+# Additional references:
+# - sed/awk editing: https://unix.stackexchange.com/questions/642578/command-line-for-editing-a-configuration-file-value-without-an-interactive-edito
+# - shell script file format: https://askubuntu.com/questions/304999/not-able-to-execute-a-sh-file-bin-bashm-bad-interpreter
+# - plocate: https://unix.stackexchange.com/questions/113670/can-i-just-disable-updatedb/113681#113681
+# - mlocate performance: https://askubuntu.com/questions/1251484/why-does-it-take-so-much-time-to-initialize-mlocate-database
+

machineconfig-1.93/src/machineconfig/jobs/python/check_installations.py

@@ -0,0 +1,196 @@
+"""CI
+"""
+
+
+import time
+import pandas as pd
+import platform
+from rich.console import Console
+# from rich.progress import track
+from machineconfig.utils.utils import LIBRARY_ROOT, INSTALL_VERSION_ROOT
+from machineconfig.utils.installer import get_installed_cli_apps
+from crocodile.core import List as L, install_n_import, Struct
+from crocodile.file_management import P
+from crocodile.meta import Terminal
+from tqdm import tqdm
+from typing import Optional
+from datetime import datetime
+
+
+APP_SUMMARY_PATH = LIBRARY_ROOT.joinpath(f"profile/records/{platform.system().lower()}/apps_summary_report.csv")
+CLOUD: str = "gdw"  # Read.ini(DEFAULTS_PATH)['general']['rclone_config_name']
+# my onedrive doesn't allow sharing.
+
+
+def scan(path: P, pct: float = 0.0):
+    vt = install_n_import(library="vt", package="vt-py")
+    client = vt.Client(P.home().joinpath("dotfiles/creds/tokens/virustotal").read_text().split("\n")[0])
+    console = Console()
+    console.rule(f"Scanning {path}. {pct:.2f}% done")
+    if path.is_dir():
+        print(f"📁 Skipping {path} as it is a directory.")
+        return None
+    with open(str(path), "rb") as f:
+        analysis = client.scan_file(f)
+    repeat_counter: int = 0
+    while True:
+        with console.status(f"waiting for scan of {path} ... "):
+            try:
+                anal = client.get_object("/analyses/{}", analysis.id)
+                if anal.status == "completed": break
+            except Exception as ex:  # type: ignore
+                repeat_counter += 1
+                if repeat_counter > 2:
+                    raise ValueError(f"❌ Error in scanning {path}") from ex
+                print("⚠️  Error in scanning, trying again...")
+            time.sleep(30)
+    df = pd.DataFrame(anal.results.values())
+    malicious = []
+    for _idx, row in df.iterrows():
+        # try:
+        #     print(row.result)
+        # except Exception as ex:  # type: ignore
+        #     print(row)
+        if row.result is None and row.category in ["undetected", "type-unsupported", "failure", "timeout", "confirmed-timeout"]: continue
+        else:
+            Struct(row.to_dict()).print(as_config=True, title=f"🔍 Found Category {row.category}")
+            malicious.append(row)
+    positive_pct: float = round(number=len(malicious) / len(df) * 100, ndigits=1)
+    print(f"""
+{'=' * 50}
+🔬 SCAN RESULTS | Positive ratio: {positive_pct:.1f}%
+{'=' * 50}
+""")
+    return positive_pct, df
+
+
+def main() -> None:
+    apps_paths_tmp: L[P] = get_installed_cli_apps()
+    versions_files_paths: L[P] = INSTALL_VERSION_ROOT.search()
+    app_versions: list[Optional[str]] = []
+    apps_paths_raw: L[P] = L([])
+    for an_app in apps_paths_tmp:
+        version_path = versions_files_paths.filter(lambda x: x.stem == an_app.stem)
+        if len(version_path) == 1:
+            app_versions.append(version_path.list[0].read_text())
+            apps_paths_raw.append(an_app)
+        # if an_app.stem in versions_files_paths.stem:
+        #     app_versions.append(versions_files_paths.filter(lambda x: x.stem == an_app.stem.replace(".exe", "")).list[0].read_text())
+        # else:
+        #     print(f"🤔 Cloud not find a documented version for installation of {an_app.stem}, trying to get it from the app itself.")
+        #     tmp = Terminal().run(f"{an_app.stem} --version", shell="powershell").capture().op_if_successfull_or_default(strict_err=False, strict_returcode=False)
+        #     if tmp is not None: tmp = tmp.split("\n")[0]
+        #     print(f"➡️ Found version `{tmp}` for {an_app.stem}.")
+        #     app_versions.append(None)
+    print(f"""
+{'=' * 70}
+🔍 TOOL CHECK | Checking tools (#{len(apps_paths_tmp)}) collected from `{INSTALL_VERSION_ROOT}`
+{'=' * 70}
+""")
+    apps_paths_raw.print()
+    positive_pct: list[Optional[float]] = []
+    scan_time: list[str] = []
+    detailed_results: list[dict[str, Optional[pd.DataFrame]]] = []
+
+    for idx, app in enumerate(apps_paths_raw):
+        try: res = scan(path=app, pct=idx / len(apps_paths_raw) * 100)
+        except ValueError as ve:
+            print(f"❌ ERROR | {ve}")
+            res = None
+        if res is None:
+            positive_pct.append(None)
+            detailed_results.append({app.stem: None})
+        else:
+            ppct, df = res
+            positive_pct.append(ppct)
+            detailed_results.append({app.stem: df})
+        scan_time.append(datetime.now().strftime("%Y-%m-%d %H:%M"))
+
+    res_df = pd.DataFrame({"app_name": apps_paths_raw.apply(lambda x: x.stem).list,
+                           "version": app_versions,
+                           "positive_pct": positive_pct,
+                            "scan_time": scan_time,
+                           "app_path": apps_paths_raw.apply(lambda x: x.collapseuser(strict=False).as_posix()).list})
+
+    app_url: list[Optional[str]] = []
+    for idx, row in tqdm(res_df.iterrows(), total=res_df.shape[0]):
+        apps_safe_url = upload(P(str(row["app_path"])).expanduser())
+        app_url.append(apps_safe_url.as_posix() if type(apps_safe_url) is P else apps_safe_url)
+    res_df["app_url"] = app_url
+    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}
+📊 SAFETY REPORT | Summary of app scanning results
+{'=' * 70}
+""")
+    print(res_df)
+
+
+def upload(path: P):
+    import call_function_with_timeout
+    set_time_out = call_function_with_timeout.SetTimeout
+    func_with_timeout = set_time_out(lambda: path.to_cloud(CLOUD, rel2home=True, share=True, os_specific=True), timeout=180)
+    is_done, _is_timeout, _erro_message, results = func_with_timeout()
+    if is_done: return results
+    else: return None
+
+
+class PrecheckedCloudInstaller:
+    def __init__(self):
+        install_n_import("gdown")
+        self.df = pd.read_csv(APP_SUMMARY_PATH)
+
+    @staticmethod
+    def download_google_links(url: str):
+        # if "drive.google.com" in str(url): url = str(url).replace("open?", "uc?")
+        # else: raise NotImplementedError("Only google drive is supported for now.")
+        # return P(url).download(name=name)
+        gdrive_id = P(url).parts[-1].split("id=")[1]
+        gdown = install_n_import("gdown")
+        result = P(gdown.download(id=gdrive_id)).absolute()
+        return result
+
+    @staticmethod
+    def install_cli_apps(app_url: str):
+        try:
+            exe = PrecheckedCloudInstaller.download_google_links(app_url)
+        except Exception as ex:  # type: ignore
+            print(f"❌ ERROR | Failed downloading {app_url}: {ex}")
+            return None
+        if platform.system().lower() == "linux":
+            Terminal().run(f"chmod +x {exe}")
+            Terminal().run(f"mv {exe} /usr/local/bin/")
+        elif platform.system().lower() == "windows":
+            exe.move(folder=P.home().joinpath("AppData/Local/Microsoft/WindowsApps"), overwrite=True)
+        return True
+
+    def download_safe_apps(self, name: str="AllEssentials"):
+        # if platform.system().lower() == "windows":
+        #     from machineconfig.jobs.python.python_windows_installers_all import get_cli_py_installers
+        #     cli_installers = get_cli_py_installers()
+        # elif platform.system().lower() == "linux":
+        #     from machineconfig.jobs.python.python_linux_installers_all import get_cli_py_installers
+        #     cli_installers = get_cli_py_installers()
+        # else: raise NotImplementedError(f"Platform {platform.system().lower()} is not supported yet.")
+
+        if name == "AllEssentials":
+            print(f"""
+{'=' * 70}
+📥 DOWNLOAD | Downloading {self.df.shape[0]} apps...
+{'=' * 70}
+""")
+            print(self.df)
+            _res = L(self.df.app_url).apply(PrecheckedCloudInstaller.install_cli_apps, jobs=20)
+        else:
+            app_url = self.df[self.df.app_name == name].iloc[0].app_url
+            _res = PrecheckedCloudInstaller.install_cli_apps(app_url=app_url)
+
+        # print("\n" * 3)
+        # for item_flag, item_name in zip(res, self.df["app_name"]):
+        #     if item_flag: print(f"✅ {item_name} is installed. 😁")
+        #     else: print(f"❌ {item_name} failed to install for reasons explained in the log above, try manually.")
+
+
+if __name__ == '__main__':
+    pass