machineconfig 1.91__tar.gz → 1.92__tar.gz

machineconfig-1.92/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.1
+Name: machineconfig
+Version: 1.92
+Summary: Dotfiles management package
+Home-page: https://github.com/thisismygitrepo/machineconfig
+Author: Alex Al-Saffar
+Author-email: programmer@usa.com
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/machineconfig/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+
+<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.92/src/machineconfig/__init__.py

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

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

@@ -0,0 +1,181 @@
+
+"""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"positive_ratio = {positive_pct:.1f} %")
+    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"Checking tools collected from `{INSTALL_VERSION_ROOT}`:")
+    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(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("Safety Report:")
+    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 in 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"Downloading {self.df.shape[0]} apps ...")
+            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

machineconfig-1.92/src/machineconfig/jobs/python_custom_installers/dev/code.py

@@ -0,0 +1,35 @@
+
+"""vs code installer as per https://code.visualstudio.com/docs/setup/linux
+"""
+
+from typing import Optional
+import platform
+
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "Visual Studio Code",
+        "filename_template_windows_amd_64": "VSCodeSetup-{}.exe",
+        "filename_template_linux_amd_64": "code_{}.deb",
+        "strip_v": True,
+        "exe_name": "code"
+    }
+
+
+def main(version: Optional[str] = None):
+
+    if platform.system() == 'Linux':
+        import machineconfig.jobs.python_custom_installers as module
+        from pathlib import Path
+        install_script = Path(module.__file__).parent.joinpath("scripts/linux/vscode.sh").read_text(encoding="utf-8")
+
+    elif platform.system() == 'Windows':
+        install_script = """winget install --no-upgrade --name "Microsoft Visual Studio Code" --Id "Microsoft.VisualStudioCode" --source winget --scope user --accept-package-agreements --accept-source-agreements"""
+    else:
+        raise NotImplementedError(f"Unsupported platform: {platform.system()}")
+    _ = version
+    return install_script
+
+
+if __name__ == '__main__':
+    pass

machineconfig-1.92/src/machineconfig/jobs/python_custom_installers/dev/docker_desktop.py

@@ -0,0 +1,52 @@
+
+"""
+Installer
+"""
+# from machineconfig.utils.installer import get_latest_release
+# from crocodile.meta import Terminal
+from typing import Optional
+
+# https://docs.docker.com/desktop/install/ubuntu/
+# https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository
+# https://stackoverflow.com/questions/41133455/docker-repository-does-not-have-a-release-file-on-running-apt-get-update-on-ubun
+
+
+# url = r"https://github.com/koute/bytehound"
+# fname = r"bytehound-x86_64-unknown-linux-gnu.tgz"
+
+
+config_dict = {
+    "repo_url": "CUSTOM",
+    "doc": """Docker Desktop for Ubuntu as per https://docs.docker.com/desktop/install/ubuntu/""",
+    "filename_template_windows_amd_64": "gh_{}_windows_amd64.zip",
+    "filename_template_linux_amd_64": "gh_{}_linux_amd64.tar.gz",
+    "strip_v": True,
+    "exe_name": "docker"
+}
+
+
+def main(version: Optional[str]):
+    _ = version
+    code = """
+# Add Docker's official GPG key:
+sudo apt-get update
+sudo apt-get install ca-certificates curl gnupg
+sudo install -m 0755 -d /etc/apt/keyrings
+curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
+sudo chmod a+r /etc/apt/keyrings/docker.gpg
+
+# Add the repository to Apt sources:
+echo \
+  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
+  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
+  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+sudo apt-get update
+
+sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+
+"""
+    return code
+
+
+if __name__ == '__main__':
+    pass

machineconfig-1.92/src/machineconfig/jobs/python_custom_installers/dev/reverse_proxy.md

@@ -0,0 +1,31 @@
+
+
+given terminal access to a remote computer in my home in australia, and using frpc and frps, give me commands (no config files) to start a proxy server that enable me to access a website https://example.com.au that is only available in Australia, so I can access it from my vocation house in iraq. I have http port 8100 on my computer in australia accesssible securely to me everywhere through cloudflare.
+
+
+# Start frps to listen on port 8100
+./frps -p 8100
+./frps --bind_addr 0.0.0.0 --bind_port 8100 --token "yoursecretqwe"
+
+# Start frpc with HTTP proxy configuration
+./frpc http --server_addr "AUSTRALIA_MACHINE_DOMAIN_OR_IP:8100" \
+     --token "yoursecret" \
+     --local_port 8080 \
+     --plugin http_proxy \
+     --plugin_local_addr "example.com.au:443" \
+     --plugin_host_header "example.com.au"
+
+# Start local proxy to forward traffic
+ssh -L 8080:example.com.au:443 localhost
+# Now you can access the Australian site through: https://localhost:8080
+
+
+---
+
+
+./frps --bind_port=7000 --token=secret
+
+./frpc http selfservice.hrms.sa.gov.au/PROD2:443 \
+  --server_addr=127.0.0.1 --server_port=7000 \
+  --token=secret
+

