opal-rspec 0.4.3 → 0.5.0.beta1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (525) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +1 -0
  3. data/CHANGELOG.md +9 -3
  4. data/Gemfile +6 -5
  5. data/README.md +73 -13
  6. data/Rakefile +108 -12
  7. data/lib/opal/rspec/version.rb +1 -1
  8. data/lib/opal/rspec.rb +35 -12
  9. data/opal/opal/rspec/async/async_example.rb +87 -0
  10. data/opal/opal/rspec/async/example_group.rb +94 -0
  11. data/opal/opal/rspec/async/hooks.rb +46 -0
  12. data/opal/opal/rspec/async/legacy.rb +50 -0
  13. data/opal/opal/rspec/async.rb +4 -289
  14. data/opal/opal/rspec/browser_formatter.rb +55 -18
  15. data/opal/opal/rspec/fixes/caller_filter.rb +6 -0
  16. data/opal/opal/rspec/fixes/example.rb +20 -0
  17. data/opal/opal/rspec/fixes/example_groups.rb +32 -0
  18. data/opal/opal/rspec/fixes/expectations.rb +21 -0
  19. data/opal/opal/rspec/fixes/formatter.rb +62 -0
  20. data/opal/opal/rspec/fixes/kernel.rb +35 -0
  21. data/opal/opal/rspec/fixes/matchers.rb +15 -0
  22. data/opal/opal/rspec/fixes/mocks.rb +13 -0
  23. data/opal/opal/rspec/fixes/reporter.rb +12 -0
  24. data/opal/opal/rspec/fixes.rb +11 -115
  25. data/opal/opal/rspec/pre_require_fixes.rb +4 -0
  26. data/opal/opal/rspec/requires.rb +103 -35
  27. data/opal/opal/rspec/runner.rb +19 -15
  28. data/opal/opal/rspec/text_formatter.rb +24 -10
  29. data/opal/opal/rspec.rb +4 -9
  30. data/opal-rspec.gemspec +5 -2
  31. data/{vendor_lib → rspec/lib}/rspec/version.rb +1 -1
  32. data/{vendor_lib → rspec/lib}/rspec.rb +0 -0
  33. data/rspec-core/benchmarks/call_v_yield.rb +81 -0
  34. data/rspec-core/benchmarks/check_inclusion.rb +125 -0
  35. data/rspec-core/benchmarks/define_method_v_attr_reader_v_def.rb +81 -0
  36. data/rspec-core/benchmarks/eager_vs_lazy_metadata/define_examples.rb +22 -0
  37. data/rspec-core/benchmarks/eager_vs_lazy_metadata.rb +126 -0
  38. data/rspec-core/benchmarks/filter_object.rb +35 -0
  39. data/rspec-core/benchmarks/index_v_take_while.rb +47 -0
  40. data/rspec-core/benchmarks/map_then_flatten_vs_flat_map_benchmarks.rb +94 -0
  41. data/rspec-core/benchmarks/require_relative_v_require.rb +75 -0
  42. data/rspec-core/benchmarks/respond_to_v_defined.rb +72 -0
  43. data/rspec-core/benchmarks/several_regexps_v_one_big_one.rb +86 -0
  44. data/rspec-core/benchmarks/sort_by_v_shuffle.rb +83 -0
  45. data/rspec-core/benchmarks/to_proc_v_not_to_proc.rb +539 -0
  46. data/rspec-core/features/step_definitions/additional_cli_steps.rb +126 -0
  47. data/rspec-core/features/step_definitions/core_standalone_steps.rb +12 -0
  48. data/rspec-core/features/support/env.rb +21 -0
  49. data/rspec-core/features/support/require_expect_syntax_in_aruba_specs.rb +29 -0
  50. data/rspec-core/features/support/rubinius.rb +6 -0
  51. data/{vendor_lib → rspec-core/lib}/rspec/autorun.rb +0 -0
  52. data/{vendor_lib → rspec-core/lib}/rspec/core/backport_random.rb +40 -6
  53. data/rspec-core/lib/rspec/core/backtrace_formatter.rb +66 -0
  54. data/{vendor_lib → rspec-core/lib}/rspec/core/configuration.rb +561 -250
  55. data/rspec-core/lib/rspec/core/configuration_options.rb +173 -0
  56. data/rspec-core/lib/rspec/core/drb.rb +111 -0
  57. data/rspec-core/lib/rspec/core/dsl.rb +93 -0
  58. data/rspec-core/lib/rspec/core/example.rb +502 -0
  59. data/rspec-core/lib/rspec/core/example_group.rb +606 -0
  60. data/rspec-core/lib/rspec/core/filter_manager.rb +259 -0
  61. data/{vendor_lib → rspec-core/lib}/rspec/core/flat_map.rb +1 -0
  62. data/rspec-core/lib/rspec/core/formatters/base_formatter.rb +67 -0
  63. data/rspec-core/lib/rspec/core/formatters/base_text_formatter.rb +76 -0
  64. data/rspec-core/lib/rspec/core/formatters/console_codes.rb +64 -0
  65. data/{vendor_lib → rspec-core/lib}/rspec/core/formatters/deprecation_formatter.rb +65 -36
  66. data/rspec-core/lib/rspec/core/formatters/documentation_formatter.rb +68 -0
  67. data/{vendor_lib → rspec-core/lib}/rspec/core/formatters/helpers.rb +18 -13
  68. data/{vendor_lib → rspec-core/lib}/rspec/core/formatters/html_formatter.rb +69 -75
  69. data/{vendor_lib → rspec-core/lib}/rspec/core/formatters/html_printer.rb +17 -22
  70. data/rspec-core/lib/rspec/core/formatters/json_formatter.rb +94 -0
  71. data/rspec-core/lib/rspec/core/formatters/profile_formatter.rb +65 -0
  72. data/rspec-core/lib/rspec/core/formatters/progress_formatter.rb +28 -0
  73. data/rspec-core/lib/rspec/core/formatters/protocol.rb +163 -0
  74. data/{vendor_lib → rspec-core/lib}/rspec/core/formatters/snippet_extractor.rb +15 -12
  75. data/rspec-core/lib/rspec/core/formatters.rb +240 -0
  76. data/rspec-core/lib/rspec/core/hooks.rb +591 -0
  77. data/{vendor_lib → rspec-core/lib}/rspec/core/memoized_helpers.rb +82 -41
  78. data/rspec-core/lib/rspec/core/metadata.rb +437 -0
  79. data/rspec-core/lib/rspec/core/metadata_filter.rb +95 -0
  80. data/rspec-core/lib/rspec/core/minitest_assertions_adapter.rb +28 -0
  81. data/rspec-core/lib/rspec/core/mocking_adapters/flexmock.rb +31 -0
  82. data/{vendor_lib/rspec/core/mocking/with_mocha.rb → rspec-core/lib/rspec/core/mocking_adapters/mocha.rb} +21 -16
  83. data/rspec-core/lib/rspec/core/mocking_adapters/null.rb +14 -0
  84. data/rspec-core/lib/rspec/core/mocking_adapters/rr.rb +31 -0
  85. data/rspec-core/lib/rspec/core/mocking_adapters/rspec.rb +32 -0
  86. data/rspec-core/lib/rspec/core/notifications.rb +542 -0
  87. data/{vendor_lib → rspec-core/lib}/rspec/core/option_parser.rb +53 -65
  88. data/{vendor_lib → rspec-core/lib}/rspec/core/ordering.rb +11 -10
  89. data/rspec-core/lib/rspec/core/pending.rb +163 -0
  90. data/rspec-core/lib/rspec/core/project_initializer/spec/spec_helper.rb +89 -0
  91. data/rspec-core/lib/rspec/core/project_initializer.rb +48 -0
  92. data/rspec-core/lib/rspec/core/rake_task.rb +187 -0
  93. data/rspec-core/lib/rspec/core/reporter.rb +149 -0
  94. data/{vendor_lib → rspec-core/lib}/rspec/core/ruby_project.rb +3 -2
  95. data/rspec-core/lib/rspec/core/runner.rb +158 -0
  96. data/{vendor_lib → rspec-core/lib}/rspec/core/shared_context.rb +7 -5
  97. data/rspec-core/lib/rspec/core/shared_example_group.rb +182 -0
  98. data/rspec-core/lib/rspec/core/test_unit_assertions_adapter.rb +30 -0
  99. data/rspec-core/lib/rspec/core/version.rb +9 -0
  100. data/rspec-core/lib/rspec/core/warnings.rb +40 -0
  101. data/{vendor_lib → rspec-core/lib}/rspec/core/world.rb +78 -26
  102. data/{vendor_lib → rspec-core/lib}/rspec/core.rb +64 -98
  103. data/rspec-core/spec/command_line/order_spec.rb +213 -0
  104. data/rspec-core/spec/rspec/core/backtrace_formatter_spec.rb +306 -0
  105. data/rspec-core/spec/rspec/core/configuration_options_spec.rb +425 -0
  106. data/rspec-core/spec/rspec/core/configuration_spec.rb +1963 -0
  107. data/rspec-core/spec/rspec/core/drb_spec.rb +278 -0
  108. data/rspec-core/spec/rspec/core/dsl_spec.rb +85 -0
  109. data/rspec-core/spec/rspec/core/example_execution_result_spec.rb +142 -0
  110. data/rspec-core/spec/rspec/core/example_group_constants_spec.rb +16 -0
  111. data/rspec-core/spec/rspec/core/example_group_spec.rb +1621 -0
  112. data/rspec-core/spec/rspec/core/example_spec.rb +662 -0
  113. data/rspec-core/spec/rspec/core/failed_example_notification_spec.rb +25 -0
  114. data/rspec-core/spec/rspec/core/filter_manager_spec.rb +299 -0
  115. data/rspec-core/spec/rspec/core/formatters/base_text_formatter_spec.rb +182 -0
  116. data/rspec-core/spec/rspec/core/formatters/console_codes_spec.rb +65 -0
  117. data/rspec-core/spec/rspec/core/formatters/deprecation_formatter_spec.rb +225 -0
  118. data/rspec-core/spec/rspec/core/formatters/documentation_formatter_spec.rb +111 -0
  119. data/rspec-core/spec/rspec/core/formatters/helpers_spec.rb +104 -0
  120. data/rspec-core/spec/rspec/core/formatters/html_formatter_spec.rb +111 -0
  121. data/rspec-core/spec/rspec/core/formatters/json_formatter_spec.rb +183 -0
  122. data/rspec-core/spec/rspec/core/formatters/profile_formatter_spec.rb +99 -0
  123. data/rspec-core/spec/rspec/core/formatters/progress_formatter_spec.rb +55 -0
  124. data/rspec-core/spec/rspec/core/formatters/snippet_extractor_spec.rb +26 -0
  125. data/rspec-core/spec/rspec/core/formatters_spec.rb +160 -0
  126. data/rspec-core/spec/rspec/core/hooks_filtering_spec.rb +227 -0
  127. data/rspec-core/spec/rspec/core/hooks_spec.rb +447 -0
  128. data/rspec-core/spec/rspec/core/memoized_helpers_spec.rb +537 -0
  129. data/rspec-core/spec/rspec/core/metadata_filter_spec.rb +181 -0
  130. data/rspec-core/spec/rspec/core/metadata_spec.rb +642 -0
  131. data/rspec-core/spec/rspec/core/notifications_spec.rb +92 -0
  132. data/rspec-core/spec/rspec/core/option_parser_spec.rb +270 -0
  133. data/rspec-core/spec/rspec/core/ordering_spec.rb +102 -0
  134. data/rspec-core/spec/rspec/core/pending_example_spec.rb +221 -0
  135. data/rspec-core/spec/rspec/core/pending_spec.rb +8 -0
  136. data/rspec-core/spec/rspec/core/project_initializer_spec.rb +123 -0
  137. data/rspec-core/spec/rspec/core/rake_task_spec.rb +351 -0
  138. data/rspec-core/spec/rspec/core/random_spec.rb +47 -0
  139. data/rspec-core/spec/rspec/core/reporter_spec.rb +198 -0
  140. data/rspec-core/spec/rspec/core/resources/a_bar.rb +0 -0
  141. data/rspec-core/spec/rspec/core/resources/a_foo.rb +0 -0
  142. data/rspec-core/spec/rspec/core/resources/a_spec.rb +1 -0
  143. data/rspec-core/spec/rspec/core/resources/acceptance/bar.rb +0 -0
  144. data/rspec-core/spec/rspec/core/resources/acceptance/foo_spec.rb +0 -0
  145. data/rspec-core/spec/rspec/core/resources/custom_example_group_runner.rb +14 -0
  146. data/rspec-core/spec/rspec/core/resources/formatter_specs.rb +58 -0
  147. data/rspec-core/spec/rspec/core/resources/utf8_encoded.rb +9 -0
  148. data/rspec-core/spec/rspec/core/rspec_matchers_spec.rb +45 -0
  149. data/rspec-core/spec/rspec/core/ruby_project_spec.rb +26 -0
  150. data/rspec-core/spec/rspec/core/runner_spec.rb +309 -0
  151. data/rspec-core/spec/rspec/core/shared_context_spec.rb +102 -0
  152. data/rspec-core/spec/rspec/core/shared_example_group_spec.rb +268 -0
  153. data/rspec-core/spec/rspec/core/warnings_spec.rb +72 -0
  154. data/rspec-core/spec/rspec/core/world_spec.rb +142 -0
  155. data/rspec-core/spec/rspec/core_spec.rb +103 -0
  156. data/rspec-core/spec/spec_helper.rb +89 -0
  157. data/rspec-core/spec/support/config_options_helper.rb +13 -0
  158. data/rspec-core/spec/support/fake_minitest/minitest/minitest_assertions.rb +4 -0
  159. data/rspec-core/spec/support/fake_minitest/minitest.rb +0 -0
  160. data/rspec-core/spec/support/fake_minitest/test/unit/assertions.rb +6 -0
  161. data/rspec-core/spec/support/formatter_support.rb +263 -0
  162. data/rspec-core/spec/support/helper_methods.rb +26 -0
  163. data/rspec-core/spec/support/isolated_home_directory.rb +16 -0
  164. data/rspec-core/spec/support/matchers.rb +103 -0
  165. data/rspec-core/spec/support/mathn_integration_support.rb +12 -0
  166. data/rspec-core/spec/support/sandboxing.rb +50 -0
  167. data/rspec-core/spec/support/shared_example_groups.rb +43 -0
  168. data/rspec-core/spec/support/spec_files.rb +44 -0
  169. data/rspec-expectations/benchmarks/2.x_vs_3.x_matcher_dsl_implementation.rb +253 -0
  170. data/rspec-expectations/benchmarks/autoload_v_require.rb +25 -0
  171. data/rspec-expectations/benchmarks/cloning_matchers.rb +19 -0
  172. data/rspec-expectations/benchmarks/default_messages_as_methods_v_blocks.rb +27 -0
  173. data/rspec-expectations/benchmarks/example_spec.rb +9 -0
  174. data/rspec-expectations/benchmarks/include_v_superclass.rb +39 -0
  175. data/rspec-expectations/benchmarks/match_array/failing_with_distinct_items.rb +147 -0
  176. data/rspec-expectations/benchmarks/match_array/failing_with_duplicate_items.rb +122 -0
  177. data/rspec-expectations/benchmarks/match_array/passing_with_distinct_items.rb +154 -0
  178. data/rspec-expectations/benchmarks/match_array/passing_with_duplicate_items.rb +132 -0
  179. data/rspec-expectations/benchmarks/match_array/rubyprof/passing_with_distinct_items.rb +9 -0
  180. data/rspec-expectations/benchmarks/matcher_dsl_vs_classes.rb +180 -0
  181. data/rspec-expectations/benchmarks/method_to_proc.rb +72 -0
  182. data/rspec-expectations/benchmarks/set_vs_array_include.rb +68 -0
  183. data/rspec-expectations/features/step_definitions/additional_cli_steps.rb +22 -0
  184. data/rspec-expectations/features/support/disallow_certain_apis.rb +34 -0
  185. data/rspec-expectations/features/support/env.rb +21 -0
  186. data/rspec-expectations/features/support/rubinius.rb +6 -0
  187. data/{vendor_lib/rspec/matchers → rspec-expectations/lib/rspec/expectations}/configuration.rb +50 -16
  188. data/rspec-expectations/lib/rspec/expectations/expectation_target.rb +119 -0
  189. data/rspec-expectations/lib/rspec/expectations/fail_with.rb +34 -0
  190. data/rspec-expectations/lib/rspec/expectations/handler.rb +167 -0
  191. data/rspec-expectations/lib/rspec/expectations/minitest_integration.rb +17 -0
  192. data/rspec-expectations/lib/rspec/expectations/syntax.rb +132 -0
  193. data/{vendor_lib → rspec-expectations/lib}/rspec/expectations/version.rb +1 -1
  194. data/rspec-expectations/lib/rspec/expectations.rb +68 -0
  195. data/rspec-expectations/lib/rspec/matchers/aliased_matcher.rb +116 -0
  196. data/rspec-expectations/lib/rspec/matchers/built_in/all.rb +85 -0
  197. data/rspec-expectations/lib/rspec/matchers/built_in/base_matcher.rb +132 -0
  198. data/rspec-expectations/lib/rspec/matchers/built_in/be.rb +277 -0
  199. data/rspec-expectations/lib/rspec/matchers/built_in/be_between.rb +77 -0
  200. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/built_in/be_instance_of.rb +11 -4
  201. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/built_in/be_kind_of.rb +5 -0
  202. data/rspec-expectations/lib/rspec/matchers/built_in/be_within.rb +72 -0
  203. data/rspec-expectations/lib/rspec/matchers/built_in/change.rb +337 -0
  204. data/rspec-expectations/lib/rspec/matchers/built_in/compound.rb +258 -0
  205. data/rspec-expectations/lib/rspec/matchers/built_in/contain_exactly.rb +249 -0
  206. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/built_in/cover.rb +3 -0
  207. data/rspec-expectations/lib/rspec/matchers/built_in/eq.rb +75 -0
  208. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/built_in/eql.rb +17 -6
  209. data/rspec-expectations/lib/rspec/matchers/built_in/equal.rb +81 -0
  210. data/rspec-expectations/lib/rspec/matchers/built_in/exist.rb +86 -0
  211. data/rspec-expectations/lib/rspec/matchers/built_in/has.rb +101 -0
  212. data/rspec-expectations/lib/rspec/matchers/built_in/have_attributes.rb +84 -0
  213. data/rspec-expectations/lib/rspec/matchers/built_in/include.rb +105 -0
  214. data/rspec-expectations/lib/rspec/matchers/built_in/match.rb +29 -0
  215. data/rspec-expectations/lib/rspec/matchers/built_in/operators.rb +119 -0
  216. data/rspec-expectations/lib/rspec/matchers/built_in/output.rb +152 -0
  217. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/built_in/raise_error.rb +66 -46
  218. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/built_in/respond_to.rb +43 -26
  219. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/built_in/satisfy.rb +13 -4
  220. data/rspec-expectations/lib/rspec/matchers/built_in/start_and_end_with.rb +82 -0
  221. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/built_in/throw_symbol.rb +51 -13
  222. data/rspec-expectations/lib/rspec/matchers/built_in/yield.rb +420 -0
  223. data/rspec-expectations/lib/rspec/matchers/built_in.rb +52 -0
  224. data/rspec-expectations/lib/rspec/matchers/composable.rb +183 -0
  225. data/{vendor_lib/rspec/matchers/matcher.rb → rspec-expectations/lib/rspec/matchers/dsl.rb} +120 -30
  226. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers/generated_descriptions.rb +13 -6
  227. data/rspec-expectations/lib/rspec/matchers/matcher_delegator.rb +33 -0
  228. data/rspec-expectations/lib/rspec/matchers/matcher_protocol.rb +99 -0
  229. data/rspec-expectations/lib/rspec/matchers/pretty.rb +77 -0
  230. data/{vendor_lib → rspec-expectations/lib}/rspec/matchers.rb +408 -74
  231. data/rspec-expectations/spec/rspec/expectations/configuration_spec.rb +226 -0
  232. data/rspec-expectations/spec/rspec/expectations/expectation_target_spec.rb +147 -0
  233. data/rspec-expectations/spec/rspec/expectations/extensions/kernel_spec.rb +69 -0
  234. data/rspec-expectations/spec/rspec/expectations/fail_with_spec.rb +73 -0
  235. data/rspec-expectations/spec/rspec/expectations/handler_spec.rb +200 -0
  236. data/rspec-expectations/spec/rspec/expectations/minitest_integration_spec.rb +25 -0
  237. data/rspec-expectations/spec/rspec/expectations/syntax_spec.rb +93 -0
  238. data/rspec-expectations/spec/rspec/expectations_spec.rb +15 -0
  239. data/rspec-expectations/spec/rspec/matchers/aliased_matcher_spec.rb +113 -0
  240. data/rspec-expectations/spec/rspec/matchers/aliases_spec.rb +455 -0
  241. data/rspec-expectations/spec/rspec/matchers/built_in/all_spec.rb +212 -0
  242. data/rspec-expectations/spec/rspec/matchers/built_in/base_matcher_spec.rb +140 -0
  243. data/rspec-expectations/spec/rspec/matchers/built_in/be_between_spec.rb +157 -0
  244. data/rspec-expectations/spec/rspec/matchers/built_in/be_instance_of_spec.rb +61 -0
  245. data/rspec-expectations/spec/rspec/matchers/built_in/be_kind_of_spec.rb +39 -0
  246. data/rspec-expectations/spec/rspec/matchers/built_in/be_spec.rb +685 -0
  247. data/rspec-expectations/spec/rspec/matchers/built_in/be_within_spec.rb +139 -0
  248. data/rspec-expectations/spec/rspec/matchers/built_in/change_spec.rb +829 -0
  249. data/rspec-expectations/spec/rspec/matchers/built_in/compound_spec.rb +537 -0
  250. data/rspec-expectations/spec/rspec/matchers/built_in/contain_exactly_spec.rb +556 -0
  251. data/rspec-expectations/spec/rspec/matchers/built_in/cover_spec.rb +67 -0
  252. data/rspec-expectations/spec/rspec/matchers/built_in/eq_spec.rb +176 -0
  253. data/rspec-expectations/spec/rspec/matchers/built_in/eql_spec.rb +39 -0
  254. data/rspec-expectations/spec/rspec/matchers/built_in/equal_spec.rb +130 -0
  255. data/rspec-expectations/spec/rspec/matchers/built_in/exist_spec.rb +139 -0
  256. data/rspec-expectations/spec/rspec/matchers/built_in/has_spec.rb +179 -0
  257. data/rspec-expectations/spec/rspec/matchers/built_in/have_attributes_spec.rb +177 -0
  258. data/rspec-expectations/spec/rspec/matchers/built_in/include_spec.rb +587 -0
  259. data/rspec-expectations/spec/rspec/matchers/built_in/match_spec.rb +100 -0
  260. data/rspec-expectations/spec/rspec/matchers/built_in/operators_spec.rb +250 -0
  261. data/rspec-expectations/spec/rspec/matchers/built_in/output_spec.rb +168 -0
  262. data/rspec-expectations/spec/rspec/matchers/built_in/raise_error_spec.rb +446 -0
  263. data/rspec-expectations/spec/rspec/matchers/built_in/respond_to_spec.rb +290 -0
  264. data/rspec-expectations/spec/rspec/matchers/built_in/satisfy_spec.rb +42 -0
  265. data/rspec-expectations/spec/rspec/matchers/built_in/start_and_end_with_spec.rb +347 -0
  266. data/rspec-expectations/spec/rspec/matchers/built_in/throw_symbol_spec.rb +133 -0
  267. data/rspec-expectations/spec/rspec/matchers/built_in/yield_spec.rb +643 -0
  268. data/rspec-expectations/spec/rspec/matchers/composable_spec.rb +77 -0
  269. data/rspec-expectations/spec/rspec/matchers/define_negated_matcher_spec.rb +199 -0
  270. data/rspec-expectations/spec/rspec/matchers/description_generation_spec.rb +189 -0
  271. data/rspec-expectations/spec/rspec/matchers/dsl_spec.rb +1036 -0
  272. data/rspec-expectations/spec/rspec/matchers/legacy_spec.rb +104 -0
  273. data/rspec-expectations/spec/rspec/matchers_spec.rb +108 -0
  274. data/rspec-expectations/spec/spec_helper.rb +94 -0
  275. data/rspec-expectations/spec/support/matchers.rb +54 -0
  276. data/rspec-expectations/spec/support/shared_examples.rb +101 -0
  277. data/rspec-mocks/benchmarks/double_creation.rb +66 -0
  278. data/rspec-mocks/benchmarks/each_value_v_values_each.rb +58 -0
  279. data/rspec-mocks/benchmarks/find_original_method_early.rb +64 -0
  280. data/rspec-mocks/benchmarks/method_defined_at_any_visibility.rb +101 -0
  281. data/rspec-mocks/benchmarks/thread_safety.rb +24 -0
  282. data/rspec-mocks/benchmarks/transfer_nested_constants.rb +77 -0
  283. data/rspec-mocks/features/step_definitions/additional_cli_steps.rb +21 -0
  284. data/rspec-mocks/features/support/disallow_certain_apis.rb +24 -0
  285. data/rspec-mocks/features/support/env.rb +22 -0
  286. data/rspec-mocks/features/support/rubinius.rb +6 -0
  287. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/any_instance/chain.rb +19 -2
  288. data/rspec-mocks/lib/rspec/mocks/any_instance/expect_chain_chain.rb +35 -0
  289. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/any_instance/expectation_chain.rb +12 -11
  290. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/any_instance/message_chains.rb +15 -5
  291. data/rspec-mocks/lib/rspec/mocks/any_instance/proxy.rb +116 -0
  292. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/any_instance/recorder.rb +105 -38
  293. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/any_instance/stub_chain.rb +9 -9
  294. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/any_instance/stub_chain_chain.rb +5 -1
  295. data/rspec-mocks/lib/rspec/mocks/any_instance.rb +10 -0
  296. data/rspec-mocks/lib/rspec/mocks/argument_list_matcher.rb +72 -0
  297. data/rspec-mocks/lib/rspec/mocks/argument_matchers.rb +282 -0
  298. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/configuration.rb +60 -14
  299. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/error_generator.rb +93 -43
  300. data/rspec-mocks/lib/rspec/mocks/example_methods.rb +379 -0
  301. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/instance_method_stasher.rb +30 -7
  302. data/rspec-mocks/lib/rspec/mocks/marshal_extension.rb +41 -0
  303. data/rspec-mocks/lib/rspec/mocks/matchers/expectation_customization.rb +20 -0
  304. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/matchers/have_received.rb +36 -14
  305. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/matchers/receive.rb +24 -30
  306. data/rspec-mocks/lib/rspec/mocks/matchers/receive_message_chain.rb +66 -0
  307. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/matchers/receive_messages.rb +9 -10
  308. data/rspec-mocks/lib/rspec/mocks/message_chain.rb +91 -0
  309. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/message_expectation.rb +156 -105
  310. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/method_double.rb +81 -30
  311. data/rspec-mocks/lib/rspec/mocks/method_reference.rb +155 -0
  312. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/mutate_const.rb +84 -166
  313. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/object_reference.rb +19 -18
  314. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/order_group.rb +4 -5
  315. data/rspec-mocks/lib/rspec/mocks/proxy.rb +431 -0
  316. data/rspec-mocks/lib/rspec/mocks/space.rb +221 -0
  317. data/rspec-mocks/lib/rspec/mocks/standalone.rb +3 -0
  318. data/rspec-mocks/lib/rspec/mocks/syntax.rb +329 -0
  319. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/targets.rb +20 -13
  320. data/rspec-mocks/lib/rspec/mocks/test_double.rb +135 -0
  321. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/verifying_double.rb +69 -19
  322. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/verifying_message_expecation.rb +23 -21
  323. data/{vendor_lib → rspec-mocks/lib}/rspec/mocks/verifying_proxy.rb +58 -38
  324. data/rspec-mocks/lib/rspec/mocks/version.rb +9 -0
  325. data/rspec-mocks/lib/rspec/mocks.rb +126 -0
  326. data/rspec-mocks/spec/rspec/mocks/and_call_original_spec.rb +267 -0
  327. data/rspec-mocks/spec/rspec/mocks/and_return_spec.rb +21 -0
  328. data/rspec-mocks/spec/rspec/mocks/and_wrap_original_spec.rb +63 -0
  329. data/rspec-mocks/spec/rspec/mocks/and_yield_spec.rb +161 -0
  330. data/rspec-mocks/spec/rspec/mocks/any_instance/message_chains_spec.rb +39 -0
  331. data/rspec-mocks/spec/rspec/mocks/any_instance_spec.rb +1242 -0
  332. data/rspec-mocks/spec/rspec/mocks/argument_matchers_spec.rb +336 -0
  333. data/rspec-mocks/spec/rspec/mocks/array_including_matcher_spec.rb +39 -0
  334. data/rspec-mocks/spec/rspec/mocks/at_least_spec.rb +147 -0
  335. data/rspec-mocks/spec/rspec/mocks/at_most_spec.rb +113 -0
  336. data/rspec-mocks/spec/rspec/mocks/before_all_spec.rb +75 -0
  337. data/rspec-mocks/spec/rspec/mocks/block_return_value_spec.rb +68 -0
  338. data/rspec-mocks/spec/rspec/mocks/combining_implementation_instructions_spec.rb +196 -0
  339. data/rspec-mocks/spec/rspec/mocks/configuration_spec.rb +175 -0
  340. data/rspec-mocks/spec/rspec/mocks/double_spec.rb +830 -0
  341. data/rspec-mocks/spec/rspec/mocks/example_methods_spec.rb +11 -0
  342. data/rspec-mocks/spec/rspec/mocks/expiration_spec.rb +90 -0
  343. data/rspec-mocks/spec/rspec/mocks/hash_excluding_matcher_spec.rb +65 -0
  344. data/rspec-mocks/spec/rspec/mocks/hash_including_matcher_spec.rb +92 -0
  345. data/rspec-mocks/spec/rspec/mocks/instance_method_stasher_spec.rb +72 -0
  346. data/rspec-mocks/spec/rspec/mocks/marshal_extension_spec.rb +67 -0
  347. data/rspec-mocks/spec/rspec/mocks/matchers/have_received_spec.rb +513 -0
  348. data/rspec-mocks/spec/rspec/mocks/matchers/receive_message_chain_spec.rb +227 -0
  349. data/rspec-mocks/spec/rspec/mocks/matchers/receive_messages_spec.rb +148 -0
  350. data/rspec-mocks/spec/rspec/mocks/matchers/receive_spec.rb +525 -0
  351. data/rspec-mocks/spec/rspec/mocks/methods_spec.rb +24 -0
  352. data/rspec-mocks/spec/rspec/mocks/mock_expectation_error_spec.rb +20 -0
  353. data/rspec-mocks/spec/rspec/mocks/mock_ordering_spec.rb +112 -0
  354. data/rspec-mocks/spec/rspec/mocks/multiple_return_value_spec.rb +130 -0
  355. data/rspec-mocks/spec/rspec/mocks/mutate_const_spec.rb +561 -0
  356. data/rspec-mocks/spec/rspec/mocks/nil_expectation_warning_spec.rb +52 -0
  357. data/rspec-mocks/spec/rspec/mocks/null_object_double_spec.rb +135 -0
  358. data/rspec-mocks/spec/rspec/mocks/once_counts_spec.rb +50 -0
  359. data/rspec-mocks/spec/rspec/mocks/order_group_spec.rb +26 -0
  360. data/rspec-mocks/spec/rspec/mocks/partial_double_spec.rb +379 -0
  361. data/rspec-mocks/spec/rspec/mocks/partial_double_using_mocks_directly_spec.rb +83 -0
  362. data/rspec-mocks/spec/rspec/mocks/precise_counts_spec.rb +66 -0
  363. data/rspec-mocks/spec/rspec/mocks/serialization_spec.rb +89 -0
  364. data/rspec-mocks/spec/rspec/mocks/should_syntax_spec.rb +539 -0
  365. data/rspec-mocks/spec/rspec/mocks/space_spec.rb +242 -0
  366. data/rspec-mocks/spec/rspec/mocks/spy_spec.rb +127 -0
  367. data/rspec-mocks/spec/rspec/mocks/stash_spec.rb +43 -0
  368. data/rspec-mocks/spec/rspec/mocks/stub_chain_spec.rb +166 -0
  369. data/rspec-mocks/spec/rspec/mocks/stub_implementation_spec.rb +98 -0
  370. data/rspec-mocks/spec/rspec/mocks/stub_spec.rb +520 -0
  371. data/rspec-mocks/spec/rspec/mocks/stubbed_message_expectations_spec.rb +56 -0
  372. data/rspec-mocks/spec/rspec/mocks/syntax_agnostic_message_matchers_spec.rb +99 -0
  373. data/rspec-mocks/spec/rspec/mocks/syntax_spec.rb +7 -0
  374. data/rspec-mocks/spec/rspec/mocks/test_double_spec.rb +53 -0
  375. data/rspec-mocks/spec/rspec/mocks/thrice_counts_spec.rb +72 -0
  376. data/rspec-mocks/spec/rspec/mocks/to_ary_spec.rb +52 -0
  377. data/rspec-mocks/spec/rspec/mocks/twice_counts_spec.rb +64 -0
  378. data/rspec-mocks/spec/rspec/mocks/verifying_doubles/class_double_with_class_loaded_spec.rb +118 -0
  379. data/rspec-mocks/spec/rspec/mocks/verifying_doubles/class_double_with_class_not_loaded_spec.rb +58 -0
  380. data/rspec-mocks/spec/rspec/mocks/verifying_doubles/construction_spec.rb +54 -0
  381. data/rspec-mocks/spec/rspec/mocks/verifying_doubles/expected_arg_verification_spec.rb +81 -0
  382. data/rspec-mocks/spec/rspec/mocks/verifying_doubles/instance_double_with_class_loaded_spec.rb +195 -0
  383. data/rspec-mocks/spec/rspec/mocks/verifying_doubles/instance_double_with_class_not_loaded_spec.rb +57 -0
  384. data/rspec-mocks/spec/rspec/mocks/verifying_doubles/method_visibility_spec.rb +129 -0
  385. data/rspec-mocks/spec/rspec/mocks/verifying_doubles/object_double_spec.rb +68 -0
  386. data/rspec-mocks/spec/rspec/mocks_spec.rb +199 -0
  387. data/rspec-mocks/spec/spec_helper.rb +131 -0
  388. data/rspec-mocks/spec/support/before_all_shared_example_group.rb +16 -0
  389. data/rspec-mocks/spec/support/doubled_classes.rb +74 -0
  390. data/rspec-mocks/spec/support/matchers.rb +15 -0
  391. data/rspec-support/benchmarks/caller.rb +81 -0
  392. data/{vendor_lib → rspec-support/lib}/rspec/support/caller_filter.rb +11 -4
  393. data/rspec-support/lib/rspec/support/differ.rb +214 -0
  394. data/rspec-support/lib/rspec/support/directory_maker.rb +61 -0
  395. data/rspec-support/lib/rspec/support/encoded_string.rb +69 -0
  396. data/rspec-support/lib/rspec/support/fuzzy_matcher.rb +48 -0
  397. data/rspec-support/lib/rspec/support/hunk_generator.rb +47 -0
  398. data/rspec-support/lib/rspec/support/matcher_definition.rb +31 -0
  399. data/rspec-support/lib/rspec/support/method_signature_verifier.rb +272 -0
  400. data/rspec-support/lib/rspec/support/os.rb +18 -0
  401. data/rspec-support/lib/rspec/support/recursive_const_methods.rb +76 -0
  402. data/rspec-support/lib/rspec/support/ruby_features.rb +45 -0
  403. data/rspec-support/lib/rspec/support/spec/deprecation_helpers.rb +60 -0
  404. data/rspec-support/lib/rspec/support/spec/formatting_support.rb +9 -0
  405. data/{vendor_lib → rspec-support/lib}/rspec/support/spec/in_sub_process.rb +5 -2
  406. data/rspec-support/lib/rspec/support/spec/prevent_load_time_warnings.rb +44 -0
  407. data/rspec-support/lib/rspec/support/spec/shell_out.rb +69 -0
  408. data/{vendor_lib → rspec-support/lib}/rspec/support/spec/stderr_splitter.rb +7 -5
  409. data/rspec-support/lib/rspec/support/spec/with_isolated_directory.rb +9 -0
  410. data/rspec-support/lib/rspec/support/spec/with_isolated_stderr.rb +13 -0
  411. data/rspec-support/lib/rspec/support/spec.rb +72 -0
  412. data/{vendor_lib → rspec-support/lib}/rspec/support/version.rb +1 -1
  413. data/rspec-support/lib/rspec/support/version_checker.rb +53 -0
  414. data/rspec-support/lib/rspec/support/warnings.rb +39 -0
  415. data/rspec-support/lib/rspec/support.rb +76 -0
  416. data/rspec-support/spec/rspec/support/caller_filter_spec.rb +66 -0
  417. data/rspec-support/spec/rspec/support/differ_spec.rb +322 -0
  418. data/rspec-support/spec/rspec/support/directory_maker_spec.rb +58 -0
  419. data/rspec-support/spec/rspec/support/encoded_string_spec.rb +86 -0
  420. data/rspec-support/spec/rspec/support/fuzzy_matcher_spec.rb +179 -0
  421. data/rspec-support/spec/rspec/support/method_signature_verifier_spec.rb +357 -0
  422. data/rspec-support/spec/rspec/support/os_spec.rb +36 -0
  423. data/rspec-support/spec/rspec/support/recursive_const_methods_spec.rb +49 -0
  424. data/rspec-support/spec/rspec/support/spec/in_sub_process_spec.rb +36 -0
  425. data/rspec-support/spec/rspec/support/spec/prevent_load_time_warnings_spec.rb +10 -0
  426. data/rspec-support/spec/rspec/support/spec/shell_out_spec.rb +44 -0
  427. data/rspec-support/spec/rspec/support/spec/stderr_splitter_spec.rb +60 -0
  428. data/rspec-support/spec/rspec/support/spec/with_isolated_std_err_spec.rb +21 -0
  429. data/rspec-support/spec/rspec/support/version_checker_spec.rb +29 -0
  430. data/rspec-support/spec/rspec/support/warnings_spec.rb +66 -0
  431. data/rspec-support/spec/rspec/support_spec.rb +119 -0
  432. data/rspec-support/spec/spec_helper.rb +2 -0
  433. data/spec/after_hooks_spec.rb +140 -0
  434. data/spec/around_hooks_spec.rb +223 -0
  435. data/spec/async_spec.rb +147 -1
  436. data/spec/before_hooks_spec.rb +183 -0
  437. data/spec/example_spec.rb +11 -0
  438. data/spec/matchers_spec.rb +4 -0
  439. data/spec/skip_pending_spec.rb +43 -0
  440. data/spec/subject_spec.rb +87 -0
  441. data/util/create_requires.rb +45 -0
  442. metadata +443 -147
  443. data/spec/named_subject_spec.rb +0 -11
  444. data/vendor_lib/rspec/core/backtrace_formatter.rb +0 -65
  445. data/vendor_lib/rspec/core/command_line.rb +0 -36
  446. data/vendor_lib/rspec/core/configuration_options.rb +0 -143
  447. data/vendor_lib/rspec/core/drb_command_line.rb +0 -26
  448. data/vendor_lib/rspec/core/drb_options.rb +0 -87
  449. data/vendor_lib/rspec/core/dsl.rb +0 -26
  450. data/vendor_lib/rspec/core/example.rb +0 -312
  451. data/vendor_lib/rspec/core/example_group.rb +0 -540
  452. data/vendor_lib/rspec/core/filter_manager.rb +0 -224
  453. data/vendor_lib/rspec/core/formatters/base_formatter.rb +0 -291
  454. data/vendor_lib/rspec/core/formatters/base_text_formatter.rb +0 -307
  455. data/vendor_lib/rspec/core/formatters/documentation_formatter.rb +0 -67
  456. data/vendor_lib/rspec/core/formatters/json_formatter.rb +0 -99
  457. data/vendor_lib/rspec/core/formatters/progress_formatter.rb +0 -32
  458. data/vendor_lib/rspec/core/formatters.rb +0 -54
  459. data/vendor_lib/rspec/core/hooks.rb +0 -535
  460. data/vendor_lib/rspec/core/metadata.rb +0 -313
  461. data/vendor_lib/rspec/core/mocking/with_absolutely_nothing.rb +0 -11
  462. data/vendor_lib/rspec/core/mocking/with_flexmock.rb +0 -27
  463. data/vendor_lib/rspec/core/mocking/with_rr.rb +0 -27
  464. data/vendor_lib/rspec/core/mocking/with_rspec.rb +0 -27
  465. data/vendor_lib/rspec/core/pending.rb +0 -110
  466. data/vendor_lib/rspec/core/project_initializer.rb +0 -88
  467. data/vendor_lib/rspec/core/rake_task.rb +0 -128
  468. data/vendor_lib/rspec/core/reporter.rb +0 -132
  469. data/vendor_lib/rspec/core/runner.rb +0 -97
  470. data/vendor_lib/rspec/core/shared_example_group/collection.rb +0 -27
  471. data/vendor_lib/rspec/core/shared_example_group.rb +0 -146
  472. data/vendor_lib/rspec/core/version.rb +0 -7
  473. data/vendor_lib/rspec/core/warnings.rb +0 -22
  474. data/vendor_lib/rspec/expectations/differ.rb +0 -154
  475. data/vendor_lib/rspec/expectations/errors.rb +0 -9
  476. data/vendor_lib/rspec/expectations/expectation_target.rb +0 -87
  477. data/vendor_lib/rspec/expectations/extensions/object.rb +0 -29
  478. data/vendor_lib/rspec/expectations/extensions.rb +0 -1
  479. data/vendor_lib/rspec/expectations/fail_with.rb +0 -79
  480. data/vendor_lib/rspec/expectations/handler.rb +0 -68
  481. data/vendor_lib/rspec/expectations/syntax.rb +0 -182
  482. data/vendor_lib/rspec/expectations.rb +0 -75
  483. data/vendor_lib/rspec/matchers/built_in/base_matcher.rb +0 -68
  484. data/vendor_lib/rspec/matchers/built_in/be.rb +0 -213
  485. data/vendor_lib/rspec/matchers/built_in/be_within.rb +0 -55
  486. data/vendor_lib/rspec/matchers/built_in/change.rb +0 -141
  487. data/vendor_lib/rspec/matchers/built_in/eq.rb +0 -22
  488. data/vendor_lib/rspec/matchers/built_in/equal.rb +0 -48
  489. data/vendor_lib/rspec/matchers/built_in/exist.rb +0 -26
  490. data/vendor_lib/rspec/matchers/built_in/has.rb +0 -48
  491. data/vendor_lib/rspec/matchers/built_in/include.rb +0 -61
  492. data/vendor_lib/rspec/matchers/built_in/match.rb +0 -17
  493. data/vendor_lib/rspec/matchers/built_in/match_array.rb +0 -51
  494. data/vendor_lib/rspec/matchers/built_in/start_and_end_with.rb +0 -48
  495. data/vendor_lib/rspec/matchers/built_in/yield.rb +0 -297
  496. data/vendor_lib/rspec/matchers/built_in.rb +0 -39
  497. data/vendor_lib/rspec/matchers/compatibility.rb +0 -14
  498. data/vendor_lib/rspec/matchers/dsl.rb +0 -23
  499. data/vendor_lib/rspec/matchers/method_missing.rb +0 -12
  500. data/vendor_lib/rspec/matchers/operator_matcher.rb +0 -99
  501. data/vendor_lib/rspec/matchers/pretty.rb +0 -70
  502. data/vendor_lib/rspec/matchers/test_unit_integration.rb +0 -11
  503. data/vendor_lib/rspec/mocks/argument_list_matcher.rb +0 -104
  504. data/vendor_lib/rspec/mocks/argument_matchers.rb +0 -264
  505. data/vendor_lib/rspec/mocks/arity_calculator.rb +0 -66
  506. data/vendor_lib/rspec/mocks/errors.rb +0 -12
  507. data/vendor_lib/rspec/mocks/example_methods.rb +0 -201
  508. data/vendor_lib/rspec/mocks/extensions/marshal.rb +0 -17
  509. data/vendor_lib/rspec/mocks/framework.rb +0 -36
  510. data/vendor_lib/rspec/mocks/method_reference.rb +0 -95
  511. data/vendor_lib/rspec/mocks/mock.rb +0 -7
  512. data/vendor_lib/rspec/mocks/proxy.rb +0 -269
  513. data/vendor_lib/rspec/mocks/proxy_for_nil.rb +0 -37
  514. data/vendor_lib/rspec/mocks/space.rb +0 -95
  515. data/vendor_lib/rspec/mocks/standalone.rb +0 -3
  516. data/vendor_lib/rspec/mocks/stub_chain.rb +0 -51
  517. data/vendor_lib/rspec/mocks/syntax.rb +0 -374
  518. data/vendor_lib/rspec/mocks/test_double.rb +0 -109
  519. data/vendor_lib/rspec/mocks/version.rb +0 -7
  520. data/vendor_lib/rspec/mocks.rb +0 -100
  521. data/vendor_lib/rspec/support/spec/deprecation_helpers.rb +0 -29
  522. data/vendor_lib/rspec/support/spec.rb +0 -14
  523. data/vendor_lib/rspec/support/warnings.rb +0 -41
  524. data/vendor_lib/rspec/support.rb +0 -6
  525. data/vendor_lib/rspec-expectations.rb +0 -1
