stackops 26.6.1__tar.gz → 26.6.3__tar.gz

stackops-26.6.3/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: stackops
+Version: 26.6.3
+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: joblib>=1.5.3
+Requires-Dist: paramiko>=4.0.0
+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
+
+<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 orchestator (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>
+
+
+## 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 overwrite-default-path \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-26.6.3/pyproject.toml

@@ -0,0 +1,163 @@
+[build-system]
+requires = ["setuptools>=80", "wheel"]
+build-backend = "setuptools.build_meta"
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+[project]
+name = "stackops"
+version = "26.6.3"
+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",
+    "joblib>=1.5.3",
+    "paramiko>=4.0.0",
+    "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 = [
+
+]
+
+
+[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.4.1",
+    "cleanpy>=0.5.1",
+    "cowsay>=6.1",
+    "duckdb>=1.5.1",
+    "gdown>=5.2.1",
+    "griffe>=2.0.2",
+    "ipdb>=0.13.13",
+    "ipykernel>=7.2.0",
+    "ipython>=9.11.0",
+    "kaleido>=1.2.0",
+    "marimo>=0.21.1",
+    "matplotlib>=3.10.8",
+    "mkdocstrings>=1.0.3",
+    "mkdocstrings-python>=2.0.3",
+    "mypy>=1.19.1",
+    "numpy>=2.4.3",
+    "pandas>=3.0.1",
+    "plotly>=6.6.0",
+    "polars>=1.39.3",
+    "pre-commit>=4.5.1",
+    "pudb>=2025.1.5",
+    "py7zr>=1.1.0",
+    "pydantic>=2.12.5",
+    "pydeps>=3.0.2",
+    "pyinstaller>=6.19.0",
+    "pylint>=4.0.5",
+    "pylsp-mypy>=0.7.1",
+    "pymupdf>=1.27.2.2",
+    "pypdf>=6.9.2",
+    "pyrefly>=0.58.0",
+    "pyright>=1.1.408",
+    "pytest>=9.0.2",
+    "python-lsp-server[mypy]>=1.14.0",
+    "qrcode>=8.2",
+    "ruff>=0.15.7",
+    "ruff-lsp>=0.0.62",
+    "sqlalchemy>=2.0.48",
+    "textual>=8.1.1",
+    "trogon>=0.6.0",
+    "ty>=0.0.25",
+    "types-mysqlclient>=2.2.0.20250915",
+    "types-paramiko>=4.0.0.20260322",
+    "types-pytz>=2026.1.1.20260304",
+    "types-pyyaml>=6.0.12.20250915",
+    "types-requests>=2.32.4.20260324",
+    "types-sqlalchemy>=1.4.53.38",
+    "types-toml>=0.10.8.20240310",
+    "types-urllib3>=1.26.25.14",
+    "vt-py>=0.22.0",
+    "yapf>=0.43.0",
+    "zensical>=0.0.29",
+]
+other = [
+    "duckdb-engine>=0.17.0",
+    "pycrucible>=0.4.6",
+    "vt-py>=0.22.0",
+]
+plot = [
+    "duckdb>=1.5.1",
+    "ipykernel>=7.2.0",
+    "ipython>=9.11.0",
+    "jupyterlab>=4.5.6",
+    "kaleido>=1.2.0",
+    "matplotlib>=3.10.8",
+    "nbformat>=5.10.4",
+    "numpy>=2.4.3",
+    "plotly>=6.6.0",
+    "polars>=1.39.3",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.48",
+]
+
+
+[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.6.3/src/manual/test_secrets_schema.py

@@ -0,0 +1,47 @@
+import json
+from pathlib import Path
+
+import pytest
+
+from stackops.secrets.loader import SecretsSchemaError, load_secrets_file
+from stackops.secrets.models import SecretRecord
+
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+SECRETS_SCHEMA_PATH = REPO_ROOT / "src" / "stackops" / "secrets" / "secrets.schema.json"
+SECRETS_EXAMPLE_PATH = REPO_ROOT / "src" / "stackops" / "secrets" / "secrets.example.json"
+
+
+def test_loader_requires_secret_name(tmp_path: Path) -> None:
+    secrets_path = tmp_path / "secrets.json"
+    secrets_path.write_text(
+        json.dumps({"version": "0.5", "entries": [{"name": "service", "secrets": [{"keyValues": {"TOKEN": "redacted"}}]}]}), encoding="utf-8"
+    )
+
+    with pytest.raises(SecretsSchemaError, match=r"entries\[0\]\.secrets\[0\]\.name must be a non-empty string"):
+        load_secrets_file(secrets_path)
+
+
+def test_loaded_secret_name_is_required_type(tmp_path: Path) -> None:
+    secrets_path = tmp_path / "secrets.json"
+    secrets_path.write_text(
+        json.dumps({"version": "0.5", "entries": [{"name": "service", "secrets": [{"name": "api-token", "keyValues": {"TOKEN": "redacted"}}]}]}),
+        encoding="utf-8",
+    )
+
+    loaded = load_secrets_file(secrets_path)
+    secret: SecretRecord = loaded["entries"][0]["secrets"][0]
+
+    assert secret["name"] == "api-token"
+
+
+def test_schema_requires_secret_name() -> None:
+    schema = json.loads(SECRETS_SCHEMA_PATH.read_text(encoding="utf-8"))
+
+    assert schema["definitions"]["secret"]["required"] == ["name", "keyValues"]
+
+
+def test_packaged_example_secret_entries_have_names() -> None:
+    example = json.loads(SECRETS_EXAMPLE_PATH.read_text(encoding="utf-8"))
+
+    assert all("name" in secret for entry in example["entries"] for secret in entry["secrets"])

stackops-26.6.3/src/manual/test_stackops_versioning.py

@@ -0,0 +1,42 @@
+from datetime import date
+
+import pytest
+
+from stackops.scripts.python.helpers.helpers_utils.upgrade_packages import (
+    format_stackops_display_version,
+    get_next_stackops_version,
+    parse_stackops_calver,
+)
+
+
+def test_legacy_version_migrates_to_current_calver_month() -> None:
+    assert get_next_stackops_version("8.104", today=date(2026, 6, 9)) == "26.6"
+
+
+def test_same_month_releases_increment_unbounded_release_number() -> None:
+    assert get_next_stackops_version("26.6", today=date(2026, 6, 9)) == "26.6.1"
+    assert get_next_stackops_version("26.6.500", today=date(2026, 6, 9)) == "26.6.501"
+
+
+def test_new_month_release_resets_to_month_base_version() -> None:
+    assert get_next_stackops_version("26.6.500", today=date(2026, 7, 1)) == "26.7"
+    assert get_next_stackops_version("25.12.4", today=date(2026, 1, 1)) == "26.1"
+
+
+def test_future_month_version_is_rejected_to_avoid_downgrade() -> None:
+    with pytest.raises(ValueError, match="later than today's release month"):
+        get_next_stackops_version("26.7", today=date(2026, 6, 9))
+
+
+def test_display_version_keeps_v_prefix_and_canonical_month() -> None:
+    assert format_stackops_display_version("26.6") == "v26.6"
+    assert format_stackops_display_version("26.6.1") == "v26.6.1"
+
+
+def test_calver_parser_accepts_tag_style_and_rejects_invalid_months() -> None:
+    parsed = parse_stackops_calver("v26.6.500")
+    assert parsed is not None
+    assert parsed.year == 26
+    assert parsed.month == 6
+    assert parsed.release == 500
+    assert parse_stackops_calver("8.104") is None

stackops-26.6.3/src/stackops/architecture_graph/__main__.py

@@ -0,0 +1,5 @@
+from stackops.architecture_graph.cli import main
+
+
+if __name__ == "__main__":
+    main()

stackops-26.6.3/src/stackops/architecture_graph/cli.py

@@ -0,0 +1,70 @@
+import argparse
+from dataclasses import dataclass
+from pathlib import Path
+from typing import cast
+
+from stackops.architecture_graph.graph import build_graph_page_payload
+from stackops.architecture_graph.renderer import write_html
+
+DEFAULT_DEPTH = 1
+DEFAULT_MAX_DEPTH = 3
+DEFAULT_OUTPUT_PATH = Path(".ai/architecture_dependencies.html")
+DEFAULT_PACKAGE_NAME = "stackops"
+DEFAULT_SOURCE_ROOT = Path("src/stackops")
+
+
+@dataclass(frozen=True, slots=True)
+class CliArgs:
+    source_root: Path
+    package_name: str
+    output_path: Path
+    depth: int
+    max_depth: int
+
+
+def main() -> None:
+    args = parse_cli_args()
+    if not args.source_root.exists():
+        raise SystemExit(f"source root does not exist: {args.source_root}")
+    payload = build_graph_page_payload(
+        source_root=args.source_root,
+        package_name=args.package_name,
+        initial_depth=args.depth,
+        max_depth=args.max_depth,
+    )
+    output_path = write_html(payload=payload, output_path=args.output_path)
+    print(f"Wrote {output_path}")
+
+
+def parse_cli_args() -> CliArgs:
+    parser = build_parser()
+    namespace = parser.parse_args()
+    source_root = cast(Path, getattr(namespace, "source_root"))
+    package_name = cast(str, getattr(namespace, "package_name"))
+    output_path = cast(Path, getattr(namespace, "output_path"))
+    depth = cast(int, getattr(namespace, "depth"))
+    max_depth = cast(int, getattr(namespace, "max_depth"))
+    if depth < 0:
+        raise SystemExit("--depth must be zero or greater")
+    if max_depth < depth:
+        raise SystemExit("--max-depth must be greater than or equal to --depth")
+    return CliArgs(
+        source_root=source_root,
+        package_name=package_name,
+        output_path=output_path,
+        depth=depth,
+        max_depth=max_depth,
+    )
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="python -m stackops.architecture_graph",
+        description="Generate an interactive HTML dependency graph for StackOps.",
+    )
+    parser.add_argument("--source-root", type=Path, default=DEFAULT_SOURCE_ROOT)
+    parser.add_argument("--package-name", default=DEFAULT_PACKAGE_NAME)
+    parser.add_argument("--output", dest="output_path", type=Path, default=DEFAULT_OUTPUT_PATH)
+    parser.add_argument("--depth", type=int, default=DEFAULT_DEPTH)
+    parser.add_argument("--max-depth", type=int, default=DEFAULT_MAX_DEPTH)
+    return parser

