opal-rspec 0.7.0.rc.1 → 0.7.0.rc.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/opal/rspec/version.rb +1 -1
- data/opal-rspec.gemspec +5 -3
- data/rspec-core/upstream/.document +5 -0
- data/rspec-core/upstream/.gitignore +21 -0
- data/rspec-core/upstream/.rspec +2 -0
- data/rspec-core/upstream/.rubocop.yml +53 -0
- data/rspec-core/upstream/.rubocop_rspec_base.yml +130 -0
- data/rspec-core/upstream/.travis.yml +35 -0
- data/rspec-core/upstream/.yardopts +7 -0
- data/rspec-core/upstream/Changelog.md +1641 -0
- data/rspec-core/upstream/DEV-README.md +28 -0
- data/rspec-core/upstream/Gemfile +34 -0
- data/rspec-core/upstream/Gemfile-custom.sample +19 -0
- data/rspec-core/upstream/Guardfile +5 -0
- data/rspec-core/upstream/License.txt +25 -0
- data/rspec-core/upstream/README.md +243 -0
- data/rspec-core/upstream/Rakefile +85 -0
- data/rspec-core/upstream/benchmarks/README.md +4 -0
- data/rspec-core/upstream/benchmarks/boot_time_with_many_load_path_dirs.sh +123 -0
- data/rspec-core/upstream/benchmarks/call_v_yield.rb +81 -0
- data/rspec-core/upstream/benchmarks/check_inclusion.rb +125 -0
- data/rspec-core/upstream/benchmarks/define_method_v_attr_reader_v_def.rb +81 -0
- data/rspec-core/upstream/benchmarks/eager_vs_lazy_metadata.rb +126 -0
- data/rspec-core/upstream/benchmarks/eager_vs_lazy_metadata/define_examples.rb +22 -0
- data/rspec-core/upstream/benchmarks/filter_object.rb +35 -0
- data/rspec-core/upstream/benchmarks/index_v_take_while.rb +47 -0
- data/rspec-core/upstream/benchmarks/map_then_flatten_vs_flat_map_benchmarks.rb +94 -0
- data/rspec-core/upstream/benchmarks/require_relative_v_require.rb +75 -0
- data/rspec-core/upstream/benchmarks/respond_to_v_defined.rb +72 -0
- data/rspec-core/upstream/benchmarks/several_regexps_v_one_big_one.rb +86 -0
- data/rspec-core/upstream/benchmarks/sort_by_v_shuffle.rb +83 -0
- data/rspec-core/upstream/benchmarks/to_proc_v_not_to_proc.rb +539 -0
- data/rspec-core/upstream/cucumber.yml +6 -0
- data/rspec-core/upstream/exe/rspec +4 -0
- data/rspec-core/upstream/features/.nav +62 -0
- data/rspec-core/upstream/features/README.md +13 -0
- data/rspec-core/upstream/features/Upgrade.md +352 -0
- data/rspec-core/upstream/features/command_line/README.md +28 -0
- data/rspec-core/upstream/features/command_line/dry_run.feature +29 -0
- data/rspec-core/upstream/features/command_line/example_name_option.feature +98 -0
- data/rspec-core/upstream/features/command_line/exit_status.feature +66 -0
- data/rspec-core/upstream/features/command_line/fail_fast.feature +27 -0
- data/rspec-core/upstream/features/command_line/format_option.feature +86 -0
- data/rspec-core/upstream/features/command_line/init.feature +50 -0
- data/rspec-core/upstream/features/command_line/line_number_appended_to_path.feature +159 -0
- data/rspec-core/upstream/features/command_line/order.md +23 -0
- data/rspec-core/upstream/features/command_line/pattern_option.feature +42 -0
- data/rspec-core/upstream/features/command_line/rake_task.feature +158 -0
- data/rspec-core/upstream/features/command_line/randomization.feature +62 -0
- data/rspec-core/upstream/features/command_line/require_option.feature +45 -0
- data/rspec-core/upstream/features/command_line/ruby.feature +23 -0
- data/rspec-core/upstream/features/command_line/tag.feature +102 -0
- data/rspec-core/upstream/features/command_line/warnings_option.feature +29 -0
- data/rspec-core/upstream/features/configuration/alias_example_to.feature +57 -0
- data/rspec-core/upstream/features/configuration/backtrace_exclusion_patterns.feature +138 -0
- data/rspec-core/upstream/features/configuration/custom_settings.feature +84 -0
- data/rspec-core/upstream/features/configuration/default_path.feature +37 -0
- data/rspec-core/upstream/features/configuration/deprecation_stream.feature +87 -0
- data/rspec-core/upstream/features/configuration/enable_global_dsl.feature +60 -0
- data/rspec-core/upstream/features/configuration/exclude_pattern.feature +43 -0
- data/rspec-core/upstream/features/configuration/fail_fast.feature +79 -0
- data/rspec-core/upstream/features/configuration/failure_exit_code.feature +53 -0
- data/rspec-core/upstream/features/configuration/order_and_seed.feature +5 -0
- data/rspec-core/upstream/features/configuration/output_stream.feature +27 -0
- data/rspec-core/upstream/features/configuration/overriding_global_ordering.feature +90 -0
- data/rspec-core/upstream/features/configuration/pattern.feature +62 -0
- data/rspec-core/upstream/features/configuration/profile.feature +220 -0
- data/rspec-core/upstream/features/configuration/read_options_from_file.feature +95 -0
- data/rspec-core/upstream/features/configuration/run_all_when_everything_filtered.feature +78 -0
- data/rspec-core/upstream/features/configuration/zero_monkey_patching_mode.feature +106 -0
- data/rspec-core/upstream/features/core_standalone.feature +23 -0
- data/rspec-core/upstream/features/example_groups/aliasing.feature +48 -0
- data/rspec-core/upstream/features/example_groups/basic_structure.feature +55 -0
- data/rspec-core/upstream/features/example_groups/shared_context.feature +92 -0
- data/rspec-core/upstream/features/example_groups/shared_examples.feature +295 -0
- data/rspec-core/upstream/features/expectation_framework_integration/configure_expectation_framework.feature +167 -0
- data/rspec-core/upstream/features/filtering/exclusion_filters.feature +135 -0
- data/rspec-core/upstream/features/filtering/if_and_unless.feature +165 -0
- data/rspec-core/upstream/features/filtering/inclusion_filters.feature +101 -0
- data/rspec-core/upstream/features/formatters/configurable_colors.feature +32 -0
- data/rspec-core/upstream/features/formatters/custom_formatter.feature +37 -0
- data/rspec-core/upstream/features/formatters/json_formatter.feature +30 -0
- data/rspec-core/upstream/features/helper_methods/arbitrary_methods.feature +40 -0
- data/rspec-core/upstream/features/helper_methods/let.feature +50 -0
- data/rspec-core/upstream/features/helper_methods/modules.feature +146 -0
- data/rspec-core/upstream/features/hooks/around_hooks.feature +345 -0
- data/rspec-core/upstream/features/hooks/before_and_after_hooks.feature +434 -0
- data/rspec-core/upstream/features/hooks/filtering.feature +234 -0
- data/rspec-core/upstream/features/metadata/current_example.feature +57 -0
- data/rspec-core/upstream/features/metadata/described_class.feature +17 -0
- data/rspec-core/upstream/features/metadata/user_defined.feature +100 -0
- data/rspec-core/upstream/features/mock_framework_integration/use_any_framework.feature +106 -0
- data/rspec-core/upstream/features/mock_framework_integration/use_flexmock.feature +94 -0
- data/rspec-core/upstream/features/mock_framework_integration/use_mocha.feature +95 -0
- data/rspec-core/upstream/features/mock_framework_integration/use_rr.feature +96 -0
- data/rspec-core/upstream/features/mock_framework_integration/use_rspec.feature +113 -0
- data/rspec-core/upstream/features/pending_and_skipped_examples/README.md +3 -0
- data/rspec-core/upstream/features/pending_and_skipped_examples/pending_examples.feature +73 -0
- data/rspec-core/upstream/features/pending_and_skipped_examples/skipped_examples.feature +106 -0
- data/rspec-core/upstream/features/spec_files/arbitrary_file_suffix.feature +13 -0
- data/rspec-core/upstream/features/step_definitions/additional_cli_steps.rb +126 -0
- data/rspec-core/upstream/features/step_definitions/core_standalone_steps.rb +12 -0
- data/rspec-core/upstream/features/subject/explicit_subject.feature +187 -0
- data/rspec-core/upstream/features/subject/implicit_subject.feature +57 -0
- data/rspec-core/upstream/features/subject/one_liner_syntax.feature +69 -0
- data/rspec-core/upstream/features/support/env.rb +21 -0
- data/rspec-core/upstream/features/support/require_expect_syntax_in_aruba_specs.rb +29 -0
- data/rspec-core/upstream/features/support/rubinius.rb +6 -0
- data/rspec-core/upstream/lib/rspec/autorun.rb +2 -0
- data/rspec-core/upstream/lib/rspec/core.rb +169 -0
- data/rspec-core/upstream/lib/rspec/core/backport_random.rb +336 -0
- data/rspec-core/upstream/lib/rspec/core/backtrace_formatter.rb +66 -0
- data/rspec-core/upstream/lib/rspec/core/configuration.rb +1440 -0
- data/rspec-core/upstream/lib/rspec/core/configuration_options.rb +173 -0
- data/rspec-core/upstream/lib/rspec/core/drb.rb +111 -0
- data/rspec-core/upstream/lib/rspec/core/dsl.rb +93 -0
- data/rspec-core/upstream/lib/rspec/core/example.rb +502 -0
- data/rspec-core/upstream/lib/rspec/core/example_group.rb +606 -0
- data/rspec-core/upstream/lib/rspec/core/filter_manager.rb +259 -0
- data/rspec-core/upstream/lib/rspec/core/flat_map.rb +18 -0
- data/rspec-core/upstream/lib/rspec/core/formatters.rb +240 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/base_formatter.rb +67 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/base_text_formatter.rb +76 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/console_codes.rb +64 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/deprecation_formatter.rb +222 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/documentation_formatter.rb +68 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/helpers.rb +87 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/html_formatter.rb +149 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/html_printer.rb +403 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/json_formatter.rb +94 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/profile_formatter.rb +65 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/progress_formatter.rb +28 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/protocol.rb +163 -0
- data/rspec-core/upstream/lib/rspec/core/formatters/snippet_extractor.rb +104 -0
- data/rspec-core/upstream/lib/rspec/core/hooks.rb +591 -0
- data/rspec-core/upstream/lib/rspec/core/memoized_helpers.rb +472 -0
- data/rspec-core/upstream/lib/rspec/core/metadata.rb +437 -0
- data/rspec-core/upstream/lib/rspec/core/metadata_filter.rb +95 -0
- data/rspec-core/upstream/lib/rspec/core/minitest_assertions_adapter.rb +28 -0
- data/rspec-core/upstream/lib/rspec/core/mocking_adapters/flexmock.rb +31 -0
- data/rspec-core/upstream/lib/rspec/core/mocking_adapters/mocha.rb +57 -0
- data/rspec-core/upstream/lib/rspec/core/mocking_adapters/null.rb +14 -0
- data/rspec-core/upstream/lib/rspec/core/mocking_adapters/rr.rb +31 -0
- data/rspec-core/upstream/lib/rspec/core/mocking_adapters/rspec.rb +32 -0
- data/rspec-core/upstream/lib/rspec/core/notifications.rb +542 -0
- data/rspec-core/upstream/lib/rspec/core/option_parser.rb +222 -0
- data/rspec-core/upstream/lib/rspec/core/ordering.rb +155 -0
- data/rspec-core/upstream/lib/rspec/core/pending.rb +163 -0
- data/rspec-core/upstream/lib/rspec/core/project_initializer.rb +48 -0
- data/rspec-core/upstream/lib/rspec/core/project_initializer/.rspec +2 -0
- data/rspec-core/upstream/lib/rspec/core/project_initializer/spec/spec_helper.rb +89 -0
- data/rspec-core/upstream/lib/rspec/core/rake_task.rb +187 -0
- data/rspec-core/upstream/lib/rspec/core/reporter.rb +149 -0
- data/rspec-core/upstream/lib/rspec/core/ruby_project.rb +45 -0
- data/rspec-core/upstream/lib/rspec/core/runner.rb +158 -0
- data/rspec-core/upstream/lib/rspec/core/shared_context.rb +55 -0
- data/rspec-core/upstream/lib/rspec/core/shared_example_group.rb +182 -0
- data/rspec-core/upstream/lib/rspec/core/test_unit_assertions_adapter.rb +30 -0
- data/rspec-core/upstream/lib/rspec/core/version.rb +9 -0
- data/rspec-core/upstream/lib/rspec/core/warnings.rb +40 -0
- data/rspec-core/upstream/lib/rspec/core/world.rb +183 -0
- data/rspec-core/upstream/maintenance-branch +1 -0
- data/rspec-core/upstream/rspec-core.gemspec +53 -0
- data/rspec-core/upstream/script/clone_all_rspec_repos +24 -0
- data/rspec-core/upstream/script/console +8 -0
- data/rspec-core/upstream/script/functions.sh +168 -0
- data/rspec-core/upstream/script/ignores +72 -0
- data/rspec-core/upstream/script/list_method_cache_busters.sh +23 -0
- data/rspec-core/upstream/script/prevent_runtime_method_cache_busters +15 -0
- data/rspec-core/upstream/script/regen_fixtures.sh +39 -0
- data/rspec-core/upstream/script/rspec_with_simplecov +42 -0
- data/rspec-core/upstream/script/run_build +28 -0
- data/rspec-expectations/upstream/.document +5 -0
- data/rspec-expectations/upstream/.gitignore +17 -0
- data/rspec-expectations/upstream/.rspec +2 -0
- data/rspec-expectations/upstream/.rubocop.yml +5 -0
- data/rspec-expectations/upstream/.rubocop_rspec_base.yml +130 -0
- data/rspec-expectations/upstream/.travis.yml +35 -0
- data/rspec-expectations/upstream/.yardopts +6 -0
- data/rspec-expectations/upstream/Changelog.md +835 -0
- data/rspec-expectations/upstream/DEV-README.md +28 -0
- data/rspec-expectations/upstream/Gemfile +35 -0
- data/rspec-expectations/upstream/Gemfile-custom.sample +19 -0
- data/rspec-expectations/upstream/Guardfile +6 -0
- data/rspec-expectations/upstream/License.txt +24 -0
- data/rspec-expectations/upstream/README.md +278 -0
- data/rspec-expectations/upstream/Rakefile +78 -0
- data/rspec-expectations/upstream/Should.md +168 -0
- data/rspec-expectations/upstream/benchmarks/2.x_vs_3.x_matcher_dsl_implementation.rb +253 -0
- data/rspec-expectations/upstream/benchmarks/autoload_v_require.rb +25 -0
- data/rspec-expectations/upstream/benchmarks/cloning_matchers.rb +19 -0
- data/rspec-expectations/upstream/benchmarks/default_messages_as_methods_v_blocks.rb +27 -0
- data/rspec-expectations/upstream/benchmarks/example_spec.rb +9 -0
- data/rspec-expectations/upstream/benchmarks/include_v_superclass.rb +39 -0
- data/rspec-expectations/upstream/benchmarks/match_array/failing_with_distinct_items.rb +147 -0
- data/rspec-expectations/upstream/benchmarks/match_array/failing_with_duplicate_items.rb +122 -0
- data/rspec-expectations/upstream/benchmarks/match_array/passing_with_distinct_items.rb +154 -0
- data/rspec-expectations/upstream/benchmarks/match_array/passing_with_duplicate_items.rb +132 -0
- data/rspec-expectations/upstream/benchmarks/match_array/rubyprof/passing_with_distinct_items.rb +9 -0
- data/rspec-expectations/upstream/benchmarks/matcher_dsl_vs_classes.rb +180 -0
- data/rspec-expectations/upstream/benchmarks/method_to_proc.rb +72 -0
- data/rspec-expectations/upstream/benchmarks/set_vs_array_include.rb +68 -0
- data/rspec-expectations/upstream/cucumber.yml +10 -0
- data/rspec-expectations/upstream/features/.nav +41 -0
- data/rspec-expectations/upstream/features/README.md +49 -0
- data/rspec-expectations/upstream/features/built_in_matchers/README.md +137 -0
- data/rspec-expectations/upstream/features/built_in_matchers/all.feature +60 -0
- data/rspec-expectations/upstream/features/built_in_matchers/be.feature +175 -0
- data/rspec-expectations/upstream/features/built_in_matchers/be_within.feature +48 -0
- data/rspec-expectations/upstream/features/built_in_matchers/change.feature +66 -0
- data/rspec-expectations/upstream/features/built_in_matchers/comparisons.feature +96 -0
- data/rspec-expectations/upstream/features/built_in_matchers/contain_exactly.feature +64 -0
- data/rspec-expectations/upstream/features/built_in_matchers/cover.feature +47 -0
- data/rspec-expectations/upstream/features/built_in_matchers/end_with.feature +48 -0
- data/rspec-expectations/upstream/features/built_in_matchers/equality.feature +135 -0
- data/rspec-expectations/upstream/features/built_in_matchers/exist.feature +44 -0
- data/rspec-expectations/upstream/features/built_in_matchers/have_attributes.feature +47 -0
- data/rspec-expectations/upstream/features/built_in_matchers/include.feature +123 -0
- data/rspec-expectations/upstream/features/built_in_matchers/match.feature +49 -0
- data/rspec-expectations/upstream/features/built_in_matchers/output.feature +68 -0
- data/rspec-expectations/upstream/features/built_in_matchers/predicates.feature +181 -0
- data/rspec-expectations/upstream/features/built_in_matchers/raise_error.feature +144 -0
- data/rspec-expectations/upstream/features/built_in_matchers/respond_to.feature +83 -0
- data/rspec-expectations/upstream/features/built_in_matchers/satisfy.feature +32 -0
- data/rspec-expectations/upstream/features/built_in_matchers/start_with.feature +48 -0
- data/rspec-expectations/upstream/features/built_in_matchers/throw_symbol.feature +90 -0
- data/rspec-expectations/upstream/features/built_in_matchers/types.feature +116 -0
- data/rspec-expectations/upstream/features/built_in_matchers/yield.feature +156 -0
- data/rspec-expectations/upstream/features/composing_matchers.feature +246 -0
- data/rspec-expectations/upstream/features/compound_expectations.feature +52 -0
- data/rspec-expectations/upstream/features/custom_matchers/access_running_example.feature +48 -0
- data/rspec-expectations/upstream/features/custom_matchers/define_diffable_matcher.feature +29 -0
- data/rspec-expectations/upstream/features/custom_matchers/define_matcher.feature +337 -0
- data/rspec-expectations/upstream/features/custom_matchers/define_matcher_outside_rspec.feature +32 -0
- data/rspec-expectations/upstream/features/custom_matchers/define_matcher_with_fluent_interface.feature +51 -0
- data/rspec-expectations/upstream/features/customized_message.feature +39 -0
- data/rspec-expectations/upstream/features/define_negated_matcher.feature +29 -0
- data/rspec-expectations/upstream/features/diffing.feature +85 -0
- data/rspec-expectations/upstream/features/implicit_docstrings.feature +51 -0
- data/rspec-expectations/upstream/features/step_definitions/additional_cli_steps.rb +22 -0
- data/rspec-expectations/upstream/features/support/disallow_certain_apis.rb +34 -0
- data/rspec-expectations/upstream/features/support/env.rb +21 -0
- data/rspec-expectations/upstream/features/support/rubinius.rb +6 -0
- data/rspec-expectations/upstream/features/syntax_configuration.feature +92 -0
- data/rspec-expectations/upstream/features/test_frameworks/minitest.feature +44 -0
- data/rspec-expectations/upstream/lib/rspec/expectations.rb +68 -0
- data/rspec-expectations/upstream/lib/rspec/expectations/configuration.rb +147 -0
- data/rspec-expectations/upstream/lib/rspec/expectations/expectation_target.rb +119 -0
- data/rspec-expectations/upstream/lib/rspec/expectations/fail_with.rb +34 -0
- data/rspec-expectations/upstream/lib/rspec/expectations/handler.rb +167 -0
- data/rspec-expectations/upstream/lib/rspec/expectations/minitest_integration.rb +17 -0
- data/rspec-expectations/upstream/lib/rspec/expectations/syntax.rb +132 -0
- data/rspec-expectations/upstream/lib/rspec/expectations/version.rb +8 -0
- data/rspec-expectations/upstream/lib/rspec/matchers.rb +967 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/aliased_matcher.rb +116 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in.rb +52 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/all.rb +85 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/base_matcher.rb +132 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/be.rb +277 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/be_between.rb +77 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/be_instance_of.rb +22 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/be_kind_of.rb +16 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/be_within.rb +72 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/change.rb +337 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/compound.rb +258 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/contain_exactly.rb +249 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/cover.rb +24 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/eq.rb +75 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/eql.rb +34 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/equal.rb +81 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/exist.rb +86 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/has.rb +101 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/have_attributes.rb +84 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/include.rb +105 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/match.rb +29 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/operators.rb +119 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/output.rb +152 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/raise_error.rb +174 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/respond_to.rb +91 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/satisfy.rb +39 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/start_and_end_with.rb +82 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/throw_symbol.rb +132 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/built_in/yield.rb +420 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/composable.rb +183 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/dsl.rb +391 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/generated_descriptions.rb +42 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/matcher_delegator.rb +33 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/matcher_protocol.rb +99 -0
- data/rspec-expectations/upstream/lib/rspec/matchers/pretty.rb +77 -0
- data/rspec-expectations/upstream/maintenance-branch +1 -0
- data/rspec-expectations/upstream/rspec-expectations.gemspec +46 -0
- data/rspec-expectations/upstream/script/clone_all_rspec_repos +24 -0
- data/rspec-expectations/upstream/script/functions.sh +168 -0
- data/rspec-expectations/upstream/script/run_build +28 -0
- data/rspec-mocks/upstream/.autotest +7 -0
- data/rspec-mocks/upstream/.document +5 -0
- data/rspec-mocks/upstream/.gitignore +18 -0
- data/rspec-mocks/upstream/.rspec +2 -0
- data/rspec-mocks/upstream/.rubocop.yml +17 -0
- data/rspec-mocks/upstream/.rubocop_rspec_base.yml +130 -0
- data/rspec-mocks/upstream/.travis.yml +35 -0
- data/rspec-mocks/upstream/.yardopts +6 -0
- data/rspec-mocks/upstream/Changelog.md +817 -0
- data/rspec-mocks/upstream/DEV-README.md +28 -0
- data/rspec-mocks/upstream/Gemfile +34 -0
- data/rspec-mocks/upstream/Gemfile-custom.sample +19 -0
- data/rspec-mocks/upstream/Guardfile +8 -0
- data/rspec-mocks/upstream/License.txt +24 -0
- data/rspec-mocks/upstream/README.md +397 -0
- data/rspec-mocks/upstream/Rakefile +72 -0
- data/rspec-mocks/upstream/benchmarks/boot_time.sh +31 -0
- data/rspec-mocks/upstream/benchmarks/double_creation.rb +66 -0
- data/rspec-mocks/upstream/benchmarks/each_value_v_values_each.rb +58 -0
- data/rspec-mocks/upstream/benchmarks/find_original_method_early.rb +64 -0
- data/rspec-mocks/upstream/benchmarks/method_defined_at_any_visibility.rb +101 -0
- data/rspec-mocks/upstream/benchmarks/thread_safety.rb +24 -0
- data/rspec-mocks/upstream/benchmarks/transfer_nested_constants.rb +77 -0
- data/rspec-mocks/upstream/cucumber.yml +2 -0
- data/rspec-mocks/upstream/features/.nav +43 -0
- data/rspec-mocks/upstream/features/README.md +76 -0
- data/rspec-mocks/upstream/features/basics/allowing_messages.feature +35 -0
- data/rspec-mocks/upstream/features/basics/expecting_messages.feature +73 -0
- data/rspec-mocks/upstream/features/basics/null_object_doubles.feature +35 -0
- data/rspec-mocks/upstream/features/basics/partial_test_doubles.feature +70 -0
- data/rspec-mocks/upstream/features/basics/scope.feature +99 -0
- data/rspec-mocks/upstream/features/basics/spies.feature +144 -0
- data/rspec-mocks/upstream/features/basics/test_doubles.feature +41 -0
- data/rspec-mocks/upstream/features/configuring_responses/README.md +12 -0
- data/rspec-mocks/upstream/features/configuring_responses/block_implementation.feature +131 -0
- data/rspec-mocks/upstream/features/configuring_responses/calling_the_original_implementation.feature +52 -0
- data/rspec-mocks/upstream/features/configuring_responses/raising_an_error.feature +28 -0
- data/rspec-mocks/upstream/features/configuring_responses/returning_a_value.feature +52 -0
- data/rspec-mocks/upstream/features/configuring_responses/throwing.feature +36 -0
- data/rspec-mocks/upstream/features/configuring_responses/wrapping_the_original_implementation.feature +53 -0
- data/rspec-mocks/upstream/features/configuring_responses/yielding.feature +76 -0
- data/rspec-mocks/upstream/features/mutating_constants/README.md +78 -0
- data/rspec-mocks/upstream/features/mutating_constants/hide_defined_constant.feature +64 -0
- data/rspec-mocks/upstream/features/mutating_constants/hide_undefined_constant.feature +22 -0
- data/rspec-mocks/upstream/features/mutating_constants/stub_defined_constant.feature +77 -0
- data/rspec-mocks/upstream/features/mutating_constants/stub_undefined_constant.feature +50 -0
- data/rspec-mocks/upstream/features/old_syntax/README.md +35 -0
- data/rspec-mocks/upstream/features/old_syntax/any_instance.feature +105 -0
- data/rspec-mocks/upstream/features/old_syntax/should_receive.feature +90 -0
- data/rspec-mocks/upstream/features/old_syntax/stub.feature +51 -0
- data/rspec-mocks/upstream/features/old_syntax/stub_chain.feature +69 -0
- data/rspec-mocks/upstream/features/old_syntax/unstub.feature +43 -0
- data/rspec-mocks/upstream/features/outside_rspec/minitest.feature +80 -0
- data/rspec-mocks/upstream/features/outside_rspec/standalone.feature +33 -0
- data/rspec-mocks/upstream/features/setting_constraints/README.md +6 -0
- data/rspec-mocks/upstream/features/setting_constraints/matching_arguments.feature +97 -0
- data/rspec-mocks/upstream/features/setting_constraints/message_order.feature +63 -0
- data/rspec-mocks/upstream/features/setting_constraints/receive_counts.feature +189 -0
- data/rspec-mocks/upstream/features/step_definitions/additional_cli_steps.rb +21 -0
- data/rspec-mocks/upstream/features/support/disallow_certain_apis.rb +24 -0
- data/rspec-mocks/upstream/features/support/env.rb +22 -0
- data/rspec-mocks/upstream/features/support/rubinius.rb +6 -0
- data/rspec-mocks/upstream/features/verifying_doubles/README.md +13 -0
- data/rspec-mocks/upstream/features/verifying_doubles/class_doubles.feature +70 -0
- data/rspec-mocks/upstream/features/verifying_doubles/dynamic_classes.feature +73 -0
- data/rspec-mocks/upstream/features/verifying_doubles/instance_doubles.feature +101 -0
- data/rspec-mocks/upstream/features/verifying_doubles/object_doubles.feature +62 -0
- data/rspec-mocks/upstream/features/verifying_doubles/partial_doubles.feature +34 -0
- data/rspec-mocks/upstream/features/working_with_legacy_code/README.md +3 -0
- data/rspec-mocks/upstream/features/working_with_legacy_code/any_instance.feature +115 -0
- data/rspec-mocks/upstream/features/working_with_legacy_code/message_chains.feature +79 -0
- data/rspec-mocks/upstream/lib/rspec/mocks.rb +126 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance.rb +10 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance/chain.rb +109 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance/expect_chain_chain.rb +35 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance/expectation_chain.rb +48 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance/message_chains.rb +85 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance/proxy.rb +116 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance/recorder.rb +267 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance/stub_chain.rb +45 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/any_instance/stub_chain_chain.rb +27 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/argument_list_matcher.rb +72 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/argument_matchers.rb +282 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/configuration.rb +157 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/error_generator.rb +253 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/example_methods.rb +379 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/instance_method_stasher.rb +135 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/marshal_extension.rb +41 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/matchers/expectation_customization.rb +20 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/matchers/have_received.rb +121 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/matchers/receive.rb +106 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/matchers/receive_message_chain.rb +66 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/matchers/receive_messages.rb +71 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/message_chain.rb +91 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/message_expectation.rb +694 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/method_double.rb +260 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/method_reference.rb +155 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/mutate_const.rb +324 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/object_reference.rb +91 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/order_group.rb +81 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/proxy.rb +431 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/space.rb +221 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/standalone.rb +3 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/syntax.rb +329 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/targets.rb +97 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/test_double.rb +135 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/verifying_double.rb +127 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/verifying_message_expecation.rb +62 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/verifying_proxy.rb +171 -0
- data/rspec-mocks/upstream/lib/rspec/mocks/version.rb +9 -0
- data/rspec-mocks/upstream/maintenance-branch +1 -0
- data/rspec-mocks/upstream/rspec-mocks.gemspec +44 -0
- data/rspec-mocks/upstream/script/clone_all_rspec_repos +24 -0
- data/rspec-mocks/upstream/script/functions.sh +168 -0
- data/rspec-mocks/upstream/script/ignores +55 -0
- data/rspec-mocks/upstream/script/list_method_cache_busters.sh +22 -0
- data/rspec-mocks/upstream/script/run_build +28 -0
- data/rspec-support/upstream/.gitignore +19 -0
- data/rspec-support/upstream/.rspec +4 -0
- data/rspec-support/upstream/.rubocop.yml +1 -0
- data/rspec-support/upstream/.rubocop_rspec_base.yml +130 -0
- data/rspec-support/upstream/.travis.yml +35 -0
- data/rspec-support/upstream/Changelog.md +77 -0
- data/rspec-support/upstream/Gemfile +21 -0
- data/rspec-support/upstream/LICENSE.txt +22 -0
- data/rspec-support/upstream/README.md +17 -0
- data/rspec-support/upstream/Rakefile +30 -0
- data/rspec-support/upstream/benchmarks/caller.rb +81 -0
- data/rspec-support/upstream/lib/rspec/support.rb +76 -0
- data/rspec-support/upstream/lib/rspec/support/caller_filter.rb +63 -0
- data/rspec-support/upstream/lib/rspec/support/differ.rb +214 -0
- data/rspec-support/upstream/lib/rspec/support/directory_maker.rb +61 -0
- data/rspec-support/upstream/lib/rspec/support/encoded_string.rb +69 -0
- data/rspec-support/upstream/lib/rspec/support/fuzzy_matcher.rb +48 -0
- data/rspec-support/upstream/lib/rspec/support/hunk_generator.rb +47 -0
- data/rspec-support/upstream/lib/rspec/support/matcher_definition.rb +31 -0
- data/rspec-support/upstream/lib/rspec/support/method_signature_verifier.rb +272 -0
- data/rspec-support/upstream/lib/rspec/support/os.rb +18 -0
- data/rspec-support/upstream/lib/rspec/support/recursive_const_methods.rb +76 -0
- data/rspec-support/upstream/lib/rspec/support/ruby_features.rb +45 -0
- data/rspec-support/upstream/lib/rspec/support/spec.rb +72 -0
- data/rspec-support/upstream/lib/rspec/support/spec/deprecation_helpers.rb +60 -0
- data/rspec-support/upstream/lib/rspec/support/spec/formatting_support.rb +9 -0
- data/rspec-support/upstream/lib/rspec/support/spec/in_sub_process.rb +43 -0
- data/rspec-support/upstream/lib/rspec/support/spec/prevent_load_time_warnings.rb +44 -0
- data/rspec-support/upstream/lib/rspec/support/spec/shell_out.rb +69 -0
- data/rspec-support/upstream/lib/rspec/support/spec/stderr_splitter.rb +52 -0
- data/rspec-support/upstream/lib/rspec/support/spec/with_isolated_directory.rb +9 -0
- data/rspec-support/upstream/lib/rspec/support/spec/with_isolated_stderr.rb +13 -0
- data/rspec-support/upstream/lib/rspec/support/version.rb +7 -0
- data/rspec-support/upstream/lib/rspec/support/version_checker.rb +53 -0
- data/rspec-support/upstream/lib/rspec/support/warnings.rb +39 -0
- data/rspec-support/upstream/maintenance-branch +1 -0
- data/rspec-support/upstream/rspec-support.gemspec +34 -0
- data/rspec-support/upstream/script/clone_all_rspec_repos +24 -0
- data/rspec-support/upstream/script/functions.sh +168 -0
- data/rspec-support/upstream/script/run_build +28 -0
- data/rspec/upstream/.document +2 -0
- data/rspec/upstream/.gitignore +11 -0
- data/rspec/upstream/Gemfile +7 -0
- data/rspec/upstream/License.txt +24 -0
- data/rspec/upstream/README.md +47 -0
- data/rspec/upstream/Rakefile +25 -0
- data/rspec/upstream/certs/rspec.pem +22 -0
- data/rspec/upstream/lib/rspec.rb +3 -0
- data/rspec/upstream/lib/rspec/version.rb +5 -0
- data/rspec/upstream/rspec.gemspec +40 -0
- metadata +462 -53
- data/rspec-core/spec/files_to_exclude.txt +0 -12
- data/rspec-core/spec/filters.rb +0 -211
- data/rspec-core/spec/fixes/missing_constants.rb +0 -34
- data/rspec-core/spec/fixes/sandboxing.rb +0 -72
- data/rspec-core/spec/fixes/shared_examples.rb +0 -6
- data/rspec-core/spec/requires.rb +0 -41
- data/rspec-expectations/spec/files_to_exclude.txt +0 -2
- data/rspec-expectations/spec/filters.rb +0 -188
- data/rspec-expectations/spec/fixes/missing_constants.rb +0 -10
- data/rspec-expectations/spec/fixes/shared_examples.rb +0 -15
- data/rspec-expectations/spec/requires.rb +0 -32
- data/rspec-mocks/spec/files_to_exclude.txt +0 -11
- data/rspec-mocks/spec/filters.rb +0 -98
- data/rspec-mocks/spec/fixes/shared_examples.rb +0 -6
- data/rspec-mocks/spec/requires.rb +0 -22
- data/rspec-support/spec/files_to_exclude.txt +0 -26
- data/rspec-support/spec/filters.rb +0 -17
- data/rspec-support/spec/fixes/missing_constants.rb +0 -3
- data/rspec-support/spec/fixes/shared_examples.rb +0 -4
- data/rspec-support/spec/requires.rb +0 -30
- data/spec-opal-passing/spec_helper.rb +0 -3
- data/spec-opal-passing/tautology_spec.rb +0 -21
- data/spec-opal-rspec/core/example_group_spec.rb +0 -145
- data/spec-opal-rspec/core/failed_example_notification_spec.rb +0 -31
- data/spec-opal-rspec/core/hooks_spec.rb +0 -113
- data/spec-opal-rspec/core/memoized_helpers_spec.rb +0 -36
- data/spec-opal-rspec/core/metadata_spec.rb +0 -48
- data/spec-opal-rspec/expectations/be_instance_of_spec.rb +0 -11
- data/spec-opal-rspec/expectations/dsl_spec.rb +0 -66
- data/spec-opal-rspec/expectations/expectation_target_spec.rb +0 -21
- data/spec-opal-rspec/expectations/yield_spec.rb +0 -11
- data/spec-opal/after_hooks_spec.rb +0 -142
- data/spec-opal/around_hooks_spec.rb +0 -77
- data/spec-opal/async_spec.rb +0 -134
- data/spec-opal/before_hooks_spec.rb +0 -185
- data/spec-opal/browser-formatter/opal_browser_formatter_spec.rb +0 -14
- data/spec-opal/example_spec.rb +0 -176
- data/spec-opal/legacy_async_spec.rb +0 -189
- data/spec-opal/matchers_spec.rb +0 -207
- data/spec-opal/mock_spec.rb +0 -65
- data/spec-opal/other/color_on_by_default_spec.rb +0 -9
- data/spec-opal/other/dummy_spec.rb +0 -5
- data/spec-opal/other/formatter_dependency.rb +0 -3
- data/spec-opal/other/ignored_spec.opal +0 -5
- data/spec-opal/other/test_formatter.rb +0 -9
- data/spec-opal/should_syntax_spec.rb +0 -19
- data/spec-opal/skip_pending_spec.rb +0 -45
- data/spec-opal/spec_helper.rb +0 -8
- data/spec-opal/sprockets_runner_js_errors.rb.erb +0 -18
- data/spec-opal/subject_spec.rb +0 -89
@@ -0,0 +1,28 @@
|
|
1
|
+
## Set up the dev environment
|
2
|
+
|
3
|
+
git clone git://github.com/rspec/rspec-mocks.git
|
4
|
+
cd rspec-mocks
|
5
|
+
gem install bundler
|
6
|
+
bundle install
|
7
|
+
|
8
|
+
Now you should be able to run any of:
|
9
|
+
|
10
|
+
rake
|
11
|
+
rake spec
|
12
|
+
rake cucumber
|
13
|
+
|
14
|
+
Or, if you prefer to use the rspec and cucumber commands directly, you can either:
|
15
|
+
|
16
|
+
bundle exec rspec
|
17
|
+
|
18
|
+
Or ...
|
19
|
+
|
20
|
+
bundle install --binstubs
|
21
|
+
bin/rspec
|
22
|
+
|
23
|
+
## Customize the dev enviroment
|
24
|
+
|
25
|
+
The Gemfile includes the gems you'll need to be able to run specs. If you want
|
26
|
+
to customize your dev enviroment with additional tools like guard or
|
27
|
+
ruby-debug, add any additional gem declarations to Gemfile-custom (see
|
28
|
+
Gemfile-custom.sample for some examples).
|
@@ -0,0 +1,34 @@
|
|
1
|
+
source "https://rubygems.org"
|
2
|
+
|
3
|
+
gemspec
|
4
|
+
|
5
|
+
branch = File.read(File.expand_path("../maintenance-branch", __FILE__)).chomp
|
6
|
+
%w[rspec rspec-core rspec-expectations rspec-support].each do |lib|
|
7
|
+
library_path = File.expand_path("../../#{lib}", __FILE__)
|
8
|
+
if File.exist?(library_path) && !ENV['USE_GIT_REPOS']
|
9
|
+
gem lib, :path => library_path
|
10
|
+
else
|
11
|
+
gem lib, :git => "git://github.com/rspec/#{lib}.git", :branch => branch
|
12
|
+
end
|
13
|
+
end
|
14
|
+
|
15
|
+
gem 'yard', '~> 0.8.7', :require => false
|
16
|
+
gem 'rubocop', "~> 0.23.0", :platform => [:ruby_19, :ruby_20, :ruby_21]
|
17
|
+
|
18
|
+
### deps for rdoc.info
|
19
|
+
group :documentation do
|
20
|
+
gem 'redcarpet', '2.1.1' unless RUBY_PLATFORM == 'java'
|
21
|
+
gem 'github-markup', '0.7.2'
|
22
|
+
end
|
23
|
+
|
24
|
+
gem 'simplecov', '~> 0.8'
|
25
|
+
|
26
|
+
platforms :jruby do
|
27
|
+
gem "jruby-openssl"
|
28
|
+
end
|
29
|
+
|
30
|
+
platforms :rbx do
|
31
|
+
gem 'rubysl'
|
32
|
+
end
|
33
|
+
|
34
|
+
eval File.read('Gemfile-custom') if File.exist?('Gemfile-custom')
|
@@ -0,0 +1,19 @@
|
|
1
|
+
group :development do
|
2
|
+
gem 'interactive_rspec'
|
3
|
+
gem 'relish', '~> 0.6.0'
|
4
|
+
gem 'guard-rspec', '~> 1.2.1'
|
5
|
+
gem 'growl', '1.0.3'
|
6
|
+
gem 'spork', '0.9.0'
|
7
|
+
|
8
|
+
platform :mri do
|
9
|
+
gem 'rb-fsevent', '~> 0.9.0'
|
10
|
+
gem 'ruby-prof', '~> 0.10.0'
|
11
|
+
|
12
|
+
case RUBY_VERSION
|
13
|
+
when /^1.8/
|
14
|
+
gem 'ruby-debug'
|
15
|
+
when /^1.9/
|
16
|
+
gem 'debugger'
|
17
|
+
end
|
18
|
+
end
|
19
|
+
end
|
@@ -0,0 +1,24 @@
|
|
1
|
+
(The MIT License)
|
2
|
+
|
3
|
+
Copyright (c) 2012 David Chelimsky, Myron Marston
|
4
|
+
Copyright (c) 2006 David Chelimsky, The RSpec Development Team
|
5
|
+
Copyright (c) 2005 Steven Baker
|
6
|
+
|
7
|
+
Permission is hereby granted, free of charge, to any person obtaining
|
8
|
+
a copy of this software and associated documentation files (the
|
9
|
+
"Software"), to deal in the Software without restriction, including
|
10
|
+
without limitation the rights to use, copy, modify, merge, publish,
|
11
|
+
distribute, sublicense, and/or sell copies of the Software, and to
|
12
|
+
permit persons to whom the Software is furnished to do so, subject to
|
13
|
+
the following conditions:
|
14
|
+
|
15
|
+
The above copyright notice and this permission notice shall be
|
16
|
+
included in all copies or substantial portions of the Software.
|
17
|
+
|
18
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
19
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
20
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
21
|
+
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
22
|
+
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
23
|
+
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
24
|
+
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
@@ -0,0 +1,397 @@
|
|
1
|
+
# RSpec Mocks [![Build Status](https://secure.travis-ci.org/rspec/rspec-mocks.png?branch=master)](http://travis-ci.org/rspec/rspec-mocks) [![Code Climate](https://codeclimate.com/github/rspec/rspec-mocks.png)](https://codeclimate.com/github/rspec/rspec-mocks)
|
2
|
+
rspec-mocks is a test-double framework for rspec with support for method stubs,
|
3
|
+
fakes, and message expectations on generated test-doubles and real objects
|
4
|
+
alike.
|
5
|
+
|
6
|
+
## Install
|
7
|
+
|
8
|
+
gem install rspec # for rspec-core, rspec-expectations, rspec-mocks
|
9
|
+
gem install rspec-mocks # for rspec-mocks only
|
10
|
+
|
11
|
+
## Test Doubles
|
12
|
+
|
13
|
+
A test double is an object that stands in for another object in your system
|
14
|
+
during a code example. Use the `double` method, passing in an optional identifier, to create one:
|
15
|
+
|
16
|
+
```ruby
|
17
|
+
book = double("book")
|
18
|
+
```
|
19
|
+
|
20
|
+
Most of the time you will want some confidence that your doubles resemble an
|
21
|
+
existing object in your system. Verifying doubles are provided for this
|
22
|
+
purpose. If the existing object is available, they will prevent you from adding
|
23
|
+
stubs and expectations for methods that do not exist or that have an invalid
|
24
|
+
number of parameters.
|
25
|
+
|
26
|
+
```ruby
|
27
|
+
book = instance_double("Book", :pages => 250)
|
28
|
+
```
|
29
|
+
|
30
|
+
Verifying doubles have some clever tricks to enable you to both test in
|
31
|
+
isolation without your dependencies loaded while still being able to validate
|
32
|
+
them against real objects. More detail is available in [their
|
33
|
+
documentation](https://github.com/rspec/rspec-mocks/blob/master/features/verifying_doubles).
|
34
|
+
|
35
|
+
## Method Stubs
|
36
|
+
|
37
|
+
A method stub is an implementation that returns a pre-determined value. Method
|
38
|
+
stubs can be declared on test doubles or real objects using the same syntax.
|
39
|
+
rspec-mocks supports 3 forms for declaring method stubs:
|
40
|
+
|
41
|
+
```ruby
|
42
|
+
allow(book).to receive(:title) { "The RSpec Book" }
|
43
|
+
allow(book).to receive(:title).and_return("The RSpec Book")
|
44
|
+
allow(book).to receive_messages(
|
45
|
+
:title => "The RSpec Book",
|
46
|
+
:subtitle => "Behaviour-Driven Development with RSpec, Cucumber, and Friends")
|
47
|
+
```
|
48
|
+
|
49
|
+
You can also use this shortcut, which creates a test double and declares a
|
50
|
+
method stub in one statement:
|
51
|
+
|
52
|
+
```ruby
|
53
|
+
book = double("book", :title => "The RSpec Book")
|
54
|
+
```
|
55
|
+
|
56
|
+
The first argument is a name, which is used for documentation and appears in
|
57
|
+
failure messages. If you don't care about the name, you can leave it out,
|
58
|
+
making the combined instantiation/stub declaration very terse:
|
59
|
+
|
60
|
+
```ruby
|
61
|
+
double(:foo => 'bar')
|
62
|
+
```
|
63
|
+
|
64
|
+
This is particularly nice when providing a list of test doubles to a method
|
65
|
+
that iterates through them:
|
66
|
+
|
67
|
+
```ruby
|
68
|
+
order.calculate_total_price(double(:price => 1.99), double(:price => 2.99))
|
69
|
+
```
|
70
|
+
|
71
|
+
## Consecutive return values
|
72
|
+
|
73
|
+
When a stub might be invoked more than once, you can provide additional
|
74
|
+
arguments to `and_return`. The invocations cycle through the list. The last
|
75
|
+
value is returned for any subsequent invocations:
|
76
|
+
|
77
|
+
```ruby
|
78
|
+
allow(die).to receive(:roll).and_return(1, 2, 3)
|
79
|
+
die.roll # => 1
|
80
|
+
die.roll # => 2
|
81
|
+
die.roll # => 3
|
82
|
+
die.roll # => 3
|
83
|
+
die.roll # => 3
|
84
|
+
```
|
85
|
+
|
86
|
+
To return an array in a single invocation, declare an array:
|
87
|
+
|
88
|
+
```ruby
|
89
|
+
allow(team).to receive(:players).and_return([double(:name => "David")])
|
90
|
+
```
|
91
|
+
|
92
|
+
## Message Expectations
|
93
|
+
|
94
|
+
A message expectation is an expectation that the test double will receive a
|
95
|
+
message some time before the example ends. If the message is received, the
|
96
|
+
expectation is satisfied. If not, the example fails.
|
97
|
+
|
98
|
+
```ruby
|
99
|
+
validator = double("validator")
|
100
|
+
expect(validator).to receive(:validate) { "02134" }
|
101
|
+
zipcode = Zipcode.new("02134", validator)
|
102
|
+
zipcode.valid?
|
103
|
+
```
|
104
|
+
|
105
|
+
## Test Spies
|
106
|
+
|
107
|
+
Verifies the given object received the expected message during the course of
|
108
|
+
the test. For a message to be verified, the given object must be setup to spy
|
109
|
+
on it, either by having it explicitly stubbed or by being a null object double
|
110
|
+
(e.g. `double(...).as_null_object`). Convenience methods are provided to easily
|
111
|
+
create null object doubles for this purpose:
|
112
|
+
|
113
|
+
```ruby
|
114
|
+
spy("invitation") # => same as `double("invitation").as_null_object`
|
115
|
+
instance_spy("Invitation") # => same as `instance_double("Invitation").as_null_object`
|
116
|
+
class_spy("Invitation") # => same as `class_double("Invitation").as_null_object`
|
117
|
+
object_spy("Invitation") # => same as `object_double("Invitation").as_null_object`
|
118
|
+
```
|
119
|
+
|
120
|
+
Stubbing and verifying messages received in this way implements the Test Spy
|
121
|
+
pattern.
|
122
|
+
|
123
|
+
```ruby
|
124
|
+
invitation = spy('invitation')
|
125
|
+
|
126
|
+
user.accept_invitation(invitation)
|
127
|
+
|
128
|
+
expect(invitation).to have_received(:accept)
|
129
|
+
|
130
|
+
# You can also use other common message expectations. For example:
|
131
|
+
expect(invitation).to have_received(:accept).with(mailer)
|
132
|
+
expect(invitation).to have_received(:accept).twice
|
133
|
+
expect(invitation).to_not have_received(:accept).with(mailer)
|
134
|
+
|
135
|
+
# One can specify a return value on the spy the same way one would a double.
|
136
|
+
invitation = spy('invitation', :accept => true)
|
137
|
+
expect(invitation).to have_received(:accept).with(mailer)
|
138
|
+
expect(invitation.accept).to eq(true)
|
139
|
+
```
|
140
|
+
|
141
|
+
## Nomenclature
|
142
|
+
|
143
|
+
### Mock Objects and Test Stubs
|
144
|
+
|
145
|
+
The names Mock Object and Test Stub suggest specialized Test Doubles. i.e.
|
146
|
+
a Test Stub is a Test Double that only supports method stubs, and a Mock
|
147
|
+
Object is a Test Double that supports message expectations and method
|
148
|
+
stubs.
|
149
|
+
|
150
|
+
There is a lot of overlapping nomenclature here, and there are many
|
151
|
+
variations of these patterns (fakes, spies, etc). Keep in mind that most of
|
152
|
+
the time we're talking about method-level concepts that are variations of
|
153
|
+
method stubs and message expectations, and we're applying to them to _one_
|
154
|
+
generic kind of object: a Test Double.
|
155
|
+
|
156
|
+
### Test-Specific Extension
|
157
|
+
|
158
|
+
a.k.a. Partial Double, a Test-Specific Extension is an extension of a
|
159
|
+
real object in a system that is instrumented with test-double like
|
160
|
+
behaviour in the context of a test. This technique is very common in Ruby
|
161
|
+
because we often see class objects acting as global namespaces for methods.
|
162
|
+
For example, in Rails:
|
163
|
+
|
164
|
+
```ruby
|
165
|
+
person = double("person")
|
166
|
+
allow(Person).to receive(:find) { person }
|
167
|
+
```
|
168
|
+
|
169
|
+
In this case we're instrumenting Person to return the person object we've
|
170
|
+
defined whenever it receives the `find` message. We can also set a message
|
171
|
+
expectation so that the example fails if `find` is not called:
|
172
|
+
|
173
|
+
```ruby
|
174
|
+
person = double("person")
|
175
|
+
expect(Person).to receive(:find) { person }
|
176
|
+
```
|
177
|
+
|
178
|
+
RSpec replaces the method we're stubbing or mocking with its own
|
179
|
+
test-double-like method. At the end of the example, RSpec verifies any message
|
180
|
+
expectations, and then restores the original methods.
|
181
|
+
|
182
|
+
## Expecting Arguments
|
183
|
+
|
184
|
+
```ruby
|
185
|
+
expect(double).to receive(:msg).with(*args)
|
186
|
+
expect(double).to_not receive(:msg).with(*args)
|
187
|
+
```
|
188
|
+
|
189
|
+
You can set multiple expectations for the same message if you need to:
|
190
|
+
|
191
|
+
```ruby
|
192
|
+
expect(double).to receive(:msg).with("A", 1, 3)
|
193
|
+
expect(double).to receive(:msg).with("B", 2, 4)
|
194
|
+
```
|
195
|
+
|
196
|
+
## Argument Matchers
|
197
|
+
|
198
|
+
Arguments that are passed to `with` are compared with actual arguments
|
199
|
+
received using ==. In cases in which you want to specify things about the
|
200
|
+
arguments rather than the arguments themselves, you can use any of the
|
201
|
+
matchers that ship with rspec-expectations. They don't all make syntactic
|
202
|
+
sense (they were primarily designed for use with RSpec::Expectations), but
|
203
|
+
you are free to create your own custom RSpec::Matchers.
|
204
|
+
|
205
|
+
rspec-mocks also adds some keyword Symbols that you can use to
|
206
|
+
specify certain kinds of arguments:
|
207
|
+
|
208
|
+
```ruby
|
209
|
+
expect(double).to receive(:msg).with(no_args())
|
210
|
+
expect(double).to receive(:msg).with(any_args())
|
211
|
+
expect(double).to receive(:msg).with(1, kind_of(Numeric), "b") #2nd argument can be any kind of Numeric
|
212
|
+
expect(double).to receive(:msg).with(1, boolean(), "b") #2nd argument can be true or false
|
213
|
+
expect(double).to receive(:msg).with(1, /abc/, "b") #2nd argument can be any String matching the submitted Regexp
|
214
|
+
expect(double).to receive(:msg).with(1, anything(), "b") #2nd argument can be anything at all
|
215
|
+
expect(double).to receive(:msg).with(1, duck_type(:abs, :div), "b") #2nd argument can be object that responds to #abs and #div
|
216
|
+
expect(double).to receive(:msg).with(hash_including(:a => 5)) # first arg is a hash with a: 5 as one of the key-values
|
217
|
+
expect(double).to receive(:msg).with(array_including(5)) # first arg is an array with 5 as one of the key-values
|
218
|
+
expect(double).to receive(:msg).with(hash_excluding(:a => 5)) # first arg is a hash without a: 5 as one of the key-values
|
219
|
+
```
|
220
|
+
|
221
|
+
## Receive Counts
|
222
|
+
|
223
|
+
```ruby
|
224
|
+
expect(double).to receive(:msg).once
|
225
|
+
expect(double).to receive(:msg).twice
|
226
|
+
expect(double).to receive(:msg).exactly(n).times
|
227
|
+
expect(double).to receive(:msg).at_least(:once)
|
228
|
+
expect(double).to receive(:msg).at_least(:twice)
|
229
|
+
expect(double).to receive(:msg).at_least(n).times
|
230
|
+
expect(double).to receive(:msg).at_most(:once)
|
231
|
+
expect(double).to receive(:msg).at_most(:twice)
|
232
|
+
expect(double).to receive(:msg).at_most(n).times
|
233
|
+
```
|
234
|
+
|
235
|
+
## Ordering
|
236
|
+
|
237
|
+
```ruby
|
238
|
+
expect(double).to receive(:msg).ordered
|
239
|
+
expect(double).to receive(:other_msg).ordered
|
240
|
+
# This will fail if the messages are received out of order
|
241
|
+
```
|
242
|
+
|
243
|
+
This can include the same message with different arguments:
|
244
|
+
|
245
|
+
```ruby
|
246
|
+
expect(double).to receive(:msg).with("A", 1, 3).ordered
|
247
|
+
expect(double).to receive(:msg).with("B", 2, 4).ordered
|
248
|
+
```
|
249
|
+
|
250
|
+
## Setting Responses
|
251
|
+
|
252
|
+
Whether you are setting a message expectation or a method stub, you can
|
253
|
+
tell the object precisely how to respond. The most generic way is to pass
|
254
|
+
a block to `receive`:
|
255
|
+
|
256
|
+
```ruby
|
257
|
+
expect(double).to receive(:msg) { value }
|
258
|
+
```
|
259
|
+
|
260
|
+
When the double receives the `msg` message, it evaluates the block and returns
|
261
|
+
the result.
|
262
|
+
|
263
|
+
```ruby
|
264
|
+
expect(double).to receive(:msg).and_return(value)
|
265
|
+
expect(double).to receive(:msg).exactly(3).times.and_return(value1, value2, value3)
|
266
|
+
# returns value1 the first time, value2 the second, etc
|
267
|
+
expect(double).to receive(:msg).and_raise(error)
|
268
|
+
# error can be an instantiated object or a class
|
269
|
+
# if it is a class, it must be instantiable with no args
|
270
|
+
expect(double).to receive(:msg).and_throw(:msg)
|
271
|
+
expect(double).to receive(:msg).and_yield(values, to, yield)
|
272
|
+
expect(double).to receive(:msg).and_yield(values, to, yield).and_yield(some, other, values, this, time)
|
273
|
+
# for methods that yield to a block multiple times
|
274
|
+
```
|
275
|
+
|
276
|
+
Any of these responses can be applied to a stub as well
|
277
|
+
|
278
|
+
```ruby
|
279
|
+
allow(double).to receive(:msg).and_return(value)
|
280
|
+
allow(double).to receive(:msg).and_return(value1, value2, value3)
|
281
|
+
allow(double).to receive(:msg).and_raise(error)
|
282
|
+
allow(double).to receive(:msg).and_throw(:msg)
|
283
|
+
allow(double).to receive(:msg).and_yield(values, to, yield)
|
284
|
+
allow(double).to receive(:msg).and_yield(values, to, yield).and_yield(some, other, values, this, time)
|
285
|
+
```
|
286
|
+
|
287
|
+
## Arbitrary Handling
|
288
|
+
|
289
|
+
Once in a while you'll find that the available expectations don't solve the
|
290
|
+
particular problem you are trying to solve. Imagine that you expect the message
|
291
|
+
to come with an Array argument that has a specific length, but you don't care
|
292
|
+
what is in it. You could do this:
|
293
|
+
|
294
|
+
```ruby
|
295
|
+
expect(double).to receive(:msg) do |arg|
|
296
|
+
expect(arg.size).to eq 7
|
297
|
+
end
|
298
|
+
```
|
299
|
+
|
300
|
+
If the method being stubbed itself takes a block, and you need to yield to it
|
301
|
+
in some special way, you can use this:
|
302
|
+
|
303
|
+
```ruby
|
304
|
+
expect(double).to receive(:msg) do |&arg|
|
305
|
+
begin
|
306
|
+
arg.call
|
307
|
+
ensure
|
308
|
+
# cleanup
|
309
|
+
end
|
310
|
+
end
|
311
|
+
```
|
312
|
+
|
313
|
+
## Delegating to the Original Implementation
|
314
|
+
|
315
|
+
When working with a partial mock object, you may occasionally
|
316
|
+
want to set a message expecation without interfering with how
|
317
|
+
the object responds to the message. You can use `and_call_original`
|
318
|
+
to achieve this:
|
319
|
+
|
320
|
+
```ruby
|
321
|
+
expect(Person).to receive(:find).and_call_original
|
322
|
+
Person.find # => executes the original find method and returns the result
|
323
|
+
```
|
324
|
+
|
325
|
+
## Combining Expectation Details
|
326
|
+
|
327
|
+
Combining the message name with specific arguments, receive counts and responses
|
328
|
+
you can get quite a bit of detail in your expectations:
|
329
|
+
|
330
|
+
```ruby
|
331
|
+
expect(double).to receive(:<<).with("illegal value").once.and_raise(ArgumentError)
|
332
|
+
```
|
333
|
+
|
334
|
+
While this is a good thing when you really need it, you probably don't really
|
335
|
+
need it! Take care to specify only the things that matter to the behavior of
|
336
|
+
your code.
|
337
|
+
|
338
|
+
## Stubbing and Hiding Constants
|
339
|
+
|
340
|
+
See the [mutating constants
|
341
|
+
README](https://github.com/rspec/rspec-mocks/blob/master/features/mutating_constants/README.md)
|
342
|
+
for info on this feature.
|
343
|
+
|
344
|
+
## Use `before(:example)`, not `before(:context)`
|
345
|
+
|
346
|
+
Stubs in `before(:context)` are not supported. The reason is that all stubs and mocks get cleared out after each example, so any stub that is set in `before(:context)` would work in the first example that happens to run in that group, but not for any others.
|
347
|
+
|
348
|
+
Instead of `before(:context)`, use `before(:example)`.
|
349
|
+
|
350
|
+
## Settings mocks or stubs on any instance of a class
|
351
|
+
|
352
|
+
rspec-mocks provides two methods, `allow_any_instance_of` and
|
353
|
+
`expect_any_instance_of`, that will allow you to stub or mock any instance
|
354
|
+
of a class. They are used in place of `allow` or `expect`:
|
355
|
+
|
356
|
+
```ruby
|
357
|
+
allow_any_instance_of(Widget).to receive(:name).and_return("Wibble")
|
358
|
+
expect_any_instance_of(Widget).to receive(:name).and_return("Wobble")
|
359
|
+
```
|
360
|
+
|
361
|
+
These methods add the appropriate stub or expectation to all instances of
|
362
|
+
`Widget`.
|
363
|
+
|
364
|
+
This feature is sometimes useful when working with legacy code, though in
|
365
|
+
general we discourage its use for a number of reasons:
|
366
|
+
|
367
|
+
* The `rspec-mocks` API is designed for individual object instances, but this
|
368
|
+
feature operates on entire classes of objects. As a result there are some
|
369
|
+
sematically confusing edge cases. For example in
|
370
|
+
`expect_any_instance_of(Widget).to receive(:name).twice` it isn't clear
|
371
|
+
whether each specific instance is expected to receive `name` twice, or if two
|
372
|
+
receives total are expected. (It's the former.)
|
373
|
+
* Using this feature is often a design smell. It may be
|
374
|
+
that your test is trying to do too much or that the object under test is too
|
375
|
+
complex.
|
376
|
+
* It is the most complicated feature of `rspec-mocks`, and has historically
|
377
|
+
received the most bug reports. (None of the core team actively use it,
|
378
|
+
which doesn't help.)
|
379
|
+
|
380
|
+
|
381
|
+
## Further Reading
|
382
|
+
|
383
|
+
There are many different viewpoints about the meaning of mocks and stubs. If
|
384
|
+
you are interested in learning more, here is some recommended reading:
|
385
|
+
|
386
|
+
* Mock Objects: http://www.mockobjects.com/
|
387
|
+
* Endo-Testing: http://stalatest.googlecode.com/svn/trunk/Literatur/mockobjects.pdf
|
388
|
+
* Mock Roles, Not Objects: http://jmock.org/oopsla2004.pdf
|
389
|
+
* Test Double: http://www.martinfowler.com/bliki/TestDouble.html
|
390
|
+
* Test Double Patterns: http://xunitpatterns.com/Test%20Double%20Patterns.html
|
391
|
+
* Mocks aren't stubs: http://www.martinfowler.com/articles/mocksArentStubs.html
|
392
|
+
|
393
|
+
## Also see
|
394
|
+
|
395
|
+
* [http://github.com/rspec/rspec](http://github.com/rspec/rspec)
|
396
|
+
* [http://github.com/rspec/rspec-core](http://github.com/rspec/rspec-core)
|
397
|
+
* [http://github.com/rspec/rspec-expectations](http://github.com/rspec/rspec-expectations)
|