Rspec mock argument capture

capture.rb

# just an example of what it could be
argument = capture('label')
widget = double

# argument acts like an argument matcher that always matches but stores a reference to the real value
allow(widget).to receive(:do_something).with(argument)

# contrived, I know this could be done using the instance_of argument matcher
expect(argument.value).to be_instance_of(Something)

You can already do this:

argument = nil
allow(widget).to receive(:do_something) { |arg| argument = arg }
widget.do_something(Something.new)
expect(argument).to be_instance_of(Something)

It's unclear to me what's better about capture then the flexibility you already get from being able to pass a block?

@myronmarston nope, that's all thats needed, I wasn't aware you could yield the argument.

Still, I like the capture syntax :)

expect(foo).to receive(:publish_doc) do |doc|
  expect(doc.category).to eq "Code red"
  expect(doc.message).to eq "The monkeys have escaped"
end