Ruby On Rails in UA/Программирование на ROR/Использование Mocha

Returns a mock object which will detect calls to any instance of this class.
Product.any_instance.stubs(:save).returns(false) product_1 = Product.new assert_equal false, product_1.save product_2 = Product.new assert_equal false, product_2.save


mock(name) → mock object
mock(expected_methods = {}) → mock object
mock(name, expected_methods = {}) → mock object


Note that (contrary to expectations set up by stub) these expectations must be fulfilled during the test.
def test_product product = mock('ipod_product', :manufacturer => 'ipod', :price => 100) assert_equal 'ipod', product.manufacturer assert_equal 100, product.price # an error will be raised unless both Product#manufacturer and Product#price have been called end


stub(name) → mock object
stub(stubbed_methods = {}) → mock object
stub(name, stubbed_methods = {}) → mock object

Note that (contrary to expectations set up by mock) these expectations need not be fulfilled during the test.

def test_product product = stub('ipod_product', :manufacturer => 'ipod', :price => 100) assert_equal 'ipod', product.manufacturer assert_equal 100, product.price # an error will not be raised even if Product#manufacturer and Product#price have not been called end

stub_everything(name) → mock object
stub_everything(stubbed_methods = {}) → mock object
stub_everything(name, stubbed_methods = {}) → mock object

Creates a mock object that accepts calls to any method. By default it will return nil for any method call. name and stubbed_methods work in the same way as for stub.
<br /> def test_product <br /> product = stub_everything('ipod_product', :price => 100) <br /> assert_nil product.manufacturer <br /> assert_nil product.any_old_method <br /> assert_equal 100, product.price <br /> end <br /> <textarea class="ruby" name="code"> <br /> <br /> <b>at_least(minimum_number_of_times) → expectation</b> <br /> <br /> Modifies expectation so that the expected method must be called at least a minimum_number_of_times. <br /> <br /> <textarea class="ruby" name="code"> <br /> object = mock() <br /> object.expects(:expected_method).at_least(2) <br /> 3.times { object.expected_method } <br /> # => verify succeeds <br /> <br /> object = mock() <br /> object.expects(:expected_method).at_least(2) <br /> object.expected_method <br /> # => verify fails <br /> <textarea class="ruby" name="code"> <br /> <br /> <b>at_least_once() → expectation</b> <br /> Modifies expectation so that the expected method must be called at least once. <br /> <br /> object = mock() object.expects(:expected_method).at_least_once object.expected_method # => verify succeeds object = mock() object.expects(:expected_method).at_least_once # => verify fails


at_most(maximum_number_of_times) → expectation
Modifies expectation so that the expected method must be called at most a maximum_number_of_times.

object = mock() object.expects(:expected_method).at_most(2) 2.times { object.expected_method } # => verify succeeds object = mock() object.expects(:expected_method).at_most(2) 3.times { object.expected_method } # => verify fails

at_most_once() → expectation

Modifies expectation so that the expected method must be called at most once.
object = mock() object.expects(:expected_method).at_most_once object.expected_method # => verify succeeds object = mock() object.expects(:expected_method).at_most_once 2.times { object.expected_method } # => verify fails multiple_yields(*parameter_groups) → expectation Modifies expectation so that when the expected method is called, it yields multiple times per invocation with the specified parameter_groups. object = mock() object.expects(:expected_method).multiple_yields(['result_1', 'result_2'], ['result_3']) yielded_values = [] object.expected_method { |*values| yielded_values << values } yielded_values # => [['result_1', 'result_2'], ['result_3]]

May be called multiple times on the same expectation for consecutive invocations. Also see Expectation#then.
object = mock() object.stubs(:expected_method).multiple_yields([1, 2], [3]).then.multiple_yields([4], [5, 6]) yielded_values_from_first_invocation = [] yielded_values_from_second_invocation = [] object.expected_method { |*values| yielded_values_from_first_invocation << values } # first invocation object.expected_method { |*values| yielded_values_from_second_invocation << values } # second invocation yielded_values_from_first_invocation # => [[1, 2], [3]] yielded_values_from_second_invocation # => [[4], [5, 6]]

never() → expectation
Modifies expectation so that the expected method must never be called.
object = mock() object.expects(:expected_method).never object.expected_method # => verify fails object = mock() object.expects(:expected_method).never object.expected_method # => verify succeeds

once() → expectation
Modifies expectation so that the expected method must be called exactly once. Note that this is the default behaviour for an expectation, but you may wish to use it for clarity/emphasis.
object = mock() object.expects(:expected_method).once object.expected_method # => verify succeeds object = mock() object.expects(:expected_method).once object.expected_method object.expected_method # => verify fails object = mock() object.expects(:expected_method).once # => verify fails

