Weblate 測試套件與連續整合¶

測試套件存在於多數目前代碼，通過為任何新的功能新增測試情況來擴大覆寫範圍，並確認其正常工作。

連續整合¶

Weblate 仰賴 GitHub Actions 執行測試、建置說明文件、程式碼檢查及其他工作，以確保程式碼品質。

Codecov 從已執行的測試中收集程式碼覆蓋率資訊。

有幾項工作來確認不同的方面：

使用 pytest 進行單元與功能測試的。
使用 Sphinx 建置說明文件並檢查外部連結。
使用 ruff 和 pylint 的程式碼 lint 和品質保證。
使用 CodeQL 進行程式碼安全掃描。
視覺化變更測試使用 Argos CI 。
使用 prek 格式化程式碼；這是 pre-commit 框架速度更快的第三方重新實作。
來自所有支援的發佈版本的合併測試
設定確認（確保產生的 dist 檔案不遺失任何內容，並可以測試）

CI 設定位於 .github/workflows 目錄，並大量使用 ci 目錄中的輔助指令碼。這些指令碼也可手動執行，但需要數個環境變數，主要用於指定 Django 設定檔及測試資料庫連線。範例定義位於 scripts/test-database.sh：

weblate/trans/tests/test_selenium.py 中的 Selenium 螢幕擷取畫面測試有兩項用途：在 CI 中產生用於視覺變更測試的圖片，並由 make -C docs update-screenshots 將相同圖片轉換成說明檔案的螢幕擷取畫面。螢幕擷取畫面固定資料應盡量接近實際呈現的頁面，讓 CI 能找出使用者介面的回歸問題。若螢幕擷取畫面包含不固定的執行階段資料，請優先使用可重現的伺服器端測試輸入，而非在呈現後變更 DOM。

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

# Simple way to configure test database from environment

# shellcheck shell=sh

# Database server configuration
export CI_DB_USER=weblate
export CI_DB_PASSWORD=weblate
export CI_DB_HOST=127.0.0.1

# Django settings module to use
export DJANGO_SETTINGS_MODULE=weblate.settings_test

簡單的執行看起來可以像這樣：

source scripts/test-database.sh
./ci/run-migrate
./ci/run-test
./ci/run-docs

Weblate 的本機測試¶

執行測試前，請確保開發依賴已安裝：

uv sync --all-extras --dev

使用 pytest 測試¶

執行測試前，應該收集靜態檔案，因為一些測試在出現時依賴於它們：

DJANGO_SETTINGS_MODULE=weblate.settings_test uv run ./manage.py collectstatic --noinput

您可以使用 pytest 在本機執行測試套件：

uv run pytest

執行單一測試檔案：

uv run pytest weblate/utils/tests/test_search.py

提示

您會需要使用資料庫（PostgreSQL）伺服器來檢測。 Django 預設新增另外的資料庫，以 test_ 前綴來執行測試，因此在您的設定設定使用 weblate 的情況下，測試會使用 test_weblate 資料庫。設定的說明請參閱適用於 Weblate 的資料庫設定。

weblate/settings_test.py 也用在 CI 環境中（請參閱連續整合），並且可以使用環境變數調整：

export CI_DB_USER=weblate
export CI_DB_PASSWORD=weblate
export CI_DB_HOST=127.0.0.1
export CI_DB_PORT=60000
export DJANGO_SETTINGS_MODULE=weblate.settings_test

提示

測試也可以在開發者 docker 容器內執行，請參閱在 Docker 中本機執行 Weblate。

也參考

執行及撰寫 Django 測試的詳細資訊，請參閱 Testing in Django。

Weblate 模組的本機測試¶

測試使用 pytest 執行，首先您需要安裝開發相依套件：

uv sync --all-extras --dev

然後您可以在儲存庫簽出中執行測試套件：

uv run pytest

測試儲存庫¶

Weblate 測試套件中的許多測試會使用測試儲存庫。此儲存庫維護於 https://github.com/WeblateOrg/test。接著使用 scripts/pack-test-data.sh 為各個受支援的版本控制系統產生含儲存庫的 tarball，並以 weblate/trans/tests/data/test-base-repo.git.tar、weblate/trans/tests/data/test-base-repo.hg.tar 及 weblate/trans/tests/data/test-base-repo.svn.tar 儲存在 Weblate 儲存庫中。

https://github.com/WeblateOrg/test 儲存庫會在發行時加上標籤，確保可使用發行標籤存取當時使用的測試資料。指令碼會盡可能建立可重現的 tarball。