rspec-core 3.13.6 → 4.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82dbc399705e303ef18399ee250bf5fb934ba581db0f46b474ba65197b2c6a50
-  data.tar.gz: 56e628d1e04d1c79ceb6b4de672a0c3db07fc4c8b33c85695cd7eeb5d28e0cc6
+  metadata.gz: b56c09e1de4509725d998327b9063cb42f125f4974ca130c165605779751609c
+  data.tar.gz: 8bbf38e64d7d044f3c03194200c3a643ec18bbd26df5641461509f756cc612aa
 SHA512:
-  metadata.gz: b7fac1133c1618a679a8ac4d1f3eb8b66344434687611405a4f6a7c5d61834e80782c60a0685d8c2a886d4c3a42d05db31f20c3616887610658d2e814a153bf0
-  data.tar.gz: 75c5ceb3eedfdec5cb7ffc31d4078befc87684ff898e13173a25208132428a98472d8745c2272b58f7f3c64b9cd5056c8206752602dfc9d6a0f11164f51499d7
+  metadata.gz: bd6c5b7d64ed1f4e6a9f6d5cfdfda66460113f92056e1e53ee8fc801c8019e4443776e5b1e8fb9fb5416139023b320808b644ab23e1b611ad3c9fe6a06eeaed7
+  data.tar.gz: c20dd14add003858dcd535c74f200ef0ef969602a831a91cfd62be0896940eb97a89678db1f120c5476652f2245af3488db69d183cddb1a9008994ad964ff037

data/Changelog.md

@@ -1,8 +1,55 @@
 ### Development