@@ -1,27 +1,23 @@
1
- require 'rspec/matchers/pretty'
2
-
3
- require 'rspec/matchers/built_in'
4
- require 'rspec/matchers/matcher'
5
- require 'rspec/matchers/operator_matcher'
6
-
7
- require 'rspec/matchers/generated_descriptions'
8
- require 'rspec/matchers/method_missing'
9
- require 'rspec/matchers/compatibility'
10
- require 'rspec/matchers/dsl'
11
- require 'rspec/matchers/test_unit_integration'
12
-
1
+ require 'rspec/support'
2
+ RSpec::Support.require_rspec_support 'matcher_definition'
3
+ RSpec::Support.define_optimized_require_for_rspec(:matchers) { |f| require_relative(f) }
4
+
5
+ %w[
6
+ pretty
7
+ composable
8
+ built_in
9
+ generated_descriptions
10
+ dsl
11
+ matcher_delegator
12
+ aliased_matcher
13
+ ].each { |file| RSpec::Support.require_rspec_matchers(file) }
14
+
15
+ # RSpec's top level namespace. All of rspec-expectations is contained
16
+ # in the `RSpec::Expectations` and `RSpec::Matchers` namespaces.
13
17
  module RSpec
14
18
  # RSpec::Matchers provides a number of useful matchers we use to define
