文件
Gem | RDoc | 範例 (Relish / Gherkin) |
---|---|---|
rspec-core | 3.13 | 3.13 |
rspec-expectations | 3.13 | 3.13 |
rspec-mocks | 3.13 | 3.13 |
rspec-rails | 7.0 | 7.0 |
RSpec 由多個程式庫組成,這些程式庫設計為協同工作,也可以獨立與其他測試工具(如 Cucumber 或 Minitest)一起使用。
RSpec 的組成部分為:
- rspec-core:規格執行器,提供豐富的命令列程式、彈性且可自訂的報表,以及組織程式碼範例的 API。
- rspec-expectations:提供可讀的 API 來表達程式碼範例的預期結果。
- rspec-mocks:測試替身框架,提供多種類型的虛擬物件,讓您能嚴格控制規格執行的環境。
- rspec-rails:支援使用 RSpec 來測試 Ruby on Rails 應用程式,以取代 Rails 內建的測試框架。
API 文件包含 RSpec 支援的所有公開 API 的詳細資訊。我們將這些視為主要文件,並將根據 語意版本控制 的政策來處理這些 API。我們鼓勵您僅使用公開 API,因為私有 API 可能會在任何版本中變更而沒有警告。如果您有現有公開 API 不支援的使用案例,請提問,我們將樂於為您新增 API 或將現有的私有 API 公開。
Gherkin 範例
(例如 RelishApp)
RSpec 也透過以 Gherkin 撰寫的可執行範例進行文件化。這些範例以「端對端」的方式撰寫,示範如何在可執行的規格檔案中使用各種 RSpec 功能。它們是了解 RSpec 功能以及如何將各部分組合在一起的好資源,但若要取得有關特定 API 或功能的詳細文件,我們建議參考 API 文件。
這些功能檔案會在我們的 CI 流程中透過 Cucumber 執行,以確保它們始終與目前的程式碼庫保持同步。
先前我們的 Gherkin 範例可以在 RelishApp 上閱讀,但目前這項服務無法使用。我們感謝 Matt Wynne 多年來對這些範例的貢獻,現在我們透過上表自行託管這些範例。