stackops 26.7.1__tar.gz → 26.8__tar.gz

stackops-26.8/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: stackops
+Version: 26.8
+Summary: Developer Stack Manager
+Author-email: Alex Al-Saffar <programmer@usa.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/thisismygitrepo/stackops
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/stackops/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: fire>=0.7.1
+Requires-Dist: gitpython>=3.1.46
+Requires-Dist: psutil>=7.2.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: randomname>=0.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: typer>=0.24.1
+Provides-Extra: windows
+Provides-Extra: plot
+Requires-Dist: duckdb>=1.5.4; extra == "plot"
+Requires-Dist: duckdb-engine>=0.17.0; extra == "plot"
+Requires-Dist: ipykernel>=7.3.0; extra == "plot"
+Requires-Dist: ipython>=9.15.0; extra == "plot"
+Requires-Dist: jupyterlab>=4.6.0; extra == "plot"
+Requires-Dist: kaleido>=1.3.0; extra == "plot"
+Requires-Dist: matplotlib>=3.11.0; extra == "plot"
+Requires-Dist: nbformat>=5.10.4; extra == "plot"
+Requires-Dist: numpy>=2.5.0; extra == "plot"
+Requires-Dist: plotly>=6.8.0; extra == "plot"
+Requires-Dist: polars>=1.42.0; extra == "plot"
+Requires-Dist: python-magic>=0.4.27; extra == "plot"
+Requires-Dist: sqlalchemy>=2.0.51; extra == "plot"
+
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Digital Life Manager.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestrator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+
+
+| Before | After |
+| --- | --- |
+| ![Fresh minimal machine state](docs/assets/before.png) | ![Developer-ready machine state](docs/assets/after.png) |
+
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: irm bit.ly/sopsw | iex
+```
+
+</details>
+
+
+## Codex Skill
+
+Install the StackOps skill for Codex with:
+
+```bash
+bunx skills add thisismygitrepo/stackops --skill stackops --global --agent codex --yes
+```
+
+
+## Quick Init
+
+Run these once StackOps is installed.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict throw-error \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, and SSH transfer helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the full tree.
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-26.8/pyproject.toml

@@ -0,0 +1,178 @@
+[build-system]
+requires = ["setuptools>=80", "wheel"]
+build-backend = "setuptools.build_meta"
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+[project]
+name = "stackops"
+version = "26.8"
+description = "Developer Stack Manager"
+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.13"
+dependencies = [
+    "fire>=0.7.1",
+    "gitpython>=3.1.46",
+    "psutil>=7.2.2",
+    "pyyaml>=6.0.3",
+    "questionary>=2.1.1",
+    "randomname>=0.2.1",
+    "requests>=2.32.5",
+    "rich>=14.3.3",
+    "tenacity>=9.1.4",
+    "typer>=0.24.1",
+]
+
+[project.optional-dependencies]
+windows = []
+plot = [
+    "duckdb>=1.5.4",
+    "duckdb-engine>=0.17.0",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jupyterlab>=4.6.0",
+    "kaleido>=1.3.0",
+    "matplotlib>=3.11.0",
+    "nbformat>=5.10.4",
+    "numpy>=2.5.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.51",
+]
+
+
+[project.urls]
+"Homepage" = "https://github.com/thisismygitrepo/stackops"
+"Bug Tracker" = "https://github.com/thisismygitrepo/stackops/issues"
+
+[project.scripts]
+devops = "stackops.scripts.python.devops:main"
+cloud = "stackops.scripts.python.cloud:main"
+fire = "stackops.scripts.python.fire_jobs:main"
+agents = "stackops.scripts.python.agents:main"
+terminal = "stackops.scripts.python.terminal:main"
+preview = "stackops.scripts.python.preview:main"
+utils = "stackops.scripts.python.utils:main"
+stackops = "stackops.scripts.python.stackops_entry:main"
+seek = "stackops.scripts.python.seek:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+license-files = []
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+stackops = ["**/*.toml", "**/*.md", "**/*.sh", "**/*.ps1", "**/*.txt", "utils/schemas/**/*.json", "utils/schemas/**/*.yaml"]
+
+[dependency-groups]
+dev = [
+    "aider>=0.2.6",
+    "build>=1.5.0",
+    "cleanpy>=0.5.1",
+    "cowsay>=6.1",
+    "duckdb>=1.5.4",
+    "gdown>=6.1.0",
+    "griffe>=2.1.0",
+    "ipdb>=0.13.13",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jsonschema>=4.26.0",
+    "kaleido>=1.3.0",
+    "marimo>=0.23.11",
+    "matplotlib>=3.11.0",
+    "mkdocstrings>=1.0.4",
+    "mkdocstrings-python>=2.0.5",
+    "mypy>=2.1.0",
+    "numpy>=2.5.0",
+    "pandas>=3.0.3",
+    "paramiko>=5.0.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "pre-commit>=4.6.0",
+    "pudb>=2025.1.5",
+    "py7zr>=1.1.3",
+    "pydantic>=2.13.4",
+    "pydeps>=3.0.6",
+    "pyinstaller>=6.21.0",
+    "pylint>=4.0.6",
+    "pylsp-mypy>=0.7.3",
+    "pymupdf>=1.27.2.3",
+    "pypdf>=6.14.2",
+    "pyrefly>=1.1.1",
+    "pyright>=1.1.411",
+    "pytest>=9.1.1",
+    "python-lsp-server[mypy]>=1.14.0",
+    "qrcode>=8.2",
+    "ruff>=0.15.20",
+    "ruff-lsp>=0.0.62",
+    "sqlalchemy>=2.0.51",
+    "textual>=8.2.7",
+    "trogon>=0.6.0",
+    "ty>=0.0.55",
+    "types-mysqlclient>=2.2.0.20260508",
+    "types-paramiko>=5.0.0.20260617",
+    "types-pytz>=2026.2.0.20260518",
+    "types-pyyaml>=6.0.12.20260518",
+    "types-requests>=2.33.0.20260518",
+    "types-sqlalchemy>=1.4.53.38",
+    "types-toml>=0.10.8.20260518",
+    "types-urllib3>=1.26.25.14",
+    "vt-py>=0.22.0",
+    "yapf>=0.43.0",
+    "zensical>=0.0.46",
+]
+other = [
+    "duckdb-engine>=0.17.0",
+    "pycrucible>=0.4.6",
+    "vt-py>=0.22.0",
+]
+plot = [
+    "duckdb>=1.5.4",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jupyterlab>=4.6.0",
+    "kaleido>=1.3.0",
+    "matplotlib>=3.11.0",
+    "nbformat>=5.10.4",
+    "numpy>=2.5.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.51",
+]
+
+
+# [tool.uv]
+# default-groups = []
+
+[tool.pycrucible]
+entry = "src/stackops/scripts/python/devops.py"
+[tool.pycrucible.options]
+debug = false
+extract_to_temp = false
+delete_after_run = false
+offline_mode = false
+
+[tool.pycrucible.patterns]
+include = [
+    "**/*.py",
+    "**/*.ps1",
+    "**/*.sh",
+    "**/*.md",
+]
+exclude = [
+    "**/__pycache__/**",
+]

stackops-26.8/src/stackops/jobs/installer/python_scripts/deer_flow.py

@@ -0,0 +1,63 @@
+import platform
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Final
+
+from stackops.utils.schemas.installer.installer_types import InstallerData
+
+
+DEER_FLOW_REPOSITORY_URL: Final[str] = "https://github.com/bytedance/deer-flow"
+DEER_FLOW_INSTALL_ROOT: Final[Path] = Path.home().joinpath("code", "foreign", "deer-flow")
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> None:
+    repository_url = installer_data["repoURL"]
+    if repository_url != DEER_FLOW_REPOSITORY_URL:
+        raise ValueError(f"Unexpected DeerFlow repository URL: {repository_url}")
+
+    if DEER_FLOW_INSTALL_ROOT.exists():
+        if not DEER_FLOW_INSTALL_ROOT.joinpath(".git").is_dir():
+            raise FileExistsError(f"DeerFlow install path exists but is not a Git repository: {DEER_FLOW_INSTALL_ROOT}")
+    else:
+        DEER_FLOW_INSTALL_ROOT.parent.mkdir(parents=True, exist_ok=True)
+        subprocess.run(
+            ["git", "clone", DEER_FLOW_REPOSITORY_URL, str(DEER_FLOW_INSTALL_ROOT)],
+            check=True,
+        )
+
+    if version is not None:
+        subprocess.run(
+            ["git", "-C", str(DEER_FLOW_INSTALL_ROOT), "fetch", "--tags", "origin"],
+            check=True,
+        )
+        subprocess.run(
+            ["git", "-C", str(DEER_FLOW_INSTALL_ROOT), "checkout", "--detach", version],
+            check=True,
+        )
+    elif update:
+        subprocess.run(
+            ["git", "-C", str(DEER_FLOW_INSTALL_ROOT), "pull", "--ff-only"],
+            check=True,
+        )
+
+    if not DEER_FLOW_INSTALL_ROOT.joinpath("config.yaml").is_file():
+        if platform.system() == "Windows":
+            bash_path = shutil.which("bash")
+            if bash_path is None:
+                raise FileNotFoundError("DeerFlow setup on Windows requires Git Bash")
+            subprocess.run(
+                [
+                    bash_path,
+                    "-lc",
+                    'cd "$(cygpath -u "$1")" && make setup',
+                    "stackops-deer-flow",
+                    str(DEER_FLOW_INSTALL_ROOT),
+                ],
+                check=True,
+            )
+        else:
+            subprocess.run(["make", "setup"], cwd=DEER_FLOW_INSTALL_ROOT, check=True)
+
+    print(f"DeerFlow workspace: {DEER_FLOW_INSTALL_ROOT}")
+    print("Run `make docker-init && make docker-start` from that directory for the recommended Docker development environment.")

stackops-26.8/src/stackops/jobs/installer/python_scripts/orca.py

@@ -0,0 +1,157 @@
+import os
+import platform
+import subprocess
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
+from stackops.utils.installer_utils.installer_class import Installer
+from stackops.utils.path_core import delete_path
+from stackops.utils.schemas.installer.installer_types import InstallerData
+from stackops.utils.source_of_truth import WINDOWS_INSTALL_PATH
+
+
+ORCA_WINDOWS_ASSET_NAME = "orca-windows-setup.exe"
+ORCA_WINDOWS_WRAPPER_NAME = "orca.cmd"
+ORCA_STALE_WINDOWS_INSTALLER_NAME = "orca.exe"
+ORCA_MACOS_CASK = "stablyai/orca/orca"
+
+
+def _build_windows_installer_data(base_installer_data: InstallerData) -> InstallerData:
+    return InstallerData(
+        appName=base_installer_data["appName"],
+        license=base_installer_data["license"],
+        doc=base_installer_data["doc"],
+        repoURL=base_installer_data["repoURL"],
+        categoryLabels=base_installer_data["categoryLabels"],
+        fileNamePattern={
+            "amd64": {"linux": None, "windows": ORCA_WINDOWS_ASSET_NAME, "darwin": None},
+            "arm64": {"linux": None, "windows": None, "darwin": None},
+        },
+    )
+
+
+def _get_windows_orca_search_roots() -> tuple[Path, ...]:
+    local_app_data_raw = os.environ.get("LOCALAPPDATA")
+    local_app_data = Path(local_app_data_raw) if local_app_data_raw else Path.home().joinpath("AppData", "Local")
+    search_roots: list[Path] = [local_app_data, local_app_data.joinpath("Programs")]
+    for env_name in ("ProgramFiles", "ProgramFiles(x86)"):
+        search_root_raw = os.environ.get(env_name)
+        if not search_root_raw:
+            continue
+        search_root = Path(search_root_raw)
+        if search_root not in search_roots:
+            search_roots.append(search_root)
+    return tuple(search_roots)
+
+
+def _iter_orca_install_directories(search_root: Path) -> list[Path]:
+    if not search_root.is_dir():
+        return []
+    candidate_dirs: list[Path] = []
+    if "orca" in search_root.name.lower():
+        candidate_dirs.append(search_root)
+    for child in search_root.iterdir():
+        if child.is_dir() and "orca" in child.name.lower():
+            candidate_dirs.append(child)
+    return candidate_dirs
+
+
+def _get_direct_orca_gui_executable(install_dir: Path) -> Path | None:
+    for executable_name in ("Orca.exe", "orca.exe"):
+        candidate = install_dir.joinpath(executable_name)
+        if candidate.is_file():
+            return candidate
+    return None
+
+
+def _get_nested_orca_gui_executable(install_dir: Path) -> Path | None:
+    nested_matches: list[Path] = []
+    for executable_name in ("Orca.exe", "orca.exe"):
+        nested_matches.extend(
+            candidate for candidate in install_dir.rglob(executable_name) if candidate.is_file() and candidate.parent.name.lower() != "bin"
+        )
+    if len(nested_matches) == 0:
+        return None
+    nested_matches.sort(key=lambda candidate: (len(candidate.relative_to(install_dir).parts), candidate.as_posix().lower()))
+    return nested_matches[0]
+
+
+def _find_installed_orca_gui_executable(search_roots: tuple[Path, ...]) -> Path:
+    nested_matches: list[Path] = []
+    for search_root in search_roots:
+        for install_dir in _iter_orca_install_directories(search_root=search_root):
+            direct_match = _get_direct_orca_gui_executable(install_dir=install_dir)
+            if direct_match is not None:
+                return direct_match
+            nested_match = _get_nested_orca_gui_executable(install_dir=install_dir)
+            if nested_match is not None:
+                nested_matches.append(nested_match)
+    if len(nested_matches) > 0:
+        nested_matches.sort(key=lambda candidate: (len(candidate.parts), candidate.as_posix().lower()))
+        return nested_matches[0]
+    raise FileNotFoundError("Could not find Orca.exe after running the Windows installer.")
+
+
+def _find_bundled_windows_orca_cli(gui_executable: Path) -> Path:
+    cli_executable = gui_executable.parent.joinpath("resources", "bin", "orca.exe")
+    if not cli_executable.is_file():
+        raise FileNotFoundError(f"Could not find the bundled Orca CLI after installation: {cli_executable}")
+    return cli_executable
+
+
+def _remove_stale_windows_apps_orca_entry() -> None:
+    stale_installer_path = Path(WINDOWS_INSTALL_PATH).joinpath(ORCA_STALE_WINDOWS_INSTALLER_NAME)
+    if stale_installer_path.is_file():
+        stale_installer_path.unlink(missing_ok=True)
+
+
+def _write_windows_orca_wrapper(target_executable: Path) -> Path:
+    windows_install_path = Path(WINDOWS_INSTALL_PATH)
+    windows_install_path.mkdir(parents=True, exist_ok=True)
+    _remove_stale_windows_apps_orca_entry()
+    wrapper_path = windows_install_path.joinpath(ORCA_WINDOWS_WRAPPER_NAME)
+    wrapper_path.write_text(
+        f"""@echo off
+\"{target_executable}\" %*
+""",
+        encoding="utf-8",
+    )
+    return wrapper_path
+
+
+def _install_orca_on_windows(installer_data: InstallerData, version: str | None) -> None:
+    installer = Installer(installer_data=_build_windows_installer_data(base_installer_data=installer_data))
+    installer_path, _resolved_version = installer.binary_download(version=version)
+    _ = _resolved_version
+    if not installer_path.is_file():
+        raise FileNotFoundError(f"Expected Orca Windows installer to be a file, got: {installer_path}")
+    try:
+        subprocess.run([str(installer_path), "/S"], text=True, check=True)
+        gui_executable = _find_installed_orca_gui_executable(search_roots=_get_windows_orca_search_roots())
+        cli_executable = _find_bundled_windows_orca_cli(gui_executable=gui_executable)
+        _write_windows_orca_wrapper(target_executable=cli_executable)
+    finally:
+        delete_path(installer_path, verbose=False)
+
+
+def _install_orca_on_macos(version: str | None, update: bool) -> None:
+    if version is not None:
+        raise ValueError("Version-pinned Orca installation is not supported on macOS; the official Homebrew cask manages releases.")
+    command = ["brew", "upgrade", "--cask", "--greedy", "orca"] if update else ["brew", "install", "--cask", ORCA_MACOS_CASK]
+    subprocess.run(command, text=True, check=True)
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> None:
+    match platform.system():
+        case "Darwin":
+            _install_orca_on_macos(version=version, update=update)
+        case "Windows":
+            _install_orca_on_windows(installer_data=installer_data, version=version)
+        case operating_system:
+            raise NotImplementedError(f"Orca installer script is not supported on {operating_system}.")
+
+
+if __name__ == "__main__":
+    if TYPE_CHECKING:
+        _main_protocol_check: InstallerPythonScriptMain = main