cyri_ (Cyril Kato)

Fix 1.0：先写规范，再测试

cyri_ — Thu, 05 Nov 2026 23:13:38 +0800

Fix 1.0 发布了。

Fix 是一个 Ruby 的规范框架。它让你用 RFC 2119 的词汇——MUST、SHOULD、MAY——写下一个对象应该做什么，而不涉及它是怎么实现的。规范写好之后，拿任何一个对象去测试它，每条期望得到一个结果。

一个例子

require "fix"

class Duck
  def walk = "Klop klop!"
  def swim = "Swoosh..."
end

Fix :Duck do
  on :walk do
    it MUST eq "Klop klop!"
  end

  on :swim do
    it MUST eq "Swoosh..."
  end

  on :speak do
    it MAY eq "Quaaaaaack!"
  end
end

exit(Fix[:Duck].test { Duck.new })

$ ruby duck_fix.rb
duck_fix.rb:10: Success: expected "Klop klop!" to eq "Klop klop!"
duck_fix.rb:14: Success: expected "Swoosh..." to eq "Swoosh..."
duck_fix.rb:18: Info: NoMethodError: undefined method 'speak' for an instance of Duck
$ echo $?
0

Fix :Duck do … end 构建一份规范，并以这个名字注册；Fix[:Duck] 把它找回来。on :walk 向主体发送 walk，里面的 it 判断返回值。it 后面不是块，而是一个要求：一个级别，然后一个匹配器。

鸭子不会说话，但规范只说它 MAY 说话：方法不存在，结果是一条 Info，规范依然满足，进程退出码为 0。换成 MUST，就是一条 Error，退出码为 1。

五种结果

两个问题把级别区分开来：方法存在吗？MUST 和 SHOULD 要求它存在，MAY 不要求。它做了规范说的事吗？MUST 和 MAY 要求做到，SHOULD 只是建议。于是有五种结果：

级别	匹配	不匹配	方法不存在	其他异常
MUST	Success	Failure	Error	Error
SHOULD	Success	Warning	Error	Error
MAY	Success	Failure	Info	Error

Success、Warning、Info 通过；Failure、Error 不通过。

设计上的几个选择

规范与主体分开。 规范是一份文档，加载时读一遍；主体由 test 的块构建。同一份规范可以测试 Duck.new，也可以测试任何别的对象。
每个上下文一个子进程。 每个有期望的上下文都在 fork 出来的子进程里运行：主体留下的任何状态都碰不到下一个上下文，主体抛出的异常（包括 exit）只是它那一条期望的错误。
输出只有结果。 每条期望一行：位置: 结果: 摘要，错误的 backtrace 缩进在下面。没有颜色，没有点，没有计数。test 返回是否全部通过，exit 把它变成进程的退出码。
很小。 lib/ 下 9 个文件，约 300 行代码。Fix 站在四个各自独立的 gem 上：Aw（在子进程里运行一个块，带回结果）、Defi（把一次方法调用当作值）、Matchi（匹配器）、Spectus（RFC 2119 的级别与判定）。

规范还可以用 let 和 with 给主体传参数，可以用 fix(:Name) 要求另一份规范。fix-command 提供 fix 命令，把 fix/ 目录下的每个 *_fix.rb 各自放在一个进程里运行。这些都在 README 里。

开始

gem "fix"

需要 Ruby 3.3 或更高版本，以及一个支持 fork 的系统。

这个项目我写了十二年，1.0 是它第一次让我觉得没有什么可以再去掉的。欢迎试用，欢迎反馈。

从测试框架中期待什么 Ruby 代码？

cyri_ — Sat, 03 Jul 2021 22:52:36 +0800

你知道当你使用你喜欢的测试框架的DSL时，会产生什么样的代码吗？

作为一个开发者，你可能有兴趣知道。也许直接写出来太吓人了。或者它可能比 minitest 测试集更轻。

总之，为了尝试回答这个问题，同时避免 RSpec 和 minitest 之间无休止的争论，我将在本文中使用RSpec clone 项目。

什么是 RSpec clone？

这个项目是对 RSpec 的一个最小化的重新实现，强调正确性、安全性和标准化。

RSpec clone 试图实现社区RSpec 风格指南中列出的准则和最佳实践。大多数 RSpec 的 DSL 的实现是为了表达所需的结果。没有什么神奇的力量。

为了快速了解该框架是如何构建和执行测试的，我将向你展示 DSL 语法和生成的 Ruby 代码之间的对应关系。为了便于阅读，这些对应关系是按方法分组的。

从 DSL 到 Ruby

`describe` 该方法

当我写：

RSpec.describe String do
end

我希望能产生这样的代码：

Class.new do
  private

  def described_class
    String
  end
end

