merge

Author: wangxingjun778

.github/workflows/citest.yaml

@@ -0,0 +1,79 @@
+name: citest
+
+on:
+  push:
+    branches:
+      - main
+      - "release/**"
+    paths-ignore:
+      - "docs/**"
+      - "temp/**"
+      - "README.md"
+      - "LICENSE"
+      - ".github/workflows/publish.yaml"
+
+  pull_request:
+    paths-ignore:
+      - "docs/**"
+      - "temp/**"
+      - "README.md"
+      - "LICENSE"
+      - ".github/workflows/publish.yaml"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  unittest:
+    # Mock mode: no credentials, no network calls to the Hub. This mirrors
+    # distro build sandboxes (NixOS/FreeBSD) so a green run here means the
+    # test suite also passes when downstream packagers run it.
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        # 3.10 = oldest supported, 3.14 = used by NixOS packaging.
+        python-version: ["3.10", "3.12", "3.14"]
+    env:
+      MODELSCOPE_RUN_REMOTE_TESTS: "false"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package with dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run unit tests (mock mode)
+        run: pytest tests/ --ignore=tests/integration -q
+
+  lint:
+    # Hard gate: the ruff/mypy backlog was cleared, keep it at zero.
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install package with dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Ruff check
+        run: ruff check src/ tests/
+
+      - name: Ruff format check
+        run: ruff format --check src/ tests/
+
+      - name: Mypy
+        run: mypy src/modelscope_hub/

.github/workflows/publish.yaml

@@ -10,7 +10,29 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  test-gate:
+    # Release gate: the mock-mode suite must pass before anything is built
+    # or uploaded. Same environment shape as downstream distro sandboxes.
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    env:
+      MODELSCOPE_RUN_REMOTE_TESTS: "false"
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install package with dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run unit tests (mock mode)
+        run: pytest tests/ --ignore=tests/integration -q
+
   build-n-publish:
+    needs: test-gate
     runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v4

.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+# Local pre-commit hooks. Optional but recommended: CI (citest.yaml) enforces
+# the same checks as a hard gate, this just gives faster feedback.
+#
+# Setup:
+#   pip install pre-commit && pre-commit install
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.11
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+        files: ^(src|tests)/
+      - id: ruff-format
+        files: ^(src|tests)/
+# mypy is intentionally left to CI: a full run over src/ takes too long for a
+# commit hook and needs the package's own dependencies installed.