-[Full Changelog](https://github.com/rspec/rspec/compare/rspec-core-v3.13.6...3-13-maintenance)
+[Full Changelog](https://github.com/rspec/rspec/compare/rspec-core-v3.13.6...main)
+
+# 4.0.0.beta1 / 2026-02-18
+
+Breaking Changes:
+
+* Ruby < 3.0 is no longer supported. (Phil Pirozhkov, Jon Rowe, rspec/rspec-core#2787, rspec/rspec#258)
+* Extract `should` syntax (including the non-monkey-patching one liner).
+  (Phil Pirozhkov, rspec/rspec-core#2803)
+* Remove globally-exposed DSL (example and shared group methods
+  in the root scope and on Module). (Phil Pirozhkov, rspec/rspec-core#2803)
+* Remove `run_all_when_everything_filtered` configuration option. (Phil Pirozhkov, rspec/rspec-core#2845)
+* Change the default `shared_context_metadata_behavior` to `apply_to_host_groups`
+  and remove the configuration option. (Phil Pirozhkov, rspec/rspec-core#2834)
+* Raise on unsupported hook scope usage. (Phil Pirozhkov, rspec/rspec-core#2849)
+* Raise on usage of metadata on suite-level scopes. (Phil Pirozhkov, rspec/rspec-core#2849)
+* Raise an error when `fail_fast` is configured with
+  an unsupported value. (Phil Pirozhkov, rspec/rspec-core#2849)
+* Remove deprecated access to an example group's metadata through the example.
+  (Phil Pirozhkov, rspec/rspec-core#2851)
+* Remove deprecated Hash-like behavior from example
+  execution result. (Phil Pirozhkov, rspec/rspec-core#2862)
+* Skip setting the default pattern from Rake task. (Phil Pirozhkov, rspec/rspec-core#2868)
+* Remove special `:if`/`:unless` filtering metadata. (Phil Pirozhkov, rspec/rspec-core#2870)
+* Remove deprecated `color` configuration option and `--color` command line
+  option. (Phil Pirozhkov, rspec/rspec-core#2864)
+* Remove `it_should_behave_like` nested shared group method and
+  `alias_it_should_behave_like_to` configuration option. (Phil Pirozhkov, rspec/rspec-core#2864)
+* Remove deprecated `treat_symbols_as_metadata_keys_with_true_values` configuration
+  option. (Phil Pirozhkov, rspec/rspec-core#2864)
+* Remove support for Mocha version < 1.0. (Phil Pirozhkov, rspec/rspec-core#2864)
+* Remove deprecated `PendingExampleFixedNotification` and
+  `PendingExampleFailedAsExpectedNotification` classes. (Phil Pirozhkov, rspec/rspec-core#2864)
+* Remove deprecated `rerun_argument` example method. (Phil Pirozhkov, rspec/rspec-core#2864)
+* Raise on attempt to use a legacy formatter without `rspec-legacy_formatters`.
+  (Phil Pirozhkov, rspec/rspec-core#2864)
+* Unify multi-condition filtering to use "all" semantic. (Phil Pirozhkov, rspec/rspec-core#2874)
+* Change the default order to random. (Santiago Bartesaghi, rspec/rspec-core#2929)
+* Default warning level is now `:deprecations_only`. (Jon Rowe, rspec/rspec#161)
+* Raise an error when a block is passed to `include_examples`. (Phil Pirozhkov, rspec/rspec#259)
+
+Enhancements:
+
+* Add config option (`RSpec::Core::Configuration#force_line_number_for_spec_rerun`) to
+  allways print a line number rather than an example id when the line number is ambiguous.
+  (Baden Ashford, rspec/rspec-core#3085)
+* Expand `RSpec::Core::Configuration#warnings=` to take `:all`, `:deprecations_only` and `:none`
+  options. (Jean Boussier, rspec/rspec#161)
 
 ### 3.13.6 / 2025-10-19
-[Full Changelog](http://github.com/rspec/rspec/compare/rspec-core-v3.13.4...rspec-core-v3.13.5)
+[Full Changelog](http://github.com/rspec/rspec/compare/rspec-core-v3.13.5...rspec-core-v3.13.6)
 
 Bug Fixes:
 

data/LICENSE.md

@@ -1,8 +1,8 @@
 The MIT License (MIT)
 =====================
 
-* Copyright © 2012 Chad Humphries, David Chelimsky, Myron Marston
-* Copyright © 2009 Chad Humphries, David Chelimsky
+* Copyright © 2013 David Chelimsky, Myron Marston, Jon Rowe, Sam Phippen, Xavier Shay, Bradley Schaefer
+* Copyright © 2012 David Chelimsky, Myron Marston
 * Copyright © 2006 David Chelimsky, The RSpec Development Team
 * Copyright © 2005 Steven Baker
 

data/README.md

@@ -1,23 +1,11 @@
-# rspec-core [![Build Status](https://github.com/rspec/rspec-core/workflows/RSpec%20CI/badge.svg)](https://github.com/rspec/rspec-core/actions) [![Code Climate](https://codeclimate.com/github/rspec/rspec-core.svg)](https://codeclimate.com/github/rspec/rspec-core)
+# RSpec::Core
 
-rspec-core provides the structure for writing executable examples of how your
-code should behave, and an `rspec` command with tools to constrain which
-examples get run and tailor the output.
+This is the detailed readme for `rspec-core`, see also:
 
-## Install
-
-    gem install rspec      # for rspec-core, rspec-expectations, rspec-mocks
-    gem install rspec-core # for rspec-core only
-    rspec --help
-
-Want to run against the `main` branch? You'll need to include the dependent
-RSpec repos as well. Add the following to your `Gemfile`:
-
-```ruby
-%w[rspec rspec-core rspec-expectations rspec-mocks rspec-support].each do |lib|
-  gem lib, :git => "https://github.com/rspec/#{lib}.git", :branch => 'main'
-end
-```
+* [The combined readme](../README.md)
+* [rspec-expectations](../rspec-expectations/README.md)
+* [rspec-mocks](../rspec-mocks/README.md)
+* [rspec-support](../rspec-support/README.md)
 
 ## Basic Structure
 
@@ -78,10 +66,8 @@ the inheritance semantics you'd want for free.
 ## Aliases
 
 You can declare example groups using either `describe` or `context`.
-For a top level example group, `describe` and `context` are available
-off of `RSpec`. For backwards compatibility, they are also available
-off of the `main` object and `Module` unless you disable monkey
-patching.
+For a top-level example group, `describe` and `context` are available
+off of `RSpec`.
 
 You can declare examples within a group using any of `it`, `specify`, or
 `example`.
@@ -89,7 +75,7 @@ You can declare examples within a group using any of `it`, `specify`, or
 ## Shared Examples and Contexts
 
 Declare a shared example group using `shared_examples`, and then include it
-in any group using `include_examples`.
+in any group using `it_behaves_like` or `include_examples`.
 
 ```ruby
 RSpec.shared_examples "collections" do |collection_class|
@@ -98,15 +84,39 @@ RSpec.shared_examples "collections" do |collection_class|
   end
 end
 
+RSpec.shared_examples "implements #empty?" do
+  it "returns true when there are no members" do
+    expect(empty_target).to be_empty
+  end
+
+  it "returns false when there are members" do
+    expect(non_empty_target).to_not be_empty
+  end
+end
+
 RSpec.describe Array do
   include_examples "collections", Array
+
+  it_behaves_like "implements #empty?" do
+    let(:empty_target) { Array.new }
+    let(:non_empty_target) { [:key] }
+  end
 end
 
 RSpec.describe Hash do
   include_examples "collections", Hash
+
+  it_behaves_like "implements #empty?" do
+    let(:empty_target) { Hash.new }
+    let(:non_empty_target) { {key: :value} }
+  end
 end
 ```
 
+Note that `include_examples` directly includes examples into the current context, whilst
+`it_behaves_like` wraps the examples in a new context which allows you to pass a block
+to customise things like `let` or `subject` without using local variables passed in.
+
 Nearly anything that can be declared within an example group can be declared
 within a shared example group. This includes `before`, `after`, and `around`
 hooks, `let` declarations, and nested groups/contexts.
@@ -366,24 +376,3 @@ Calculator
 Finished in 0.000379 seconds
 1 example, 0 failures
 ```
-
-## Contributing
-
-Once you've set up the environment, you'll need to cd into the working
-directory of whichever repo you want to work in. From there you can run the
-specs and cucumber features, and make patches.
-
-NOTE: You do not need to use rspec-dev to work on a specific RSpec repo. You
-can treat each RSpec repo as an independent project.
-
-* [Build details](BUILD_DETAIL.md)
-* [Code of Conduct](CODE_OF_CONDUCT.md)
-* [Detailed contributing guide](CONTRIBUTING.md)
-* [Development setup guide](DEVELOPMENT.md)
-
-## Also see
-
-* [https://github.com/rspec/rspec](https://github.com/rspec/rspec)
-* [https://github.com/rspec/rspec-expectations](https://github.com/rspec/rspec-expectations)
-* [https://github.com/rspec/rspec-mocks](https://github.com/rspec/rspec-mocks)
-* [https://github.com/rspec/rspec-rails](https://github.com/rspec/rspec-rails)

data/lib/rspec/core/bisect/example_minimizer.rb

@@ -123,7 +123,7 @@ module RSpec
 
           if @failed_example_ids.empty?
             raise BisectFailedError, "\n\nNo failures found. Bisect only works " \
-                  "in the presence of one or more failing examples."
+                                     "in the presence of one or more failing examples."
           else
             notify(:bisect_original_run_complete, :failed_example_ids => failed_example_ids,
                                                   :non_failing_example_ids => non_failing_example_ids,
@@ -160,8 +160,8 @@ module RSpec
           return if expected_order == results.all_example_ids
 
           raise BisectFailedError, "\n\nThe example ordering is inconsistent. " \
-                "`--bisect` relies upon consistent ordering (e.g. by passing " \
-                "`--seed` if you're using random ordering) to work properly."
+                                   "`--bisect` relies upon consistent ordering (e.g. by passing " \
+                                   "`--seed` if you're using random ordering) to work properly."
         end
 
         def notify(*args)

data/lib/rspec/core/bisect/fork_runner.rb

@@ -112,12 +112,6 @@ module RSpec
               c.load_spec_files
             end
 
-            # `announce_filters` has the side effect of implementing the logic
-            # that honors `config.run_all_when_everything_filtered` so we need
-            # to call it here. When we remove `run_all_when_everything_filtered`
-            # (slated for RSpec 4), we can remove this call to `announce_filters`.
-            @runner.world.announce_filters
-
             @runner.run_specs(@runner.world.ordered_example_groups)
             latest_run_results = formatter.results
 

data/lib/rspec/core/bisect/shell_command.rb

@@ -1,4 +1,5 @@
 RSpec::Support.require_rspec_core "shell_escape"
+RSpec::Support.require_rspec_support 'ruby_features'
 require 'shellwords'
 
 module RSpec
@@ -63,6 +64,7 @@ module RSpec
       private
 
         include RSpec::Core::ShellEscape
+
         # On JRuby, Open3.popen3 does not handle shellescaped args properly:
         # https://github.com/jruby/jruby/issues/2767
         if RSpec::Support::Ruby.jruby?

data/lib/rspec/core/bisect/shell_runner.rb

@@ -41,31 +41,8 @@ module RSpec
           end
         end
 
-        # `Open3.capture2e` does not work on JRuby:
-        # https://github.com/jruby/jruby/issues/2766
-        if Open3.respond_to?(:capture2e) && !RSpec::Support::Ruby.jruby?
-          def run_command(cmd)
-            Open3.capture2e(@shell_command.bisect_environment_hash, cmd).first
-          end
-        else # for 1.8.7
-          # :nocov:
-          def run_command(cmd)
-            out = err = nil
-
-            original_spec_opts = ENV['SPEC_OPTS']
-            ENV['SPEC_OPTS'] = @shell_command.spec_opts_without_bisect
-
-            Open3.popen3(cmd) do |_, stdout, stderr|
-              # Reading the streams blocks until the process is complete
-              out = stdout.read
-              err = stderr.read
-            end
-
-            "Stdout:\n#{out}\n\nStderr:\n#{err}"
-          ensure
-            ENV['SPEC_OPTS'] = original_spec_opts
-          end
-          # :nocov:
+        def run_command(cmd)
+          Open3.capture2e(@shell_command.bisect_environment_hash, cmd).first
         end
       end
     end

data/lib/rspec/core/bisect/utilities.rb

@@ -34,17 +34,13 @@ module RSpec
       # parent.
       # @private
       class Channel
-        if String.method_defined?(:encoding)
-          MARSHAL_DUMP_ENCODING = Marshal.dump("").encoding
-        end
+        MARSHAL_DUMP_ENCODING = Marshal.dump("").encoding
 
         def initialize
           @read_io, @write_io = IO.pipe
 
-          if defined?(MARSHAL_DUMP_ENCODING) && IO.method_defined?(:set_encoding)
-            # Ensure the pipe can send any content produced by Marshal.dump
-            @write_io.set_encoding MARSHAL_DUMP_ENCODING
-          end
+          # Ensure the pipe can send any content produced by Marshal.dump
+          @write_io.set_encoding MARSHAL_DUMP_ENCODING
         end
 
         def send(message)