dchelimsky-rspec 1.1.10
Sign up to get free protection for your applications and to get access to all the features.
- data/History.txt +1192 -0
- data/License.txt +22 -0
- data/Manifest.txt +403 -0
- data/README.txt +39 -0
- data/Rakefile +90 -0
- data/TODO.txt +10 -0
- data/bin/autospec +4 -0
- data/bin/spec +4 -0
- data/examples/pure/autogenerated_docstrings_example.rb +19 -0
- data/examples/pure/before_and_after_example.rb +40 -0
- data/examples/pure/behave_as_example.rb +45 -0
- data/examples/pure/custom_expectation_matchers.rb +54 -0
- data/examples/pure/custom_formatter.rb +12 -0
- data/examples/pure/dynamic_spec.rb +9 -0
- data/examples/pure/file_accessor.rb +19 -0
- data/examples/pure/file_accessor_spec.rb +38 -0
- data/examples/pure/greeter_spec.rb +31 -0
- data/examples/pure/helper_method_example.rb +14 -0
- data/examples/pure/io_processor.rb +8 -0
- data/examples/pure/io_processor_spec.rb +21 -0
- data/examples/pure/legacy_spec.rb +11 -0
- data/examples/pure/mocking_example.rb +27 -0
- data/examples/pure/multi_threaded_behaviour_runner.rb +28 -0
- data/examples/pure/nested_classes_example.rb +36 -0
- data/examples/pure/partial_mock_example.rb +29 -0
- data/examples/pure/pending_example.rb +20 -0
- data/examples/pure/predicate_example.rb +27 -0
- data/examples/pure/priority.txt +1 -0
- data/examples/pure/shared_example_group_example.rb +81 -0
- data/examples/pure/shared_stack_examples.rb +38 -0
- data/examples/pure/spec_helper.rb +3 -0
- data/examples/pure/stack.rb +36 -0
- data/examples/pure/stack_spec.rb +63 -0
- data/examples/pure/stack_spec_with_nested_example_groups.rb +67 -0
- data/examples/pure/stubbing_example.rb +69 -0
- data/examples/pure/yielding_example.rb +33 -0
- data/examples/stories/adder.rb +13 -0
- data/examples/stories/addition +34 -0
- data/examples/stories/addition.rb +9 -0
- data/examples/stories/calculator.rb +65 -0
- data/examples/stories/game-of-life/.loadpath +5 -0
- data/examples/stories/game-of-life/README.txt +21 -0
- data/examples/stories/game-of-life/behaviour/everything.rb +6 -0
- data/examples/stories/game-of-life/behaviour/examples/examples.rb +3 -0
- data/examples/stories/game-of-life/behaviour/examples/game_behaviour.rb +35 -0
- data/examples/stories/game-of-life/behaviour/examples/grid_behaviour.rb +66 -0
- data/examples/stories/game-of-life/behaviour/stories/CellsWithLessThanTwoNeighboursDie.story +21 -0
- data/examples/stories/game-of-life/behaviour/stories/CellsWithMoreThanThreeNeighboursDie.story +21 -0
- data/examples/stories/game-of-life/behaviour/stories/EmptySpacesWithThreeNeighboursCreateACell.story +42 -0
- data/examples/stories/game-of-life/behaviour/stories/ICanCreateACell.story +42 -0
- data/examples/stories/game-of-life/behaviour/stories/ICanKillACell.story +17 -0
- data/examples/stories/game-of-life/behaviour/stories/TheGridWraps.story +53 -0
- data/examples/stories/game-of-life/behaviour/stories/create_a_cell.rb +52 -0
- data/examples/stories/game-of-life/behaviour/stories/helper.rb +6 -0
- data/examples/stories/game-of-life/behaviour/stories/kill_a_cell.rb +26 -0
- data/examples/stories/game-of-life/behaviour/stories/steps.rb +5 -0
- data/examples/stories/game-of-life/behaviour/stories/stories.rb +3 -0
- data/examples/stories/game-of-life/behaviour/stories/stories.txt +22 -0
- data/examples/stories/game-of-life/life/game.rb +23 -0
- data/examples/stories/game-of-life/life/grid.rb +43 -0
- data/examples/stories/game-of-life/life.rb +3 -0
- data/examples/stories/helper.rb +9 -0
- data/examples/stories/steps/addition_steps.rb +18 -0
- data/failing_examples/README.txt +7 -0
- data/failing_examples/diffing_spec.rb +36 -0
- data/failing_examples/failing_autogenerated_docstrings_example.rb +19 -0
- data/failing_examples/failure_in_setup.rb +10 -0
- data/failing_examples/failure_in_teardown.rb +10 -0
- data/failing_examples/mocking_example.rb +40 -0
- data/failing_examples/mocking_with_flexmock.rb +26 -0
- data/failing_examples/mocking_with_mocha.rb +25 -0
- data/failing_examples/mocking_with_rr.rb +27 -0
- data/failing_examples/partial_mock_example.rb +20 -0
- data/failing_examples/predicate_example.rb +29 -0
- data/failing_examples/raising_example.rb +47 -0
- data/failing_examples/spec_helper.rb +3 -0
- data/failing_examples/syntax_error_example.rb +7 -0
- data/failing_examples/team_spec.rb +44 -0
- data/failing_examples/timeout_behaviour.rb +7 -0
- data/init.rb +9 -0
- data/lib/autotest/discover.rb +3 -0
- data/lib/autotest/rspec.rb +46 -0
- data/lib/spec/adapters/ruby_engine/mri.rb +8 -0
- data/lib/spec/adapters/ruby_engine/rubinius.rb +8 -0
- data/lib/spec/adapters/ruby_engine.rb +26 -0
- data/lib/spec/adapters.rb +1 -0
- data/lib/spec/example/before_and_after_hooks.rb +93 -0
- data/lib/spec/example/configuration.rb +167 -0
- data/lib/spec/example/errors.rb +30 -0
- data/lib/spec/example/example_group.rb +25 -0
- data/lib/spec/example/example_group_factory.rb +81 -0
- data/lib/spec/example/example_group_methods.rb +368 -0
- data/lib/spec/example/example_matcher.rb +44 -0
- data/lib/spec/example/example_methods.rb +105 -0
- data/lib/spec/example/module_reopening_fix.rb +21 -0
- data/lib/spec/example/pending.rb +18 -0
- data/lib/spec/example/shared_example_group.rb +52 -0
- data/lib/spec/example.rb +12 -0
- data/lib/spec/expectations/differs/default.rb +66 -0
- data/lib/spec/expectations/errors.rb +12 -0
- data/lib/spec/expectations/extensions/object.rb +63 -0
- data/lib/spec/expectations/extensions/string_and_symbol.rb +17 -0
- data/lib/spec/expectations/extensions.rb +2 -0
- data/lib/spec/expectations/handler.rb +52 -0
- data/lib/spec/expectations.rb +56 -0
- data/lib/spec/extensions/class.rb +24 -0
- data/lib/spec/extensions/main.rb +87 -0
- data/lib/spec/extensions/metaclass.rb +7 -0
- data/lib/spec/extensions/object.rb +6 -0
- data/lib/spec/extensions.rb +4 -0
- data/lib/spec/interop/test/unit/autorunner.rb +6 -0
- data/lib/spec/interop/test/unit/testcase.rb +71 -0
- data/lib/spec/interop/test/unit/testresult.rb +6 -0
- data/lib/spec/interop/test/unit/testsuite_adapter.rb +34 -0
- data/lib/spec/interop/test/unit/ui/console/testrunner.rb +61 -0
- data/lib/spec/interop/test.rb +12 -0
- data/lib/spec/matchers/be.rb +221 -0
- data/lib/spec/matchers/be_close.rb +37 -0
- data/lib/spec/matchers/change.rb +148 -0
- data/lib/spec/matchers/eql.rb +43 -0
- data/lib/spec/matchers/equal.rb +43 -0
- data/lib/spec/matchers/exist.rb +22 -0
- data/lib/spec/matchers/has.rb +34 -0
- data/lib/spec/matchers/have.rb +150 -0
- data/lib/spec/matchers/include.rb +77 -0
- data/lib/spec/matchers/match.rb +41 -0
- data/lib/spec/matchers/operator_matcher.rb +79 -0
- data/lib/spec/matchers/raise_error.rb +132 -0
- data/lib/spec/matchers/respond_to.rb +46 -0
- data/lib/spec/matchers/satisfy.rb +47 -0
- data/lib/spec/matchers/simple_matcher.rb +132 -0
- data/lib/spec/matchers/throw_symbol.rb +74 -0
- data/lib/spec/matchers.rb +162 -0
- data/lib/spec/mocks/argument_constraints.rb +165 -0
- data/lib/spec/mocks/argument_expectation.rb +49 -0
- data/lib/spec/mocks/error_generator.rb +84 -0
- data/lib/spec/mocks/errors.rb +10 -0
- data/lib/spec/mocks/extensions/object.rb +3 -0
- data/lib/spec/mocks/extensions.rb +1 -0
- data/lib/spec/mocks/framework.rb +15 -0
- data/lib/spec/mocks/message_expectation.rb +331 -0
- data/lib/spec/mocks/methods.rb +51 -0
- data/lib/spec/mocks/mock.rb +56 -0
- data/lib/spec/mocks/order_group.rb +29 -0
- data/lib/spec/mocks/proxy.rb +224 -0
- data/lib/spec/mocks/space.rb +28 -0
- data/lib/spec/mocks/spec_methods.rb +46 -0
- data/lib/spec/mocks.rb +200 -0
- data/lib/spec/rake/spectask.rb +227 -0
- data/lib/spec/rake/verify_rcov.rb +52 -0
- data/lib/spec/runner/backtrace_tweaker.rb +56 -0
- data/lib/spec/runner/class_and_arguments_parser.rb +16 -0
- data/lib/spec/runner/command_line.rb +17 -0
- data/lib/spec/runner/drb_command_line.rb +20 -0
- data/lib/spec/runner/example_group_runner.rb +59 -0
- data/lib/spec/runner/formatter/base_formatter.rb +79 -0
- data/lib/spec/runner/formatter/base_text_formatter.rb +126 -0
- data/lib/spec/runner/formatter/failing_example_groups_formatter.rb +27 -0
- data/lib/spec/runner/formatter/failing_examples_formatter.rb +20 -0
- data/lib/spec/runner/formatter/html_formatter.rb +337 -0
- data/lib/spec/runner/formatter/nested_text_formatter.rb +65 -0
- data/lib/spec/runner/formatter/profile_formatter.rb +51 -0
- data/lib/spec/runner/formatter/progress_bar_formatter.rb +34 -0
- data/lib/spec/runner/formatter/snippet_extractor.rb +52 -0
- data/lib/spec/runner/formatter/specdoc_formatter.rb +39 -0
- data/lib/spec/runner/formatter/story/html_formatter.rb +174 -0
- data/lib/spec/runner/formatter/story/plain_text_formatter.rb +194 -0
- data/lib/spec/runner/formatter/story/progress_bar_formatter.rb +42 -0
- data/lib/spec/runner/formatter/text_mate_formatter.rb +16 -0
- data/lib/spec/runner/heckle_runner.rb +72 -0
- data/lib/spec/runner/heckle_runner_unsupported.rb +10 -0
- data/lib/spec/runner/option_parser.rb +205 -0
- data/lib/spec/runner/options.rb +320 -0
- data/lib/spec/runner/reporter.rb +167 -0
- data/lib/spec/runner/spec_parser.rb +71 -0
- data/lib/spec/runner.rb +213 -0
- data/lib/spec/story/extensions/main.rb +86 -0
- data/lib/spec/story/extensions/regexp.rb +9 -0
- data/lib/spec/story/extensions/string.rb +9 -0
- data/lib/spec/story/extensions.rb +3 -0
- data/lib/spec/story/given_scenario.rb +14 -0
- data/lib/spec/story/runner/plain_text_story_runner.rb +48 -0
- data/lib/spec/story/runner/scenario_collector.rb +18 -0
- data/lib/spec/story/runner/scenario_runner.rb +54 -0
- data/lib/spec/story/runner/story_mediator.rb +137 -0
- data/lib/spec/story/runner/story_parser.rb +247 -0
- data/lib/spec/story/runner/story_runner.rb +70 -0
- data/lib/spec/story/runner.rb +59 -0
- data/lib/spec/story/scenario.rb +14 -0
- data/lib/spec/story/step.rb +70 -0
- data/lib/spec/story/step_group.rb +89 -0
- data/lib/spec/story/step_mother.rb +38 -0
- data/lib/spec/story/story.rb +39 -0
- data/lib/spec/story/world.rb +128 -0
- data/lib/spec/story.rb +10 -0
- data/lib/spec/version.rb +13 -0
- data/lib/spec.rb +32 -0
- data/plugins/mock_frameworks/flexmock.rb +23 -0
- data/plugins/mock_frameworks/mocha.rb +19 -0
- data/plugins/mock_frameworks/rr.rb +21 -0
- data/plugins/mock_frameworks/rspec.rb +20 -0
- data/rake_tasks/examples.rake +7 -0
- data/rake_tasks/examples_with_rcov.rake +9 -0
- data/rake_tasks/failing_examples_with_html.rake +9 -0
- data/rake_tasks/verify_rcov.rake +7 -0
- data/rspec.gemspec +42 -0
- data/spec/README.jruby +15 -0
- data/spec/autotest/autotest_helper.rb +6 -0
- data/spec/autotest/autotest_matchers.rb +47 -0
- data/spec/autotest/discover_spec.rb +19 -0
- data/spec/autotest/rspec_spec.rb +150 -0
- data/spec/rspec_suite.rb +6 -0
- data/spec/ruby_forker.rb +13 -0
- data/spec/spec/adapters/ruby_engine_spec.rb +16 -0
- data/spec/spec/example/configuration_spec.rb +296 -0
- data/spec/spec/example/example_group_class_definition_spec.rb +48 -0
- data/spec/spec/example/example_group_factory_spec.rb +165 -0
- data/spec/spec/example/example_group_methods_spec.rb +584 -0
- data/spec/spec/example/example_group_spec.rb +683 -0
- data/spec/spec/example/example_matcher_spec.rb +96 -0
- data/spec/spec/example/example_methods_spec.rb +169 -0
- data/spec/spec/example/example_runner_spec.rb +194 -0
- data/spec/spec/example/nested_example_group_spec.rb +71 -0
- data/spec/spec/example/pending_module_spec.rb +145 -0
- data/spec/spec/example/predicate_matcher_spec.rb +21 -0
- data/spec/spec/example/shared_example_group_spec.rb +281 -0
- data/spec/spec/example/subclassing_example_group_spec.rb +25 -0
- data/spec/spec/expectations/differs/default_spec.rb +127 -0
- data/spec/spec/expectations/extensions/object_spec.rb +95 -0
- data/spec/spec/expectations/fail_with_spec.rb +71 -0
- data/spec/spec/extensions/main_spec.rb +71 -0
- data/spec/spec/interop/test/unit/resources/spec_that_fails.rb +10 -0
- data/spec/spec/interop/test/unit/resources/spec_that_passes.rb +10 -0
- data/spec/spec/interop/test/unit/resources/spec_with_errors.rb +10 -0
- data/spec/spec/interop/test/unit/resources/spec_with_options_hash.rb +13 -0
- data/spec/spec/interop/test/unit/resources/test_case_that_fails.rb +10 -0
- data/spec/spec/interop/test/unit/resources/test_case_that_passes.rb +10 -0
- data/spec/spec/interop/test/unit/resources/test_case_with_errors.rb +10 -0
- data/spec/spec/interop/test/unit/resources/testsuite_adapter_spec_with_test_unit.rb +38 -0
- data/spec/spec/interop/test/unit/spec_spec.rb +52 -0
- data/spec/spec/interop/test/unit/test_unit_spec_helper.rb +14 -0
- data/spec/spec/interop/test/unit/testcase_spec.rb +49 -0
- data/spec/spec/interop/test/unit/testsuite_adapter_spec.rb +9 -0
- data/spec/spec/matchers/be_close_spec.rb +39 -0
- data/spec/spec/matchers/be_spec.rb +248 -0
- data/spec/spec/matchers/change_spec.rb +329 -0
- data/spec/spec/matchers/description_generation_spec.rb +153 -0
- data/spec/spec/matchers/eql_spec.rb +28 -0
- data/spec/spec/matchers/equal_spec.rb +28 -0
- data/spec/spec/matchers/exist_spec.rb +57 -0
- data/spec/spec/matchers/handler_spec.rb +150 -0
- data/spec/spec/matchers/has_spec.rb +63 -0
- data/spec/spec/matchers/have_spec.rb +394 -0
- data/spec/spec/matchers/include_spec.rb +64 -0
- data/spec/spec/matchers/match_spec.rb +37 -0
- data/spec/spec/matchers/matcher_methods_spec.rb +78 -0
- data/spec/spec/matchers/mock_constraint_matchers_spec.rb +24 -0
- data/spec/spec/matchers/operator_matcher_spec.rb +191 -0
- data/spec/spec/matchers/raise_error_spec.rb +315 -0
- data/spec/spec/matchers/respond_to_spec.rb +54 -0
- data/spec/spec/matchers/satisfy_spec.rb +36 -0
- data/spec/spec/matchers/simple_matcher_spec.rb +93 -0
- data/spec/spec/matchers/throw_symbol_spec.rb +54 -0
- data/spec/spec/mocks/any_number_of_times_spec.rb +36 -0
- data/spec/spec/mocks/argument_expectation_spec.rb +23 -0
- data/spec/spec/mocks/at_least_spec.rb +97 -0
- data/spec/spec/mocks/at_most_spec.rb +93 -0
- data/spec/spec/mocks/bug_report_10260_spec.rb +8 -0
- data/spec/spec/mocks/bug_report_10263_spec.rb +24 -0
- data/spec/spec/mocks/bug_report_11545_spec.rb +33 -0
- data/spec/spec/mocks/bug_report_15719_spec.rb +30 -0
- data/spec/spec/mocks/bug_report_496.rb +17 -0
- data/spec/spec/mocks/bug_report_7611_spec.rb +19 -0
- data/spec/spec/mocks/bug_report_7805_spec.rb +22 -0
- data/spec/spec/mocks/bug_report_8165_spec.rb +31 -0
- data/spec/spec/mocks/bug_report_8302_spec.rb +26 -0
- data/spec/spec/mocks/failing_mock_argument_constraints_spec.rb +95 -0
- data/spec/spec/mocks/hash_including_matcher_spec.rb +53 -0
- data/spec/spec/mocks/mock_ordering_spec.rb +84 -0
- data/spec/spec/mocks/mock_space_spec.rb +54 -0
- data/spec/spec/mocks/mock_spec.rb +555 -0
- data/spec/spec/mocks/multiple_return_value_spec.rb +113 -0
- data/spec/spec/mocks/nil_expectation_warning_spec.rb +53 -0
- data/spec/spec/mocks/null_object_mock_spec.rb +54 -0
- data/spec/spec/mocks/once_counts_spec.rb +53 -0
- data/spec/spec/mocks/options_hash_spec.rb +35 -0
- data/spec/spec/mocks/partial_mock_spec.rb +149 -0
- data/spec/spec/mocks/partial_mock_using_mocks_directly_spec.rb +66 -0
- data/spec/spec/mocks/passing_mock_argument_constraints_spec.rb +130 -0
- data/spec/spec/mocks/precise_counts_spec.rb +52 -0
- data/spec/spec/mocks/record_messages_spec.rb +26 -0
- data/spec/spec/mocks/stub_spec.rb +188 -0
- data/spec/spec/mocks/twice_counts_spec.rb +67 -0
- data/spec/spec/package/bin_spec_spec.rb +22 -0
- data/spec/spec/runner/class_and_argument_parser_spec.rb +23 -0
- data/spec/spec/runner/command_line_spec.rb +141 -0
- data/spec/spec/runner/drb_command_line_spec.rb +97 -0
- data/spec/spec/runner/empty_file.txt +0 -0
- data/spec/spec/runner/examples.txt +2 -0
- data/spec/spec/runner/failed.txt +3 -0
- data/spec/spec/runner/formatter/base_formatter_spec.rb +112 -0
- data/spec/spec/runner/formatter/failing_example_groups_formatter_spec.rb +45 -0
- data/spec/spec/runner/formatter/failing_examples_formatter_spec.rb +33 -0
- data/spec/spec/runner/formatter/html_formatted-1.8.4.html +365 -0
- data/spec/spec/runner/formatter/html_formatted-1.8.5-jruby.html +387 -0
- data/spec/spec/runner/formatter/html_formatted-1.8.5.html +371 -0
- data/spec/spec/runner/formatter/html_formatted-1.8.6-jruby.html +381 -0
- data/spec/spec/runner/formatter/html_formatted-1.8.6.html +370 -0
- data/spec/spec/runner/formatter/html_formatter_spec.rb +61 -0
- data/spec/spec/runner/formatter/nested_text_formatter_spec.rb +318 -0
- data/spec/spec/runner/formatter/profile_formatter_spec.rb +65 -0
- data/spec/spec/runner/formatter/progress_bar_formatter_spec.rb +155 -0
- data/spec/spec/runner/formatter/snippet_extractor_spec.rb +18 -0
- data/spec/spec/runner/formatter/spec_mate_formatter_spec.rb +103 -0
- data/spec/spec/runner/formatter/specdoc_formatter_spec.rb +159 -0
- data/spec/spec/runner/formatter/story/html_formatter_spec.rb +135 -0
- data/spec/spec/runner/formatter/story/plain_text_formatter_spec.rb +600 -0
- data/spec/spec/runner/formatter/story/progress_bar_formatter_spec.rb +82 -0
- data/spec/spec/runner/formatter/text_mate_formatted-1.8.4.html +365 -0
- data/spec/spec/runner/formatter/text_mate_formatted-1.8.6.html +370 -0
- data/spec/spec/runner/heckle_runner_spec.rb +78 -0
- data/spec/spec/runner/heckler_spec.rb +13 -0
- data/spec/spec/runner/noisy_backtrace_tweaker_spec.rb +45 -0
- data/spec/spec/runner/option_parser_spec.rb +421 -0
- data/spec/spec/runner/options_spec.rb +450 -0
- data/spec/spec/runner/output_one_time_fixture.rb +7 -0
- data/spec/spec/runner/output_one_time_fixture_runner.rb +8 -0
- data/spec/spec/runner/output_one_time_spec.rb +16 -0
- data/spec/spec/runner/quiet_backtrace_tweaker_spec.rb +62 -0
- data/spec/spec/runner/reporter_spec.rb +238 -0
- data/spec/spec/runner/resources/a_bar.rb +0 -0
- data/spec/spec/runner/resources/a_foo.rb +0 -0
- data/spec/spec/runner/resources/a_spec.rb +1 -0
- data/spec/spec/runner/spec.opts +2 -0
- data/spec/spec/runner/spec_drb.opts +1 -0
- data/spec/spec/runner/spec_parser/spec_parser_fixture.rb +70 -0
- data/spec/spec/runner/spec_parser_spec.rb +85 -0
- data/spec/spec/runner/spec_spaced.opts +2 -0
- data/spec/spec/runner_spec.rb +11 -0
- data/spec/spec/spec_classes.rb +133 -0
- data/spec/spec/story/builders.rb +46 -0
- data/spec/spec/story/extensions/main_spec.rb +161 -0
- data/spec/spec/story/extensions_spec.rb +14 -0
- data/spec/spec/story/given_scenario_spec.rb +27 -0
- data/spec/spec/story/runner/plain_text_story_runner_spec.rb +90 -0
- data/spec/spec/story/runner/scenario_collector_spec.rb +27 -0
- data/spec/spec/story/runner/scenario_runner_spec.rb +214 -0
- data/spec/spec/story/runner/story_mediator_spec.rb +143 -0
- data/spec/spec/story/runner/story_parser_spec.rb +401 -0
- data/spec/spec/story/runner/story_runner_spec.rb +294 -0
- data/spec/spec/story/runner_spec.rb +93 -0
- data/spec/spec/story/scenario_spec.rb +18 -0
- data/spec/spec/story/step_group_spec.rb +157 -0
- data/spec/spec/story/step_mother_spec.rb +84 -0
- data/spec/spec/story/step_spec.rb +272 -0
- data/spec/spec/story/story_helper.rb +2 -0
- data/spec/spec/story/story_spec.rb +84 -0
- data/spec/spec/story/world_spec.rb +423 -0
- data/spec/spec.opts +6 -0
- data/spec/spec_helper.rb +77 -0
- data/stories/all.rb +5 -0
- data/stories/configuration/before_blocks.story +21 -0
- data/stories/configuration/stories.rb +7 -0
- data/stories/example_groups/autogenerated_docstrings +45 -0
- data/stories/example_groups/example_group_with_should_methods +17 -0
- data/stories/example_groups/nested_groups +17 -0
- data/stories/example_groups/output +25 -0
- data/stories/example_groups/stories.rb +7 -0
- data/stories/helper.rb +6 -0
- data/stories/interop/examples_and_tests_together +30 -0
- data/stories/interop/stories.rb +7 -0
- data/stories/interop/test_case_with_should_methods +17 -0
- data/stories/mock_framework_integration/stories.rb +7 -0
- data/stories/mock_framework_integration/use_flexmock.story +9 -0
- data/stories/pending_stories/README +3 -0
- data/stories/resources/helpers/cmdline.rb +9 -0
- data/stories/resources/helpers/story_helper.rb +16 -0
- data/stories/resources/matchers/smart_match.rb +37 -0
- data/stories/resources/spec/before_blocks_example.rb +32 -0
- data/stories/resources/spec/example_group_with_should_methods.rb +12 -0
- data/stories/resources/spec/simple_spec.rb +8 -0
- data/stories/resources/spec/spec_with_flexmock.rb +18 -0
- data/stories/resources/steps/running_rspec.rb +50 -0
- data/stories/resources/stories/failing_story.rb +15 -0
- data/stories/resources/test/spec_and_test_together.rb +57 -0
- data/stories/resources/test/test_case_with_should_methods.rb +30 -0
- data/stories/stories/multiline_steps.story +23 -0
- data/stories/stories/steps/multiline_steps.rb +13 -0
- data/stories/stories/stories.rb +6 -0
- data/story_server/prototype/javascripts/builder.js +136 -0
- data/story_server/prototype/javascripts/controls.js +972 -0
- data/story_server/prototype/javascripts/dragdrop.js +976 -0
- data/story_server/prototype/javascripts/effects.js +1117 -0
- data/story_server/prototype/javascripts/prototype.js +4140 -0
- data/story_server/prototype/javascripts/rspec.js +149 -0
- data/story_server/prototype/javascripts/scriptaculous.js +58 -0
- data/story_server/prototype/javascripts/slider.js +276 -0
- data/story_server/prototype/javascripts/sound.js +55 -0
- data/story_server/prototype/javascripts/unittest.js +568 -0
- data/story_server/prototype/lib/server.rb +24 -0
- data/story_server/prototype/stories.html +176 -0
- data/story_server/prototype/stylesheets/rspec.css +136 -0
- data/story_server/prototype/stylesheets/test.css +90 -0
- metadata +495 -0
@@ -0,0 +1,51 @@
|
|
1
|
+
module Spec
|
2
|
+
module Mocks
|
3
|
+
module Methods
|
4
|
+
def should_receive(sym, opts={}, &block)
|
5
|
+
__mock_proxy.add_message_expectation(opts[:expected_from] || caller(1)[0], sym.to_sym, opts, &block)
|
6
|
+
end
|
7
|
+
|
8
|
+
def should_not_receive(sym, &block)
|
9
|
+
__mock_proxy.add_negative_message_expectation(caller(1)[0], sym.to_sym, &block)
|
10
|
+
end
|
11
|
+
|
12
|
+
def stub!(sym_or_hash, opts={})
|
13
|
+
if Hash === sym_or_hash
|
14
|
+
sym_or_hash.each {|method, value| stub!(method).and_return value }
|
15
|
+
else
|
16
|
+
__mock_proxy.add_stub(caller(1)[0], sym_or_hash.to_sym, opts)
|
17
|
+
end
|
18
|
+
end
|
19
|
+
|
20
|
+
def received_message?(sym, *args, &block) #:nodoc:
|
21
|
+
__mock_proxy.received_message?(sym.to_sym, *args, &block)
|
22
|
+
end
|
23
|
+
|
24
|
+
def rspec_verify #:nodoc:
|
25
|
+
__mock_proxy.verify
|
26
|
+
end
|
27
|
+
|
28
|
+
def rspec_reset #:nodoc:
|
29
|
+
__mock_proxy.reset
|
30
|
+
end
|
31
|
+
|
32
|
+
def as_null_object
|
33
|
+
__mock_proxy.as_null_object
|
34
|
+
end
|
35
|
+
|
36
|
+
def null_object?
|
37
|
+
__mock_proxy.null_object?
|
38
|
+
end
|
39
|
+
|
40
|
+
private
|
41
|
+
|
42
|
+
def __mock_proxy
|
43
|
+
if Mock === self
|
44
|
+
@mock_proxy ||= Proxy.new(self, @name, @options)
|
45
|
+
else
|
46
|
+
@mock_proxy ||= Proxy.new(self)
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
50
|
+
end
|
51
|
+
end
|
@@ -0,0 +1,56 @@
|
|
1
|
+
module Spec
|
2
|
+
module Mocks
|
3
|
+
class Mock
|
4
|
+
include Methods
|
5
|
+
|
6
|
+
# Creates a new mock with a +name+ (that will be used in error messages
|
7
|
+
# only) == Options:
|
8
|
+
# * <tt>:null_object</tt> - if true, the mock object acts as a forgiving
|
9
|
+
# null object allowing any message to be sent to it.
|
10
|
+
def initialize(name, stubs_and_options={})
|
11
|
+
@name = name
|
12
|
+
@options = parse_options(stubs_and_options)
|
13
|
+
assign_stubs(stubs_and_options)
|
14
|
+
end
|
15
|
+
|
16
|
+
# This allows for comparing the mock to other objects that proxy such as
|
17
|
+
# ActiveRecords belongs_to proxy objects By making the other object run
|
18
|
+
# the comparison, we're sure the call gets delegated to the proxy target
|
19
|
+
# This is an unfortunate side effect from ActiveRecord, but this should
|
20
|
+
# be safe unless the RHS redefines == in a nonsensical manner
|
21
|
+
def ==(other)
|
22
|
+
other == __mock_proxy
|
23
|
+
end
|
24
|
+
|
25
|
+
def method_missing(sym, *args, &block)
|
26
|
+
__mock_proxy.instance_eval {@messages_received << [sym, args, block]}
|
27
|
+
begin
|
28
|
+
return self if __mock_proxy.null_object?
|
29
|
+
super(sym, *args, &block)
|
30
|
+
rescue NameError
|
31
|
+
__mock_proxy.raise_unexpected_message_error sym, *args
|
32
|
+
end
|
33
|
+
end
|
34
|
+
|
35
|
+
def inspect
|
36
|
+
"#<#{self.class}:#{sprintf '0x%x', self.object_id} @name=#{@name.inspect}>"
|
37
|
+
end
|
38
|
+
|
39
|
+
def to_s
|
40
|
+
inspect.gsub('<','[').gsub('>',']')
|
41
|
+
end
|
42
|
+
|
43
|
+
private
|
44
|
+
|
45
|
+
def parse_options(options)
|
46
|
+
options.has_key?(:null_object) ? {:null_object => options.delete(:null_object)} : {}
|
47
|
+
end
|
48
|
+
|
49
|
+
def assign_stubs(stubs)
|
50
|
+
stubs.each_pair do |message, response|
|
51
|
+
stub!(message).and_return(response)
|
52
|
+
end
|
53
|
+
end
|
54
|
+
end
|
55
|
+
end
|
56
|
+
end
|
@@ -0,0 +1,29 @@
|
|
1
|
+
module Spec
|
2
|
+
module Mocks
|
3
|
+
class OrderGroup
|
4
|
+
def initialize error_generator
|
5
|
+
@error_generator = error_generator
|
6
|
+
@ordering = Array.new
|
7
|
+
end
|
8
|
+
|
9
|
+
def register(expectation)
|
10
|
+
@ordering << expectation
|
11
|
+
end
|
12
|
+
|
13
|
+
def ready_for?(expectation)
|
14
|
+
return @ordering.first == expectation
|
15
|
+
end
|
16
|
+
|
17
|
+
def consume
|
18
|
+
@ordering.shift
|
19
|
+
end
|
20
|
+
|
21
|
+
def handle_order_constraint expectation
|
22
|
+
return unless @ordering.include? expectation
|
23
|
+
return consume if ready_for?(expectation)
|
24
|
+
@error_generator.raise_out_of_order_error expectation.sym
|
25
|
+
end
|
26
|
+
|
27
|
+
end
|
28
|
+
end
|
29
|
+
end
|
@@ -0,0 +1,224 @@
|
|
1
|
+
module Spec
|
2
|
+
module Mocks
|
3
|
+
class Proxy
|
4
|
+
DEFAULT_OPTIONS = {
|
5
|
+
:null_object => false,
|
6
|
+
}
|
7
|
+
|
8
|
+
@@warn_about_expectations_on_nil = true
|
9
|
+
|
10
|
+
def self.allow_message_expectations_on_nil
|
11
|
+
@@warn_about_expectations_on_nil = false
|
12
|
+
|
13
|
+
# ensure nil.rspec_verify is called even if an expectation is not set in the example
|
14
|
+
# otherwise the allowance would effect subsequent examples
|
15
|
+
$rspec_mocks.add(nil) unless $rspec_mocks.nil?
|
16
|
+
end
|
17
|
+
|
18
|
+
def initialize(target, name=nil, options={})
|
19
|
+
@target = target
|
20
|
+
@name = name
|
21
|
+
@error_generator = ErrorGenerator.new target, name
|
22
|
+
@expectation_ordering = OrderGroup.new @error_generator
|
23
|
+
@expectations = []
|
24
|
+
@messages_received = []
|
25
|
+
@stubs = []
|
26
|
+
@proxied_methods = []
|
27
|
+
@options = options ? DEFAULT_OPTIONS.dup.merge(options) : DEFAULT_OPTIONS
|
28
|
+
end
|
29
|
+
|
30
|
+
def null_object?
|
31
|
+
@options[:null_object]
|
32
|
+
end
|
33
|
+
|
34
|
+
def as_null_object
|
35
|
+
@options[:null_object] = true
|
36
|
+
@target
|
37
|
+
end
|
38
|
+
|
39
|
+
def add_message_expectation(expected_from, sym, opts={}, &block)
|
40
|
+
__add sym
|
41
|
+
warn_if_nil_class sym
|
42
|
+
if existing_stub = @stubs.detect {|s| s.sym == sym }
|
43
|
+
expectation = existing_stub.build_child(expected_from, block_given?? block : nil, 1, opts)
|
44
|
+
else
|
45
|
+
expectation = MessageExpectation.new(@error_generator, @expectation_ordering, expected_from, sym, block_given? ? block : nil, 1, opts)
|
46
|
+
end
|
47
|
+
@expectations << expectation
|
48
|
+
@expectations.last
|
49
|
+
end
|
50
|
+
|
51
|
+
def add_negative_message_expectation(expected_from, sym, &block)
|
52
|
+
__add sym
|
53
|
+
warn_if_nil_class sym
|
54
|
+
@expectations << NegativeMessageExpectation.new(@error_generator, @expectation_ordering, expected_from, sym, block_given? ? block : nil)
|
55
|
+
@expectations.last
|
56
|
+
end
|
57
|
+
|
58
|
+
def add_stub(expected_from, sym, opts={})
|
59
|
+
__add sym
|
60
|
+
@stubs.unshift MessageExpectation.new(@error_generator, @expectation_ordering, expected_from, sym, nil, :any, opts)
|
61
|
+
@stubs.first
|
62
|
+
end
|
63
|
+
|
64
|
+
def verify #:nodoc:
|
65
|
+
verify_expectations
|
66
|
+
ensure
|
67
|
+
reset
|
68
|
+
end
|
69
|
+
|
70
|
+
def reset
|
71
|
+
clear_expectations
|
72
|
+
clear_stubs
|
73
|
+
reset_proxied_methods
|
74
|
+
clear_proxied_methods
|
75
|
+
reset_nil_expectations_warning
|
76
|
+
end
|
77
|
+
|
78
|
+
def received_message?(sym, *args, &block)
|
79
|
+
@messages_received.any? {|array| array == [sym, args, block]}
|
80
|
+
end
|
81
|
+
|
82
|
+
def has_negative_expectation?(sym)
|
83
|
+
@expectations.detect {|expectation| expectation.negative_expectation_for?(sym)}
|
84
|
+
end
|
85
|
+
|
86
|
+
def message_received(sym, *args, &block)
|
87
|
+
expectation = find_matching_expectation(sym, *args)
|
88
|
+
stub = find_matching_method_stub(sym, *args)
|
89
|
+
|
90
|
+
if (stub && expectation && expectation.called_max_times?) || (stub && !expectation)
|
91
|
+
if expectation = find_almost_matching_expectation(sym, *args)
|
92
|
+
expectation.advise(args, block) unless expectation.expected_messages_received?
|
93
|
+
end
|
94
|
+
stub.invoke([], block)
|
95
|
+
elsif expectation
|
96
|
+
expectation.invoke(args, block)
|
97
|
+
elsif expectation = find_almost_matching_expectation(sym, *args)
|
98
|
+
expectation.advise(args, block) if null_object? unless expectation.expected_messages_received?
|
99
|
+
raise_unexpected_message_args_error(expectation, *args) unless (has_negative_expectation?(sym) or null_object?)
|
100
|
+
else
|
101
|
+
@target.send :method_missing, sym, *args, &block
|
102
|
+
end
|
103
|
+
end
|
104
|
+
|
105
|
+
def raise_unexpected_message_args_error(expectation, *args)
|
106
|
+
@error_generator.raise_unexpected_message_args_error expectation, *args
|
107
|
+
end
|
108
|
+
|
109
|
+
def raise_unexpected_message_error(sym, *args)
|
110
|
+
@error_generator.raise_unexpected_message_error sym, *args
|
111
|
+
end
|
112
|
+
|
113
|
+
private
|
114
|
+
|
115
|
+
def __add(sym)
|
116
|
+
$rspec_mocks.add(@target) unless $rspec_mocks.nil?
|
117
|
+
define_expected_method(sym)
|
118
|
+
end
|
119
|
+
|
120
|
+
def warn_if_nil_class(sym)
|
121
|
+
if proxy_for_nil_class? && @@warn_about_expectations_on_nil
|
122
|
+
Kernel.warn("An expectation of :#{sym} was set on nil. Called from #{caller[2]}. Use allow_message_expectations_on_nil to disable warnings.")
|
123
|
+
end
|
124
|
+
end
|
125
|
+
|
126
|
+
def define_expected_method(sym)
|
127
|
+
visibility_string = "#{visibility(sym)} :#{sym}"
|
128
|
+
if target_responds_to?(sym) && !target_metaclass.method_defined?(munge(sym))
|
129
|
+
munged_sym = munge(sym)
|
130
|
+
target_metaclass.instance_eval do
|
131
|
+
alias_method munged_sym, sym if method_defined?(sym.to_s)
|
132
|
+
end
|
133
|
+
@proxied_methods << sym
|
134
|
+
end
|
135
|
+
|
136
|
+
target_metaclass.class_eval(<<-EOF, __FILE__, __LINE__)
|
137
|
+
def #{sym}(*args, &block)
|
138
|
+
__mock_proxy.message_received :#{sym}, *args, &block
|
139
|
+
end
|
140
|
+
#{visibility_string}
|
141
|
+
EOF
|
142
|
+
end
|
143
|
+
|
144
|
+
def target_responds_to?(sym)
|
145
|
+
return @target.send(munge(:respond_to?),sym) if @already_proxied_respond_to
|
146
|
+
return @already_proxied_respond_to = true if sym == :respond_to?
|
147
|
+
return @target.respond_to?(sym)
|
148
|
+
end
|
149
|
+
|
150
|
+
def visibility(sym)
|
151
|
+
if Mock === @target
|
152
|
+
'public'
|
153
|
+
elsif target_metaclass.private_method_defined?(sym)
|
154
|
+
'private'
|
155
|
+
elsif target_metaclass.protected_method_defined?(sym)
|
156
|
+
'protected'
|
157
|
+
else
|
158
|
+
'public'
|
159
|
+
end
|
160
|
+
end
|
161
|
+
|
162
|
+
def munge(sym)
|
163
|
+
"proxied_by_rspec__#{sym.to_s}".to_sym
|
164
|
+
end
|
165
|
+
|
166
|
+
def clear_expectations
|
167
|
+
@expectations.clear
|
168
|
+
end
|
169
|
+
|
170
|
+
def clear_stubs
|
171
|
+
@stubs.clear
|
172
|
+
end
|
173
|
+
|
174
|
+
def clear_proxied_methods
|
175
|
+
@proxied_methods.clear
|
176
|
+
end
|
177
|
+
|
178
|
+
def target_metaclass
|
179
|
+
class << @target; self; end
|
180
|
+
end
|
181
|
+
|
182
|
+
def verify_expectations
|
183
|
+
@expectations.each do |expectation|
|
184
|
+
expectation.verify_messages_received
|
185
|
+
end
|
186
|
+
end
|
187
|
+
|
188
|
+
def reset_proxied_methods
|
189
|
+
@proxied_methods.each do |sym|
|
190
|
+
munged_sym = munge(sym)
|
191
|
+
target_metaclass.instance_eval do
|
192
|
+
if method_defined?(munged_sym.to_s)
|
193
|
+
alias_method sym, munged_sym
|
194
|
+
undef_method munged_sym
|
195
|
+
else
|
196
|
+
undef_method sym
|
197
|
+
end
|
198
|
+
end
|
199
|
+
end
|
200
|
+
end
|
201
|
+
|
202
|
+
def proxy_for_nil_class?
|
203
|
+
@target.nil?
|
204
|
+
end
|
205
|
+
|
206
|
+
def reset_nil_expectations_warning
|
207
|
+
@@warn_about_expectations_on_nil = true if proxy_for_nil_class?
|
208
|
+
end
|
209
|
+
|
210
|
+
def find_matching_expectation(sym, *args)
|
211
|
+
@expectations.find {|expectation| expectation.matches(sym, args)}
|
212
|
+
end
|
213
|
+
|
214
|
+
def find_almost_matching_expectation(sym, *args)
|
215
|
+
@expectations.find {|expectation| expectation.matches_name_but_not_args(sym, args)}
|
216
|
+
end
|
217
|
+
|
218
|
+
def find_matching_method_stub(sym, *args)
|
219
|
+
@stubs.find {|stub| stub.matches(sym, args)}
|
220
|
+
end
|
221
|
+
|
222
|
+
end
|
223
|
+
end
|
224
|
+
end
|
@@ -0,0 +1,28 @@
|
|
1
|
+
module Spec
|
2
|
+
module Mocks
|
3
|
+
class Space
|
4
|
+
def add(obj)
|
5
|
+
mocks << obj unless mocks.detect {|m| m.equal? obj}
|
6
|
+
end
|
7
|
+
|
8
|
+
def verify_all
|
9
|
+
mocks.each do |mock|
|
10
|
+
mock.rspec_verify
|
11
|
+
end
|
12
|
+
end
|
13
|
+
|
14
|
+
def reset_all
|
15
|
+
mocks.each do |mock|
|
16
|
+
mock.rspec_reset
|
17
|
+
end
|
18
|
+
mocks.clear
|
19
|
+
end
|
20
|
+
|
21
|
+
private
|
22
|
+
|
23
|
+
def mocks
|
24
|
+
@mocks ||= []
|
25
|
+
end
|
26
|
+
end
|
27
|
+
end
|
28
|
+
end
|
@@ -0,0 +1,46 @@
|
|
1
|
+
module Spec
|
2
|
+
module Mocks
|
3
|
+
module ExampleMethods
|
4
|
+
include Spec::Mocks::ArgumentConstraints
|
5
|
+
|
6
|
+
# Shortcut for creating an instance of Spec::Mocks::Mock.
|
7
|
+
#
|
8
|
+
# +name+ is used for failure reporting, so you should use the
|
9
|
+
# role that the mock is playing in the example.
|
10
|
+
#
|
11
|
+
# +stubs_and_options+ lets you assign options and stub values
|
12
|
+
# at the same time. The only option available is :null_object.
|
13
|
+
# Anything else is treated as a stub value.
|
14
|
+
#
|
15
|
+
# == Examples
|
16
|
+
#
|
17
|
+
# stub_thing = mock("thing", :a => "A")
|
18
|
+
# stub_thing.a == "A" => true
|
19
|
+
#
|
20
|
+
# stub_person = stub("thing", :name => "Joe", :email => "joe@domain.com")
|
21
|
+
# stub_person.name => "Joe"
|
22
|
+
# stub_person.email => "joe@domain.com"
|
23
|
+
def mock(name, stubs_and_options={})
|
24
|
+
Spec::Mocks::Mock.new(name, stubs_and_options)
|
25
|
+
end
|
26
|
+
|
27
|
+
alias :stub :mock
|
28
|
+
|
29
|
+
# Shortcut for creating a mock object that will return itself in response
|
30
|
+
# to any message it receives that it hasn't been explicitly instructed
|
31
|
+
# to respond to.
|
32
|
+
def stub_everything(name = 'stub')
|
33
|
+
mock(name, :null_object => true)
|
34
|
+
end
|
35
|
+
|
36
|
+
# Disables warning messages about expectations being set on nil.
|
37
|
+
#
|
38
|
+
# By default warning messages are issued when expectations are set on nil. This is to
|
39
|
+
# prevent false-positives and to catch potential bugs early on.
|
40
|
+
def allow_message_expectations_on_nil
|
41
|
+
Proxy.allow_message_expectations_on_nil
|
42
|
+
end
|
43
|
+
|
44
|
+
end
|
45
|
+
end
|
46
|
+
end
|
data/lib/spec/mocks.rb
ADDED
@@ -0,0 +1,200 @@
|
|
1
|
+
require 'spec/mocks/framework'
|
2
|
+
require 'spec/mocks/extensions/object'
|
3
|
+
|
4
|
+
module Spec
|
5
|
+
# == Mocks and Stubs
|
6
|
+
#
|
7
|
+
# RSpec will create Mock Objects and Stubs for you at runtime, or attach stub/mock behaviour
|
8
|
+
# to any of your real objects (Partial Mock/Stub). Because the underlying implementation
|
9
|
+
# for mocks and stubs is the same, you can intermingle mock and stub
|
10
|
+
# behaviour in either dynamically generated mocks or your pre-existing classes.
|
11
|
+
# There is a semantic difference in how they are created, however,
|
12
|
+
# which can help clarify the role it is playing within a given spec.
|
13
|
+
#
|
14
|
+
# == Mock Objects
|
15
|
+
#
|
16
|
+
# Mocks are objects that allow you to set and verify expectations that they will
|
17
|
+
# receive specific messages during run time. They are very useful for specifying how the subject of
|
18
|
+
# the spec interacts with its collaborators. This approach is widely known as "interaction
|
19
|
+
# testing".
|
20
|
+
#
|
21
|
+
# Mocks are also very powerful as a design tool. As you are
|
22
|
+
# driving the implementation of a given class, Mocks provide an anonymous
|
23
|
+
# collaborator that can change in behaviour as quickly as you can write an expectation in your
|
24
|
+
# spec. This flexibility allows you to design the interface of a collaborator that often
|
25
|
+
# does not yet exist. As the shape of the class being specified becomes more clear, so do the
|
26
|
+
# requirements for its collaborators - often leading to the discovery of new types that are
|
27
|
+
# needed in your system.
|
28
|
+
#
|
29
|
+
# Read Endo-Testing[http://www.mockobjects.com/files/endotesting.pdf] for a much
|
30
|
+
# more in depth description of this process.
|
31
|
+
#
|
32
|
+
# == Stubs
|
33
|
+
#
|
34
|
+
# Stubs are objects that allow you to set "stub" responses to
|
35
|
+
# messages. As Martin Fowler points out on his site,
|
36
|
+
# mocks_arent_stubs[http://www.martinfowler.com/articles/mocksArentStubs.html].
|
37
|
+
# Paraphrasing Fowler's paraphrasing
|
38
|
+
# of Gerard Meszaros: Stubs provide canned responses to messages they might receive in a test, while
|
39
|
+
# mocks allow you to specify and, subsquently, verify that certain messages should be received during
|
40
|
+
# the execution of a test.
|
41
|
+
#
|
42
|
+
# == Partial Mocks/Stubs
|
43
|
+
#
|
44
|
+
# RSpec also supports partial mocking/stubbing, allowing you to add stub/mock behaviour
|
45
|
+
# to instances of your existing classes. This is generally
|
46
|
+
# something to be avoided, because changes to the class can have ripple effects on
|
47
|
+
# seemingly unrelated specs. When specs fail due to these ripple effects, the fact
|
48
|
+
# that some methods are being mocked can make it difficult to understand why a
|
49
|
+
# failure is occurring.
|
50
|
+
#
|
51
|
+
# That said, partials do allow you to expect and
|
52
|
+
# verify interactions with class methods such as +#find+ and +#create+
|
53
|
+
# on Ruby on Rails model classes.
|
54
|
+
#
|
55
|
+
# == Further Reading
|
56
|
+
#
|
57
|
+
# There are many different viewpoints about the meaning of mocks and stubs. If you are interested
|
58
|
+
# in learning more, here is some recommended reading:
|
59
|
+
#
|
60
|
+
# * Mock Objects: http://www.mockobjects.com/
|
61
|
+
# * Endo-Testing: http://www.mockobjects.com/files/endotesting.pdf
|
62
|
+
# * Mock Roles, Not Objects: http://www.mockobjects.com/files/mockrolesnotobjects.pdf
|
63
|
+
# * Test Double Patterns: http://xunitpatterns.com/Test%20Double%20Patterns.html
|
64
|
+
# * Mocks aren't stubs: http://www.martinfowler.com/articles/mocksArentStubs.html
|
65
|
+
#
|
66
|
+
# == Creating a Mock
|
67
|
+
#
|
68
|
+
# You can create a mock in any specification (or setup) using:
|
69
|
+
#
|
70
|
+
# mock(name, options={})
|
71
|
+
#
|
72
|
+
# The optional +options+ argument is a +Hash+. Currently the only supported
|
73
|
+
# option is +:null_object+. Setting this to true instructs the mock to ignore
|
74
|
+
# any messages it hasn’t been told to expect – and quietly return itself. For example:
|
75
|
+
#
|
76
|
+
# mock("person", :null_object => true)
|
77
|
+
#
|
78
|
+
# == Creating a Stub
|
79
|
+
#
|
80
|
+
# You can create a stub in any specification (or setup) using:
|
81
|
+
#
|
82
|
+
# stub(name, stub_methods_and_values_hash)
|
83
|
+
#
|
84
|
+
# For example, if you wanted to create an object that always returns
|
85
|
+
# "More?!?!?!" to "please_sir_may_i_have_some_more" you would do this:
|
86
|
+
#
|
87
|
+
# stub("Mr Sykes", :please_sir_may_i_have_some_more => "More?!?!?!")
|
88
|
+
#
|
89
|
+
# == Creating a Partial Mock
|
90
|
+
#
|
91
|
+
# You don't really "create" a partial mock, you simply add method stubs and/or
|
92
|
+
# mock expectations to existing classes and objects:
|
93
|
+
#
|
94
|
+
# Factory.should_receive(:find).with(id).and_return(value)
|
95
|
+
# obj.stub!(:to_i).and_return(3)
|
96
|
+
# etc ...
|
97
|
+
#
|
98
|
+
# == Expecting Messages
|
99
|
+
#
|
100
|
+
# my_mock.should_receive(:sym)
|
101
|
+
# my_mock.should_not_receive(:sym)
|
102
|
+
#
|
103
|
+
# == Expecting Arguments
|
104
|
+
#
|
105
|
+
# my_mock.should_receive(:sym).with(*args)
|
106
|
+
# my_mock.should_not_receive(:sym).with(*args)
|
107
|
+
#
|
108
|
+
# == Argument Constraints using Expression Matchers
|
109
|
+
#
|
110
|
+
# Arguments that are passed to #with are compared with actual arguments received
|
111
|
+
# using == by default. In cases in which you want to specify things about the arguments
|
112
|
+
# rather than the arguments themselves, you can use any of the Expression Matchers.
|
113
|
+
# They don't all make syntactic sense (they were primarily designed for use with
|
114
|
+
# Spec::Expectations), but you are free to create your own custom Spec::Matchers.
|
115
|
+
#
|
116
|
+
# Spec::Mocks does provide one additional Matcher method named #ducktype.
|
117
|
+
#
|
118
|
+
# In addition, Spec::Mocks adds some keyword Symbols that you can use to
|
119
|
+
# specify certain kinds of arguments:
|
120
|
+
#
|
121
|
+
# my_mock.should_receive(:sym).with(no_args())
|
122
|
+
# my_mock.should_receive(:sym).with(any_args())
|
123
|
+
# my_mock.should_receive(:sym).with(1, an_instance_of(Numeric), "b") #2nd argument can any type of Numeric
|
124
|
+
# my_mock.should_receive(:sym).with(1, boolean(), "b") #2nd argument can true or false
|
125
|
+
# my_mock.should_receive(:sym).with(1, /abc/, "b") #2nd argument can be any String matching the submitted Regexp
|
126
|
+
# my_mock.should_receive(:sym).with(1, anything(), "b") #2nd argument can be anything at all
|
127
|
+
# my_mock.should_receive(:sym).with(1, ducktype(:abs, :div), "b")
|
128
|
+
# #2nd argument can be object that responds to #abs and #div
|
129
|
+
#
|
130
|
+
# == Receive Counts
|
131
|
+
#
|
132
|
+
# my_mock.should_receive(:sym).once
|
133
|
+
# my_mock.should_receive(:sym).twice
|
134
|
+
# my_mock.should_receive(:sym).exactly(n).times
|
135
|
+
# my_mock.should_receive(:sym).at_least(:once)
|
136
|
+
# my_mock.should_receive(:sym).at_least(:twice)
|
137
|
+
# my_mock.should_receive(:sym).at_least(n).times
|
138
|
+
# my_mock.should_receive(:sym).at_most(:once)
|
139
|
+
# my_mock.should_receive(:sym).at_most(:twice)
|
140
|
+
# my_mock.should_receive(:sym).at_most(n).times
|
141
|
+
# my_mock.should_receive(:sym).any_number_of_times
|
142
|
+
#
|
143
|
+
# == Ordering
|
144
|
+
#
|
145
|
+
# my_mock.should_receive(:sym).ordered
|
146
|
+
# my_mock.should_receive(:other_sym).ordered
|
147
|
+
# #This will fail if the messages are received out of order
|
148
|
+
#
|
149
|
+
# == Setting Reponses
|
150
|
+
#
|
151
|
+
# Whether you are setting a mock expectation or a simple stub, you can tell the
|
152
|
+
# object precisely how to respond:
|
153
|
+
#
|
154
|
+
# my_mock.should_receive(:sym).and_return(value)
|
155
|
+
# my_mock.should_receive(:sym).exactly(3).times.and_return(value1, value2, value3)
|
156
|
+
# # returns value1 the first time, value2 the second, etc
|
157
|
+
# my_mock.should_receive(:sym).and_return { ... } #returns value returned by the block
|
158
|
+
# my_mock.should_receive(:sym).and_raise(error)
|
159
|
+
# #error can be an instantiated object or a class
|
160
|
+
# #if it is a class, it must be instantiable with no args
|
161
|
+
# my_mock.should_receive(:sym).and_throw(:sym)
|
162
|
+
# my_mock.should_receive(:sym).and_yield(values,to,yield)
|
163
|
+
# my_mock.should_receive(:sym).and_yield(values,to,yield).and_yield(some,other,values,this,time)
|
164
|
+
# # for methods that yield to a block multiple times
|
165
|
+
#
|
166
|
+
# Any of these responses can be applied to a stub as well, but stubs do
|
167
|
+
# not support any qualifiers about the message received (i.e. you can't specify arguments
|
168
|
+
# or receive counts):
|
169
|
+
#
|
170
|
+
# my_mock.stub!(:sym).and_return(value)
|
171
|
+
# my_mock.stub!(:sym).and_return(value1, value2, value3)
|
172
|
+
# my_mock.stub!(:sym).and_raise(error)
|
173
|
+
# my_mock.stub!(:sym).and_throw(:sym)
|
174
|
+
# my_mock.stub!(:sym).and_yield(values,to,yield)
|
175
|
+
# my_mock.stub!(:sym).and_yield(values,to,yield).and_yield(some,other,values,this,time)
|
176
|
+
#
|
177
|
+
# == Arbitrary Handling
|
178
|
+
#
|
179
|
+
# Once in a while you'll find that the available expectations don't solve the
|
180
|
+
# particular problem you are trying to solve. Imagine that you expect the message
|
181
|
+
# to come with an Array argument that has a specific length, but you don't care
|
182
|
+
# what is in it. You could do this:
|
183
|
+
#
|
184
|
+
# my_mock.should_receive(:sym) do |arg|
|
185
|
+
# arg.should be_an_istance_of(Array)
|
186
|
+
# arg.length.should == 7
|
187
|
+
# end
|
188
|
+
#
|
189
|
+
# Note that this would fail if the number of arguments received was different from
|
190
|
+
# the number of block arguments (in this case 1).
|
191
|
+
#
|
192
|
+
# == Combining Expectation Details
|
193
|
+
#
|
194
|
+
# Combining the message name with specific arguments, receive counts and responses
|
195
|
+
# you can get quite a bit of detail in your expectations:
|
196
|
+
#
|
197
|
+
# my_mock.should_receive(:<<).with("illegal value").once.and_raise(ArgumentError)
|
198
|
+
module Mocks
|
199
|
+
end
|
200
|
+
end
|