argospy 0.2.2__tar.gz

argospy-0.2.2/.dockerignore

@@ -0,0 +1,7 @@
+**/.venv
+**/__pycache__
+**/node_modules
+**/out
+**/.git
+dash/ui/dist
+*.egg-info

argospy-0.2.2/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  python:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v10.1.0
+        with:
+          python-version: "3.12"
+      - run: uv build
+      - run: |
+          uv venv
+          uv pip install dist/*.whl
+          .venv/bin/argos --help
+
+  dash-ui:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: dash/ui
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: dash/ui/package-lock.json
+      - run: npm ci
+      - run: npm run build

argospy-0.2.2/.github/workflows/release.yml

@@ -0,0 +1,105 @@
+name: Release
+
+on:
+  push:
+    tags: ["[0-9]+.[0-9]+.[0-9]+"]
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+
+      - name: Check tag matches package versions
+        run: |
+          set -euo pipefail
+          TAG="${GITHUB_REF_NAME}"
+          PY_VER=$(python3 -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          DASH_VER=$(python3 -c "import tomllib; print(tomllib.load(open('dash/pyproject.toml','rb'))['project']['version'])")
+          CHART_VER=$(python3 -c "import pathlib,re; t=pathlib.Path('chart/Chart.yaml').read_text(); print(re.search(r'(?m)^version:\\s*(\\S+)', t).group(1))")
+          APP_VER=$(python3 -c "import pathlib,re; t=pathlib.Path('chart/Chart.yaml').read_text(); print(re.search(r'(?m)^appVersion:\\s*[\"\\']?([^\"\\']+)', t).group(1))")
+          echo "tag=$TAG py=$PY_VER dash=$DASH_VER chart=$CHART_VER app=$APP_VER"
+          if [ "$TAG" != "$PY_VER" ] || [ "$TAG" != "$DASH_VER" ] || [ "$TAG" != "$CHART_VER" ] || [ "$TAG" != "$APP_VER" ]; then
+            echo "::error::Tag $TAG must match pyproject.toml, dash/pyproject.toml, and chart/Chart.yaml"
+            exit 1
+          fi
+
+      - uses: astral-sh/setup-uv@v10.1.0
+        with:
+          python-version: "3.12"
+          enable-cache: true
+
+      - name: Build wheel
+        run: uv build
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: python-dist
+          path: dist/
+          if-no-files-found: error
+
+  publish-pypi:
+    needs: check
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/argospy/
+    permissions:
+      id-token: write
+      contents: read
+      actions: read
+    steps:
+      - uses: astral-sh/setup-uv@v10.1.0
+        with:
+          enable-cache: false
+          ignore-empty-workdir: true
+
+      - uses: actions/download-artifact@v8
+        with:
+          name: python-dist
+          path: dist/
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always
+
+  deploy-dash:
+    needs: check
+    runs-on: [self-hosted, buildof]
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - name: Build image and helm office
+        env:
+          TAG: ${{ github.ref_name }}
+        run: bash scripts/dash-release.sh
+
+  github-release:
+    needs: [publish-pypi, deploy-dash]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      actions: read
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: python-dist
+          path: dist/
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            dist/*.whl
+            dist/*.tar.gz

argospy-0.2.2/.gitignore

@@ -0,0 +1,19 @@
+out/
+dash/ui/node_modules/
+dash/ui/dist/
+.venv/
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.python-version
+.DS_Store
+.env
+.env.*
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.coverage
+htmlcov/

argospy-0.2.2/Dockerfile

@@ -0,0 +1,25 @@
+ARG NODE_IMAGE=harbor.saidc/base/saidc-node:22-pnpm11.12.0
+ARG BASE_IMAGE=harbor.saidc/base/saidc-uv:0.12.0
+
+FROM ${NODE_IMAGE} AS ui
+WORKDIR /ui
+COPY dash/ui/package.json dash/ui/package-lock.json* ./
+RUN --mount=type=cache,target=/root/.npm npm install
+COPY dash/ui/ ./
+RUN npm run build
+
+FROM ${BASE_IMAGE}
+WORKDIR /app
+COPY dash/pyproject.toml dash/alembic.ini dash/entrypoint.sh dash/skill.md ./
+COPY dash/alembic ./alembic
+COPY dash/*.py ./
+COPY dash/routers ./routers
+RUN --mount=type=cache,target=/root/.cache/uv \
+    python -c 'import tomllib, pathlib; print("\n".join(tomllib.load(pathlib.Path("pyproject.toml").open("rb"))["project"]["dependencies"]))' \
+    | uv pip install --system -r -
+COPY --from=ui /ui/dist ./ui/dist
+RUN chmod +x /app/entrypoint.sh
+ENV PYTHONPATH=/app
+ENV PORT=8080
+EXPOSE 8080
+ENTRYPOINT ["/app/entrypoint.sh"]

argospy-0.2.2/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.5
+Name: argospy
+Version: 0.2.2
+Summary: once / soak test framework
+Project-URL: Homepage, https://github.com/lpythu/argos
+Project-URL: Repository, https://github.com/lpythu/argos
+Project-URL: Issues, https://github.com/lpythu/argos/issues
+Author: Peiyang Li
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# argos
+
+once / soak 框架库 + dash。
+
+PyPI 项目名是 **`argospy`**（`argos` 已被占用）。安装后命令仍是 `argos`。
+
+写 case 的人请去 [argos-pack](https://acahti.saidc.ai/saidc/argos-pack)，不要用这个仓。
+
+```bash
+pip install argospy
+```
+
+- Git：`https://github.com/lpythu/argos`（private）
+- Wheel：tag `X.Y.Z`（不带 `v`）→ PyPI `argospy` + office dash
+- Dash：`https://argos.saidc.ai`
+
+CLI 零第三方依赖。`argos-pack` 依赖 `argospy`。

argospy-0.2.2/README.md

@@ -0,0 +1,17 @@
+# argos
+
+once / soak 框架库 + dash。
+
+PyPI 项目名是 **`argospy`**（`argos` 已被占用）。安装后命令仍是 `argos`。
+
+写 case 的人请去 [argos-pack](https://acahti.saidc.ai/saidc/argos-pack)，不要用这个仓。
+
+```bash
+pip install argospy
+```
+
+- Git：`https://github.com/lpythu/argos`（private）
+- Wheel：tag `X.Y.Z`（不带 `v`）→ PyPI `argospy` + office dash
+- Dash：`https://argos.saidc.ai`
+
+CLI 零第三方依赖。`argos-pack` 依赖 `argospy`。

argospy-0.2.2/RELEASING.md

@@ -0,0 +1,33 @@
+# Releasing argos
+
+Tag **`X.Y.Z`**（不带 `v`）触发 [`.github/workflows/release.yml`](.github/workflows/release.yml)：
+
+1. 校验 tag 与 `pyproject.toml` / `chart/Chart.yaml` 一致
+2. `uv build` → PyPI `argospy`（Trusted Publishing）
+3. buildof 打 dash 镜像并 helm 到 office
+
+本机不执行 `uv publish` / helm。
+
+## Everyday
+
+```bash
+./scripts/release.sh 0.2.1
+git push origin main --tags
+```
+
+脚本只改版本、提交、打 annotated tag。推送后由 Actions 发布。
+
+## One-time: PyPI Trusted Publishing
+
+不在 GitHub 里存长期 token。绑定一次 OIDC：
+
+1. 仓库 Environment **`pypi`**（Settings → Environments）
+2. https://pypi.org/manage/account/publishing/ → **Add a new pending publisher**
+   - PyPI project name: `argospy`
+   - Owner: `lpythu`
+   - Repository: `argos`
+   - Workflow: `release.yml`
+   - Environment name: `pypi`
+3. 第一次成功的 `uv publish` 会创建项目
+
+不要在仓库里放 `UV_PUBLISH_TOKEN`。`uv publish --trusted-publishing always` 只走 OIDC，空 token 会和 trusted publishing 冲突。

argospy-0.2.2/argos/case.py

@@ -0,0 +1,166 @@
+import json
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any, Callable
+
+ONCE = "once"
+SOAK = "soak"
+
+
+def case_slug(case_id: str) -> str:
+    return case_id.replace(":", "-")
+
+
+def run_slug(ids: list[str]) -> str:
+    if not ids:
+        return "empty"
+    if len(ids) == 1:
+        return case_slug(ids[0])
+    groups = {part.split(":", 1)[0] if ":" in part else part for part in ids}
+    if len(groups) == 1:
+        return next(iter(groups))
+    if len(ids) <= 3:
+        return "+".join(case_slug(i) for i in ids)
+    return f"{len(ids)}-cases"
+
+
+@dataclass(frozen=True)
+class Spec:
+    id: str
+    title: str
+    group: str
+    tags: tuple[str, ...] = ()
+    modes: tuple[str, ...] = (ONCE,)
+    pack: str = ""
+
+    @property
+    def slug(self) -> str:
+        return case_slug(self.id)
+
+
+@dataclass
+class Step:
+    name: str
+    status: str
+    detail: str = ""
+
+
+@dataclass
+class Result:
+    spec: Spec
+    status: str
+    elapsed_s: float
+    error: str = ""
+    metrics: dict[str, Any] = field(default_factory=dict)
+    steps: list[Step] = field(default_factory=list)
+    notes: list[str] = field(default_factory=list)
+    dest: str = ""
+    iteration: int = 0
+
+
+class Skip(Exception):
+    pass
+
+
+class Fail(Exception):
+    pass
+
+
+class Context:
+    def __init__(
+        self,
+        spec: Spec,
+        dest: Path,
+        emit: Callable[[dict], None],
+        *,
+        iteration: int = 0,
+        run_dest: Path | None = None,
+        mode: str = ONCE,
+    ):
+        self.spec = spec
+        self.dest = dest
+        self.dest.mkdir(parents=True, exist_ok=True)
+        self.iteration = iteration
+        self.run_dest = run_dest or dest.parent
+        self.mode = mode
+        self.metrics: dict[str, Any] = {}
+        self.steps: list[Step] = []
+        self.notes: list[str] = []
+        self._emit = emit
+        self.write(
+            "case.json",
+            {
+                "id": spec.id,
+                "slug": spec.slug,
+                "title": spec.title,
+                "group": spec.group,
+                "pack": spec.pack,
+                "tags": list(spec.tags),
+                "modes": list(spec.modes),
+            },
+        )
+
+    def metric(self, key: str, value: Any) -> None:
+        self.metrics[key] = value
+        self._dump()
+        self._emit({"type": "metric", "id": self.spec.id, "key": key, "value": value})
+
+    def note(self, message: str) -> None:
+        self.notes.append(message)
+        self._emit({"type": "note", "id": self.spec.id, "message": message})
+
+    def step(self, name: str, status: str = "ok", detail: str = "") -> None:
+        row = Step(name=name, status=status, detail=detail)
+        for i, existing in enumerate(self.steps):
+            if existing.name == name:
+                self.steps[i] = row
+                break
+        else:
+            self.steps.append(row)
+        self._dump()
+        self._emit({"type": "step", "id": self.spec.id, "name": name, "status": status, "detail": detail})
+
+    def check(self, ok: bool, message: str) -> None:
+        if not ok:
+            raise Fail(message)
+
+    def skip(self, message: str) -> None:
+        raise Skip(message)
+
+    def fail(self, message: str) -> None:
+        raise Fail(message)
+
+    def own(self, resource_id: str, catalog_id: str = "") -> None:
+        path = self.run_dest / "owned.json"
+        rows: list[dict[str, str]] = []
+        if path.exists():
+            raw = json.loads(path.read_text())
+            if isinstance(raw, list):
+                rows = [row for row in raw if isinstance(row, dict)]
+        if any(row.get("id") == resource_id for row in rows):
+            return
+        rows.append({"id": resource_id, "catalog_id": catalog_id})
+        path.write_text(json.dumps(rows, indent=2, ensure_ascii=False) + "\n")
+
+    def write(self, name: str, obj: Any) -> Path:
+        path = self.dest / name
+        if isinstance(obj, (bytes, bytearray)):
+            path.write_bytes(obj)
+        elif isinstance(obj, str):
+            path.write_text(obj)
+        else:
+            path.write_text(json.dumps(obj, indent=2, ensure_ascii=False) + "\n")
+        return path
+
+    def _dump(self) -> None:
+        self.write(
+            "progress.json",
+            {
+                "id": self.spec.id,
+                "slug": self.spec.slug,
+                "title": self.spec.title,
+                "metrics": self.metrics,
+                "steps": [s.__dict__ for s in self.steps],
+                "notes": self.notes,
+            },
+        )