Add #fits and #xits methods

RSpec core library has a convention of prepending 'f' and 'x' to it's methods to support running certain blocks or tests with :focus or :skip tags. This commit aims to bring rspec-its inline with this convention by making #fits and #xits methods available to the spec writer.

.gitignore

@@ -17,3 +17,5 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+bundle
+bin

README.md

@@ -97,6 +97,13 @@ Metadata arguments are supported.
 its(:size, focus: true) { should eq(1) }
 ```
 
+Alternatively, you can use the `f` and `x` prefix for `focus` and `skip` metadata, respectively.
+
+```ruby
+fits(:size) { should eq(1) }
+xits(:not_implemented_method) { will_not raise_error }
+```
+
 ## Contributing
 
 1. Fork it

lib/rspec/its.rb

@@ -171,12 +171,40 @@ def should_not(matcher=nil, message=nil)
       end
     end
 
+    # Calls the #its method adding the :focus tag to metadata to allowing
+    # to be run in focus.
+    #
+    # @example
+    #
+    #   # This ...
+    #   describe Array do
+    #     fits(:size) { should eq(0) }
+    #   end
+    def fits(attribute, *options, &block)
+      opts = (Array(options) << :focus).uniq
+      its(attribute, *opts, &block)
+    end
+
+    # Calls the #its method adding the :skip tag to metadata to allowing
+    # to be be skipped.
+    #
+    # @example
+    #
+    #   # This ...
+    #   describe Array do
+    #     xits(:size) { should eq(0) }
+    #   end
+    def xits(attribute, *options, &block)
+      opts = (Array(options) << :skip).uniq
+      its(attribute, *opts, &block)
+    end
+
   end
 end
 
 RSpec.configure do |rspec|
   rspec.extend RSpec::Its
-  rspec.backtrace_exclusion_patterns << %r(/lib/rspec/its)
+  rspec.backtrace_exclusion_patterns << %r{/lib/rspec/its/fits/xits}
 end
 
 RSpec::SharedContext.send(:include, RSpec::Its)

spec/rspec/its_spec.rb

@@ -9,6 +9,7 @@ module RSpec
           its([]) { expect(described_class).to be Its }
         end
       end
+
       context "with explicit subject" do
         subject do
           Class.new do
@@ -243,6 +244,7 @@ def false_if_first_time
           end
         end
       end
+
       context "with metadata" do
         context "preserves access to metadata that doesn't end in hash" do
           its([], :foo) do |example|
@@ -376,5 +378,58 @@ def terminator
         end
       end
     end
+
+    describe "#fits" do
+      it 'calls #its with :focus metadata' do
+        stub = Class.new do
+          include RSpec::Its
+        end.new
+        allow(stub).to receive(:its)
+
+        expect(stub).to receive(:its).with('attribute', :focus).and_yield
+        stub.fits('attribute') {}
+      end
+
+      it "fits is focused within the example group" do
+        ex_it, ex_fits = nil
+
+        RSpec.describe do
+          extend RSpec::Its
+
+          ex_it = its(:name) { :its_example }
+          ex_fits = fits(:class) { :fits_example }
+        end
+
+        expect(ex_it.examples.first.metadata[:focus]).to be_falsey
+        expect(ex_fits.examples.first.metadata[:focus]).to be_truthy
+      end
+    end
+
+    describe "#xits" do
+      it 'calls #its with :skip metadata' do
+        stub = Class.new do
+          include RSpec::Its
+        end.new
+        allow(stub).to receive(:its)
+
+        expect(stub).to receive(:its).with('attribute', :skip).and_yield
+        stub.xits('attribute') {}
+      end
+
+      it "xits is skipped within the example group" do
+        ex_it, ex_xits = nil
+
+        RSpec.describe do
+          extend RSpec::Its
+
+          ex_it = its(:name) { :its_example }
+          ex_xits = xits(:class) { :xits_example }
+        end
+
+        expect(ex_it.examples.first.metadata[:skip]).to be_falsey
+        expect(ex_xits.examples.first.metadata[:skip]).to be_truthy
+      end
+    end
+
   end
 end

spec/spec_helper.rb

@@ -1,6 +1,6 @@
 require 'rspec/its'
 
-Dir['./spec/support/**/*'].each {|f| require f}
+Dir['./support/**/*.rb'].each {|f| require f}
 
 class NullFormatter
   private