15
- # expectations. A matcher is any object that responds to the following:
16
- #
17
- # matches?(actual)
18
- # failure_message_for_should
19
- #
20
- # These methods are also part of the matcher protocol, but are optional:
21
- #
22
- # does_not_match?(actual)
23
- # failure_message_for_should_not
24
- # description
19
+ # expectations. Any object that implements the [matcher protocol](Matchers/MatcherProtocol)
20
+ # can be used as a matcher.
25
21
  #
26
22
  # ## Predicates
27
23
  #
@@ -59,6 +55,12 @@ module RSpec
59
55
  # You can use this feature to invoke any predicate that begins with "has_", whether it is
60
56
  # part of the Ruby libraries (like `Hash#has_key?`) or a method you wrote on your own class.
61
57
  #
58
+ # Note that RSpec does not provide composable aliases for these dynamic predicate
59
+ # matchers. You can easily define your own aliases, though:
60
+ #
61
+ # RSpec::Matchers.alias_matcher :a_user_who_is_an_admin, :be_an_admin
62
+ # expect(user_list).to include(a_user_who_is_an_admin)
63
+ #
62
64
  # ## Custom Matchers
63
65
  #
64
66
  # When you find that none of the stock matchers provide a natural feeling
@@ -98,11 +100,11 @@ module RSpec
98
100
  # player.in_zone?(zone)