raises(exception = RuntimeError?, message = nil) → expectation

Modifies expectation so that when the expected method is called, it raises the specified exception with the specified message.
object = mock() object.expects(:expected_method).raises(Exception, 'message') object.expected_method # => raises exception of class Exception and with message 'message'

May be called multiple times on the same expectation. Also see Expectation#then.
object = mock() object.stubs(:expected_method).raises(Exception1).then.raises(Exception2) object.expected_method # => raises exception of class Exception1 object.expected_method # => raises exception of class Exception2
May be called in conjunction with Expectation#returns on the same expectation.
object = mock() object.stubs(:expected_method).raises(Exception).then.returns(2, 3) object.expected_method # => raises exception of class Exception1 object.expected_method # => 2 object.expected_method # => 3

returns(value) → expectation
:call-seq: returns(*values) → expectation
Modifies expectation so that when the expected method is called, it returns the specified value.
object = mock() object.stubs(:stubbed_method).returns('result') object.stubbed_method # => 'result' object.stubbed_method # => 'result'

If multiple values are given, these are returned in turn on consecutive calls to the method.
object = mock() object.stubs(:stubbed_method).returns(1, 2) object.stubbed_method # => 1 object.stubbed_method # => 2
May be called multiple times on the same expectation. Also see Expectation#then.
object = mock() object.stubs(:expected_method).returns(1, 2).then.returns(3) object.expected_method # => 1 object.expected_method # => 2 object.expected_method # => 3
May be called in conjunction with Expectation#raises on the same expectation.
object = mock() object.stubs(:expected_method).returns(1, 2).then.raises(Exception) object.expected_method # => 1 object.expected_method # => 2 object.expected_method # => raises exception of class Exception1
If value is a Proc, then the expected method will return the result of calling Proc#call.

This usage is deprecated. Use explicit multiple return values and/or multiple expectations instead.

A Proc instance will be treated the same as any other value in a future release.
object = mock() object.stubs(:stubbed_method).returns(lambda { rand(100) }) object.stubbed_method # => 41 object.stubbed_method # => 77

then() → expectation

Syntactic sugar to improve readability. Has no effect on state of the expectation.
object = mock() object.stubs(:expected_method).returns(1, 2).then.raises(Exception).then.returns(4) object.expected_method # => 1 object.expected_method # => 2 object.expected_method # => raises exception of class Exception object.expected_method # => 4

times(range) → expectation
Modifies expectation so that the number of calls to the expected method must be within a specific range.

range can be specified as an exact integer or as a range of integers
object = mock() object.expects(:expected_method).times(3) 3.times { object.expected_method } # => verify succeeds object = mock() object.expects(:expected_method).times(3) 2.times { object.expected_method } # => verify fails object = mock() object.expects(:expected_method).times(2..4) 3.times { object.expected_method } # => verify succeeds object = mock() object.expects(:expected_method).times(2..4) object.expected_method # => verify fails

with(*arguments, ¶meter_block) → expectation

Modifies expectation so that the expected method must be called with specified arguments.
object = mock() object.expects(:expected_method).with(:param1, :param2) object.expected_method(:param1, :param2) # => verify succeeds object = mock() object.expects(:expected_method).with(:param1, :param2) object.expected_method(:param3) # => verify fails

May be used with parameter matchers in Mocha::ParameterMatchers?.

If a parameter_block is given, the block is called with the parameters passed to the expected method. The expectation is matched if the block evaluates to true.
object = mock() object.expects(:expected_method).with() { |value| value % 4 == 0 } object.expected_method(16) # => verify succeeds object = mock() object.expects(:expected_method).with() { |value| value % 4 == 0 } object.expected_method(17) # => verify fails

yields(*parameters) → expectation

Modifies expectation so that when the expected method is called, it yields with the specified parameters.
object = mock() object.expects(:expected_method).yields('result') yielded_value = nil object.expected_method { |value| yielded_value = value } yielded_value # => 'result'

May be called multiple times on the same expectation for consecutive invocations. Also see Expectation#then.
object = mock() object.stubs(:expected_method).yields(1).then.yields(2) yielded_values_from_first_invocation = [] yielded_values_from_second_invocation = [] object.expected_method { |value| yielded_values_from_first_invocation << value } # first invocation object.expected_method { |value| yielded_values_from_second_invocation << value } # second invocation yielded_values_from_first_invocation # => [1] yielded_values_from_second_invocation # => [2]