machineconfig-1.92/src/machineconfig/jobs/python_custom_installers/hx.py

@@ -0,0 +1,58 @@
+
+"""
+Installers do not add runtime files to the machine, hence this script.
+"""
+
+from crocodile.file_management import P
+from machineconfig.utils.installer import Installer, WINDOWS_INSTALL_PATH
+from typing import Optional
+import platform
+
+
+config_dict = {
+        "repo_url": "CUSTOM",
+        "doc": "Helix is a post-modern modal text editor.",
+        "filename_template_windows_amd_64": "helix-{}-x86_64-windows.zip",
+        "filename_template_linux_amd_64": "helix-{}-x86_64-linux.tar.xz",
+        "strip_v": False,
+        "exe_name": "hx"
+    }
+
+
+def main(version: Optional[str]):
+    config_dict_copy = config_dict.copy()
+    config_dict_copy["repo_url"] = "https://github.com/helix-editor/helix"
+    inst = Installer.from_dict(d=config_dict_copy, name="hx")
+    downloaded, _version_to_be_installed = inst.download(version=version)
+    if platform.system() == "Windows":
+        hx_file_search = downloaded.search("hx.exe", folders=False, files=True, r=True)
+    else:
+        hx_file_search = downloaded.search("hx", folders=False, files=True, r=True)        
+    assert len(hx_file_search) == 1
+    hx_file = hx_file_search.list[0]
+    contrib = hx_file.parent / "contrib"
+    runtime = contrib.parent / "runtime"
+    assert runtime.exists()
+    assert contrib.exists()
+    P.home().joinpath(".config/helix/runtime").delete(sure=True)
+    P.home().joinpath(".config/helix/contrib").delete(sure=True)
+    if platform.system() == "Linux":
+        # hx_file.move(folder=LINUX_INSTALL_PATH)  # to be added later
+        contrib.move(folder="~/.config/helix")
+        runtime.move(folder="~/.config/helix")
+    elif platform.system() == "Windows":
+        hx_file.move(folder=WINDOWS_INSTALL_PATH)
+        contrib.move(folder="~/.config/helix")
+        runtime.move(folder="~/.config/helix")
+    else:
+        print("Unsupported OS")
+    downloaded.delete(sure=True)
+
+    if platform.system() == "Linux":
+        inst.install(version=version)  # because we can't normally move hx (without privliage) # hx_file.move(folder=LINUX_INSTALL_PATH)
+
+    return ""
+
+
+if __name__ == "__main__":
+    main(version=None)

machineconfig-1.92/src/machineconfig/jobs/python_custom_installers/scripts/linux/docker.sh