99
101
  # end
100
102
  #
101
- # failure_message_for_should do |player|
103
+ # failure_message do |player|
102
104
  # # generate and return the appropriate string.
103
105
  # end
104
106
  #
105
- # failure_message_for_should_not do |player|
107
+ # failure_message_when_negated do |player|
106
108
  # # generate and return the appropriate string.
107
109
  # end
108
110
  #
@@ -113,8 +115,8 @@ module RSpec
113
115
  #
114
116
  # Each of the message-generation methods has access to the block arguments
115
117
  # passed to the <tt>create</tt> method (in this case, <tt>zone</tt>). The
116
- # failure message methods (<tt>failure_message_for_should</tt> and
117
- # <tt>failure_message_for_should_not</tt>) are passed the actual value (the
118
+ # failure message methods (<tt>failure_message</tt> and
119
+ # <tt>failure_message_when_negated</tt>) are passed the actual value (the
118
120
  # receiver of <tt>expect(..)</tt> or <tt>expect(..).not_to</tt>).
119
121
  #
120
122
  # ### Custom Matcher from scratch
@@ -131,11 +133,11 @@ module RSpec
131
133
  # @target.current_zone.eql?(Zone.new(@expected))
132
134
  # end
133
135
  #
134
- # def failure_message_for_should
136
+ # def failure_message
135
137
  # "expected #{@target.inspect} to be in Zone #{@expected}"
