rspec-core 2.99.0 → 3.0.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    ZDVlNDg3NzUxMWY5NDk2MzQ2ZDQyMDhmNWY4YjJmZmEwOTgwMzZiMw==
+    MjlhNTVjYmI4MjQwNDYwMWViMjUzNDBlZTg0OWE3MmIxMTMwMTNmYw==
   data.tar.gz: !binary |-
-    MjkzYTI0M2ZkN2IxYzAxYmM1NmY1MWUzYjhmNDY5NGFhNjk0MjZiMA==
+    YmYxZTAyNzhjNTgzNTRjMzk1OWQyMWU5NzQ5MDNmMWVlNTA0ZTRhYw==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    MzBjODk5ZmU4ZTEzODk0ZmIyMTkwOTFiNWNhZTg2YWU4Yjc5ZjcxN2JkYWFm
-    YWE4ODk3YWFkZTkwM2M2NGZlZTFjYjI1ODRmNGIyOWY0YjQ0ZjMwNDhjNTUz
-    MDBjZDA3NjI2YWM1NmM2NGVlYzM1ZDE0ZDlmMjVlMmFkZGQ0NTU=
+    MTI1OTczM2M4NDgxNjRiN2YyNDBkZDdhM2FiZmVhNGFjMmQ2NjA4OGMwMWNk
+    ODkwM2ZjZWI5ZmFkOTlmY2QzZGFmOTA3NDIwMjcxOGRjMjk5Mzg3YWJmNjE2
+    YzdkNTc2Y2IzMmQ0YzY0MmNmOTk5ZGNmNzZlNDc4ZGJmZWQ3YTU=
   data.tar.gz: !binary |-
-    NTkwMmUxMzViOWE1MjQ2NTMzMTEwZWU1ODY4ODgxYjBlZjdkNjU3ODM2NDc5
-    YWRkNjA2M2U0NDE1OWJiOTNiN2E3ZTg3MDk4OTdlOTUwODk2M2JlMzBkZjU1
-    ODZlMjY4MjBkNWQ3YzgzMTUzNmJjZTFkMDllNTlkZTBmYjU0YjU=
+    NGJjMDgwMDZlNzQ0YTI3YmZkYjY5OGVjNDc4ZTFmYmUxMGYwMGFlYWY0MDlm
+    Mjg1ZGRkNTMzZGI2MTNhYWIxNmFlOGRlYThkYmZhOGM5N2FjNmQwM2Y2OTdm
+    ZWNlZTg3NmZhOTA3NWZjODRmNmQwMTA5NDkzNTM5MmMxMjY3YTM=

data/.yardopts

@@ -1,6 +1,7 @@
 --exclude features
 --no-private
 --markup markdown
+--default-return void
 -
 Changelog.md
 License.txt

data/Changelog.md