@@ -0,0 +1,86 @@
+
+get_os_type() {
+    if [ -f "/etc/debian_version" ]; then
+        if [ -f "/etc/ubuntu_version" ] || [ -f "/etc/lsb-release" ]; then
+            echo "ubuntu"
+        else
+            echo "debian"
+        fi
+    fi
+}
+
+get_ubuntu_base_version() {
+    local mint_codename=$(lsb_release -cs)
+    case "$mint_codename" in
+        "wilma")
+            echo "noble"
+            ;;
+        "virginia")
+            echo "jammy"
+            ;;
+        *)
+            echo "$mint_codename"
+            ;;
+    esac
+}
+
+get_debian_version() {
+    lsb_release -cs
+}
+
+OS_TYPE=$(get_os_type)
+if [ "$OS_TYPE" = "ubuntu" ]; then
+    DISTRO_VERSION=$(get_ubuntu_base_version)
+else
+    DISTRO_VERSION=$(get_debian_version)
+fi
+
+# Add Docker's official GPG key:
+sudo nala update
+sudo nala install ca-certificates curl
+
+sudo install -m 0755 -d /etc/apt/keyrings
+sudo curl -fsSL "https://download.docker.com/linux/$OS_TYPE/gpg" | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
+
+# Add the repository to Apt sources:
+echo \
+  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/$OS_TYPE \
+  $DISTRO_VERSION stable" | \
+  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+
+sudo nala update
+sudo nala install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
+
+
+sudo systemctl enable docker || true
+docker run hello-world || true
+
+sudo groupadd docker 2>/dev/null || true
+sudo usermod -aG docker $USER || true
+
+# As per NixOs installer:
+# nix-env -iA nixpkgs.docker
+# # as per: https://docs.docker.com/engine/install/linux-postinstall/
+# sudo groupadd docker
+# sudo usermod -aG docker $USER
+# # Now you need to log out and in OR run: `newgrp docker`
+# 
+
+
+# in older wsl, following installation, docker run hello-world will fail with error:
+# https://stackoverflow.com/questions/44678725/cannot-connect-to-the-docker-daemon-at-unix-var-run-docker-sock-is-the-docker
+# You need to run the following command to fix it: systemctl start dockerd
+# However, in newer wsl, systemctl is not available. One can start it but it adds to much cluttering services not needed in wsl.
+# one way to get around it https://askubuntu.com/questions/1379425/system-has-not-been-booted-with-systemd-as-init-system-pid-1-cant-operate
+# is adding the script docker.sh to /etc/init.d/dockerd
+
+# no internet in wsl docker instance: add /etc/docker/daemon.json
+# https://github.com/MicrosoftDocs/WSL/issues/422
+
+# lastly, to avoid cases where sudo is needed for every docker command
+# sudo usermod -a -G docker $USER  # then reboot
+# this is as per: https://stackoverflow.com/questions/47854463/docker-got-permission-denied-while-trying-to-connect-to-the-docker-daemon-socke
+
+# databricks only:
+# sudo nala install fuse-overlayfs
+

machineconfig-1.92/src/machineconfig/jobs/python_custom_installers/scripts/linux/timescaledb.sh

@@ -0,0 +1,34 @@
+# as per: https://docs.timescale.com/self-hosted/latest/install/installation-linux/#install-timescaledb-on-linux
+
+get_ubuntu_base_version() {
+    local os_codename=$(lsb_release -cs)
+    case "$os_codename" in
+        "wilma")
+            echo "noble"  # Map Mint Wilma to the base image Ubuntu 24.04 LTS
+            ;;
+        "virginia")
+            echo "jammy"  # Map Mint Jammy tothe base image Ubuntu 22.04 LTS
+            ;;
+        *)
+            echo "$os_codename"
+            ;;
+    esac
+}
+
+ubuntu_version=$(get_ubuntu_base_version)
+
+# Add PostgreSQL repository
+# echo "deb https://apt.postgresql.org/pub/repos/apt $ubuntu_version-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
+# wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/postgresql.gpg
+sudo nala install postgresql-common -y
+sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh -y
+
+# Add TimescaleDB repository
+echo "deb https://packagecloud.io/timescale/timescaledb/ubuntu/ $ubuntu_version main" | sudo tee /etc/apt/sources.list.d/timescaledb.list
+wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/timescaledb.gpg
+
+sudo nala update
+sudo apt install -y postgresql-16 postgresql-client-16 timescaledb-2-postgresql-16
+sudo timescaledb-tune
+sudo systemctl restart postgresql
+sudo -u postgres psql

machineconfig-1.92/src/machineconfig/jobs/python_custom_installers/scripts/linux/warp-cli.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/bash
+
+# as per https://pkg.cloudflareclient.com/
+
+
+
+get_ubuntu_base_version() {
+    local mint_codename=$(lsb_release -cs)
+    case "$mint_codename" in
+        "wilma")
+            echo "noble"  # Mint 22 (wilma) is based on Ubuntu 24.04 (noble)
+            ;;
+        "virginia")  # Mint 21 (virginia) is based on Ubuntu 22.04 (jammy)
+            echo "jammy"
+            ;;
+        *)
+            echo "$mint_codename"
+            ;;
+    esac
+}
+ubuntu_version=$(get_ubuntu_base_version)
+
+curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | sudo gpg --yes --dearmor --output /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg
+
+echo "deb [signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ $ubuntu_version main" | sudo tee /etc/apt/sources.list.d/cloudflare-client.list
+
+sudo nala update
+sudo nala install cloudflare-warp -y
+warp-cli registration new