136
138
  # end
137
139
  #
138
- # def failure_message_for_should_not
140
+ # def failure_message_when_negated
139
141
  # "expected #{@target.inspect} not to be in Zone #{@expected}"
140
142
  # end
141
143
  # end
@@ -171,32 +173,127 @@ module RSpec
171
173
  # RSpec::configure do |config|
172
174
  # config.include(CustomGameMatchers)
173
175
  # end
176
+ #
177
+ # ### Making custom matchers composable
178
+ #
179
+ # RSpec's built-in matchers are designed to be composed, in expressions like:
180
+ #
181
+ # expect(["barn", 2.45]).to contain_exactly(
182
+ # a_value_within(0.1).of(2.5),
183
+ # a_string_starting_with("bar")
184
+ # )
185
+ #
186
+ # Custom matchers can easily participate in composed matcher expressions like these.
187
+ # Include {RSpec::Matchers::Composable} in your custom matcher to make it support
188
+ # being composed (matchers defined using the DSL have this included automatically).
189
+ # Within your matcher's `matches?` method (or the `match` block, if using the DSL),
190
+ # use `values_match?(expected, actual)` rather than `expected == actual`.
191
+ # Under the covers, `values_match?` is able to match arbitrary
192
+ # nested data structures containing a mix of both matchers and non-matcher objects.
193
+ # It uses `===` and `==` to perform the matching, considering the values to
194
+ # match if either returns `true`. The `Composable` mixin also provides some helper
195
+ # methods for surfacing the matcher descriptions within your matcher's description
196
+ # or failure messages.
197
+ #
198
+ # RSpec's built-in matchers each have a number of aliases that rephrase the matcher
199
+ # from a verb phrase (such as `be_within`) to a noun phrase (such as `a_value_within`),
200
+ # which reads better when the matcher is passed as an argument in a composed matcher
201
+ # expressions, and also uses the noun-phrase wording in the matcher's `description`,
202
+ # for readable failure messages. You can alias your custom matchers in similar fashion
203
+ # using {RSpec::Matchers.alias_matcher}.
174
204
  module Matchers
