Add silence_filter_announcements config option

Author: draffensperger

Filtering.md

@@ -159,3 +159,16 @@ end
 ```
 
 These declarations can also be overridden from the command line.
+
+## Silencing filter announcements
+
+By default, RSpec will print a message before your specs run indicating what filters are configured, for instance, it might print "Run options: include {:focus=>true}" if you set `config.filter_run_including :focus => true`.
+
+If you wish to prevent those messages from appearing in your spec output, you can set the `silence_filter_announcements` config setting to `true` like this:
+
+``` ruby
+RSpec.configure do |c|
+  c.filter_run_including :foo => :bar
+  c.silence_filter_announcements = true
+end
+```

lib/rspec/core/configuration.rb

@@ -293,6 +293,11 @@ def exclude_pattern=(value)
       #   :cyan]`
       add_setting :detail_color
 
+      # @macro add_setting
+      # Don't print filter info i.e. "Run options: include {:focus=>true}"
+      # (default `false`).
+      add_setting :silence_filter_announcements
+
       # Deprecated. This config option was added in RSpec 2 to pave the way
       # for this being the default behavior in RSpec 3. Now this option is
       # a no-op.

lib/rspec/core/world.rb

@@ -106,6 +106,8 @@ def reporter
       # Notify reporter of filters.
       def announce_filters
         fail_if_config_and_cli_options_invalid
+        return if @configuration.silence_filter_announcements?
+
         filter_announcements = []
 
         announce_inclusion_filter filter_announcements

spec/rspec/core/world_spec.rb

@@ -224,6 +224,15 @@ module RSpec::Core
             world.announce_filters
           end
         end
+
+        context "with a filter but with silence_filter_announcements" do
+          it "does not announce" do
+            configuration.silence_filter_announcements = true
+            configuration.filter_run_including :foo => 'bar'
+            expect(reporter).to_not receive(:message)
+            world.announce_filters
+          end
+        end
       end
 
       context "with examples" do