檢視原始碼 測試結構

一般

測試通過執行一個或多個測試套件來進行。一個測試套件包含測試案例、配置函數和資訊函數。測試案例可以分組到所謂的測試案例群組中。測試套件是一個 Erlang 模組，而測試案例則實作為 Erlang 函數。測試套件儲存在測試目錄中。

跳過測試案例

某些測試案例可以被跳過，例如，如果您事先知道某個特定的測試案例會失敗。原因可能是尚未實作的功能、已知但尚未修復的錯誤，或者某些在特定平台上不工作或不適用的功能。

測試案例可以透過以下方式跳過：

  • 在測試規格中使用 skip_suites 和 skip_cases 術語。
  • 從函數 init_per_testcase/2 或 init_per_suite/1 返回 {skip,Reason}。
  • 從測試案例的執行子句返回 {skip,Reason}。執行子句會被調用，因此作者必須確保測試案例不會運行。

當測試案例被跳過時，它會在 HTML 日誌中被標記為 SKIPPED。

術語定義

  • 自動跳過的測試案例 - 當配置函數失敗（即，意外終止）時，依賴該配置函數的測試案例會被 Common Test 自動跳過。測試案例的狀態隨後為「自動跳過」。如果運行時無法獲得所需的配置數據，Common Test 也會「自動跳過」測試案例。

  • 配置函數 - 測試套件中的一個函數，旨在用於設置、清理和/或驗證被測試系統 (SUT) 和/或 Common Test 主機節點上的狀態和環境，以便測試案例（或一組測試案例）可以正確執行。

  • 配置文件 - 包含與測試和/或 SUT 相關數據的文件，例如，協議伺服器地址、客戶端登錄詳細資訊和硬體介面地址。也就是說，任何要在套件中作為變數處理而不是硬編碼的數據。

  • 配置變數 - 與從配置文件讀取到的數據值相關聯的名稱（Erlang 原子）。

  • data_dir - 測試套件的資料目錄。此目錄包含測試套件使用的任何檔案，例如，額外的 Erlang 模組、二進制檔或資料檔案。

  • 資訊函數 - 測試套件中的一個函數，它返回一個屬性列表（由 Common Test 伺服器讀取），描述了執行套件中測試案例的條件。

  • 主要日誌檔 - 一個或多個測試套件的概觀和摘要日誌檔。

  • 次要日誌檔 - 特定測試案例的日誌檔。也稱為測試案例日誌檔。

  • priv_dir - 測試套件的私有目錄。當測試套件需要寫入檔案時，會使用此目錄。

  • ct_run - 一個可執行程式的名稱，可以用作指定和使用 Common Test 運行測試的介面。

  • 測試案例 - 包含在測試套件中的單個測試。測試案例實作為測試套件模組中的一個函數。

  • 測試案例群組 - 一組共享配置函數和執行屬性的測試案例。執行屬性指定群組中的測試案例是以隨機順序、並行或順序執行，以及是否重複執行群組。測試案例群組也可以是巢狀的。也就是說，一個群組除了測試案例外，還可以包含子群組。

  • 測試套件 - 一個 Erlang 模組，包含針對特定功能區域的一組測試案例。

  • 測試目錄 - 包含一個或多個測試套件模組的目錄，也就是一組測試套件。

  • 引數 Config - 一個鍵值組元組列表（也就是一個屬性列表），其中包含從配置函數傳遞到測試案例的運行時配置數據。

  • 使用者跳過的測試案例 - 以 跳過測試案例 節中所述的任何方式明確跳過的測試案例的狀態。