Add GitHub Actions CI and the maintainer-scripts README

Author: edkerk

.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+# A push that obsoletes a previous run cancels it.
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: ruff
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - run: pip install --upgrade pip
+      - run: pip install ruff
+      - run: ruff check .
+
+  test:
+    name: pytest (py${{ matrix.python }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - run: pip install --upgrade pip
+      # ``-e .[dev,plotting,excel]`` so every optional extra is exercised.
+      # Gurobi is not installable on free runners; the relevant tests
+      # skip themselves when ``optlang.gurobi_interface`` cannot import.
+      - run: pip install -e ".[dev,plotting,excel]"
+      - run: pytest -q --maxfail=5 --durations=20

scripts/README.md

@@ -0,0 +1,35 @@
+# Maintainer scripts
+
+Release-time tooling. Not part of the installed package — run them from a checkout
+with raven-python installed (`pip install -e .`). End users never need these.
+
+## `build_kegg_artefacts.py`
+
+Build the publishable KEGG artefact set from an arranged KEGG dump (see
+`download_kegg_dump`): the gzipped-YAML reference model, the gzipped-TSV tables,
+and (with `--hmms`) the per-domain pressed HMM libraries. Output is laid out ready
+to upload as release assets. See [docs/maintaining_kegg_data.md](../docs/maintaining_kegg_data.md).
+
+```bash
+python scripts/build_kegg_artefacts.py --keggdb keggdb --out artefacts          # tables + model
+python scripts/build_kegg_artefacts.py --keggdb keggdb --out artefacts --hmms --threads 8
+```
+
+## `make_registry_snippet.py`
+
+After uploading the files to a release, compute their SHA256 and print the entry
+to merge into the runtime registry — `raven_python.data._DATA_REGISTRY` (data) or
+`raven_python.binaries._REGISTRY` (binary ZIP bundles). The checksum helper is shared
+with the resolvers, so published checksums always match what `ensure_data` /
+`ensure_binary` verify.
+
+```bash
+# Data artefacts:
+python scripts/make_registry_snippet.py data --dataset kegg --version kegg116 \
+    --dir artefacts --base-url https://github.com/ORG/raven-python/releases/download/kegg-data-kegg116
+
+# Binary bundle (ZIPs named <bundle>-<version>-<os>-<arch>.zip):
+python scripts/make_registry_snippet.py binary --bundle blast --version 2.16.0 \
+    --provides blastp makeblastdb --dir zips \
+    --base-url https://github.com/ORG/raven-python/releases/download/blast-2.16.0
+```