Changelog.md

Development

Full Changelog

Enhancements:

• Support the --backtrace flag when using the JSON formatter. (Matt Larraz, #2980)
• Ignore commented out lines in CLI config files (e.g. .rspec). (Junichi Ito, #2984)

3.12.0 / 2022-10-26

Full Changelog

• No changes, released to support other gems.

3.11.0 / 2022-02-09

Full Changelog

Enhancements:

• Improve pluralisation of words ending with s (like process). (Joshua Pinter, #2779)
• Add ordering by file modification time (most recent first). (Matheus Richard, #2778)
• Add to_s to reserved names for #let and #subject. (Nick Flückiger, #2886)
• Introduce RSpec.current_scope to expose the current scope in which RSpec is executing. e.g. :before_example_hook, :example etc. (@odinhb, #2895)
• Add named bold colours as options for custom colours. (#2913, #2914)
• Warn when (but not prevent) a SystemExit occurs. (Jared Beck, #2926)

3.10.2 / 2022-01-27

Full Changelog

Bug fixes:

• Ensure bisect communication uses consistent encoding. (Mike Jarema, #2852)
• Fix exception presenter when the root cause exception has nil backtrace. (Zinovyev Ivan, #2903)
• Fix inspect output of RSpec::Core::Example::Procsy to namespace correctly. (Keiko Kaneko, #2915)
• Ensure formatters not exposing #output will not crash duplicate check. (@niceking, #2916)

3.10.1 / 2020-12-27

Full Changelog

Bug fixes:

• RSpec warning output was missing deprecations from Ruby, these are now included. (Jon Rowe, #2811)

3.10.0 / 2020-10-30

Full Changelog

Enhancements:

• Memoize RSpec::Core::Formatters::ExceptionPresenter#exception_lines to improve performance with slow exception messages. (Maxime Lapointe, #2743)
• Add configuration for an error exit code (to disambiguate errored builds from failed builds by exit status). (Dana Sherson, #2749)

3.9.3 / 2020-09-30

Full Changelog

Bug Fixes:

• Declare ruby2_keywords on method_missing for other gems. (Jon Rowe, #2731)
• Ensure custom error codes are returned from bisect runs. (Jon Rowe, #2732)
• Ensure RSpec::Core::Configuration predicate config methods return booleans. (Marc-André Lafortune, #2736)
• Prevent rspec --bisect from generating zombie processes while executing bisect runs. (Benoit Tigeot, Jon Rowe, #2739)
• Predicates for pending examples, (in RSpec::Core::Example, #pending?, #skipped? and #pending_fixed?) now return boolean values rather than truthy values. (Marc-André Lafortune, #2756, #2758)
• Exceptions which have a message which cannot be cast to a string will no longer cause a crash. (Jon Rowe, #2761)

3.9.2 / 2020-05-02

Full Changelog

Bug Fixes:

• Emit a warning when around hook is used with :context scope (Phil Pirozhkov, #2687)
• Prevent invalid implementations of Exception#cause from being treated as a valid cause (and causing strange errors) in RSpec::Core::Formatters::ExceptionPresenter. (Jon Rowe, #2703)
• Correctly detect patterns when rspec_opts is an array in RSpec::Core::RakeTask. (Marc-André Lafortune, #2704)
• Make RSpec.clear_examples reset example counts for example groups. This fixes an issue with re-running specs not matching ids. (Agis Anastasopoulos, #2723)

3.9.1 / 2019-12-28

Full Changelog

Bug Fixes:

• Prevent bisect command from blocking when number of specs exceeds file descriptor limit on OSX or Linux. (Benoit Tigeot, #2669)
• Prevent warnings being issued on Ruby 2.7.0. (Jon Rowe, #2680)

3.9.0 / 2019-10-07

Full Changelog

Enhancements:

• Improve the handling of errors during loading support files, if a file errors before loading specs, RSpec will now skip loading the specs. (David Rodríguez, #2568)
• Add support for --example-matches to run examples by regular expression. (Sam Joseph, Matt Rider, @okothkongo1, #2586)
• Add did_you_mean suggestions for file names encountering a LoadError outside of examples. (@obromios, #2601)
• Add a minimalist quick fix style formatter, only outputs failures as file:line:message. (Romain Tartière, #2614)
• Convert string number values to integer when used for RSpec::Configuration#fail_fast (Viktor Fonic, #2634)
• Issue warning when invalid values are used for RSpec::Configuration#fail_fast (Viktor Fonic, #2634)
• Add support for running the Rake task in a clean environment. (Jon Rowe, #2632)
• Indent messages by there example group / example in the documentation formatter. (Samuel Williams, #2649)

3.8.2 / 2019-06-29

Full Changelog

Bug Fixes:

• Fix config.define_derived_metadata so that cascades are not triggered until metadata has been assigned to the example or example group (Myron Marston, #2635).

3.8.1 / 2019-06-13

Full Changelog

Bug Fixes:

• Handle RSpec description(s) with japanese chars in CP932 encoded files. (Benoit Tigeot, #2575)
• When defining let methods that overwrite an existing method, prevent a warning being issued by removing the old definition. (Jon Rowe, #2593)
• Prevent warning on Ruby 2.6.0-rc1 (Keiji Yoshimi, #2582)
• Fix config.define_derived_metadata so that it supports cascades. (Myron Marston, #2630).

3.8.0 / 2018-08-04

Full Changelog

Enhancements:

• Improve shell escaping used by RSpec::Core::RakeTask and --bisect so that it works on Pathname objects. (Andrew Vit, #2479)
• Nicely format errors encountered while loading files specified by --require option. (Myron Marston, #2504)
• Significantly improve the performance of --bisect on platforms that support forking by replacing the shell-based runner with one that uses forking so that RSpec and the application environment can be booted only once, instead of once per spec run. (Myron Marston, #2511)
• Provide a configuration API to pick which bisect runner is used for --bisect. Pick a runner via config.bisect_runner = :shell or config.bisect_runner = :fork in a file loaded by a --require option passed at the command line or set in .rspec. (Myron Marston, #2511)
• Support the XDG Base Directory Specification for the global options file. ~/.rspec is still supported when no options file is found in $XDG_CONFIG_HOME/rspec/options (Magnus Bergmark, #2538)
• Extract RSpec.world.prepare_example_filtering that sets up the example filtering for custom RSpec runners. (Oleg Pudeyev, #2552)

Bug Fixes:

• Prevent an ArgumentError when truncating backtraces with two identical backtraces. (Systho, #2515, Benoit Tigeot, #2539)

3.7.1 / 2018-01-02

Full Changelog

Bug Fixes:

• Work around duplicate config hook regression introduced by Ruby 2.5's lazy proc allocation. (Myron Marston, #2497)

3.7.0 / 2017-10-17

Full Changelog

Enhancements:

• Add -n alias for --next-failure. (Ian Ker-Seymer, #2434)
• Improve compatibility with --enable-frozen-string-literal option on Ruby 2.3+. (Pat Allan, #2425, #2427, #2437)
• Do not run :context hooks for example groups that have been skipped. (Devon Estes, #2442)
• Add errors_outside_of_examples_count to the JSON formatter. (Takeshi Arabiki, #2448)

Bug Fixes:

• Improve compatibility with frozen string literal flag. (#2425, Pat Allan)

3.6.0 / 2017-05-04

Full Changelog

Enhancements:

• Add seed information to JSON formatter output. (#2388, Mitsutaka Mimura)
• Include example id in the JSON formatter output. (#2369, Xavier Shay)
• Respect changes to config.output_stream after formatters have been setup. (#2401, #2419, Ilya Lavrov)

Bug Fixes:

• Delay formatter loading until the last minute to allow accessing the reporter without triggering formatter setup. (Jon Rowe, #2243)
• Ensure context hook failures running before an example can access the reporter. (Jon Jensen, #2387)
• Multiple fixes to allow using the runner multiple times within the same process: RSpec.clear_examples resets the formatter and no longer clears shared examples, and streams can be used across multiple runs rather than being closed after the first. (#2368, Xavier Shay)
• Prevent unexpected example_group_finished notifications causing an error. (#2396, VTJamie)
• Fix bugs where config.when_first_matching_example_defined hooks would fire multiple times in some cases. (Yuji Nakayama, #2400)
• Default last_run_status to "unknown" when the status field in the persistence file contains an unrecognized value. (#2360, matrinox)
• Prevent let from defining an initialize method. (#2414, Jon Rowe)

3.6.0.beta2 / 2016-12-12

Full Changelog

Enhancements:

• Include count of errors occurring outside examples in default summaries. (#2351, Jon Rowe)
• Warn when including shared example groups recursively. (#2356, Jon Rowe)
• Improve failure snippet syntax highlighting with CodeRay to highlight RSpec "keywords" like expect. (#2358, Myron Marston)

3.6.0.beta1 / 2016-10-09

Full Changelog

Enhancements:

• Warn when duplicate shared examples definitions are loaded due to being defined in files matching the spec pattern (e.g. _spec.rb) (#2278, Devon Estes)
• Improve metadata filtering so that it can match against any object that implements === instead of treating regular expressions as special. (Myron Marston, #2294)
• Improve rspec -v so that it prints out the versions of each part of RSpec to prevent confusion. (Myron Marston, #2304)
• Add config.fail_if_no_examples option which causes RSpec to fail if no examples are found. (Ewa Czechowska, #2302)
• Nicely format errors encountered while loading spec files. (Myron Marston, #2323)
• Improve the API for enabling and disabling color output (Josh Justice, #2321):
  • Automatically enable color if the output is a TTY, since color is nearly always desirable if the output can handle it.
  • Introduce new CLI flag to force color on (--force-color), even if the output is not a TTY. --no-color continues to work as well.
  • Introduce config.color_mode for configuring the color from Ruby. :automatic is the default and will produce color if the output is a TTY. :on forces it on and :off forces it off.

3.5.4 / 2016-09-30

Full Changelog

Bug Fixes:

• Remove accumulated ExampleGroup constants when reseting RSpec, preventing a memory leak. (TravisSpangle, #2328)

3.5.3 / 2016-09-02

Full Changelog

Bug Fixes:

• When applying shared group metadata to a host group, overwrite conflicting keys if the value in the host group was inherited from a parent group instead of being specified at that level. (Myron Marston, #2307)
• Handle errors in :suite hooks and provide the same nicely formatted output as errors that happen in examples. (Myron Marston, #2316)
• Set the exit status to non-zero when an error occurs in an after(:context) hook. (Myron Marston, #2320)

3.5.2 / 2016-07-28

Full Changelog

Bug Fixes:

• Wait to report example_finished until the example's execution_result has been completely filled in. (Myron Marston, #2291)
• Make sure example block is still available when using duplicate_with to clone examples. (bootstraponline, #2298)
• Don't include the default --pattern in the Rake task when rspec_opts specifies its own. (Jon Rowe, #2305)

3.5.1 / 2016-07-06

Full Changelog

Bug Fixes:

• Ensure that config hooks that are added to existing example groups are added only once. (Eugene Kenny, #2280)

3.5.0 / 2016-07-01

Full Changelog

Enhancements:

• Include any SPEC_OPTS in reproduction command printed at the end of a bisect run. (Simon Coffey, #2274)

Bug Fixes:

• Handle --bisect in SPEC_OPTS environment variable correctly so as to avoid infinite recursion. (Simon Coffey, #2271)

3.5.0.beta4 / 2016-06-05

Full Changelog

Enhancements:

• Filter out bundler stackframes from backtraces by default, since Bundler 1.12 now includes its own frames in stack traces produced by using bundle exec. (Myron Marston, #2240)
• HTML Formatter uses exception presenter to get failure message for consistency with other formatters. (@mrageh, #2222)
• Load spec files in the order of the directories or files passed at the command line, making it easy to make some specs run before others in a one-off manner. For example, rspec spec/unit spec/acceptance --order defined will run unit specs before acceptance specs. (Myron Marston, #2253)
• Add new config.include_context API for configuring global or filtered inclusion of shared contexts in example groups. (Myron Marston, #2256)
• Add new config.shared_context_metadata_behavior = :apply_to_host_groups option, which causes shared context metadata to be inherited by the metadata hash of all host groups and examples instead of configuring implicit auto-inclusion based on the passed metadata. (Myron Marston, #2256)

Bug Fixes:

• Fix --bisect so it works on large spec suites that were previously triggering "Argument list too long errors" due to all the spec locations being passed as CLI args. (Matt Jones, #2223).
• Fix deprecated :example_group-based filtering so that it properly applies to matching example groups. (Myron Marston, #2234)
• Fix NoMethodError caused by Java backtraces on JRuby. (Michele Piccirillo, #2244)

3.5.0.beta3 / 2016-04-02

Full Changelog

Enhancements:

• Add new config.filter_run_when_matching API, intended to replace the combination of config.filter_run and config.run_all_when_everything_filtered (Myron Marston, #2206)

Bug Fixes:

• Use the encoded string logic for source extraction. (Jon Rowe, #2183)
• Fix rounding issue in duration formatting helper. (Fabersky, Jon Rowe, #2208)
• Fix failure snippet extraction so that def-end snippets ending with end-only line can be extracted properly. (Yuji Nakayama, #2215)

3.5.0.beta2 / 2016-03-10

Full Changelog

Enhancements:

• Remove unneeded :execution_result example group metadata, saving a bit of memory. (Myron Marston, #2172)
• Apply hooks registered with config to previously defined groups. (Myron Marston, #2189)
• RSpec::Core::Configuration#reporter is now public API under SemVer. (Jon Rowe, #2193)
• Add new config.when_first_matching_example_defined hook. (Myron Marston, #2175)

3.5.0.beta1 / 2016-02-06

Full Changelog

Enhancements:

• Add RSpec::Core::ExampleGroup.currently_executing_a_context_hook?, primarily for use by rspec-rails. (Sam Phippen, #2131)

Bug Fixes:

• Ensure MultipleExceptionError does not contain a recursive reference to itself. (Sam Phippen, #2133)

3.4.4 / 2016-03-09

Full Changelog

Bug Fixes:

• Fix RSpec::Core::RakeTask so that it works with Rake 11. (Travis Grathwell, #2197)

3.4.3 / 2016-02-19

Full Changelog

Bug Fixes:

• Prevent a TypeError from occurring when running via the rake task when Ruby crashes. (Patrik Wenger, #2161)
• Only consider example and group declaration lines from a specific file when applying line number filtering, instead of considering all declaration lines from all spec files. (Myron Marston, #2170)
• Fix failure snippet extraction so that snippets that contain do-end style block and end with end-only line can be extracted properly. (Yuji Nakayama, #2173)
• Prevent infinite recursion when an exception is caused by itself. (Jon Rowe, #2128)

3.4.2 / 2016-01-26

Full Changelog

Bug Fixes:

• Fix rspec --profile when an example calls abort or exit. (Bradley Schaefer, #2144)
• Fix --drb so that when no DRb server is running, it prevents the DRb connection error from being listed as the cause of all expectation failures. (Myron Marston, #2156)
• Fix syntax highlighter so that it works when the coderay gem is installed as a rubygem but not already available on your load path (as happens when you use bundler). (Myron Marston, #2159)

3.4.1 / 2015-11-18

Full Changelog

Bug Fixes:

• Fix backtrace formatter to handle backtraces that are nil. (Myron Marston, #2118)

3.4.0 / 2015-11-11

Full Changelog

Enhancements:

• Combine multiple --pattern arguments making them equivalent to --pattern=1,2,...,n. (Jon Rowe, #2002)
• Improve inspect and to_s output for RSpec::Core::Example objects, replacing Ruby's excessively verbose output. (Gavin Miller, #1922)
• Add silence_filter_announcements configuration option. (David Raffensperger, #2007)
• Add optional example_finished notification to the reporter protocol for when you don't care about the example outcome. (Jon Rowe, #2013)
• Switch --bisect to a recursion-based bisection algorithm rather than a permutation-based one. This better handles cases where an example depends upon multiple other examples instead of just one and minimizes the number of runs necessary to determine that an example set cannot be minimized further. (Simon Coffey, #1997)
• Allow simple filters (e.g. :symbol key only) to be triggered by truthey values. (Tim Mertens, #2035)
• Remove unneeded warning about need for ansicon on Windows when using RSpec's --color option. (Ashley Engelund, #2038)
• Add option to configure RSpec to raise errors when issuing warnings. (Jon Rowe, #2052)
• Append the root cause of a failure or error to the printed failure output when a cause is available. (Adam Magan)
• Stop rescuing NoMemoryError, SignalExcepetion, Interrupt and SystemExit. It is dangerous to interfere with these. (Myron Marston, #2063)
• Add config.project_source_dirs setting which RSpec uses to determine if a backtrace line comes from your project source or from some external library. It defaults to spec, lib and app but can be configured differently. (Myron Marston, #2088)
• Improve failure line detection so that it looks for the failure line in any project source directory instead of just in the spec file. In addition, if no backtrace lines can be found from a project source file, we fall back to displaying the source of the first backtrace line. This should virtually eliminate the "Unable to find matching line from backtrace" messages. (Myron Marston, #2088)
• Add support for :extra_failure_lines example metadata that will be appended to the failure output. (bootstraponline, #2092).
• Add RSpec::Core::Example#duplicate_with to produce new examples with cloned metadata. (bootstraponline, #2098)
• Add RSpec::Core::Configuration#on_example_group_definition to register hooks to be invoked when example groups are created. (bootstraponline, #2094)
• Add add_example and remove_example to RSpec::Core::ExampleGroup to allow manipulating an example groups examples. (bootstraponline, #2095)
• Display multiline failure source lines in failure output when Ripper is available (MRI >= 1.9.2, and JRuby >= 1.7.5 && < 9.0.0.0.rc1). (Yuji Nakayama, #2083)
• Add max_displayed_failure_line_count configuration option (defaults to 10). (Yuji Nakayama, #2083)
• Enhance fail_fast option so it can take a number (e.g. --fail-fast=3) to force the run to abort after the specified number of failures. (Jack Scotti, #2065)
• Syntax highlight the failure snippets in text formatters when color is enabled and the coderay gem is installed on a POSIX system. (Myron Marston, #2109)

Bug Fixes:

• Lock example_status_persistence_file when reading from and writing to it to prevent race conditions when multiple processes try to use it. (Ben Woosley, #2029)
• Fix regression in 3.3 that caused spec file names with square brackets in them (such as 1[]_spec.rb) to not be loaded properly. (Myron Marston, #2041)
• Fix output encoding issue caused by ASCII literal on 1.9.3 (Jon Rowe, #2072)
• Fix requires in rspec/core/rake_task.rb to avoid double requires seen by some users. (Myron Marston, #2101)

3.3.2 / 2015-07-15

Full Changelog

Bug Fixes:

• Fix formatters to handle exceptions for which backtrace returns nil. (Myron Marston, #2023)
• Fix duplicate formatter detection so that it allows subclasses of formatters to be added. (Sebastián Tello, #2019)

3.3.1 / 2015-06-18

Full Changelog

Bug Fixes:

• Correctly run before(:suite) (and friends) in the context of an example group instance, thus making the expected RSpec environment available. (Jon Rowe, #1986)

3.3.0 / 2015-06-12

Full Changelog

Enhancements:

• Expose the reporter used to run examples via RSpec::Core::Example#reporter. (Jon Rowe, #1866)
• Make RSpec::Core::Reporter#message a public supported API. (Jon Rowe, #1866)
• Allow custom formatter events to be published via RSpec::Core::Reporter#publish(event_name, hash_of_attributes). (Jon Rowe, #1869)
• Remove dependency on the standard library Set and replace with RSpec::Core::Set. (Jon Rowe, #1870)
• Assign a unique id to each example and group so that they can be uniquely identified, even for shared examples (and similar situations) where the location isn't unique. (Myron Marston, #1884)
• Use the example id in the rerun command printed for failed examples when the location is not unique. (Myron Marston, #1884)
• Add config.example_status_persistence_file_path option, which is used to persist the last run status of each example. (Myron Marston, #1888)
• Add :last_run_status metadata to each example, which indicates what happened the last time an example ran. (Myron Marston, #1888)
• Add --only-failures CLI option which filters to only the examples that failed the last time they ran. (Myron Marston, #1888)
• Add --next-failure CLI option which allows you to repeatedly focus on just one of the currently failing examples, then move on to the next failure, etc. (Myron Marston, #1888)
• Make --order random ordering stable, so that when you rerun a subset with a given seed, the examples will be order consistently relative to each other. (Myron Marston, #1908)
• Set example group constant earlier so errors when evaluating the context include the example group name (Myron Marson, #1911)
• Make let and subject threadsafe. (Josh Cheek, #1858)
• Add version information into the JSON formatter. (Mark Swinson, #1883)
• Add --bisect CLI option, which will repeatedly run your suite in order to isolate the failures to the smallest reproducible case. (Myron Marston, #1917)
• For config.include, config.extend and config.prepend, apply the module to previously defined matching example groups. (Eugene Kenny, #1935)
• When invalid options are parsed, notify users where they came from (e.g. .rspec or ~/.rspec or ENV['SPEC_OPTS']) so they can easily find the source of the problem. (Myron Marston, #1940)
• Add pending message contents to the json formatter output. (Jon Rowe, #1949)
• Add shared group backtrace to the output displayed by the built-in formatters for pending examples that have been fixed. (Myron Marston, #1946)
• Add support for :aggregate_failures metadata. Tag an example or group with this metadata and it'll use rspec-expectations' aggregate_failures feature to allow multiple failures in an example and list them all, rather than aborting on the first failure. (Myron Marston, #1946)
• When no formatter implements #message add a fallback to prevent those messages being lost. (Jon Rowe, #1980)
• Profiling examples now takes into account time spent in before(:context) hooks. (Denis Laliberté, Jon Rowe, #1971)
• Improve failure output when an example has multiple exceptions, such as one from an it block and one from an after block. (Myron Marston, #1985)

Bug Fixes:

• Handle invalid UTF-8 strings within exception methods. (Benjamin Fleischer, #1760)
• Fix Rake Task quoting of file names with quotes to work properly on Windows. (Myron Marston, #1887)
• Fix RSpec::Core::RakeTask#failure_message so that it gets printed when the task failed. (Myron Marston, #1905)
• Make let work properly when defined in a shared context that is applied to an individual example via metadata. (Myron Marston, #1912)
• Ensure rspec/autorun respects configuration defaults. (Jon Rowe, #1933)
• Prevent modules overriding example group defined methods when included, prepended or extended by config defined after an example group. (Eugene Kenny, #1935)
• Fix regression which caused shared examples to be mistakenly run when specs where filtered to a particular location. (Ben Axnick, #1963)
• Fix time formatting logic so that it displays 70 seconds as "1 minute, 10 seconds" rather than "1 minute, 1 second". (Paul Brennan, #1984)
• Fix regression where the formatter loader would allow duplicate formatters. (Jon Rowe, #1990)

3.2.3 / 2015-04-06

Full Changelog

Bug Fixes:

• Fix how the DSL methods are defined so that RSpec is compatible with gems that define methods of the same name on Kernel (such as the its-it gem). (Alex Kwiatkowski, Ryan Ong, #1907)
• Fix before(:context) { skip } so that it does not wrongly cause the spec suite to exit with a non-zero status when no examples failed. (Myron Marston, #1926)

3.2.2 / 2015-03-11

Full Changelog

Bug Fixes:

• Fix regression in 3.2.0 that allowed tag-filtered examples to run even if there was a location filter applied to the spec file that was intended to limit the file to other examples. (#1894, Myron Marston)

3.2.1 / 2015-02-23

Full Changelog

Bug Fixes:

• Notify start-of-run seed before start notification rather than after so that formatters like Fuubar work properly. (Samuel Esposito, #1882)

3.2.0 / 2015-02-03

Full Changelog

Enhancements:

• Improve the inspect output of example groups. (Mike Dalton, #1687)
• When rake task fails, only output the command if verbose flag is set. (Ben Snape, #1704)
• Add RSpec.clear_examples as a clear way to reset examples in between spec runs, whilst retaining user configuration. (Alexey Fedorov, #1706)
• Reduce string allocations when defining and running examples by 70% and 50% respectively. (Myron Marston, #1738)
• Removed dependency on pathname from stdlib. (Sam Phippen, #1703)
• Improve the message presented when a user hits Ctrl-C. (Alex Chaffee #1717, #1742)
• Improve shared example group inclusion backtrace displayed in failed example output so that it works for all methods of including shared example groups and shows all inclusion locations. (Myron Marston, #1763)
• Issue seed notification at start (as well as the end) of the reporter run. (Arlandis Word, #1761)
• Improve the documentation of around hooks. (Jim Kingdon, #1772)
• Support prepending of modules into example groups from config and allow filtering based on metadata. (Arlandis Word, #1806)
• Emit warnings when :suite hooks are registered on an example group (where it has always been ignored) or are registered with metadata (which has always been ignored). (Myron Marston, #1805)
• Provide a friendly error message when users call RSpec example group APIs (e.g. context, describe, it, let, before, etc) from within an example where those APIs are unavailable. (Myron Marston, #1819)
• Provide a friendly error message when users call RSpec example APIs (e.g. expect, double, stub_const, etc) from within an example group where those APIs are unavailable. (Myron Marston, #1819)
• Add new RSpec::Core::Sandbox.sandboxed { } API that facilitates testing RSpec with RSpec, allowing you to define example groups and example from within an example without affecting the global RSpec.world state. (Tyler Ball, 1808)
• Apply line-number filters only to the files they are scoped to, allowing you to mix filtered and unfiltered files. (Myron Marston, #1839)
• When dumping pending examples, include the failure details so that you don't have to un-pend the example to see it. (Myron Marston, #1844)
• Make -I option support multiple values when separated by File::PATH_SEPARATOR, such as rspec -I foo:bar. This matches the behavior of Ruby's -I option. (Fumiaki Matsushima, #1855).
• Treat each example as having a singleton example group for the purposes of applying metadata-based features that normally apply to example groups to individually tagged examples. For example, RSpec.shared_context "Uses redis", :uses_redis will now apply to individual examples tagged with :uses_redis, as will config.include RedisHelpers, :uses_redis, and config.before(:context, :uses_redis) { }, etc. (Myron Marston, #1749)

Bug Fixes:

• When assigning generated example descriptions, surface errors raised by matcher.description in the example description. (Myron Marston, #1771)
• Don't consider expectations from after hooks when generating example descriptions. (Myron Marston, #1771)
• Don't apply metadata-filtered config hooks to examples in groups with matching metadata when those examples override the parent metadata value to not match. (Myron Marston, #1796)
• Fix config.expect_with :minitest so that skip uses RSpec's implementation rather than Minitest's. (Jonathan Rochkind, #1822)
• Fix NameError caused when duplicate example group aliases are defined and the DSL is not globally exposed. (Aaron Kromer, #1825)
• When a shared example defined in an external file fails, use the host example group (from a loaded spec file) for the re-run command to ensure the command will actually work. (Myron Marston, #1835)
• Fix location filtering to work properly for examples defined in a nested example group within a shared example group defined in an external file. (Bradley Schaefer, Xavier Shay, Myron Marston, #1837)
• When a pending example fails (as expected) due to a mock expectation, set RSpec::Core::Example::ExecutionResult#pending_exception -- previously it was not being set but should have been. (Myron Marston, #1844)
• Fix rake task to work when rspec-core is installed in a directory containing a space. (Guido Günther, #1845)
• Fix regression in 3.1 that caused describe Regexp to raise errors. (Durran Jordan, #1853)
• Fix regression in 3.x that caused the profile information to be printed after the summary. (Max Lincoln, #1857)
• Apply --seed before loading --require files so that required files can access the provided seed. (Myron Marston, #1745)
• Handle RSpec::Core::Formatters::DeprecationFormatter::FileStream being reopened with an IO stream, which sometimes happens with spring. (Kevin Mook, #1757)

3.1.7 / 2014-10-11

Full Changelog

Bug Fixes:

• Fix Metadata.relative_path so that for a current directory of /foo/bar, /foo/bar_1 is not wrongly converted to ._1. (Akos Vandra, #1730)
• Prevent constant lookup mistakenly finding RSpec::ExampleGroups generated constants on 1.9.2 by appending a trailing _ to the generated names. (Jon Rowe, #1737)
• Fix bug in :pending metadata. If it got set in any way besides passing it as part of the metadata literal passed to it (such as by using define_derived_metadata), it did not have the desired effect, instead marking the example as :passed. (Myron Marston, #1739)

3.1.6 / 2014-10-08

Full Changelog

Bug Fixes:

• Fix regression in rake task pattern handling, that prevented patterns that were relative from the current directory rather than from spec from working properly. (Myron Marston, #1734)
• Prevent rake task from generating duplicate load path entries. (Myron Marston, #1735)

3.1.5 / 2014-09-29

Full Changelog

Bug Fixes:

• Fix issue with the rake task incorrectly escaping strings on Windows. (Jon Rowe #1718)
• Support absolute path patterns. While this wasn't officially supported previously, setting rake_task.pattern to an absolute path pattern in RSpec 3.0 and before worked since it delegated to FileList internally (but now just forwards the pattern on to the rspec command). (Myron Marston, #1726)

3.1.4 / 2014-09-18

Full Changelog

Bug Fixes:

• Fix implicit subject when using describe false or describe nil so that it returns the provided primitive rather than the string representation. (Myron Marston, #1710)
• Fix backtrace filtering to allow code in subdirectories of your current working directory (such as vendor/bundle/...) to be filtered from backtraces. (Myron Marston, #1708)

3.1.3 / 2014-09-15

Full Changelog

Bug Fixes:

• Fix yet another regression in rake task pattern handling, to allow task.pattern = FileList["..."] to work. That was never intended to be supported but accidentally worked in 3.0 and earlier. (Myron Marston, #1701)
• Fix pattern handling so that files are normalized to absolute paths before subtracting the --exclude-pattern matched files from the --pattern matched files so that it still works even if the patterns are in slightly different forms (e.g. one starting with ./). (Christian Nelson, #1698)

3.1.2 / 2014-09-08

Full Changelog

Bug Fixes:

• Fix another regression in rake task pattern handling, so that patterns that start with ./ still work. (Christian Nelson, #1696)

3.1.1 / 2014-09-05

Full Changelog

Bug Fixes:

• Fix a regression in rake task pattern handling, so that rake_task.pattern = array works again. While we never intended to support array values (or even knew that worked!), the implementation from 3.0 and earlier used FileList internally, which allows arrays. The fix restores the old behavior. (Myron Marston, #1694)

3.1.0 / 2014-09-04

Full Changelog

Enhancements:

• Update files generated by rspec --init so that warnings are enabled in commented out section of spec_helper rather than .rspec so users have to consciously opt-in to the setting. (Andrew Hooker, #1572)
• Update spec_helper generated by rspec --init so that it sets the new rspec-expectations include_chain_clauses_in_custom_matcher_descriptions config option (which will be on by default in RSpec 4) and also sets the rspec-mocks verify_partial_doubles option (which will also default to on in RSpec 4). (Myron Marston, #1647)
• Provide an inspect output for example procsy objects (used in around hooks) that doesn't make them look like procs. (Jon Rowe, #1620)
• Remove a few unneeded require statements from rspec/core/rake_task.rb, making it even more lighterweight. (Myron Marston, #1640)
• Allow rspec-core to be used when neither rspec-mocks or rspec-expectations are installed, without requiring any user configuration. (Sam Phippen, Myron Marston, #1615)
• Don't filter out gems from backtraces by default. (The RSpec gems will still be filtered). User feedback has indicated that including gems in default backtraces will be useful. (Myron Marston, #1641)
• Add new config.filter_gems_from_backtrace "rack", "rake" API to easily filter the named gems from backtraces. (Myron Marston, #1682)
• Fix default backtrace filters so that the RSpec binary is excluded when installing RSpec as a bundler :git dependency. (Myron Marston, #1648)
• Simplify command generated by the rake task so that it no longer includes unnecessary -S. (Myron Marston, #1559)
• Add --exclude-pattern CLI option, config.exclude_pattern = config option and task.exclude_pattern = rake task config option. Matching files will be excluded. (John Gesimondo, Myron Marston, #1651, #1671)
• When an around hook fails to execute the example, mark it as pending (rather than passing) so the user is made aware of the fact that the example did not actually run. (Myron Marston, #1660)
• Remove dependency on FileUtils from the standard library so that users do not get false positives where their code relies on it but they are not requiring it. (Sam Phippen, #1565)

Bug Fixes:

• Fix rake task t.pattern = option so that it does not run all specs when it matches no files, by passing along a --pattern option to the rspec command, rather than resolving the file list and passing along the files individually. (Evgeny Zislis, #1653)
• Fix rake task default pattern so that it follows symlinks properly. (Myron Marston, #1672)
• Fix default pattern used with rspec command so that it follows symlinks properly. (Myron Marston, #1672)
• Change how we assign constant names to example group classes so that it avoids a problem with describe "Core". (Daniela Wellisz, #1679)
• Handle rendering exceptions that have a different encoding than that of their original source file. (Jon Rowe, #1681)
• Allow access to message_lines without colour for failed examples even when they're part of a shared example group. (tomykaira, #1689)

3.0.4 / 2014-08-14

Full Changelog

Bug Fixes:

• Fix processing order of CLI options so that if config.files_to_run is accessed from a file loaded by --require, --pattern is still applied. (Myron Marston, #1652)
• Fix config.pattern= so that it still takes affect even if config.files_to_run has already been accessed. (Myron Marston, #1652)

3.0.3 / 2014-07-21

Full Changelog

Bug Fixes:

• Properly convert both parts of a description into strings before concatenation. (@nicklink483, #1636)
• Exclude the working directory when figuring out folders to ignore. (Jon Rowe, Myron Marston, #1616)
• Allow ::RSpec::Core::Notifications::FailedExampleNotification#message_lines to be accessed without a colouriser. (@tomykaira, #1637)

3.0.2 / 2014-06-19

Full Changelog

Bug Fixes:

• Fix regression in CLI option handling that prevented --tag slow passed at the command line from overriding --tag ~slow in .rspec. (Colin Jones, #1602)
• Fix metadata :example_group deprecation warning so that it gets issued at the call site of the configuration that specified it as a filter rather than later when an example group is defined. (Myron Marston, #1562)
• Make the line that is printed when a shared example group fails indicating where the concrete example group is white, separating it from the stack trace that is produced for the failure. (Sam Phippen, Jon Rowe, #1606)

3.0.1 / 2014-06-12

Full Changelog

Bug Fixes:

• Fix a couple ruby warnings caused by rspec-core when loaded. (Prem Sichanugrist, #1584)
• Example groups named Config will no longer cause a Ruby warning to be issued. (Jimmy Cuadra, #1580)

3.0.0 / 2014-06-01

Full Changelog

Bug Fixes:

• Fix BaseTextFormatter so that it does not re-close a closed output stream. (Myron Marston)
• Fix regression in metadata that caused the metadata hash of a top-level example group to have a :parent_example_group key even though it has no parent example group. (Myron Marston)

Enhancements:

• Alter the default spec_helper.rb to no longer recommend config.full_backtrace = true see #1536 for discussion. (Jon Rowe)

3.0.0.rc1 / 2014-05-18

Full Changelog

Breaking Changes for 3.0.0:

• Change described_class so that in a nested group like describe MyClass, it returns MyClass rather than the outer group's described class. (Myron Marston)
• Refactor filter manager so that it no longer subclasses Hash and has a tighter, more domain-specific interface. (Sergey Pchelincev)
• Remove legacy colours definitions from BaseTextFormatter. (Jon Rowe)
• Remove console color definitions from BaseTextFormatter. (Jon Rowe)
• Restructure example group metadata so that the computed keys are exposed directly off of the metadata hash rather than being on a nested :example_group subhash. In addition, the parent example group metadata is now available as [:parent_example_group] rather than [:example_group][:example_group]. Deprecated access via the old key structure is still provided. (Myron Marston)
• Remove :describes metadata key. It duplicates :described_class for no good reason. Deprecated access via :describes is still provided. (Myron Marston)
• Rename :example_group_block metadata key to :block. (Myron Marston)
• Remove deprecated RSpec::Core::Example#options. (Myron Marston)
• Move BaseTextFormatter#colorize_summary to SummaryNotification#colorize_with (Jon Rowe).
• describe some_hash treated some_hash as metadata in RSpec 2.x but will treat it as the described object in RSpec 3.0. Metadata must always come after the description args. (Myron Marston)
• Remove deprecated display_name alias of ExampleGroup.description. (Myron Marston)
• Remove deprecated describes alias of ExampleGroup.described_class. (Myron Marston)
• Remove deprecated RSpec::Core::ExampleGroup.alias_it_behaves_like_to. Use RSpec::Core::Configuration#alias_it_behaves_like_to instead. (Myron Marston)
• Remove deprecated RSpec::Core::ExampleGroup.alias_example_to. Use RSpec::Core::Configuration#alias_example_to instead. (Myron Marston)
• Removed focused example alias and change example/group aliases fit, focus, fcontext and fdescribe to no longer include :focused => true metadata. They only contain :focus => true metadata now. This means that you will need to filter them with filter_run :focus, not filter_run :focused. (Myron Marston)
• Remove --line-number filtering. It's semantically dubious since it's a global filter (potentially applied to multiple files) but there's no meaningful connection between the same line number in multiple files. Instead use the rspec path/to/spec.rb:23:46 form, which is terser and makes more sense as it is scoped to a file. (Myron Marston)
• Remove --default_path as an alias for --default-path. (Jon Rowe)
• Remove deprecated share_examples_for. There's still shared_examples and shared_examples_for. (Myron Marston)
• Rename RSpec::Core::Configuration#warnings to RSpec::Core::Configuration#warnings? since it's a boolean flag. (Myron Marston)
• RSpec's global state is no longer reset after a spec run. This gives more flexibility to alternate runners to decide when and if they want the state reset. Alternate runners are now responsible for calling this (or doing a similar reset) if they are going to run the spec suite multiple times in the same process. (Sam Phippen)
• Merge RSpec::Core::CommandLine (never formally declared public) into RSpec::Core::Runner. (Myron Marston)
• Remove color_enabled as an alias of color. (Jon Rowe)
• Remove backtrace_cleaner as an alias of backtrace_formatter. (Jon Rowe)
• Remove filename_pattern as an alias of pattern. (Jon Rowe)
• Extract support for legacy formatters to rspec-legacy_formatters. (Jon Rowe)
• RSpec::Configuration#formatters now returns a dup to prevent mutation. (Jon Rowe)
• Replace stdlib as an available expectation framework with test_unit and minitest. (Aaron Kromer)
• Remove backtrace formatting helpers from BaseTextFormatter. (Jon Rowe)
• Extract profiler support to ProfileFormatter and ProfileNotification. Formatters should implement dump_profile if they wish to respond to --profile. (Jon Rowe)
• Extract remaining formatter state to reporter and notifications. Introduce ExamplesNotification to share information about examples that was previously held in BaseFormatter. (Jon Rowe)

Enhancements:

• Add config.default_formatter attribute, which can be used to set a formatter which will only be used if no other formatter is set (e.g. via --formatter). (Myron Marston)
• Support legacy colour definitions in LegacyFormatterAdaptor. (Jon Rowe)
• Migrate execution_result (exposed by metadata) from a hash to a first-class object with appropriate attributes. status is now stored and returned as a symbol rather than a string. It retains deprecated hash behavior for backwards compatibility. (Myron Marston)
• Provide console code helper for formatters. (Jon Rowe)
• Use raw ruby hashes for the metadata hashes rather than a subclass of a hash. Computed metadata entries are now computed in advance rather than being done lazily on first access. (Myron Marston)
• Add :block metadata entry to the example metadata, bringing parity with :block in the example group metadata. (Myron Marston)
• Add fspecify and fexample as aliases of specify and example with :focus => true metadata for parity with fit. (Myron Marston)
• Add legacy support for colorize_summary. (Jon Rowe)
• Restructure runner so it can be more easily customized in a subclass for an alternate runner. (Ben Hoskings)
• Document RSpec::Core::ConfigurationOptions as an officially supported public API. (Myron Marston)
• Add --deprecation-out CLI option which directs deprecation warnings to the named file. (Myron Marston)
• Minitest 5 compatability for expect_with :stdlib (now available as expect_with :minitest). (Xavier Shay)
• Reporter now notifies formatters of the load time of RSpec and your specs via StartNotification and SummaryNotification. (Jon Rowe)
• Add disable_monkey_patching! config option that disables all monkey patching from whatever pieces of RSpec you use. (Alexey Fedorov)
• Add Pathname support for setting all output streams. (Aaron Kromer)
• Add config.define_derived_metadata, which can be used to apply additional metadata to all groups or examples that match a given filter. (Myron Marston)
• Provide formatted and colorized backtraces via FailedExampleNotification and send PendingExampleFixedNotifications when the error is due to a passing spec you expect to fail. (Jon Rowe)
• Add dump_profile to formatter API to allow formatters to implement support for --profile. (Jon Rowe)
• Allow colourising text via ConsoleCodes with RSpec 'states' (e.g. :success, :failure) rather than direct colour codes. (Jon Rowe)
• Expose fully_formatted methods off the formatter notification objects that make it easy for a custom formatter to produce formatted output like rspec-core's. (Myron Marston)

Bug Fixes:

• Fix spec_helper.rb file generated by rspec --init so that the recommended settings correctly use the documentation formatter when running one file. (Myron Marston)
• Fix ordering problem where descriptions were generated after tearing down mocks, which resulted in unexpected exceptions. (Bradley Schaefer, Aaron Kromer, Andrey Savchenko)
• Allow a symbol to be used as an implicit subject (e.g. describe :foo). (Myron Marston)
• Prevent creating an isolated context (i.e. using RSpec.describe) when already inside a context. There is no reason to do this, and it could potentially cause unexpected bugs. (Xavier Shay)
• Fix shared example group scoping so that when two shared example groups share the same name at different levels of nested contexts, the one in the nearest context is used. (Myron Marston)
• Fix --warnings option so that it enables warnings immediately so that it applies to files loaded by --require. (Myron Marston)
• Issue a warning when you set config.deprecation_stream too late for it to take effect because the reporter has already been setup. (Myron Marston)
• Add the full RSpec::Core::Example interface to the argument yielded to around hooks. (Myron Marston)
• Line number always takes precendence when running specs with filters. (Xavier Shay)
• Ensure :if and :unless metadata filters are treated as a special case and are always in-effect. (Bradley Schaefer)
• Ensure the currently running installation of RSpec is used when the rake task shells out to rspec, even if a newer version is also installed. (Postmodern)
• Using a legacy formatter as default no longer causes an infinite loop. (Xavier Shay)

3.0.0.beta2 / 2014-02-17

Full Changelog

Breaking Changes for 3.0.0:

• Make mock_with option more strict. Strings are no longer supported (e.g. mock_with "mocha") -- use a symbol instead. Also, unrecognized values will now result in an error rather than falling back to the null mocking adapter. If you want to use the null mocking adapter, use mock_with :nothing (as has been documented for a long time). (Myron Marston)
• Remove support for overriding RSpec's built-in :if and :unless filters. (Ashish Dixit)
• Custom formatters are now required to call RSpec::Core::Formatters.register(formatter_class, *notifications) where notifications is the list of events the formatter wishes to be notified about. Notifications are handled by methods matching the names on formatters. This allows us to add or remove notifications without breaking existing formatters. (Jon Rowe)
• Change arguments passed to formatters. Rather than passing multiple arguments (which limits are ability to add additional arguments as doing so would break existing formatters), we now pass a notification value object that exposes the same data via attributes. This will allow us to add new bits of data to a notification event without breaking existing formatters. (Jon Rowe)
• Remove support for deprecated :alias option for RSpec.configuration.add_setting. (Myron Marston)
• Remove support for deprecated RSpec.configuration.requires = [...]. (Myron Marston)
• Remove support for deprecated --formatter CLI option. (Myron Marston)
• Remove support for deprecated --configure CLI option. (Myron Marston)
• Remove support for deprecated RSpec::Core::RakeTask#spec_opts=. (Myron Marston)
• An example group level pending block or :pending metadata now executes the example and cause a failure if it passes, otherwise it will be pending if it fails. The old "never run" behaviour is still used for xexample, xit, and xspecify, or via a new skip method or :skip metadata option. (Xavier Shay)
• After calling pending inside an example, the remainder of the example will now be run. If it passes a failure is raised, otherwise the example is marked pending. The old "never run" behaviour is provided a by a new skip method. (Xavier Shay)
• Pending blocks inside an example have been removed as a feature with no direct replacement. Use skip or pending without a block. (Xavier Shay)
• Pending statement is no longer allowed in before(:all) hooks. Use skip instead. (Xavier Shay)
• Remove show_failures_in_pending_blocks configuration option. (Xavier Shay)
• Remove support for specifying the documentation formatter using 's', 'n', 'spec' or 'nested'. (Jon Rowe)

Enhancements:

• Add example run time to JSON formatter output. (Karthik Kastury)
• Add more suggested settings to the files generated by rspec --init. (Myron Marston)
• Add config.alias_example_group_to, which can be used to define a new method that defines an example group with the provided metadata. (Michi Huber)
• Add xdescribe and xcontext as shortcuts to skip an example group. (Myron Marston)
• Add fdescribe and fcontext as shortcuts to focus an example group. (Myron Marston)
• Don't autorun specs via #at_exit by default. require 'rspec/autorun' is only needed when running specs via ruby, as it always has been. Running specs via rake or rspec are both unaffected. (Ben Hoskings)
• Add expose_dsl_globally config option, defaulting to true. When disabled it will remove the monkey patches rspec-core adds to main and Module (e.g. describe, shared_examples_for, etc). (Jon Rowe)
• Expose RSpec DSL entry point methods (describe, shared_examples_for, etc) on the RSpec constant. Intended for use when expose_dsl_globally is set to false. (Jon Rowe)
• For consistency, expose all example group aliases (including context) on the RSpec constant. If expose_dsl_globally is set to true, also expose them on main and Module. Historically, only describe was exposed. (Jon Rowe, Michi Huber)
• Add hook scope :example as an alias for :each, and :context as an alias for :all. (John Feminella)

Bug Fixes:

• Fix failure (undefined method path) in end-of-run summary when raise_errors_for_deprecations! is configured. (Myron Marston)
• Issue error when attempting to use -i or --I on command line, too close to -I to be considered short hand for --init. (Jon Rowe)
• Prevent adding formatters to an output target if the same formatter has already been added to that output. (Alex Peattie)
• Allow a matcher-generated example description to be used when the example is pending. (Myron Marston)
• Ensure the configured failure_exit_code is used by the rake task when there is a failure. (Jon Rowe)
• Restore behaviour whereby system exclusion filters take priority over working directory (was broken in beta1). (Jon Rowe)
• Prevent RSpec mangling file names that have substrings containing line_number or default_path. (Matijs van Zuijlen)
• Fix failure line detection so that it handles relative file paths (which can happen when running specs through ruby using rspec/autorun). (Myron Marston, #1829)

3.0.0.beta1 / 2013-11-07

Full Changelog

Breaking Changes for 3.0.0:

• Remove explicit support for 1.8.6. (Jon Rowe)
• Remove RSpec::Core::ExampleGroup#example and RSpec::Core::ExampleGroup#running_example methods. If you need access to the example (e.g. to get its metadata), use a block arg instead. (David Chelimsky)
• Remove TextMateFormatter, it has been moved to rspec-tmbundle. (Aaron Kromer)
• Remove RCov integration. (Jon Rowe)
• Remove deprecated support for RSpec 1 constructs (Myron Marston):
  • The Spec and Rspec constants (rather than RSpec).
  • Spec::Runner.configure rather than RSpec.configure.
  • Rake::SpecTask rather than RSpec::Core::RakeTask.
• Remove deprecated support for share_as. (Myron Marston)
• Remove --debug option (and corresponding option on RSpec::Core::Configuration). Instead, use -r<debugger gem name> to load whichever debugger gem you wish to use (e.g. ruby-debug, debugger, or pry). (Myron Marston)
• Extract Autotest support to a seperate gem. (Jon Rowe)
• Raise an error when a let or subject declaration is accessed in a before(:all) or after(:all) hook. (Myron Marston)
• Extract its support to a separate gem. (Peter Alfvin)
• Disallow use of a shared example group from sibling contexts, making them fully isolated. 2.14 and 2.99 allowed this but printed a deprecation warning. (Jon Rowe)
• Remove RSpec::Core::Configuration#output and RSpec::Core::Configuration#out aliases of RSpec::Core::Configuration#output_stream. (Myron Marston)
• Remove legacy ordering APIs deprecated in 2.99.0.beta1. (Myron Marston)

Enhancements:

• Replace unmaintained syntax gem with coderay gem. (Xavier Shay)
• Times in profile output are now bold instead of failure_color. (Matthew Boedicker)
• Add --no-fail-fast command line option. (Gonzalo Rodríguez-Baltanás Díaz)
• Runner now considers the local system ip address when running under Drb. (Adrian CB)
• JsonFormatter now includes --profile information. (Alex / @MasterLambaster)
• Always treat symbols passed as metadata args as hash keys with true values. RSpec 2 supported this with the treat_symbols_as_metadata_keys_with_true_values but now this behavior is always enabled. (Myron Marston)
• Add --dry-run option, which prints the formatter output of your suite without running any examples or hooks. (Thomas Stratmann, Myron Marston)
• Document the configuration options and default values in the spec_helper.rb file that is generated by RSpec. (Parker Selbert)
• Give generated example group classes a friendly name derived from the docstring, rather than something like "Nested_2". (Myron Marston)
• Avoid affecting randomization of user code when shuffling examples so that users can count on their own seeds working. (Travis Herrick)
• Ordering is no longer a single global property of the test suite. Each group can pick an ordering using :order metadata. (Andy Lindeman, Sam Phippen, Myron Marston)
• Allow named custom ordering strategies to be registered, which can then be used on individual example groups. (Andy Lindeman, Sam Phippen, Myron Marston)

Deprecations:

• treat_symbols_as_metadata_keys_with_true_values is deprecated and no longer has an affect now that the behavior it enabled is always enabled. (Myron Marston)

2.99.2 / 2014-08-19

Full Changelog

Enhancements:

• Improve deprecation warning for RSpec 3 change in describe <a symbol> behavior. (Jon Rowe, #1667)

2.99.1 / 2014-06-19

Full Changelog

Bug Fixes:

• Add missing deprecation warning for when RSpec::Core::Runner is used multiple times in the same process. In 2.x RSpec's global state was automatically cleared between runs but in 3.0 you need to call RSpec.reset manually in these situations. (Sam Phippen, #1587)
• Prevent deprecation being accidentally issues when doubles used with be_ matchers due to automatically generated descriptions. (Jon Rowe, #1573)
• Load rspec/core when loading rspec/core/rake_task to ensure we can issue deprecations correctly. (Jon Rowe, #1612)

2.99.0 / 2014-06-01

Full Changelog

Bug Fixes:

• Fix BaseTextFormatter so that it does not re-close a closed output stream. (Myron Marston)
• Use RSpec::Configuration#backtrace_exclusion_patterns rather than the deprecated RSpec::Configuration#backtrace_clean_patterns when mocking with rr. (David Dollar)

2.99.0.rc1 / 2014-05-18

Full Changelog

Enhancements:

• Add --deprecation-out CLI option which directs deprecation warnings to the named file. (Myron Marston)
• Backport support for skip in metadata to skip execution of an example. (Xavier Shay, #1472)
• Add Pathname support for setting all output streams. (Aaron Kromer)
• Add test_unit and minitest expectation frameworks. (Aaron Kromer)

Deprecations:

• Deprecate RSpec::Core::Pending::PendingDeclaredInExample, use SkipDeclaredInExample instead. (Xavier Shay)
• Issue a deprecation when described_class is accessed from within a nested describe <SomeClass> example group, since described_class will return the innermost described class in RSpec 3 rather than the outermost described class, as it behaved in RSpec 2. (Myron Marston)
• Deprecate RSpec::Core::FilterManager::DEFAULT_EXCLUSIONS, RSpec::Core::FilterManager::STANDALONE_FILTERS and use of #empty_without_conditional_filters? on those filters. (Sergey Pchelincev)
• Deprecate RSpec::Core::Example#options in favor of RSpec::Core::Example#metadata. (Myron Marston)
• Issue warning when passing a symbol or hash to describe or context as the first argument. In RSpec 2.x this would be treated as metadata but in RSpec 3 it'll be treated as the described object. To continue having it treated as metadata, pass a description before the symbol or hash. (Myron Marston)
• Deprecate RSpec::Core::BaseTextFormatter::VT100_COLORS and RSpec::Core::BaseTextFormatter::VT100_COLOR_CODES in favour of RSpec::Core::BaseTextFormatter::ConsoleCodes::VT100_CODES and RSpec::Core::BaseTextFormatter::ConsoleCodes::VT100_CODE_VALUES. (Jon Rowe)
• Deprecate RSpec::Core::ExampleGroup.display_name in favor of RSpec::Core::ExampleGroup.description. (Myron Marston)
• Deprecate RSpec::Core::ExampleGroup.describes in favor of RSpec::Core::ExampleGroup.described_class. (Myron Marston)
• Deprecate RSpec::Core::ExampleGroup.alias_example_to in favor of RSpec::Core::Configuration#alias_example_to. (Myron Marston)
• Deprecate RSpec::Core::ExampleGroup.alias_it_behaves_like_to in favor of RSpec::Core::Configuration#alias_it_behaves_like_to. (Myron Marston)
• Deprecate RSpec::Core::ExampleGroup.focused in favor of RSpec::Core::ExampleGroup.focus. (Myron Marston)
• Add deprecation warning for config.filter_run :focused since example aliases fit and focus will no longer include :focused metadata but will continue to include :focus. (Myron Marston)
• Deprecate filtering by :line_number (e.g. --line-number from the CLI). Use location filtering instead. (Myron Marston)
• Deprecate --default_path as an alternative to --default-path. (Jon Rowe)
• Deprecate RSpec::Core::Configuration#warnings in favor of RSpec::Core::Configuration#warnings?. (Myron Marston)
• Deprecate share_examples_for in favor of shared_examples_for or just shared_examples. (Myron Marston)
• Deprecate RSpec::Core::CommandLine in favor of RSpec::Core::Runner. (Myron Marston)
• Deprecate #color_enabled, #color_enabled= and #color? in favour of #color, #color= and #color_enabled? output. (Jon Rowe)
• Deprecate #filename_pattern in favour of #pattern. (Jon Rowe)
• Deprecate #backtrace_cleaner in favour of #backtrace_formatter. (Jon Rowe)
• Deprecate mutating RSpec::Configuration#formatters. (Jon Rowe)
• Deprecate stdlib as an available expectation framework in favour of test_unit and minitest. (Aaron Kromer)

Bug Fixes:

• Issue a warning when you set config.deprecation_stream too late for it to take effect because the reporter has already been setup. (Myron Marston)
• skip with a block should not execute the block. (Xavier Shay)

2.99.0.beta2 / 2014-02-17

Full Changelog

Enhancements:

• Add is_expected for one-liners that read well with the expect-based syntax. is_expected is simply defined as expect(subject) and can be used in an expression like: it { is_expected.to read_well }. (Myron Marston)
• Backport skip from RSpec 3, which acts like pending did in RSpec 2 when not given a block, since the behavior of pending is changing in RSpec 3. (Xavier Shay)

Deprecations:

• Deprecate inexact mock_with config options. RSpec 3 will only support the exact symbols :rspec, :mocha, :flexmock, :rr or :nothing (or any module that implements the adapter interface). RSpec 2 did fuzzy matching but this will not be supported going forward. (Myron Marston)
• Deprecate show_failures_in_pending_blocks config option. To achieve the same behavior as the option enabled, you can use a custom formatter instead. (Xavier Shay)
• Add a deprecation warning for the fact that the behavior of pending is changing in RSpec 3 -- rather than skipping the example (as it did in 2.x when no block was provided), it will run the example and mark it as failed if no exception is raised. Use skip instead to preserve the old behavior. (Xavier Shay)
• Deprecate 's', 'n', 'spec' and 'nested' as aliases for documentation formatter. (Jon Rowe)
• Deprecate RSpec::Core::Reporter#abort in favor of RSpec::Core::Reporter#finish. (Jon Rowe)

Bug Fixes:

• Fix failure (undefined method path) in end-of-run summary when raise_errors_for_deprecations! is configured. (Myron Marston)
• Fix issue were overridding spec ordering from the command line wasn't fully recognised interally. (Jon Rowe)

2.99.0.beta1 / 2013-11-07

Full Changelog

Enhancements

• Block-based DSL methods that run in the context of an example (it, before(:each), after(:each), let and subject) now yield the example as a block argument. (David Chelimsky)
• Warn when the name of more than one example group is submitted to include_examples and it's aliases. (David Chelimsky)
• Add expose_current_running_example_as config option for use during the upgrade process when external gems use the deprecated RSpec::Core::ExampleGroup#example and RSpec::Core::ExampleGroup#running_example methods. (Myron Marston)
• Limit spamminess of deprecation messages. (Bradley Schaefer, Loren Segal)
• Add config.raise_errors_for_deprecations! option, which turns deprecations warnings into errors to surface the full backtrace of the call site. (Myron Marston)

Deprecations

• Deprecate RSpec::Core::ExampleGroup#example and RSpec::Core::ExampleGroup#running_example methods. If you need access to the example (e.g. to get its metadata), use a block argument instead. (David Chelimsky)
• Deprecate use of autotest/rspec2 in favour of rspec-autotest. (Jon Rowe)
• Deprecate RSpec's built-in debugger support. Use a CLI option like -rruby-debug (for the ruby-debug gem) or -rdebugger (for the debugger gem) instead. (Myron Marston)
• Deprecate RSpec.configuration.treat_symbols_as_metadata_keys_with_true_values = false. RSpec 3 will not support having this option set to false. (Myron Marston)
• Deprecate accessing a let or subject declaration in a after(:all) hook. (Myron Marston, Jon Rowe)
• Deprecate built-in its usage in favor of rspec-its gem due to planned removal in RSpec 3. (Peter Alfvin)
• Deprecate RSpec::Core::PendingExampleFixedError in favor of RSpec::Core::Pending::PendingExampleFixedError. (Myron Marston)
• Deprecate RSpec::Core::Configuration#out and RSpec::Core::Configuration#output in favor of RSpec::Core::Configuration#output_stream. (Myron Marston)
• Deprecate legacy ordering APIs.
  • You should use register_ordering(:global) instead of these:
    • RSpec::Core::Configuration#order_examples
    • RSpec::Core::Configuration#order_groups
    • RSpec::Core::Configuration#order_groups_and_examples
  • These are deprecated with no replacement because in RSpec 3 ordering is a property of individual example groups rather than just a global property of the entire test suite:
    • RSpec::Core::Configuration#order
    • RSpec::Core::Configuration#randomize?
  • --order default is deprecated in favor of --order defined (Myron Marston)

2.14.8 / 2014-02-27

Full Changelog

Bug fixes:

• Fix regression with the textmateformatter that prevented backtrace links from being clickable. (Stefan Daschek)

2.14.7 / 2013-10-29

Full Changelog

Bug fixes:

• Fix regression in 2.14.6 that broke the Fivemat formatter. It depended upon either example.execution_result[:exception].pending_fixed? (which was removed in 2.14.6 to fix an issue with frozen error objects) or RSpec::Core::PendingExampleFixedError (which was renamed to RSpec::Core::Pending::PendingExampleFixedError in 2.8. This fix makes a constant alias for the old error name. (Myron Marston)

2.14.6 / 2013-10-15

Full Changelog

Bug fixes:

• Format stringified numbers correctly when mathn library is loaded. (Jay Hayes)
• Fix an issue that prevented the use of frozen error objects. (Lars Gierth)

2.14.5 / 2013-08-13

Full Changelog

Bug fixes:

• Fix a NoMethodError that was being raised when there were no shared examples or contexts declared and RSpec.world.reset is invoked. (thepoho, Jon Rowe, Myron Marston)
• Fix a deprecation warning that was being incorrectly displayed when shared_examples are declared at top level in a module scope. (Jon Rowe)
• Fix after(:all) hooks so consecutive (same context) scopes will run even if one raises an error. (Jon Rowe, Trejkaz)
• JsonFormatter no longer dies if dump_profile isn't defined (Alex / @MasterLambaster, Jon Rowe)

2.14.4 / 2013-07-21

Full Changelog

Bug fixes

• Fix regression in 2.14: ensure configured requires (via -r option) are loaded before spec files are loaded. This allows the spec files to programatically change the file pattern (Jon Rowe).
• Autoload RSpec::Mocks and RSpec::Expectations when referenced if they are not already loaded (RSpec::Matches has been autoloaded for a while). In the rspec gem, we changed it recently to stop loading rspec/mocks and rspec/expectations by default, as some users reported problems where they were intending to use mocha, not rspec-mocks, but rspec-mocks was loaded and causing a conflict. rspec-core loads mocks and expectations at the appropriate time, so it seemed like a safe change -- but caused a problem for some authors of libraries that integrate with RSpec. This fixes that problem. (Myron Marston)
• Gracefully handle a command like rspec --profile path/to/spec.rb: the path/to/spec.rb arg was being wrongly treated as the profile integer arg, which got cast 0 using to_i, causing no profiled examples to be printed. (Jon Rowe)

2.14.3 / 2013-07-13

Full Changelog

Bug fixes

• Fix deprecation notices issued from RSpec::Core::RakeTask so that they work properly when all of rspec-core is not loaded. (This was a regression in 2.14) (Jon Rowe)

2.14.2 / 2013-07-09

Full Changelog

Bug fixes

• Fix regression caused by 2.14.1 release: formatters that report that they respond_to? a notification, but had no corresponding method would raise an error when registered. The new fix is to just implement start on the deprecation formatter to fix the original JRuby/ruby-debug issue. (Jon Rowe)

2.14.1 / 2013-07-08

Full Changelog

Bug fixes

• Address deprecation formatter failure when using ruby-debug on JRuby: fix RSpec::Core::Reporter to not send a notification when the formatter's implementation of the notification method comes from Kernel (Alex Portnov, Jon Rowe).

2.14.0 / 2013-07-06

Full Changelog

Enhancements

• Apply focus to examples defined with fit (equivalent of it "description", focus: true) (Michael de Silva)

Bug fix

• Ensure methods defined by let take precedence over others when there is a name collision (e.g. from an included module). (Jon Rowe, Andy Lindeman and Myron Marston)

2.14.0.rc1 / 2013-05-27

Full Changelog

Enhancements

• Improved Windows detection inside Git Bash, for better --color handling.
• Add profiling of the slowest example groups to --profile option. The output is sorted by the slowest average example groups.
• Don't show slow examples if there's a failure and both --fail-fast and --profile options are used (Paweł Gościcki).
• Rather than always adding spec to the load path, add the configured --default-path to the load path (which defaults to spec). This better supports folks who choose to put their specs in a different directory (John Feminella).
• Add some logic to test time duration precision. Make it a function of time, dropping precision as the time increases. (Aaron Kromer)
• Add new backtrace_inclusion_patterns config option. Backtrace lines that match one of these patterns will always be included in the backtrace, even if they match an exclusion pattern, too (Sam Phippen).
• Support ERB trim mode using the - when parsing .rspec as ERB (Gabor Garami).
• Give a better error message when let and subject are called without a block. (Sam Phippen).
• List the precedence of .rspec-local in the configuration documentation (Sam Phippen)
• Support {a,b} shell expansion syntax in --pattern option (Konstantin Haase).
• Add cucumber documentation for --require command line option (Bradley Schaefer)
• Expose configuration options via config:
  • config.libs returns the libs configured to be added onto the load path
  • full_backtrace? returns the state of the backtrace cleaner
  • debug? returns true when the debugger is loaded
  • line_numbers returns the line numbers we are filtering by (if any)
  • full_description returns the RegExp used to filter descriptions (Jon Rowe)
• Add setters for RSpec.world and RSpec.configuration (Alex Soulim)
• Configure ruby's warning behaviour with --warnings (Jon Rowe)
• Fix an obscure issue on old versions of 1.8.7 where Time.dup wouldn't allow access to Time.now (Jon Rowe)
• Make shared_examples_for context aware, so that keys may be safely reused in multiple contexts without colliding. (Jon Rowe)
• Add a configurable deprecation_stream (Jon Rowe)
• Publish deprecations through a formatter (David Chelimsky)

Bug fixes

• Make JSON formatter behave the same when it comes to --profile as the text formatter (Paweł Gościcki).
• Fix named subjects so that if an inner group defines a method that overrides the named method, subject still retains the originally declared value (Myron Marston).
• Fix random ordering so that it does not cause rand in examples in nested sibling contexts to return the same value (Max Shytikov).
• Use the new backtrace_inclusion_patterns config option to ensure that folks who develop code in a directory matching one of the default exclusion patterns (e.g. gems) still get the normal backtrace filtering (Sam Phippen).
• Fix ordering of before hooks so that before hooks declared in RSpec.configure run before before hooks declared in a shared context (Michi Huber and Tejas Dinkar).
• Fix Example#full_description so that it gets filled in by the last matcher description (as Example#description already did) when no doc string has been provided (David Chelimsky).
• Fix the memoized methods (let and subject) leaking define_method as a public method. (Thomas Holmes and Jon Rowe) (#873)
• Fix warnings coming from the test suite. (Pete Higgins)

Deprecations

• Deprecate Configuration#backtrace_clean_patterns in favor of Configuration#backtrace_exclusion_patterns for greater consistency and symmetry with new backtrace_inclusion_patterns config option (Sam Phippen).
• Deprecate Configuration#requires= in favor of using ruby's require. Requires specified by the command line can still be accessed by the Configuration#require reader. (Bradley Schaefer)
• Deprecate calling SharedExampleGroups defined across sibling contexts (Jon Rowe)

2.13.1 / 2013-03-12

Full Changelog

Bug fixes

• Use hook classes as proxies rather than extending hook blocks to support lambdas for before/after/around hooks. (David Chelimsky)
• Fix regression in 2.13.0 that caused confusing behavior when overriding a named subject with an unnamed subject in an inner group and then referencing the outer group subject's name. The fix for this required us to disallow using super in a named subject (which is confusing, anyway -- named subjects create 2 methods, so which method on the parent example group are you supering to?) but super in an unnamed subject continues to work (Myron Marston).
• Do not allow a referenced let or subject in before(:all) to cause other let declarations to leak across examples (Myron Marston).
• Work around odd ruby 1.9 bug with String#match that was triggered by passing it a regex from a let declaration. For more info, see http://bugs.ruby-lang.org/issues/8059 (Aaron Kromer).
• Add missing require 'set' to base_text_formatter.rb (Tom Anderson).

Deprecations

• Deprecate accessing let or subject declarations in before(:all). These were not intended to be called in a before(:all) hook, as they exist to define state that is reset between each example, while before(:all) exists to define state that is shared across examples in an example group (Myron Marston).

2.13.0 / 2013-02-23

Full Changelog

Enhancements

• Allow --profile option to take a count argument that determines the number of slow examples to dump (Greggory Rothmeier).
• Add subject! that is the analog to let!. It defines an explicit subject and sets a before hook that will invoke the subject (Zubin Henner).
• Fix let and subject declaration so that super and return can be used in them, just like in a normal method. (Myron Marston)
• Allow output colors to be configured individually. (Charlie Maffitt)
• Always dump slow examples when --profile option is given, even when an example failed (Myron Marston).

Bug fixes

• Don't blow up when dumping error output for instances of anonymous error classes (Myron Marston).
• Fix default backtrace filters so lines from projects containing "gems" in the name are not filtered, but lines from installed gems still are (Myron Marston).
• Fix autotest command so that is uses double quotes rather than single quotes for windows compatibility (Jonas Tingeborn).
• Fix its so that uses of subject in a before or let declaration in the parent group continue to reference the parent group's subject. (Olek Janiszewski)

2.12.2 / 2012-12-13

Full Changelog

Bug fixes

• Fix RSpec::Core::RakeTask so that it is compatible with rake 0.8.7 on ruby 1.8.7. We had accidentally broke it in the 2.12 release (Myron Marston).
• Fix RSpec::Core::RakeTask so it is tolerant of the Rspec constant for backwards compatibility (Patrick Van Stee)

2.12.1 / 2012-12-01

Full Changelog

Bug fixes

• Specs are run even if another at_exit hook calls exit. This allows Test::Unit and RSpec to run together. (Suraj N. Kurapati)
• Fix full doc string concatenation so that it handles the case of a method string (e.g. "#foo") being nested under a context string (e.g. "when it is tuesday"), so that we get "when it is tuesday #foo" rather than "when it is tuesday#foo". (Myron Marston)
• Restore public API I unintentionally broke in 2.12.0: RSpec::Core::Formatters::BaseFormatter#format_backtrce(backtrace, example) (Myron Marston).

2.12.0 / 2012-11-12

Full Changelog

Enhancements

• Add support for custom ordering strategies for groups and examples. (Myron Marston)
• JSON Formatter (Alex Chaffee)
• Refactor rake task internals (Sam Phippen)
• Refactor HtmlFormatter (Pete Hodgson)
• Autotest supports a path to Ruby that contains spaces (dsisnero)
• Provide a helpful warning when a shared example group is redefined. (Mark Burns).
• --default_path can be specified as --default-line. --line_number can be specified as --line-number. Hyphens are more idiomatic command line argument separators (Sam Phippen).
• A more useful error message is shown when an invalid command line option is used (Jordi Polo).
• Add format_docstrings { |str| } config option. It can be used to apply formatting rules to example group and example docstrings. (Alex Tan)
• Add support for an .rspec-local options file. This is intended to allow individual developers to set options in a git-ignored file that override the common project options in .rspec. (Sam Phippen)
• Support for mocha 0.13.0. (Andy Lindeman)

Bug fixes

• Remove override of ExampleGroup#ancestors. This is a core ruby method that RSpec shouldn't override. Instead, define ExampleGroup#parent_groups. (Myron Marston)
• Limit monkey patching of shared example/context declaration methods (shared_examples_for, etc.) to just the objects that need it rather than every object in the system (Myron Marston).
• Fix Metadata#fetch to support computed values (Sam Goldman).
• Named subject can now be referred to from within subject block in a nested group (tomykaira).
• Fix fail_fast so that it properly exits when an error occurs in a before(:all) hook (Bradley Schaefer).
• Make the order spec files are loaded consistent, regardless of the order of the files returned by the OS or the order passed at the command line (Jo Liss and Sam Phippen).
• Ensure instance variables from before(:all) are always exposed from after(:all), even if an error occurs in before(:all) (Sam Phippen).
• rspec --init no longer generates an incorrect warning about --configure being deprecated (Sam Phippen).
• Fix pluralization of 1 seconds (Odin Dutton)
• Fix ANSICON url (Jarmo Pertman)
• Use dup of Time so reporting isn't clobbered by examples that modify Time without properly restoring it. (David Chelimsky)

Deprecations

• share_as is no longer needed. shared_context and/or RSpec::SharedContext provide better mechanisms (Sam Phippen).
• Deprecate RSpec.configuration with a block (use RSpec.configure).

2.11.1 / 2012-07-18

Full Changelog

Bug fixes

• Fix the way we autoload RSpec::Matchers so that custom matchers can be defined before rspec-core has been configured to definitely use rspec-expectations. (Myron Marston)
• Fix typo in --help message printed for -e option. (Jo Liss)
• Fix ruby warnings. (Myron Marston)
• Ignore mock expectation failures when the example has already failed. Mock expectation failures have always been ignored in this situation, but due to my changes in 27059bf1 it was printing a confusing message. (Myron Marston).

2.11.0 / 2012-07-07

Full Changelog

Enhancements

• Support multiple --example options. (Daniel Doubrovkine @dblock)
• Named subject e.g. subject(:article) { Article.new }
  • see http://blog.davidchelimsky.net/2012/05/13/spec-smell-explicit-use-of-subject/ for background.
  • thanks to Bradley Schaefer for suggesting it and Avdi Grimm for almost suggesting it.
• config.mock_with and config.expect_with yield custom config object to a block if given
  • aids decoupling from rspec-core's configuation
• include_context and include_examples support a block, which gets eval'd in the current context (vs the nested context generated by it_behaves_like).
• Add config.order = 'random' to the spec_helper.rb generated by rspec --init.
• Delay the loading of DRb (Myron Marston).
• Limit monkey patching of describe onto just the objects that need it rather than every object in the system (Myron Marston).

Bug fixes

• Support alternative path separators. For example, on Windows, you can now do this: rspec spec\subdir. (Jarmo Pertman @jarmo)
• When an example raises an error and an after or around hook does as well, print out the hook error. Previously, the error was silenced and the user got no feedback about what happened. (Myron Marston)
• --require and -I are merged among different configuration sources (Andy Lindeman)
• Delegate to mocha methods instead of aliasing them in mocha adapter.

2.10.1 / 2012-05-19

Full Changelog

Bug fixes

• RSpec.reset properly reinits configuration and world
• Call to_s before split on exception messages that might not always be Strings (slyphon)

2.10.0 / 2012-05-03

Full Changelog

Enhancements

• Add prepend_before and append_after hooks (preethiramdev)
  • intended for extension libs
  • restores rspec-1 behavior
• Reporting of profiled examples (moro)
  • Report the total amount of time taken for the top slowest examples.
  • Report what percentage the slowest examples took from the total runtime.

Bug fixes

• Properly parse SPEC_OPTS options.
• example.description returns the location of the example if there is no explicit description or matcher-generated description.
• RDoc fixes (Grzegorz Świrski)
• Do not modify example ancestry when dumping errors (Michael Grosser)

2.9.0 / 2012-03-17

Full Changelog

Enhancements

• Support for "X minutes X seconds" spec run duration in formatter. (uzzz)
• Strip whitespace from group and example names in doc formatter.
• Removed spork-0.9 shim. If you're using spork-0.8.x, you'll need to upgrade to 0.9.0.

Bug fixes

• Restore --full_backtrace option
• Ensure that values passed to config.filter_run are respected when running over DRb (using spork).
• Ensure shared example groups are reset after a run (as example groups are).
• Remove rescue false from calls to filters represented as Procs
• Ensure described_class gets the closest constant (pyromaniac)
• In "autorun", don't run the specs in the at_exit hook if there was an exception (most likely due to a SyntaxError). (sunaku)
• Don't extend groups with modules already used to extend ancestor groups.
• its correctly memoizes nil or false values (Yamada Masaki)

2.8.0 / 2012-01-04

Full Changelog

Bug fixes

• For metadata filtering, restore passing the entire array to the proc, rather than each item in the array (weidenfreak)
• Ensure each spec file is loaded only once
  • Fixes a bug that caused all the examples in a file to be run when referenced twice with line numbers in a command, e.g.
    • rspec path/to/file:37 path/to/file:42

2.8.0.rc2 / 2011-12-19

Full Changelog

Enhancments

• new --init command (Peter Schröder)
  • generates spec/spec_helper.rb
  • deletes obsolete files (on confirmation)
  • merged with and deprecates --configure command, which generated .rspec
• use require_relative when available (Ian Leitch)
• include_context and include_examples accept params (Calvin Bascom)
• print the time for every example in the html formatter (Richie Vos)
• several tasty refactoring niblets (Sasha)
• `it "does something", :x => [:foo,'bar',/baz/] (Ivan Neverov)
  • supports matching n command line tag values with an example or group

2.8.0.rc1 / 2011-11-06

Full Changelog

Enhancements

• --order (Justin Ko)
  • run examples in random order: --order rand
  • specify the seed: --order rand:123
• --seed SEED
  • equivalent of --order rand:SEED
• SharedContext supports let (David Chelimsky)
• Filter improvements (David Chelimsky)
  • override opposing tags from the command line
  • override RSpec.configure tags from the command line
  • --line_number 37 overrides all other filters
  • path/to/file.rb:37 overrides all other filters
  • refactor: consolidate filter management in a FilterManger object
• Eliminate Ruby warnings (Matijs van Zuijlen)
• Make reporter.report an API (David Chelimsky)
  • supports extension tools like interative_rspec

Changes

• change config.color_enabled (getter/setter/predicate) to color to align with --[no]-color CLI option.
  • color_enabled is still supported for now, but will likley be deprecated in a 2.x release so we can remove it in 3.0.

Bug fixes

• Make sure the bar in --tag foo:bar makes it to DRb (Aaron Gibralter)

• Fix bug where full descriptions of groups nested 3 deep were repeated.

• Restore report of time to run to start after files are loaded.

  • fixes bug where run times were cumalitive in spork
  • fixes compatibility with time-series metrics

• Don't error out when config.mock_with or expect_with is re-specifying the current config (Myron Marston)

• Deprecations

  • :alias option on configuration.add_setting. Use :alias_with on the original setting declaration instead.

2.7.1 / 2011-10-20

Full Changelog

Bug fixes

• tell autotest the correct place to find the rspec executable

2.7.0 / 2011-10-16

Full Changelog

NOTE: RSpec's release policy dictates that there should not be any backward incompatible changes in minor releases, but we're making an exception to release a change to how RSpec interacts with other command line tools.

As of 2.7.0, you must explicity require "rspec/autorun" unless you use the rspec command (which already does this for you).

Enhancements

• Add example.exception (David Chelimsky)
• --default_path command line option (Justin Ko)
• support multiple --line_number options (David J. Hamilton)
  • also supports path/to/file.rb:5:9 (runs examples on lines 5 and 9)
• Allow classes/modules to be used as shared example group identifiers (Arthur Gunn)
• Friendly error message when shared context cannot be found (Sławosz Sławiński)
• Clear formatters when resetting config (John Bintz)
• Add xspecify and xexample as temp-pending methods (David Chelimsky)
• Add --no-drb option (Iain Hecker)
• Provide more accurate run time by registering start time before code is loaded (David Chelimsky)
  • reverted in 2.8.0
• Rake task default pattern finds specs in symlinked dirs (Kelly Felkins)
• Rake task no longer does anything to invoke bundler since Bundler already handles it for us. Thanks to Andre Arko for the tip.
• Add --failure-exit-code option (Chris Griego)

Bug fixes

• Include Rake::DSL to remove deprecation warnings in Rake > 0.8.7 (Pivotal Casebook)
• Only eval let block once even if it returns nil (Adam Meehan)
• Fix --pattern option (wasn't being recognized) (David Chelimsky)
• Only implicitly require "rspec/autorun" with the rspec command (David Chelimsky)
• Ensure that rspec's at_exit defines the exit code (Daniel Doubrovkine)
• Show the correct snippet in the HTML and TextMate formatters (Brian Faherty)

2.6.4 / 2011-06-06

Full Changelog

NOTE: RSpec's release policy dictates that there should not be new functionality in patch releases, but this minor enhancement slipped in by accident. As it doesn't add a new API, we decided to leave it in rather than roll back this release.

Enhancements

• Add summary of commands to run individual failed examples.

Bug fixes

• Support exclusion filters in DRb. (Yann Lugrin)
• Fix --example escaping when run over DRb. (Elliot Winkler)
• Use standard ANSI codes for color formatting so colors work in a wider set of color schemes.

2.6.3 / 2011-05-24

Full Changelog

Bug fixes

• Explicitly convert exit code to integer, avoiding TypeError when return value of run is IO object proxied by DRb::DRbObject (Julian Scheid)
• Clarify behavior of --example command line option
• Build using a rubygems-1.6.2 to avoid downstream yaml parsing error

2.6.2 / 2011-05-21

Full Changelog

Bug fixes

• Warn rather than raise when HOME env var is not defined
• Properly merge command-line exclusions with default :if and :unless (joshcooper)

2.6.1 / 2011-05-19

Full Changelog

Bug fixes

• Don't extend nil when filters are nil
• require 'rspec/autorun' when running rcov.

2.6.0 / 2011-05-12

Full Changelog

Enhancements

• shared_context (Damian Nurzynski)
  • extend groups matching specific metadata with:
    • method definitions
    • subject declarations
    • let/let! declarations
    • etc (anything you can do in a group)
• its([:key]) works for any subject with #[]. (Peter Jaros)
• treat_symbols_as_metadata_keys_with_true_values (Myron Marston)
• Print a deprecation warning when you configure RSpec after defining an example. All configuration should happen before any examples are defined. (Myron Marston)
• Pass the exit status of a DRb run to the invoking process. This causes specs run via DRb to not just return true or false. (Ilkka Laukkanen)
• Refactoring of ConfigurationOptions#parse_options (Rodrigo Rosenfeld Rosas)
• Report excluded filters in runner output (tip from andyl)
• Clean up messages for filters/tags.
• Restore --pattern/-P command line option from rspec-1
• Support false as well as true in config.full_backtrace= (Andreas Tolf Tolfsen)

Bug fixes

• Don't stumble over an exception without a message (Hans Hasselberg)
• Remove non-ascii characters from comments that were choking rcov (Geoffrey Byers)
• Fixed backtrace so it doesn't include lines from before the autorun at_exit hook (Myron Marston)
• Include RSpec::Matchers when first example group is defined, rather than just before running the examples. This works around an obscure bug in ruby 1.9 that can cause infinite recursion. (Myron Marston)
• Don't send example_group_[started|finished] to formatters for empty groups.
• Get specs passing on jruby (Sidu Ponnappa)
• Fix bug where mixing nested groups and outer-level examples gave unpredictable :line_number behavior (Artur Małecki)
• Regexp.escape the argument to --example (tip from Elliot Winkler)
• Correctly pass/fail pending block with message expectations
• CommandLine returns exit status (0/1) instead of true/false
• Create path to formatter output file if it doesn't exist (marekj).

2.5.1 / 2011-02-06

Full Changelog

NOTE: this release breaks compatibility with rspec/autotest/bundler integration, but does so in order to greatly simplify it.

With this release, if you want the generated autotest command to include 'bundle exec', require Autotest's bundler plugin in a .autotest file in the project's root directory or in your home directory:

require "autotest/bundler"

Now you can just type 'autotest' on the command line and it will work as you expect.

If you don't want 'bundle exec', there is nothing you have to do.

2.5.0 / 2011-02-05

Full Changelog

Enhancements

• Autotest::Rspec2 parses command line args passed to autotest after '--'
• --skip-bundler option for autotest command
• Autotest regexp fixes (Jon Rowe)
• Add filters to html and textmate formatters (Daniel Quimper)
• Explicit passing of block (need for JRuby 1.6) (John Firebaugh)

Bug fixes

• fix dom IDs in HTML formatter (Brian Faherty)
• fix bug with --drb + formatters when not running in drb
• include --tag options in drb args (monocle)
• fix regression so now SPEC_OPTS take precedence over CLI options again (Roman Chernyatchik)
• only call its(:attribute) once (failing example from Brian Dunn)
• fix bizarre bug where rspec would hang after String.alias :to_int :to_i (Damian Nurzynski)

Deprecations

• implicit inclusion of 'bundle exec' when Gemfile present (use autotest's bundler plugin instead)

2.4.0 / 2011-01-02

Full Changelog

Enhancements

• start the debugger on -d so the stack trace is visible when it stops (Clifford Heath)
• apply hook filtering to examples as well as groups (Myron Marston)
• support multiple formatters, each with their own output
• show exception classes in failure messages unless they come from RSpec matchers or message expectations
• before(:all) { pending } sets all examples to pending

Bug fixes

• fix bug due to change in behavior of reject in Ruby 1.9.3-dev (Shota Fukumori)
• fix bug when running in jruby: be explicit about passing block to super (John Firebaugh)
• rake task doesn't choke on paths with quotes (Janmejay Singh)
• restore --options option from rspec-1
• require 'ostruct' to fix bug with its([key]) (Kim Burgestrand)
• --configure option generates .rspec file instead of autotest/discover.rb

2.3.1 / 2010-12-16

Full Changelog

Bug fixes

• send debugger warning message to $stdout if RSpec.configuration.error_stream has not been defined yet.
• HTML Formatter finally properly displays nested groups (Jarmo Pertman)
• eliminate some warnings when running RSpec's own suite (Jarmo Pertman)

2.3.0 / 2010-12-12

Full Changelog

Enhancements

• tell autotest to use "rspec2" if it sees a .rspec file in the project's root directory
  • replaces the need for ./autotest/discover.rb, which will not work with all versions of ZenTest and/or autotest
• config.expect_with
  • :rspec # => rspec/expectations
  • :stdlib # => test/unit/assertions
  • :rspec, :stdlib # => both

Bug fixes

• fix dev Gemfile to work on non-mac-os machines (Lake Denman)
• ensure explicit subject is only eval'd once (Laszlo Bacsi)

2.2.1 / 2010-11-28

Full Changelog

Bug fixes

• alias_method instead of override Kernel#method_missing (John Wilger)
• changed --autotest to --tty in generated command (MIKAMI Yoshiyuki)
• revert change to debugger (had introduced conflict with Rails)
  • also restored --debugger/-debug option

2.2.0 / 2010-11-28

Full Changelog

Deprecations/changes

• --debug/-d on command line is deprecated and now has no effect
• win32console is now ignored; Windows users must use ANSICON for color support (Bosko Ivanisevic)

Enhancements

• When developing locally rspec-core now works with the rspec-dev setup or your local gems
• Raise exception with helpful message when rspec-1 is loaded alongside rspec-2 (Justin Ko)
• debugger statements just work as long as ruby-debug is installed
  • otherwise you get warned, but not fired
• Expose example.metadata in around hooks
• Performance improvments (much faster now)

Bug fixes

• Make sure --fail-fast makes it across drb
• Pass -Ilib:spec to rcov

2.1.0 / 2010-11-07

Full Changelog

Enhancments

• Add skip_bundler option to rake task to tell rake task to ignore the presence of a Gemfile (jfelchner)
• Add gemfile option to rake task to tell rake task what Gemfile to look for (defaults to 'Gemfile')
• Allow passing caller trace into Metadata to support extensions (Glenn Vanderburg)
• Add deprecation warning for Spec::Runner.configure to aid upgrade from RSpec-1
• Add deprecated Spec::Rake::SpecTask to aid upgrade from RSpec-1
• Add 'autospec' command with helpful message to aid upgrade from RSpec-1
• Add support for filtering with tags on CLI (Lailson Bandeira)
• Add a helpful message about RUBYOPT when require fails in bin/rspec (slyphon)
• Add "-Ilib" to the default rcov options (Tianyi Cui)
• Make the expectation framework configurable (default rspec, of course) (Justin Ko)
• Add 'pending' to be conditional (Myron Marston)
• Add explicit support for :if and :unless as metadata keys for conditional run of examples (Myron Marston)
• Add --fail-fast command line option (Jeff Kreeftmeijer)

Bug fixes

• Eliminate stack overflow with "subject { self }"
• Require 'rspec/core' in the Raketask (ensures it required when running rcov)

2.0.1 / 2010-10-18

Full Changelog

Bug fixes

• Restore color when using spork + autotest
• Pending examples without docstrings render the correct message (Josep M. Bach)
• Fixed bug where a failure in a spec file ending in anything but _spec.rb would fail in a confusing way.
• Support backtrace lines from erb templates in html formatter (Alex Crichton)

2.0.0 / 2010-10-10

Full Changelog

RSpec-1 compatibility

• Rake task uses ENV["SPEC"] as file list if present

Bug fixes

• Bug Fix: optparse --out foo.txt (Leonardo Bessa)
• Suppress color codes for non-tty output (except autotest)

2.0.0.rc / 2010-10-05

Full Changelog

Enhancements

• implicitly require unknown formatters so you don't have to require the file explicitly on the command line (Michael Grosser)
• add --out/-o option to assign output target
• added fail_fast configuration option to abort on first failure
• support a Hash subject (its([:key]) { should == value }) (Josep M. Bach)

Bug fixes

• Explicitly require rspec version to fix broken rdoc task (Hans de Graaff)
• Ignore backtrace lines that come from other languages, like Java or Javascript (Charles Lowell)
• Rake task now does what is expected when setting (or not setting) fail_on_error and verbose
• Fix bug in which before/after(:all) hooks were running on excluded nested groups (Myron Marston)
• Fix before(:all) error handling so that it fails examples in nested groups, too (Myron Marston)

2.0.0.beta.22 / 2010-09-12

Full Changelog

Enhancements

• removed at_exit hook
• CTRL-C stops the run (almost) immediately
  • first it cleans things up by running the appropriate after(:all) and after(:suite) hooks
  • then it reports on any examples that have already run
• cleaned up rake task
  • generate correct task under variety of conditions
  • options are more consistent
  • deprecated redundant options
• run 'bundle exec autotest' when Gemfile is present
• support ERB in .rspec options files (Justin Ko)
• depend on bundler for development tasks (Myron Marston)
• add example_group_finished to formatters and reporter (Roman Chernyatchik)

Bug fixes

• support paths with spaces when using autotest (Andreas Neuhaus)
• fix module_exec with ruby 1.8.6 (Myron Marston)
• remove context method from top-level
  • was conflicting with irb, for example
• errors in before(:all) are now reported correctly (Chad Humphries)

Removals

• removed -o --options-file command line option
  • use ./.rspec and ~/.rspec