mirror of
https://github.com/EstrellaXD/Auto_Bangumi.git
synced 2026-10-30 20:24:47 +08:00
124b156b7a
- ab-plugin new 与示例插件的 requires-python 改为 >=3.14，与 SDK 0.6.0 一致 - 示例插件 ntfy-notifier / webhook-on-event 改用 httpx2 - openai / anthropic / google-genai 下限改为实际需要的大版本 - 插件 MCP 工具的 input_schema 无效时计入熔断 - 复制 RSS 链接在 HTTP 部署下回退到 execCommand（useClipboard legacy） - CI 步骤名、PLAYWRIGHT_VERSION、README 徽章与 e2e 指南改为 Python 3.14 / Playwright 1.64.1
63 lines
3.7 KiB
Markdown
63 lines
3.7 KiB
Markdown
# E2E テストガイド
|
||
|
||
エンドツーエンドテストは、本番ビルドの AutoBangumi イメージを、ローカルの決定的な上流サービス（モックの RSS、TMDB、プレーヤー、qBittorrent）に対して実行します。テストは公開サービスにアクセスしません。Docker Compose はループバックアドレスにランダムなポートを公開し、サービス同士は内部ネットワークで通信します。
|
||
|
||
完全な説明（各テストレーン、診断用の成果物、モックシナリオの追加、qBittorrent イメージのダイジェスト更新）はリポジトリの [`e2e/README.md`](https://github.com/EstrellaXD/Auto_Bangumi/blob/main/e2e/README.md) にあります。このページでは、ローカルで実行する最短の手順だけを示します。
|
||
|
||
## 準備
|
||
|
||
- Docker Engine と Compose v2
|
||
- Python 3.14 と `uv`
|
||
- Node.js 20 と pnpm 9.11
|
||
|
||
```bash
|
||
uv sync --directory backend --locked --group dev
|
||
pnpm --dir webui install --frozen-lockfile
|
||
pnpm --dir webui exec playwright install --with-deps chromium webkit firefox
|
||
```
|
||
|
||
## テストイメージのビルド
|
||
|
||
```bash
|
||
pnpm --dir webui run build
|
||
python3 e2e/scripts/build_test_image.py \
|
||
--version 3.3.999-e2e.1 \
|
||
--image auto-bangumi:e2e \
|
||
--dist webui/dist
|
||
```
|
||
|
||
ビルドスクリプトは、WebUI のビルド成果物と生成したバージョンモジュールを一時的な Docker コンテキストに置きます。ソースツリーには書き込みません。
|
||
|
||
## 実行
|
||
|
||
実行のたびに新しいプロジェクト名と作業ディレクトリを使います。作業ディレクトリを使い回すとセットアップ状態も使い回すことになり、初回起動のテストが意味を失います。
|
||
|
||
```bash
|
||
export LANE=runtime
|
||
export AB_E2E_PROJECT="ab-e2e-local-$LANE-$$"
|
||
export AB_E2E_WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/ab-e2e-$LANE.XXXXXX")"
|
||
export AB_E2E_APP_IMAGE=auto-bangumi:e2e
|
||
|
||
# ランタイムの API とプロセスのテスト
|
||
python3 e2e/scripts/stack.py run \
|
||
--profile browser \
|
||
--project-name "$AB_E2E_PROJECT" \
|
||
--work-dir "$AB_E2E_WORK_DIR" \
|
||
-- uv run --directory backend pytest src/test/e2e/runtime -m e2e -q
|
||
```
|
||
|
||
| レーン | `--` の後のコマンド | `--profile` |
|
||
| --- | --- | --- |
|
||
| ランタイム | `uv run --directory backend pytest src/test/e2e/runtime -m e2e -q` | `browser` |
|
||
| Chromium デスクトップ | `pnpm --dir webui run test:e2e:chromium --retries=0` | `browser` |
|
||
| WebKit モバイル | `pnpm --dir webui run test:e2e:webkit --retries=0` | `browser` |
|
||
| 実際の qBittorrent とパッケージ済みイメージ | `python3 e2e/scripts/run_downloader_lane.py` | `downloader` |
|
||
|
||
- 通常の `pytest` は E2E テストを飛ばします。`-m e2e` を明示する必要があります。
|
||
- `stack.py run` は Compose を片付ける前に診断情報を集め、`$AB_E2E_WORK_DIR/artifacts` に書き出します。Playwright のスクリーンショットと動画は `webui/test-results`、HTML レポートは `webui/playwright-report` にあります。
|
||
- スタックを止めるには：`python3 e2e/scripts/stack.py stop --profile browser --project-name "$AB_E2E_PROJECT" --work-dir "$AB_E2E_WORK_DIR"`。
|
||
|
||
## CI
|
||
|
||
`.github/workflows/e2e.yml` は PR ごとに、ランタイムのレーン、ブラウザのレーン（Chromium、WebKit モバイル）、実際のダウンローダーのレーンを実行します。`e2e-nightly.yml` は毎晩 Firefox のレーンを実行し、ブラウザのレーンとダウンローダーのレーンをそれぞれ独立して 2 回実行します。エンドポイントの構造や検証など、より速い契約テストは `backend/src/test/test_api_*.py` にあります。
|