175
- # @api private
176
- def self.is_a_matcher?(obj)
177
- return true if ::RSpec::Matchers::BuiltIn::BaseMatcher === obj
178
- return false if obj.respond_to?(:i_respond_to_everything_so_im_not_really_a_matcher)
179
- return false unless obj.respond_to?(:matches?)
205
+ # @method expect
206
+ # Supports `expect(actual).to matcher` syntax by wrapping `actual` in an
207
+ # `ExpectationTarget`.
208
+ # @example
209
+ # expect(actual).to eq(expected)
210
+ # expect(actual).not_to eq(expected)
211
+ # @return [ExpectationTarget]
212
+ # @see ExpectationTarget#to
213
+ # @see ExpectationTarget#not_to
214
+
215
+ # Defines a matcher alias. The returned matcher's `description` will be overriden
216
+ # to reflect the phrasing of the new name, which will be used in failure messages
217
+ # when passed as an argument to another matcher in a composed matcher expression.
218
+ #
219
+ # @param new_name [Symbol] the new name for the matcher
220
+ # @param old_name [Symbol] the original name for the matcher
221
+ # @param options [Hash] options for the aliased matcher
222
+ # @option options [Class] :klass the ruby class to use as the decorator. (Not normally used).
223
+ # @yield [String] optional block that, when given is used to define the overriden
224
+ # description. The yielded arg is the original description. If no block is
225
+ # provided, a default description override is used based on the old and
226
+ # new names.
227
+ #
228
+ # @example
229
+ #
230
+ # RSpec::Matchers.alias_matcher :a_list_that_sums_to, :sum_to
231
+ # sum_to(3).description # => "sum to 3"
232
+ # a_list_that_sums_to(3).description # => "a list that sums to 3"
233
+ #
234
+ # @example
235
+ #
236
+ # RSpec::Matchers.alias_matcher :a_list_sorted_by, :be_sorted_by do |description|
237
+ # description.sub("be sorted by", "a list sorted by")
238
+ # end
239
+ #
240
+ # be_sorted_by(:age).description # => "be sorted by age"
241
+ # a_list_sorted_by(:age).description # => "a list sorted by age"
242
+ #
243
+ # @!macro [attach] alias_matcher
244
+ # @!parse
245
+ # alias $1 $2
246
+ def self.alias_matcher(new_name, old_name, options={}, &description_override)
247
+ description_override ||= lambda do |old_desc|
248
+ old_desc.gsub(Pretty.split_words(old_name), Pretty.split_words(new_name))
249
+ end
250
+ klass = options.fetch(:klass) { AliasedMatcher }
251
+
252
+ define_method(new_name) do |*args, &block|
253
+ matcher = __send__(old_name, *args, &block)
254
+ klass.new(matcher, description_override)
255
+ end
256
+ end
180
257
 
181
- obj.respond_to?(:failure_message_for_should) || obj.respond_to?(:failure_message)
258
+ # Defines a negated matcher. The returned matcher's `description` and `failure_message`
259
+ # will be overriden to reflect the phrasing of the new name, and the match logic will
260
+ # be based on the original matcher but negated.
261
+ #
262
+ # @param negated_name [Symbol] the name for the negated matcher
263
+ # @param base_name [Symbol] the name of the original matcher that will be negated
264
+ # @yield [String] optional block that, when given is used to define the overriden
265
+ # description. The yielded arg is the original description. If no block is
266
+ # provided, a default description override is used based on the old and
267
+ # new names.
268
+ #
269
+ # @example
270
+ #
271
+ # RSpec::Matchers.define_negated_matcher :a_value_not_between, :a_value_between
272
+ # a_value_between(3, 5).description # => "a value between 3 and 5"
273
+ # a_value_not_between(3, 5).description # => "a value not between 3 and 5"
274
+ def self.define_negated_matcher(negated_name, base_name, &description_override)
275
+ alias_matcher(negated_name, base_name, :klass => AliasedNegatedMatcher, &description_override)
182
276
  end
183
277
 
184
278
  # Passes if actual is truthy (anything but false or nil)
185
279
  def be_truthy
186
280
  BuiltIn::BeTruthy.new
187
281
  end
282
+ alias_matcher :a_truthy_value, :be_truthy
188
283
 
189
- # Passes if actual is falsy (false or nil)
284
+ # Passes if actual is falsey (false or nil)
190
285
  def be_falsey
191
286
  BuiltIn::BeFalsey.new
192
287
  end
193
-
194
- alias_method :be_falsy, :be_falsey
288
+ alias_matcher :be_falsy, :be_falsey
289
+ alias_matcher :a_falsey_value, :be_falsey
290
+ alias_matcher :a_falsy_value, :be_falsey
195
291
 
196
292
  # Passes if actual is nil
197
293
  def be_nil
198
294
  BuiltIn::BeNil.new
199
295
  end
296
+ alias_matcher :a_nil_value, :be_nil
200
297
 
201
298
  # @example
202
299
  # expect(actual).to be_truthy
@@ -219,15 +316,14 @@ module RSpec
219
316
  # (e.g. be_empty), letting you choose the prefix that best suits the
220
317
  # predicate.
221
318
  def be(*args)
222
- args.empty? ?
223
- Matchers::BuiltIn::Be.new : equal(*args)
319
+ args.empty? ? Matchers::BuiltIn::Be.new : equal(*args)
224
320
  end
321
+ alias_matcher :a_value, :be, :klass => AliasedMatcherWithOperatorSupport
225
322
 
226
323
  # passes if target.kind_of?(klass)
227
324
  def be_a(klass)
228
325
  be_a_kind_of(klass)
229
326
  end
230
-
231
327
  alias_method :be_an, :be_a
232
328
 
233
329
  # Passes if actual.instance_of?(expected)
@@ -240,8 +336,8 @@ module RSpec
240
336
  def be_an_instance_of(expected)
241
337
  BuiltIn::BeAnInstanceOf.new(expected)
242
338
  end
243
-
244
339
  alias_method :be_instance_of, :be_an_instance_of
340
+ alias_matcher :an_instance_of, :be_an_instance_of
245
341
 
246
342
  # Passes if actual.kind_of?(expected)
247
343
  #
@@ -253,8 +349,25 @@ module RSpec
253
349
  def be_a_kind_of(expected)
254
350
  BuiltIn::BeAKindOf.new(expected)
255
351
  end
256
-
257
352
  alias_method :be_kind_of, :be_a_kind_of
353
+ alias_matcher :a_kind_of, :be_a_kind_of
354
+
355
+ # Passes if actual.between?(min, max). Works with any Comparable object,
356
+ # including String, Symbol, Time, or Numeric (Fixnum, Bignum, Integer,
357
+ # Float, Complex, and Rational).
358
+ #
359
+ # By default, `be_between` is inclusive (i.e. passes when given either the max or min value),
360
+ # but you can make it `exclusive` by chaining that off the matcher.
361
+ #
362
+ # @example
363
+ #
364
+ # expect(5).to be_between(1, 10)
365
+ # expect(11).not_to be_between(1, 10)
366
+ # expect(10).not_to be_between(1, 10).exclusive
367
+ def be_between(min, max)
368
+ BuiltIn::BeBetween.new(min, max)
369
+ end
370
+ alias_matcher :a_value_between, :be_between
258
371
 
