文档

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 文档。

这些功能文件通过 Cucumber 在我们的 CI 流程中执行，以确保它们始终与当前代码库保持一致。

以前，我们的 Gherkin 示例可以在 RelishApp 上阅读，但目前该服务不可用。感谢 Matt Wynne 多年来提供的托管服务，我们现在通过上面的表格自行托管这些示例。