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,183 @@
|
|
1
|
+
RSpec::Support.require_rspec_support "fuzzy_matcher"
|
2
|
+
|
3
|
+
module RSpec
|
4
|
+
module Matchers
|
5
|
+
# Mixin designed to support the composable matcher features
|
6
|
+
# of RSpec 3+. Mix it into your custom matcher classes to
|
7
|
+
# allow them to be used in a composable fashion.
|
8
|
+
#
|
9
|
+
# @api public
|
10
|
+
module Composable
|
11
|
+
# Creates a compound `and` expectation. The matcher will
|
12
|
+
# only pass if both sub-matchers pass.
|
13
|
+
# This can be chained together to form an arbitrarily long
|
14
|
+
# chain of matchers.
|
15
|
+
#
|
16
|
+
# @example
|
17
|
+
# expect(alphabet).to start_with("a").and end_with("z")
|
18
|
+
# expect(alphabet).to start_with("a") & end_with("z")
|
19
|
+
#
|
20
|
+
# @note The negative form (`expect(...).not_to matcher.and other`)
|
21
|
+
# is not supported at this time.
|
22
|
+
def and(matcher)
|
23
|
+
BuiltIn::Compound::And.new self, matcher
|
24
|
+
end
|
25
|
+
alias & and
|
26
|
+
|
27
|
+
# Creates a compound `or` expectation. The matcher will
|
28
|
+
# pass if either sub-matcher passes.
|
29
|
+
# This can be chained together to form an arbitrarily long
|
30
|
+
# chain of matchers.
|
31
|
+
#
|
32
|
+
# @example
|
33
|
+
# expect(stoplight.color).to eq("red").or eq("green").or eq("yellow")
|
34
|
+
# expect(stoplight.color).to eq("red") | eq("green") | eq("yellow")
|
35
|
+
#
|
36
|
+
# @note The negative form (`expect(...).not_to matcher.or other`)
|
37
|
+
# is not supported at this time.
|
38
|
+
def or(matcher)
|
39
|
+
BuiltIn::Compound::Or.new self, matcher
|
40
|
+
end
|
41
|
+
alias | or
|
42
|
+
|
43
|
+
# Delegates to `#matches?`. Allows matchers to be used in composable
|
44
|
+
# fashion and also supports using matchers in case statements.
|
45
|
+
def ===(value)
|
46
|
+
matches?(value)
|
47
|
+
end
|
48
|
+
|
49
|
+
private
|
50
|
+
|
51
|
+
# This provides a generic way to fuzzy-match an expected value against
|
52
|
+
# an actual value. It understands nested data structures (e.g. hashes
|
53
|
+
# and arrays) and is able to match against a matcher being used as
|
54
|
+
# the expected value or within the expected value at any level of
|
55
|
+
# nesting.
|
56
|
+
#
|
57
|
+
# Within a custom matcher you are encouraged to use this whenever your
|
58
|
+
# matcher needs to match two values, unless it needs more precise semantics.
|
59
|
+
# For example, the `eq` matcher _does not_ use this as it is meant to
|
60
|
+
# use `==` (and only `==`) for matching.
|
61
|
+
#
|
62
|
+
# @param expected [Object] what is expected
|
63
|
+
# @param actual [Object] the actual value
|
64
|
+
#
|
65
|
+
# @!visibility public
|
66
|
+
def values_match?(expected, actual)
|
67
|
+
expected = with_matchers_cloned(expected)
|
68
|
+
Support::FuzzyMatcher.values_match?(expected, actual)
|
69
|
+
end
|
70
|
+
|
71
|
+
# Returns the description of the given object in a way that is
|
72
|
+
# aware of composed matchers. If the object is a matcher with
|
73
|
+
# a `description` method, returns the description; otherwise
|
74
|
+
# returns `object.inspect`.
|
75
|
+
#
|
76
|
+
# You are encouraged to use this in your custom matcher's
|
77
|
+
# `description`, `failure_message` or
|
78
|
+
# `failure_message_when_negated` implementation if you are
|
79
|
+
# supporting matcher arguments.
|
80
|
+
#
|
81
|
+
# @!visibility public
|
82
|
+
def description_of(object)
|
83
|
+
return object.description if Matchers.is_a_describable_matcher?(object)
|
84
|
+
object.inspect
|
85
|
+
end
|
86
|
+
|
87
|
+
# Transforms the given data structue (typically a hash or array)
|
88
|
+
# into a new data structure that, when `#inspect` is called on it,
|
89
|
+
# will provide descriptions of any contained matchers rather than
|
90
|
+
# the normal `#inspect` output.
|
91
|
+
#
|
92
|
+
# You are encouraged to use this in your custom matcher's
|
93
|
+
# `description`, `failure_message` or
|
94
|
+
# `failure_message_when_negated` implementation if you are
|
95
|
+
# supporting any arguments which may be a data structure
|
96
|
+
# containing matchers.
|
97
|
+
#
|
98
|
+
# @!visibility public
|
99
|
+
def surface_descriptions_in(item)
|
100
|
+
if Matchers.is_a_describable_matcher?(item)
|
101
|
+
DescribableItem.new(item)
|
102
|
+
elsif Hash === item
|
103
|
+
Hash[surface_descriptions_in(item.to_a)]
|
104
|
+
elsif Struct === item
|
105
|
+
item.inspect
|
106
|
+
elsif enumerable?(item)
|
107
|
+
begin
|
108
|
+
item.map { |subitem| surface_descriptions_in(subitem) }
|
109
|
+
rescue IOError # STDOUT is enumerable but `map` raises an error
|
110
|
+
item.inspect
|
111
|
+
end
|
112
|
+
else
|
113
|
+
item
|
114
|
+
end
|
115
|
+
end
|
116
|
+
|
117
|
+
# @private
|
118
|
+
# Historically, a single matcher instance was only checked
|
119
|
+
# against a single value. Given that the matcher was only
|
120
|
+
# used once, it's been common to memoize some intermediate
|
121
|
+
# calculation that is derived from the `actual` value in
|
122
|
+
# order to reuse that intermediate result in the failure
|
123
|
+
# message.
|
124
|
+
#
|
125
|
+
# This can cause a problem when using such a matcher as an
|
126
|
+
# argument to another matcher in a composed matcher expression,
|
127
|
+
# since the matcher instance may be checked against multiple
|
128
|
+
# values and produce invalid results due to the memoization.
|
129
|
+
#
|
130
|
+
# To deal with this, we clone any matchers in `expected` via
|
131
|
+
# this method when using `values_match?`, so that any memoization
|
132
|
+
# does not "leak" between checks.
|
133
|
+
def with_matchers_cloned(object)
|
134
|
+
if Matchers.is_a_matcher?(object)
|
135
|
+
object.clone
|
136
|
+
elsif Hash === object
|
137
|
+
Hash[with_matchers_cloned(object.to_a)]
|
138
|
+
elsif Struct === object
|
139
|
+
object
|
140
|
+
elsif enumerable?(object)
|
141
|
+
begin
|
142
|
+
object.map { |subobject| with_matchers_cloned(subobject) }
|
143
|
+
rescue IOError # STDOUT is enumerable but `map` raises an error
|
144
|
+
object
|
145
|
+
end
|
146
|
+
else
|
147
|
+
object
|
148
|
+
end
|
149
|
+
end
|
150
|
+
|
151
|
+
if String.ancestors.include?(Enumerable) # 1.8.7
|
152
|
+
# Strings are not enumerable on 1.9, and on 1.8 they are an infinitely
|
153
|
+
# nested enumerable: since ruby lacks a character class, it yields
|
154
|
+
# 1-character strings, which are themselves enumerable, composed of a
|
155
|
+
# a single 1-character string, which is an enumerable, etc.
|
156
|
+
#
|
157
|
+
# @api private
|
158
|
+
def enumerable?(item)
|
159
|
+
return false if String === item
|
160
|
+
Enumerable === item
|
161
|
+
end
|
162
|
+
else
|
163
|
+
# @api private
|
164
|
+
def enumerable?(item)
|
165
|
+
Enumerable === item
|
166
|
+
end
|
167
|
+
end
|
168
|
+
module_function :surface_descriptions_in, :enumerable?
|
169
|
+
|
170
|
+
# Wraps an item in order to surface its `description` via `inspect`.
|
171
|
+
# @api private
|
172
|
+
DescribableItem = Struct.new(:item) do
|
173
|
+
def inspect
|
174
|
+
"(#{item.description})"
|
175
|
+
end
|
176
|
+
|
177
|
+
def pretty_print(pp)
|
178
|
+
pp.text "(#{item.description})"
|
179
|
+
end
|
180
|
+
end
|
181
|
+
end
|
182
|
+
end
|
183
|
+
end
|
@@ -0,0 +1,391 @@
|
|
1
|
+
module RSpec
|
2
|
+
module Matchers
|
3
|
+
# Defines the custom matcher DSL.
|
4
|
+
module DSL
|
5
|
+
# Defines a custom matcher.
|
6
|
+
# @see RSpec::Matchers
|
7
|
+
def define(name, &declarations)
|
8
|
+
define_method name do |*expected|
|
9
|
+
RSpec::Matchers::DSL::Matcher.new(name, declarations, self, *expected)
|
10
|
+
end
|
11
|
+
end
|
12
|
+
alias_method :matcher, :define
|
13
|
+
|
14
|
+
RSpec.configure { |c| c.extend self } if RSpec.respond_to?(:configure)
|
15
|
+
|
16
|
+
# Contains the methods that are available from within the
|
17
|
+
# `RSpec::Matchers.define` DSL for creating custom matchers.
|
18
|
+
module Macros
|
19
|
+
# Stores the block that is used to determine whether this matcher passes
|
20
|
+
# or fails. The block should return a boolean value. When the matcher is
|
21
|
+
# passed to `expect(...).to` and the block returns `true`, then the expectation
|
22
|
+
# passes. Similarly, when the matcher is passed to `expect(...).not_to` and the
|
23
|
+
# block returns `false`, then the expectation passes.
|
24
|
+
#
|
25
|
+
# @example
|
26
|
+
#
|
27
|
+
# RSpec::Matchers.define :be_even do
|
28
|
+
# match do |actual|
|
29
|
+
# actual.even?
|
30
|
+
# end
|
31
|
+
# end
|
32
|
+
#
|
33
|
+
# expect(4).to be_even # passes
|
34
|
+
# expect(3).not_to be_even # passes
|
35
|
+
# expect(3).to be_even # fails
|
36
|
+
# expect(4).not_to be_even # fails
|
37
|
+
#
|
38
|
+
# @yield [Object] actual the actual value (i.e. the value wrapped by `expect`)
|
39
|
+
def match(&match_block)
|
40
|
+
define_user_override(:matches?, match_block) do |actual|
|
41
|
+
begin
|
42
|
+
@actual = actual
|
43
|
+
super(*actual_arg_for(match_block))
|
44
|
+
rescue RSpec::Expectations::ExpectationNotMetError
|
45
|
+
false
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
|
50
|
+
# Use this to define the block for a negative expectation (`expect(...).not_to`)
|
51
|
+
# when the positive and negative forms require different handling. This
|
52
|
+
# is rarely necessary, but can be helpful, for example, when specifying
|
53
|
+
# asynchronous processes that require different timeouts.
|
54
|
+
#
|
55
|
+
# @yield [Object] actual the actual value (i.e. the value wrapped by `expect`)
|
56
|
+
def match_when_negated(&match_block)
|
57
|
+
define_user_override(:does_not_match?, match_block) do |actual|
|
58
|
+
@actual = actual
|
59
|
+
super(*actual_arg_for(match_block))
|
60
|
+
end
|
61
|
+
end
|
62
|
+
|
63
|
+
# Use this instead of `match` when the block will raise an exception
|
64
|
+
# rather than returning false to indicate a failure.
|
65
|
+
#
|
66
|
+
# @example
|
67
|
+
#
|
68
|
+
# RSpec::Matchers.define :accept_as_valid do |candidate_address|
|
69
|
+
# match_unless_raises ValidationException do |validator|
|
70
|
+
# validator.validate(candidate_address)
|
71
|
+
# end
|
72
|
+
# end
|
73
|
+
#
|
74
|
+
# expect(email_validator).to accept_as_valid("person@company.com")
|
75
|
+
#
|
76
|
+
# @yield [Object] actual the actual object (i.e. the value wrapped by `expect`)
|
77
|
+
def match_unless_raises(expected_exception=Exception, &match_block)
|
78
|
+
define_user_override(:matches?, match_block) do |actual|
|
79
|
+
@actual = actual
|
80
|
+
begin
|
81
|
+
super(*actual_arg_for(match_block))
|
82
|
+
rescue expected_exception => @rescued_exception
|
83
|
+
false
|
84
|
+
else
|
85
|
+
true
|
86
|
+
end
|
87
|
+
end
|
88
|
+
end
|
89
|
+
|
90
|
+
# Customizes the failure messsage to use when this matcher is
|
91
|
+
# asked to positively match. Only use this when the message
|
92
|
+
# generated by default doesn't suit your needs.
|
93
|
+
#
|
94
|
+
# @example
|
95
|
+
#
|
96
|
+
# RSpec::Matchers.define :have_strength do |expected|
|
97
|
+
# match { your_match_logic }
|
98
|
+
#
|
99
|
+
# failure_message do |actual|
|
100
|
+
# "Expected strength of #{expected}, but had #{actual.strength}"
|
101
|
+
# end
|
102
|
+
# end
|
103
|
+
#
|
104
|
+
# @yield [Object] actual the actual object (i.e. the value wrapped by `expect`)
|
105
|
+
def failure_message(&definition)
|
106
|
+
define_user_override(__method__, definition)
|
107
|
+
end
|
108
|
+
|
109
|
+
# Customize the failure messsage to use when this matcher is asked
|
110
|
+
# to negatively match. Only use this when the message generated by
|
111
|
+
# default doesn't suit your needs.
|
112
|
+
#
|
113
|
+
# @example
|
114
|
+
#
|
115
|
+
# RSpec::Matchers.define :have_strength do |expected|
|
116
|
+
# match { your_match_logic }
|
117
|
+
#
|
118
|
+
# failure_message_when_negated do |actual|
|
119
|
+
# "Expected not to have strength of #{expected}, but did"
|
120
|
+
# end
|
121
|
+
# end
|
122
|
+
#
|
123
|
+
# @yield [Object] actual the actual object (i.e. the value wrapped by `expect`)
|
124
|
+
def failure_message_when_negated(&definition)
|
125
|
+
define_user_override(__method__, definition)
|
126
|
+
end
|
127
|
+
|
128
|
+
# Customize the description to use for one-liners. Only use this when
|
129
|
+
# the description generated by default doesn't suit your needs.
|
130
|
+
#
|
131
|
+
# @example
|
132
|
+
#
|
133
|
+
# RSpec::Matchers.define :qualify_for do |expected|
|
134
|
+
# match { your_match_logic }
|
135
|
+
#
|
136
|
+
# description do
|
137
|
+
# "qualify for #{expected}"
|
138
|
+
# end
|
139
|
+
# end
|
140
|
+
#
|
141
|
+
# @yield [Object] actual the actual object (i.e. the value wrapped by `expect`)
|
142
|
+
def description(&definition)
|
143
|
+
define_user_override(__method__, definition)
|
144
|
+
end
|
145
|
+
|
146
|
+
# Tells the matcher to diff the actual and expected values in the failure
|
147
|
+
# message.
|
148
|
+
def diffable
|
149
|
+
define_method(:diffable?) { true }
|
150
|
+
end
|
151
|
+
|
152
|
+
# Declares that the matcher can be used in a block expectation.
|
153
|
+
# Users will not be able to use your matcher in a block
|
154
|
+
# expectation without declaring this.
|
155
|
+
# (e.g. `expect { do_something }.to matcher`).
|
156
|
+
def supports_block_expectations
|
157
|
+
define_method(:supports_block_expectations?) { true }
|
158
|
+
end
|
159
|
+
|
160
|
+
# Convenience for defining methods on this matcher to create a fluent
|
161
|
+
# interface. The trick about fluent interfaces is that each method must
|
162
|
+
# return self in order to chain methods together. `chain` handles that
|
163
|
+
# for you. If the method is invoked and the
|
164
|
+
# `include_chain_clauses_in_custom_matcher_descriptions` config option
|
165
|
+
# hash been enabled, the chained method name and args will be added to the
|
166
|
+
# default description and failure message.
|
167
|
+
#
|
168
|
+
# @example
|
169
|
+
#
|
170
|
+
# RSpec::Matchers.define :have_errors_on do |key|
|
171
|
+
# chain :with do |message|
|
172
|
+
# @message = message
|
173
|
+
# end
|
174
|
+
#
|
175
|
+
# match do |actual|
|
176
|
+
# actual.errors[key] == @message
|
177
|
+
# end
|
178
|
+
# end
|
179
|
+
#
|
180
|
+
# expect(minor).to have_errors_on(:age).with("Not old enough to participate")
|
181
|
+
def chain(name, &definition)
|
182
|
+
define_user_override(name, definition) do |*args, &block|
|
183
|
+
super(*args, &block)
|
184
|
+
@chained_method_clauses.push([name, args])
|
185
|
+
self
|
186
|
+
end
|
187
|
+
end
|
188
|
+
|
189
|
+
private
|
190
|
+
|
191
|
+
# Does the following:
|
192
|
+
#
|
193
|
+
# - Defines the named method usign a user-provided block
|
194
|
+
# in @user_method_defs, which is included as an ancestor
|
195
|
+
# in the singleton class in which we eval the `define` block.
|
196
|
+
# - Defines an overriden definition for the same method
|
197
|
+
# usign the provided `our_def` block.
|
198
|
+
# - Provides a default `our_def` block for the common case
|
199
|
+
# of needing to call the user's definition with `@actual`
|
200
|
+
# as an arg, but only if their block's arity can handle it.
|
201
|
+
#
|
202
|
+
# This compiles the user block into an actual method, allowing
|
203
|
+
# them to use normal method constructs like `return`
|
204
|
+
# (e.g. for a early guard statement), while allowing us to define
|
205
|
+
# an override that can provide the wrapped handling
|
206
|
+
# (e.g. assigning `@actual`, rescueing errors, etc) and
|
207
|
+
# can `super` to the user's definition.
|
208
|
+
def define_user_override(method_name, user_def, &our_def)
|
209
|
+
@user_method_defs.__send__(:define_method, method_name, &user_def)
|
210
|
+
our_def ||= lambda { super(*actual_arg_for(user_def)) }
|
211
|
+
define_method(method_name, &our_def)
|
212
|
+
end
|
213
|
+
|
214
|
+
# Defines deprecated macro methods from RSpec 2 for backwards compatibility.
|
215
|
+
# @deprecated Use the methods from {Macros} instead.
|
216
|
+
module Deprecated
|
217
|
+
# @deprecated Use {Macros#match} instead.
|
218
|
+
def match_for_should(&definition)
|
219
|
+
RSpec.deprecate("`match_for_should`", :replacement => "`match`")
|
220
|
+
match(&definition)
|
221
|
+
end
|
222
|
+
|
223
|
+
# @deprecated Use {Macros#match_when_negated} instead.
|
224
|
+
def match_for_should_not(&definition)
|
225
|
+
RSpec.deprecate("`match_for_should_not`", :replacement => "`match_when_negated`")
|
226
|
+
match_when_negated(&definition)
|
227
|
+
end
|
228
|
+
|
229
|
+
# @deprecated Use {Macros#failure_message} instead.
|
230
|
+
def failure_message_for_should(&definition)
|
231
|
+
RSpec.deprecate("`failure_message_for_should`", :replacement => "`failure_message`")
|
232
|
+
failure_message(&definition)
|
233
|
+
end
|
234
|
+
|
235
|
+
# @deprecated Use {Macros#failure_message_when_negated} instead.
|
236
|
+
def failure_message_for_should_not(&definition)
|
237
|
+
RSpec.deprecate("`failure_message_for_should_not`", :replacement => "`failure_message_when_negated`")
|
238
|
+
failure_message_when_negated(&definition)
|
239
|
+
end
|
240
|
+
end
|
241
|
+
end
|
242
|
+
|
243
|
+
# Defines default implementations of the matcher
|
244
|
+
# protocol methods for custom matchers. You can
|
245
|
+
# override any of these using the {RSpec::Matchers::DSL::Macros Macros} methods
|
246
|
+
# from within an `RSpec::Matchers.define` block.
|
247
|
+
module DefaultImplementations
|
248
|
+
include BuiltIn::BaseMatcher::DefaultFailureMessages
|
249
|
+
|
250
|
+
# @api private
|
251
|
+
# Used internally by objects returns by `should` and `should_not`.
|
252
|
+
def diffable?
|
253
|
+
false
|
254
|
+
end
|
255
|
+
|
256
|
+
# The default description.
|
257
|
+
def description
|
258
|
+
"#{name_to_sentence}#{to_sentence expected}#{chained_method_clause_sentences}"
|
259
|
+
end
|
260
|
+
|
261
|
+
# Matchers do not support block expectations by default. You
|
262
|
+
# must opt-in.
|
263
|
+
def supports_block_expectations?
|
264
|
+
false
|
265
|
+
end
|
266
|
+
|
267
|
+
# Most matchers do not expect call stack jumps.
|
268
|
+
def expects_call_stack_jump?
|
269
|
+
false
|
270
|
+
end
|
271
|
+
|
272
|
+
private
|
273
|
+
|
274
|
+
def chained_method_clause_sentences
|
275
|
+
return '' unless Expectations.configuration.include_chain_clauses_in_custom_matcher_descriptions?
|
276
|
+
|
277
|
+
@chained_method_clauses.map do |(method_name, method_args)|
|
278
|
+
" #{split_words(method_name)}#{to_sentence(method_args)}"
|
279
|
+
end.join
|
280
|
+
end
|
281
|
+
end
|
282
|
+
|
283
|
+
# The class used for custom matchers. The block passed to
|
284
|
+
# `RSpec::Matchers.define` will be evaluated in the context
|
285
|
+
# of the singleton class of an instance, and will have the
|
286
|
+
# {RSpec::Matchers::DSL::Macros Macros} methods available.
|
287
|
+
class Matcher
|
288
|
+
# Provides default implementations for the matcher protocol methods.
|
289
|
+
include DefaultImplementations
|
290
|
+
|
291
|
+
# Allows expectation expressions to be used in the match block.
|
292
|
+
include RSpec::Matchers
|
293
|
+
|
294
|
+
# Converts matcher name and expected args to an English expresion.
|
295
|
+
include RSpec::Matchers::Pretty
|
296
|
+
|
297
|
+
# Supports the matcher composability features of RSpec 3+.
|
298
|
+
include Composable
|
299
|
+
|
300
|
+
# Makes the macro methods available to an `RSpec::Matchers.define` block.
|
301
|
+
extend Macros
|
302
|
+
extend Macros::Deprecated
|
303
|
+
|
304
|
+
# Exposes the value being matched against -- generally the object
|
305
|
+
# object wrapped by `expect`.
|
306
|
+
attr_reader :actual
|
307
|
+
|
308
|
+
# Exposes the exception raised during the matching by `match_unless_raises`.
|
309
|
+
# Could be useful to extract details for a failure message.
|
310
|
+
attr_reader :rescued_exception
|
311
|
+
|
312
|
+
# @api private
|
313
|
+
def initialize(name, declarations, matcher_execution_context, *expected)
|
314
|
+
@name = name
|
315
|
+
@actual = nil
|
316
|
+
@expected_as_array = expected
|
317
|
+
@matcher_execution_context = matcher_execution_context
|
318
|
+
@chained_method_clauses = []
|
319
|
+
|
320
|
+
class << self
|
321
|
+
# See `Macros#define_user_override` above, for an explanation.
|
322
|
+
include(@user_method_defs = Module.new)
|
323
|
+
self
|
324
|
+
end.class_exec(*expected, &declarations)
|
325
|
+
end
|
326
|
+
|
327
|
+
# Provides the expected value. This will return an array if
|
328
|
+
# multiple arguments were passed to the matcher; otherwise it
|
329
|
+
# will return a single value.
|
330
|
+
# @see #expected_as_array
|
331
|
+
def expected
|
332
|
+
if expected_as_array.size == 1
|
333
|
+
expected_as_array[0]
|
334
|
+
else
|
335
|
+
expected_as_array
|
336
|
+
end
|
337
|
+
end
|
338
|
+
|
339
|
+
# Returns the expected value as an an array. This exists primarily
|
340
|
+
# to aid in upgrading from RSpec 2.x, since in RSpec 2, `expected`
|
341
|
+
# always returned an array.
|
342
|
+
# @see #expected
|
343
|
+
attr_reader :expected_as_array
|
344
|
+
|
345
|
+
# Adds the name (rather than a cryptic hex number)
|
346
|
+
# so we can identify an instance of
|
347
|
+
# the matcher in error messages (e.g. for `NoMethodError`)
|
348
|
+
def inspect
|
349
|
+
"#<#{self.class.name} #{name}>"
|
350
|
+
end
|
351
|
+
|
352
|
+
if RUBY_VERSION.to_f >= 1.9
|
353
|
+
# Indicates that this matcher responds to messages
|
354
|
+
# from the `@matcher_execution_context` as well.
|
355
|
+
# Also, supports getting a method object for such methods.
|
356
|
+
def respond_to_missing?(method, include_private=false)
|
357
|
+
super || @matcher_execution_context.respond_to?(method, include_private)
|
358
|
+
end
|
359
|
+
else # for 1.8.7
|
360
|
+
# Indicates that this matcher responds to messages
|
361
|
+
# from the `@matcher_execution_context` as well.
|
362
|
+
def respond_to?(method, include_private=false)
|
363
|
+
super || @matcher_execution_context.respond_to?(method, include_private)
|
364
|
+
end
|
365
|
+
end
|
366
|
+
|
367
|
+
private
|
368
|
+
|
369
|
+
def actual_arg_for(block)
|
370
|
+
block.arity.zero? ? [] : [@actual]
|
371
|
+
end
|
372
|
+
|
373
|
+
# Takes care of forwarding unhandled messages to the
|
374
|
+
# `@matcher_execution_context` (typically the current
|
375
|
+
# running `RSpec::Core::Example`). This is needed by
|
376
|
+
# rspec-rails so that it can define matchers that wrap
|
377
|
+
# Rails' test helper methods, but it's also a useful
|
378
|
+
# feature in its own right.
|
379
|
+
def method_missing(method, *args, &block)
|
380
|
+
if @matcher_execution_context.respond_to?(method)
|
381
|
+
@matcher_execution_context.__send__ method, *args, &block
|
382
|
+
else
|
383
|
+
super(method, *args, &block)
|
384
|
+
end
|
385
|
+
end
|
386
|
+
end
|
387
|
+
end
|
388
|
+
end
|
389
|
+
end
|
390
|
+
|
391
|
+
RSpec::Matchers.extend RSpec::Matchers::DSL
|