259
372
  # Passes if actual == expected +/- delta
260
373
  #
@@ -265,6 +378,8 @@ module RSpec
265
378
  def be_within(delta)
266
379
  BuiltIn::BeWithin.new(delta)
267
380
  end
381
+ alias_matcher :a_value_within, :be_within
382
+ alias_matcher :within, :be_within
268
383
 
269
384
  # Applied to a proc, specifies that its execution will cause some value to
270
385
  # change.
@@ -275,9 +390,21 @@ module RSpec
275
390
  # You can either pass <tt>receiver</tt> and <tt>message</tt>, or a block,
276
391
  # but not both.
277
392
  #
278
- # When passing a block, it must use the <tt>{ ... }</tt> format, not
279
- # do/end, as <tt>{ ... }</tt> binds to the +change+ method, whereas do/end
280
- # would errantly bind to the +expect(..)+ or +expect(..).not_to+ method.
393
+ # When passing a block, it must use the `{ ... }` format, not
394
+ # do/end, as `{ ... }` binds to the `change` method, whereas do/end
395
+ # would errantly bind to the `expect(..).to` or `expect(...).not_to` method.
396
+ #
397
+ # You can chain any of the following off of the end to specify details
398
+ # about the change:
399
+ #
400
+ # * `from`
401
+ # * `to`
402
+ #
403
+ # or any one of:
404
+ #
405
+ # * `by`
406
+ # * `by_at_least`
407
+ # * `by_at_most`
281
408
  #
282
409
  # @example
283
410
  #
@@ -305,7 +432,7 @@ module RSpec
305
432
  # string = "string"
306
433
  # expect {
307
434
  # string
308
- # }.not_to change { string }
435
+ # }.not_to change { string }.from("string")
309
436
  #
310
437
  # expect {
311
438
  # person.happy_birthday
@@ -326,15 +453,37 @@ module RSpec
326
453
  #
327
454
  # == Notes
328
455
  #
329
- # Evaluates <tt>receiver.message</tt> or <tt>block</tt> before and after it
330
- # evaluates the block passed to <tt>expect</tt>.
456
+ # Evaluates `receiver.message` or `block` before and after it
457
+ # evaluates the block passed to `expect`.
331
458
  #
332
- # <tt>expect( ... ).not_to change</tt> only supports the form with no subsequent
333
- # calls to <tt>by</tt>, <tt>by_at_least</tt>, <tt>by_at_most</tt>,
334
- # <tt>to</tt> or <tt>from</tt>.
459
+ # `expect( ... ).not_to change` supports the form that specifies `from`
460
+ # (which specifies what you expect the starting, unchanged value to be)
461
+ # but does not support forms with subsequent calls to `by`, `by_at_least`,
462
+ # `by_at_most` or `to`.
335
463
  def change(receiver=nil, message=nil, &block)
336
464
  BuiltIn::Change.new(receiver, message, &block)
337
465
  end
466
+ alias_matcher :a_block_changing, :change
467
+ alias_matcher :changing, :change
468
+
469
+ # Passes if actual contains all of the expected regardless of order.
470
+ # This works for collections. Pass in multiple args and it will only
471
+ # pass if all args are found in collection.
472
+ #
473
+ # @note This is also available using the `=~` operator with `should`,
474
+ # but `=~` is not supported with `expect`.
475
+ #
476
+ # @example
477
+ #
478
+ # expect([1, 2, 3]).to contain_exactly(1, 2, 3)
479
+ # expect([1, 2, 3]).to contain_exactly(1, 3, 2)
480
+ #
481
+ # @see #match_array
482
+ def contain_exactly(*items)
483
+ BuiltIn::ContainExactly.new(items)
484
+ end
485
+ alias_matcher :a_collection_containing_exactly, :contain_exactly
486
+ alias_matcher :containing_exactly, :contain_exactly
338
487
 
339
488
  # Passes if actual covers expected. This works for
340
489
  # Ranges. You can also pass in multiple args
@@ -350,7 +499,9 @@ module RSpec
350
499
  # ### Warning:: Ruby >= 1.9 only
351
500
  def cover(*values)
352
501
  BuiltIn::Cover.new(*values)
353
- end if (1..2).respond_to?(:cover?)
502
+ end
503
+ alias_matcher :a_range_covering, :cover
504
+ alias_matcher :covering, :cover
354
505
 
355
506
  # Matches if the actual value ends with the expected value(s). In the case
356
507
  # of a string, matches against the last `expected.length` characters of the
@@ -365,6 +516,9 @@ module RSpec
365
516
  def end_with(*expected)
366
517
  BuiltIn::EndWith.new(*expected)
367
518
  end
519
+ alias_matcher :a_collection_ending_with, :end_with
520
+ alias_matcher :a_string_ending_with, :end_with
521
+ alias_matcher :ending_with, :end_with
368
522
 
369
523
  # Passes if <tt>actual == expected</tt>.
370
524
  #
@@ -378,8 +532,10 @@ module RSpec
378
532
  def eq(expected)
379
533
  BuiltIn::Eq.new(expected)
380
534
  end
535
+ alias_matcher :an_object_eq_to, :eq
536
+ alias_matcher :eq_to, :eq
381
537
 
382
- # Passes if +actual.eql?(expected)+
538
+ # Passes if `actual.eql?(expected)`
383
539
  #
384
540
  # See http://www.ruby-doc.org/core/classes/Object.html#M001057 for more
385
541
  # information about equality in Ruby.
@@ -391,6 +547,8 @@ module RSpec
391
547
  def eql(expected)
392
548
  BuiltIn::Eql.new(expected)
393
549
  end
550
+ alias_matcher :an_object_eql_to, :eql
551
+ alias_matcher :eql_to, :eql
394
552
 
395
553
  # Passes if <tt>actual.equal?(expected)</tt> (object identity).
396
554
  #
@@ -404,6 +562,8 @@ module RSpec
404
562
  def equal(expected)
405
563
  BuiltIn::Equal.new(expected)
406
564
  end
565
+ alias_matcher :an_object_equal_to, :equal
566
+ alias_matcher :equal_to, :equal
407
567
 
408
568
  # Passes if `actual.exist?` or `actual.exists?`
409
569
  #
@@ -412,6 +572,29 @@ module RSpec
412
572
  def exist(*args)
413
573
  BuiltIn::Exist.new(*args)
414
574
  end
575
+ alias_matcher :an_object_existing, :exist
576
+ alias_matcher :existing, :exist
577
+
578
+ # Passes if actual's attribute values match the expected attributes hash.
579
+ # This works no matter how you define your attribute readers.
580
+ #
581
+ # @example
582
+ #
583
+ # Person = Struct.new(:name, :age)
584
+ # person = Person.new("Bob", 32)
585
+ #
586
+ # expect(person).to have_attributes(:name => "Bob", :age => 32)
587
+ # expect(person).to have_attributes(:name => a_string_starting_with("B"), :age => (a_value > 30) )
588
+ #
589
+ # @note It will fail if actual doesn't respond to any of the expected attributes.
590
+ #
591
+ # @example
592
+ #
593
+ # expect(person).to have_attributes(:color => "red")
594
+ def have_attributes(expected)
595
+ BuiltIn::HaveAttributes.new(expected)
596
+ end
597
+ alias_matcher :an_object_having_attributes, :have_attributes
415
598
 
416
599
  # Passes if actual includes expected. This works for
417
600
  # collections and Strings. You can also pass in multiple args
@@ -428,14 +611,60 @@ module RSpec
428
611
  def include(*expected)
429
612
  BuiltIn::Include.new(*expected)
430
613
  end
614
+ alias_matcher :a_collection_including, :include
615
+ alias_matcher :a_string_including, :include
616
+ alias_matcher :a_hash_including, :include
617
+ alias_matcher :including, :include
431
618
 
432
- # Given a Regexp or String, passes if actual.match(pattern)
619
+ # Passes if actual all expected objects pass. This works for
620
+ # any enumerable object.
621
+ #
622
+ # @example
623
+ #
624
+ # expect([1, 3, 5]).to all be_odd
625
+ # expect([1, 3, 6]).to all be_odd # fails
626
+ #
627
+ # @note The negative form `not_to all` is not supported. Instead
628
+ # use `not_to include` or pass a negative form of a matcher
629
+ # as the argument (e.g. `all exclude(:foo)`).
630
+ #
631
+ # @note You can also use this with compound matchers as well.
632
+ #
633
+ # @example
634
+ # expect([1, 3, 5]).to all( be_odd.and be_an(Integer) )
635
+ def all(expected)
636
+ BuiltIn::All.new(expected)
637
+ end
638
+
639
+ # Given a `Regexp` or `String`, passes if `actual.match(pattern)`
640
+ # Given an arbitrary nested data structure (e.g. arrays and hashes),
641
+ # matches if `expected === actual` || `actual == expected` for each
642
+ # pair of elements.
433
643
  #
434
644
  # @example
435
645
  #
436
646
  # expect(email).to match(/^([^\s]+)((?:[-a-z0-9]+\.)+[a-z]{2,})$/i)
437
647
  # expect(email).to match("@example.com")
438
648
  #
649
+ # @example
650
+ #
651
+ # hash = {
652
+ # :a => {
653
+ # :b => ["foo", 5],
654
+ # :c => { :d => 2.05 }
655
+ # }
656
+ # }
657
+ #
658
+ # expect(hash).to match(
659
+ # :a => {
660
+ # :b => a_collection_containing_exactly(
661
+ # a_string_starting_with("f"),
662
+ # an_instance_of(Fixnum)
663
+ # ),
664
+ # :c => { :d => (a_value < 3) }
665
+ # }
666
+ # )
667
+ #
439
668
  # @note The `match_regex` alias is deprecated and is not recommended for use.
