Shoulda Context 技术文档

1. 安装指南

Shoulda Context 是一个简化 Rails 项目或纯 Ruby 项目中 Minitest 和 Test::Unit 测试编写的工具。以下是安装步骤：

• 如果您正在使用 Rails 应用程序，请确保将此宝石添加到 Gemfile 的 test 组中：

group :test do
  gem 'shoulda-context', '~> 3.0.0.rc1'
end

• 如果您没有使用 Rails 应用程序，则可以直接添加：

gem 'shoulda-context', '~> 3.0.0.rc1'

然后运行 bundle install。

2. 项目的使用说明

Shoulda Context 允许您使用英文来命名测试和将它们分组，而不是使用带有许多下划线的 Ruby 方法名。以下是基本用法示例：

class CalculatorTest < Minitest::Test
  context "一个计算器" do
    setup do
      @calculator = Calculator.new
    end

    should "将两个数相加得到和" do
      assert_equal 4, @calculator.sum(2, 2)
    end

    should "将两个数相乘得到积" do
      assert_equal 10, @calculator.product(2, 5)
    end
  end
end

此外，Shoulda Context 还提供了与 RSpec 兼容的匹配器，可以进一步简化和缩短测试代码。

3. 项目API使用文档

以下是 Shoulda Context 的主要 API：

DSL

• context: 声明一个测试组。
• setup: 一个替代定义 setup 方法的 DSL 风格。
• teardown: 一个替代定义 teardown 方法的 DSL 风格。
• should: 有两种形式：
  1. 当传递一个名称和代码块时，创建一个等同于定义 test_ 方法的测试。
  2. 当传递一个匹配器时，创建一个运行匹配器的测试，断言它通过。
• should_not: 类似于 should 的匹配器版本，但创建一个断言匹配器失败的测试。
• should_eventually: 允许您暂时跳过测试。
• subject: 在上下文中定义一个对象作为测试的主要焦点。

Assertions

• assert_same_elements: 比较两个数组是否相等，但忽略顺序。
• assert_contains: 断言数组中有一个元素。
• assert_does_not_contain: assert_contains 的相反。
• assert_accepts: should 内部使用；断言匹配器对象与值匹配。
• assert_reject: should_not 内部使用；断言匹配器对象不与值匹配。

4. 项目安装方式

请参考上述安装指南部分，安装 Shoulda Context。

以上就是关于 Shoulda Context 的技术文档。希望这可以帮助您更好地使用和理解这个项目。