`context` 该方法

当我写：

RSpec.context "when in a context" do
end

我希望能产生这样的代码：

Class.new do
end

`subject` 该方法

当我写：

RSpec.describe ".subject" do
  subject do
    "foo"
  end
end

我希望能产生这样的代码：

Class.new do
  private

  def subject
    "foo"
  end
end

嵌入的 `describe` 该方法

当我写：

RSpec.describe ".describe" do
  describe "embedded describe" do
  end
end

我希望能产生这样的代码：

base = Class.new do
end

Class.new(base) do
end

`let` 该方法

当我写：

RSpec.describe ".let" do
  let(:answer_to_everything) { 41 + one }
  let(:one) { 1 }
end

我希望能产生这样的代码：

Class.new do
  private

  def answer_to_everything
    41 + one
  end

  def one
    1
  end
end

`before` 该方法

当我写：

RSpec.describe ".before" do
  before do
    puts "hello"
  end
end

我希望能产生这样的代码：

Class.new do
  private

  def initialize
    puts "hello"
  end
end

`expect` 该方法

当我写：

RSpec.describe "#expect" do
  it { expect(41.next).to be(42) }
end

我希望能产生这样的代码：

description = Class.new do
end

require "matchi/rspec"
require "r_spec/clone/expectation_target"

example = Class.new(description) { include Matchi::Helper }
sandbox = example.new
sandbox.instance_eval { ExpectationTarget::Value.new(41.next).to be(42) }

而且我希望看到这种信息：

Success: expected to be 42.

用 Ruby 测试是很有趣的！

除非你不写测试，使用这样一个 DSL 接口的好处是，它限制了在规范中引入可能导致错误的额外逻辑，鼓励使用算法复杂度较低的良好的 Ruby 模式，并使 Ruby 代码更短，更（机器）可读。

来自 Adam Hawkins、

RSpec 是一种特定领域的测试语言，而 minitest 是 Ruby。

我希望你喜欢RSpec clone，就像我喜欢这两样。谢谢你。

用 TestTube 进行 Ruby 代码测试

cyri_ — Mon, 21 Jun 2021 03:44:42 +0800

我要介绍 TestTube 🧪

这个简单的测试工具就是 Spectus 引擎。

要使用 TestTube，需要一个匹配器。例如，来自 Matchi，有一个集合。

现在，让我们使用这个自定义匹配器：

class BeTheAnswer
  def match?
    42.equal?(yield)
  end
end

让我们定义这个块：

block_of_code = -> { "101010".to_i(2) }

现在让我们看看结果：

require "test_tube"

experiment = TestTube.invoke(
  matcher: BeTheAnswer.new,
  negate: false,
  &block_of_code
)

experiment.actual # => 42
experiment.error  # => nil
experiment.got   # => true

成功！做得好！

谢谢你的阅读。

简介 Fix

cyri_ — Mon, 05 Oct 2015 22:26:48 +0800

为规范在 Ruby 中的新工具。

Fix 的是一个最低限度的测试工具。这是不到 200 行代码。它是基于Spectus，Matchi等的Defi。

这里是代码的一个例子：

class Monster
  def self.get
    {
      boo: {
        name: 'Boo',
        life: 123,
        mana: 42
      },
      hasu: {
        name: 'Hasu',
        life: 88,
        mana: 40
      }
    }
  end

  def get(id)
    self.class.get.fetch(id)
  end
end

随着 Fix 的，我们可以写这个测试：

require_relative 'monster'
require 'fix'

Fix.describe Monster do
  on :get do
    on :keys do
      it { MUST eql %i(boo hasu) }
    end
  end

  on :new do
    on :get, :boo do
      it { MUST eql({ name: 'Boo', life: 123, mana: 42 }) }
    end

    on :get, :boom do
      it { MUST raise_exception KeyError }
    end
  end
end

下面是结果：

ruby monster_fix_spec.rb
...

Ran 3 tests in 0.000411 seconds
100% compliant - 0 infos, 0 failures, 0 errors

欲了解更多详情，您可以在这里找到的文档。

快乐编码!!

cyri_ (Cyril Kato)

Fix 1.0：先写规范，再测试

一个例子

五种结果

设计上的几个选择

开始

从测试框架中期待什么 Ruby 代码？

什么是 RSpec clone？

从 DSL 到 Ruby

describe 该方法

context 该方法

subject 该方法

嵌入的 describe 该方法

let 该方法

before 该方法

expect 该方法

用 Ruby 测试是很有趣的！

用 TestTube 进行 Ruby 代码测试

简介 Fix

`describe` 该方法

`context` 该方法

`subject` 该方法

嵌入的 `describe` 该方法

`let` 该方法

`before` 该方法

`expect` 该方法