440
669
  # It was added in 2.12.1 to facilitate its use from within custom
441
670
  # matchers (due to how the custom matcher DSL was evaluated in 2.x,
@@ -443,7 +672,52 @@ module RSpec
443
672
  def match(expected)
444
673
  BuiltIn::Match.new(expected)
445
674
  end
446
- alias_method :match_regex, :match
675
+ alias_matcher :match_regex, :match
676
+ alias_matcher :an_object_matching, :match
677
+ alias_matcher :a_string_matching, :match
678
+ alias_matcher :matching, :match
679
+
680
+ # An alternate form of `contain_exactly` that accepts
681
+ # the expected contents as a single array arg rather
682
+ # that splatted out as individual items.
683
+ #
684
+ # @example
685
+ #
686
+ # expect(results).to contain_exactly(1, 2)
687
+ # # is identical to:
688
+ # expect(results).to match_array([1, 2])
689
+ #
690
+ # @see #contain_exactly
691
+ def match_array(items)
692
+ contain_exactly(*items)
693
+ end
694
+
695
+ # With no arg, passes if the block outputs `to_stdout` or `to_stderr`.
696
+ # With a string, passes if the blocks outputs that specific string `to_stdout` or `to_stderr`.
697
+ # With a regexp or matcher, passes if the blocks outputs a string `to_stdout` or `to_stderr` that matches.
698
+ #
699
+ # @example
700
+ #
701
+ # expect { print 'foo' }.to output.to_stdout
702
+ # expect { print 'foo' }.to output('foo').to_stdout
703
+ # expect { print 'foo' }.to output(/foo/).to_stdout
704
+ #
705
+ # expect { do_something }.to_not output.to_stdout
706
+ #
707
+ # expect { warn('foo') }.to output.to_stderr
708
+ # expect { warn('foo') }.to output('foo').to_stderr
709
+ # expect { warn('foo') }.to output(/foo/).to_stderr
710
+ #
711
+ # expect { do_something }.to_not output.to_stderr
712
+ #
713
+ # @note This matcher works by temporarily replacing `$stdout` or `$stderr`,
714
+ # so it's not able to intercept stream output that explicitly uses `STDOUT`/`STDERR`
715
+ # or that uses a reference to `$stdout`/`$stderr` that was stored before the
716
+ # matcher is used.
717
+ def output(expected=nil)
718
+ BuiltIn::Output.new(expected)
719
+ end
720
+ alias_matcher :a_block_outputting, :output
447
721
 
448
722
  # With no args, matches if any error is raised.
449
723
  # With a named error, matches only if that specific error is raised.
@@ -463,19 +737,28 @@ module RSpec
463
737
  def raise_error(error=Exception, message=nil, &block)
464
738
  BuiltIn::RaiseError.new(error, message, &block)
465
739
  end
740
+ alias_method :raise_exception, :raise_error
741
+
742
+ alias_matcher :a_block_raising, :raise_error do |desc|
743
+ desc.sub("raise", "a block raising")
744
+ end
466
745
 
467
- alias_method :raise_exception, :raise_error
746
+ alias_matcher :raising, :raise_error do |desc|
747
+ desc.sub("raise", "raising")
748
+ end
468
749
 
469
750
  # Matches if the target object responds to all of the names
470
751
  # provided. Names can be Strings or Symbols.
471
752
  #
472
753
  # @example
473
754
  #
474
- # expect("string").to respond_to(:length)
755
+ # expect("string").to respond_to(:length)
475
756
  #
476
757
  def respond_to(*names)
477
758
  BuiltIn::RespondTo.new(*names)
478
759
  end
760
+ alias_matcher :an_object_responding_to, :respond_to
761
+ alias_matcher :responding_to, :respond_to
479
762
 
480
763
  # Passes if the submitted block returns true. Yields target to the
481
764
  # block.
@@ -493,6 +776,8 @@ module RSpec
493
776
  def satisfy(&block)
494
777
  BuiltIn::Satisfy.new(&block)
495
778
  end
779
+ alias_matcher :an_object_satisfying, :satisfy
780
+ alias_matcher :satisfying, :satisfy
496
781
 
497
782
  # Matches if the actual value starts with the expected value(s). In the
498
783
  # case of a string, matches against the first `expected.length` characters
@@ -507,6 +792,9 @@ module RSpec
507
792
  def start_with(*expected)
508
793
  BuiltIn::StartWith.new(*expected)
509
794
  end
795
+ alias_matcher :a_collection_starting_with, :start_with
796
+ alias_matcher :a_string_starting_with, :start_with
797
+ alias_matcher :starting_with, :start_with
510
798
 
511
799
  # Given no argument, matches if a proc throws any Symbol.
512
800
  #
@@ -528,6 +816,14 @@ module RSpec
528
816
  BuiltIn::ThrowSymbol.new(expected_symbol, expected_arg)
529
817
  end
530
818
 
819
+ alias_matcher :a_block_throwing, :throw_symbol do |desc|
820
+ desc.sub("throw", "a block throwing")
821
+ end
822
+
823
+ alias_matcher :throwing, :throw_symbol do |desc|
824
+ desc.sub("throw", "throwing")
825
+ end
826
+
531
827
  # Passes if the method called in the expect block yields, regardless
532
828
  # of whether or not arguments are yielded.
533
829
  #
@@ -543,6 +839,8 @@ module RSpec
543
839
  def yield_control
544
840
  BuiltIn::YieldControl.new
545
841
  end
842
+ alias_matcher :a_block_yielding_control, :yield_control
843
+ alias_matcher :yielding_control, :yield_control
546
844
 
547
845
  # Passes if the method called in the expect block yields with
548
846
  # no arguments. Fails if it does not yield, or yields with arguments.
@@ -560,6 +858,8 @@ module RSpec
560
858
  def yield_with_no_args
561
859
  BuiltIn::YieldWithNoArgs.new
562
860
  end
861
+ alias_matcher :a_block_yielding_with_no_args, :yield_with_no_args
862
+ alias_matcher :yielding_with_no_args, :yield_with_no_args
563
863
 
564
864
  # Given no arguments, matches if the method called in the expect
565
865
  # block yields with arguments (regardless of what they are or how
@@ -589,6 +889,8 @@ module RSpec
589
889
  def yield_with_args(*args)
590
890
  BuiltIn::YieldWithArgs.new(*args)
591
891
  end
892
+ alias_matcher :a_block_yielding_with_args, :yield_with_args
893
+ alias_matcher :yielding_with_args, :yield_with_args
592
894
 
593
895
  # Designed for use with methods that repeatedly yield (such as
594
896
  # iterators). Passes if the method called in the expect block yields
@@ -609,25 +911,57 @@ module RSpec
609
911
  def yield_successive_args(*args)
610
912
  BuiltIn::YieldSuccessiveArgs.new(*args)
611
913
  end
914
+ alias_matcher :a_block_yielding_successive_args, :yield_successive_args
915
+ alias_matcher :yielding_successive_args, :yield_successive_args
916
+
917
+ # Delegates to {RSpec::Expectations.configuration}.
918
+ # This is here because rspec-core's `expect_with` option
919
+ # looks for a `configuration` method on the mixin
920
+ # (`RSpec::Matchers`) to yield to a block.
921
+ # @return [RSpec::Expectations::Configuration] the configuration object
922
+ def self.configuration
923
+ Expectations.configuration
924
+ end
612
925
 
613
- # Passes if actual contains all of the expected regardless of order.
614
- # This works for collections. Pass in multiple args and it will only
615
- # pass if all args are found in collection.
616
- #
617
- # @note This is also available using the `=~` operator with `should`,
618
- # but `=~` is not supported with `expect`.
619
- #
620
- # @note This matcher only supports positive expectations.
621
- # expect(..).not_to match_array(other_array) is not supported.
622
- #
623
- # @example
624
- #
625
- # expect([1,2,3]).to match_array([1,2,3])
626
- # expect([1,2,3]).to match_array([1,3,2])
627
- def match_array(array)
628
- BuiltIn::MatchArray.new(array)
926
+ private
927
+
928
+ BE_PREDICATE_REGEX = /^(be_(?:an?_)?)(.*)/
929
+ HAS_REGEX = /^(?:have_)(.*)/
930
+
931
+ def method_missing(method, *args, &block)
932
+ case method.to_s
933
+ when BE_PREDICATE_REGEX
934
+ BuiltIn::BePredicate.new(method, *args, &block)
935
+ when HAS_REGEX
936
+ BuiltIn::Has.new(method, *args, &block)
937
+ else
938
+ super
939
+ end
629
940
  end
630
941
 
631
- OperatorMatcher.register(Enumerable, '=~', BuiltIn::MatchArray)
942
+ # @api private
943
+ def self.is_a_matcher?(obj)
944
+ return true if ::RSpec::Matchers::BuiltIn::BaseMatcher === obj
945
+ begin
946
+ return false if obj.respond_to?(:i_respond_to_everything_so_im_not_really_a_matcher)
947
+ rescue NoMethodError
948
+ # Some objects, like BasicObject, don't implemented standard
949
+ # reflection methods.
950
+ return false
951
+ end
952
+ return false unless obj.respond_to?(:matches?)
953
+
954
+ obj.respond_to?(:failure_message) ||
955
+ obj.respond_to?(:failure_message_for_should) # support legacy matchers
956
+ end
957
+
958
+ ::RSpec::Support.register_matcher_definition do |obj|
959
+ is_a_matcher?(obj)
960
+ end
961
+
962
+ # @api private
963
+ def self.is_a_describable_matcher?(obj)
964
+ is_a_matcher?(obj) && obj.respond_to?(:description)
965
+ end
632
966
  end
633
967
  end