stackops-26.6.3/src/stackops/architecture_graph/graph.py

@@ -0,0 +1,148 @@
+from collections import Counter
+from datetime import UTC, datetime
+from pathlib import Path
+
+from stackops.architecture_graph.models import (
+    EdgePayload,
+    GraphPagePayload,
+    GraphPayload,
+    InternalImport,
+    NodeId,
+    NodePayload,
+    PythonModule,
+)
+from stackops.architecture_graph.scanner import collect_internal_imports, discover_python_modules
+
+
+def build_graph_page_payload(
+    source_root: Path,
+    package_name: str,
+    initial_depth: int,
+    max_depth: int,
+) -> GraphPagePayload:
+    if initial_depth < 0:
+        raise ValueError("initial_depth must be zero or greater")
+    if max_depth < initial_depth:
+        raise ValueError("max_depth must be greater than or equal to initial_depth")
+    modules = discover_python_modules(source_root=source_root, package_name=package_name)
+    imports = collect_internal_imports(modules=modules, package_name=package_name)
+    generated_at = datetime.now(UTC).isoformat(timespec="seconds")
+    depths = {
+        str(depth): graph_payload_from_imports(
+            source_root=source_root,
+            package_name=package_name,
+            depth=depth,
+            generated_at=generated_at,
+            modules=modules,
+            imports=imports,
+        )
+        for depth in range(max_depth + 1)
+    }
+    return {
+        "packageName": package_name,
+        "sourceRoot": str(source_root),
+        "generatedAt": generated_at,
+        "initialDepth": initial_depth,
+        "maxDepth": max_depth,
+        "depths": depths,
+    }
+
+
+def build_graph_payload(source_root: Path, package_name: str, depth: int) -> GraphPayload:
+    if depth < 0:
+        raise ValueError("depth must be zero or greater")
+    modules = discover_python_modules(source_root=source_root, package_name=package_name)
+    imports = collect_internal_imports(modules=modules, package_name=package_name)
+    generated_at = datetime.now(UTC).isoformat(timespec="seconds")
+    return graph_payload_from_imports(
+        source_root=source_root,
+        package_name=package_name,
+        depth=depth,
+        generated_at=generated_at,
+        modules=modules,
+        imports=imports,
+    )
+
+
+def graph_payload_from_imports(
+    source_root: Path,
+    package_name: str,
+    depth: int,
+    generated_at: str,
+    modules: list[PythonModule],
+    imports: list[InternalImport],
+) -> GraphPayload:
+    module_nodes = {
+        module.name: aggregate_module_name(module.name, package_name, depth)
+        for module in modules
+    }
+    node_module_counts: Counter[NodeId] = Counter(module_nodes.values())
+    node_file_counts: Counter[NodeId] = Counter(module_nodes[module.name] for module in modules)
+    edge_counts: Counter[tuple[NodeId, NodeId]] = Counter()
+
+    for internal_import in imports:
+        source = module_nodes[internal_import.importer]
+        target = module_nodes[internal_import.imported]
+        if source != target:
+            edge_counts[(source, target)] += 1
+
+    return {
+        "packageName": package_name,
+        "sourceRoot": str(source_root),
+        "depth": depth,
+        "generatedAt": generated_at,
+        "moduleCount": len(modules),
+        "importCount": len(imports),
+        "nodes": node_payloads(node_module_counts, node_file_counts, package_name),
+        "edges": edge_payloads(edge_counts),
+    }
+
+
+def aggregate_module_name(module_name: str, package_name: str, depth: int) -> NodeId:
+    package_parts = package_name.split(".")
+    module_parts = module_name.split(".")
+    keep_count = len(package_parts) + depth
+    if len(module_parts) <= keep_count:
+        return module_name
+    return ".".join(module_parts[:keep_count])
+
+
+def node_payloads(
+    module_counts: Counter[NodeId],
+    file_counts: Counter[NodeId],
+    package_name: str,
+) -> list[NodePayload]:
+    return [
+        {
+            "id": node_id,
+            "label": node_label(node_id, package_name),
+            "group": node_group(node_id, package_name),
+            "moduleCount": module_counts[node_id],
+            "fileCount": file_counts[node_id],
+        }
+        for node_id in sorted(module_counts)
+    ]
+
+
+def edge_payloads(edge_counts: Counter[tuple[NodeId, NodeId]]) -> list[EdgePayload]:
+    return [
+        {"source": source, "target": target, "count": count}
+        for (source, target), count in sorted(edge_counts.items())
+    ]
+
+
+def node_label(node_id: NodeId, package_name: str) -> str:
+    if node_id == package_name:
+        return package_name
+    suffix = node_id.removeprefix(f"{package_name}.")
+    suffix_parts = suffix.split(".")
+    if len(suffix_parts) == 1:
+        return suffix
+    return "/".join(suffix_parts[-2:])
+
+
+def node_group(node_id: NodeId, package_name: str) -> str:
+    if node_id == package_name:
+        return package_name
+    suffix = node_id.removeprefix(f"{package_name}.")
+    return suffix.split(".")[0]