@@ -1,3 +1,341 @@
+### 3.0.0 / 2014-06-01
+[Full Changelog](http://github.com/rspec/rspec-core/compare/v3.0.0.rc1...v3.0.0)
+
+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](http://github.com/rspec/rspec-core/compare/v3.0.0.beta2...v3.0.0.rc1)
+
+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](http://github.com/rspec/rspec-core/compare/v3.0.0.beta1...v3.0.0.beta2)
+
+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)
+
+### 3.0.0.beta1 / 2013-11-07
+[Full Changelog](http://github.com/rspec/rspec-core/compare/v2.99.0...v3.0.0.beta1)
+
+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.0 / 2014-06-01
 [Full Changelog](http://github.com/rspec/rspec-core/compare/v2.99.0.rc1...v2.99.0)
 
@@ -117,7 +455,7 @@ 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 wasnt
+* Fix issue were overridding spec ordering from the command line wasn't
   fully recognised interally. (Jon Rowe)
 
 ### 2.99.0.beta1 / 2013-11-07

data/License.txt

@@ -1,5 +1,6 @@
 (The MIT License)
 
+Copyright (c) 2012 Chad Humphries, David Chelimsky, Myron Marston
 Copyright (c) 2009 Chad Humphries, David Chelimsky
 Copyright (c) 2006 David Chelimsky, The RSpec Development Team
 Copyright (c) 2005 Steven Baker

data/README.md

@@ -1,4 +1,4 @@
-# rspec-core [![Build Status](https://secure.travis-ci.org/rspec/rspec-core.png?branch=master)](http://travis-ci.org/rspec/rspec-core) [![Code Climate](https://codeclimate.com/github/rspec/rspec-core.png)](https://codeclimate.com/github/rspec/rspec-core)
+# rspec-core [![Build Status](https://secure.travis-ci.org/rspec/rspec-core.png?branch=master)](http://travis-ci.org/rspec/rspec-core) [![Code Climate](https://codeclimate.com/github/rspec/rspec-core.png)](https://codeclimate.com/github/rspec/rspec-core) [![Inline docs](http://inch-pages.github.io/github/rspec/rspec-core.png)](http://inch-pages.github.io/github/rspec/rspec-core)
 
 rspec-core provides the structure for writing executable examples of how your
 code should behave, and an `rspec` command with tools to constrain which
@@ -18,7 +18,7 @@ RSpec uses the words "describe" and "it" so we can express concepts like a conve
     "It sums the prices of its line items."
 
 ```ruby
-describe Order do
+RSpec.describe Order do
   it "sums the prices of its line items" do
     order = Order.new
     order.add_entry(LineItem.new(:item => Item.new(
@@ -46,7 +46,7 @@ You can also declare nested nested groups using the `describe` or `context`
 methods:
 
 ```ruby
-describe Order do
+RSpec.describe Order do
   context "with no items" do
     it "behaves one way" do
       # ...
@@ -63,8 +63,11 @@ end
 
 ## aliases
 
-You can declare example groups using either `describe` or `context`, though
-only `describe` is available at the top level.
+You can declare example groups using either `describe` or `context`.
+For a top level example group, `describe` and `context` are available
+off of `RSpec`. For backwards compatibility, they are also available
+off of the `main` object and `Module` unless you disable monkey
+patching.
 
 You can declare examples within a group using any of `it`, `specify`, or
 `example`.
@@ -75,17 +78,17 @@ Declare a shared example group using `shared_examples`, and then include it
 in any group using `include_examples`.
 
 ```ruby
-shared_examples "collections" do |collection_class|
+RSpec.shared_examples "collections" do |collection_class|
   it "is empty when first created" do
     expect(collection_class.new).to be_empty
   end
 end
 
-describe Array do
+RSpec.describe Array do
   include_examples "collections", Array
 end
 
-describe Hash do
+RSpec.describe Hash do
   include_examples "collections", Hash
 end
 ```
@@ -123,7 +126,7 @@ using the `described_class` method, which is a wrapper for
 `example.metadata[:described_class]`.
 
 ```ruby
-describe Widget do
+RSpec.describe Widget do
   example do
     expect(described_class).to equal(Widget)
   end
@@ -135,17 +138,17 @@ class is unknown. Taking the collections shared example group from above, we can
 clean it up a bit using `described_class`:
 
 ```ruby
-shared_examples "collections" do
+RSpec.shared_examples "collections" do
   it "is empty when first created" do
     expect(described_class.new).to be_empty
   end
 end
 
-describe Array do
+RSpec.describe Array do
   include_examples "collections"
 end
 
-describe Hash do
+RSpec.describe Hash do
   include_examples "collections"
 end
 ```
@@ -165,30 +168,9 @@ the command line.
 
 ## autotest integration
 
-rspec-core ships with an Autotest extension, which is loaded automatically if
-there is a `.rspec` file in the project's root directory.
-
-## rcov integration
-
-rcov is best integrated via the [rcov rake
-task](http://www.rubydoc.info/github/relevance/rcov/master/Rcov/RcovTask).
-
-rcov can also be integrated via the rspec rake task, but it requires a bit
-more setup:
-
-```ruby
-# Rakefile
-require 'rspec/core/rake_task'
-
-RSpec::Core::RakeTask.new(:spec) do |config|
-  config.rcov = true
-end
-
-task :default => :spec
-
-# spec/spec_helper.rb
-require 'rspec/autorun' # **add this**
-```
+rspec-core no longer ships with an Autotest extension, if you require Autotest
+integration, please use the `rspec-autotest` gem and see [rspec/rspec-autotest](https://github.com/rspec/rspec-autotest)
+for details
 
 ## get started
 
@@ -197,7 +179,7 @@ this before you write any implementation code:
 
 ```ruby
 # in spec/calculator_spec.rb
-describe Calculator do
+RSpec.describe Calculator do
   describe '#add' do
     it 'returns the sum of its arguments' do
       expect(Calculator.new.add(1, 2)).to eq(3)

data/exe/rspec

@@ -1,25 +1,4 @@
 #!/usr/bin/env ruby
 
-begin
-  require 'rspec/autorun'
-rescue LoadError
-  $stderr.puts <<-EOS
-#{'*'*50}
-  Could not find 'rspec/autorun'
-
-  This may happen if you're using rubygems as your package manager, but it is not
-  being required through some mechanism before executing the rspec command.
-
-  You may need to do one of the following in your shell:
-
-    # for bash/zsh
-    export RUBYOPT=rubygems
-
-    # for csh, etc.
-    set RUBYOPT=rubygems
-
-  For background, please see http://gist.github.com/54177.
-#{'*'*50}
-  EOS
-  exit(1)
-end
+require 'rspec/core'
+RSpec::Core::Runner.invoke