Add #fits and #xits methods

.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 = (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 = (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}
 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,41 @@ def terminator
         end
       end
     end
+
+    describe "#fits" do
+      describe "focus with metadata" do
+        let(:group) do
+          RSpec.describe do
+            extend RSpec::Its
+
+            fits(:class) { true }
+          end
+        end
+        let(:reporter) { RSpec::Core::Reporter.new(RSpec::Core::Configuration.new) }
+
+        it "generates a focused example" do
+          group.run(reporter)
+          expect(group.descendants.last.examples.first.metadata[:focus]).to be_truthy
+        end
+      end
+    end
+
+    describe "#xits" do
+      describe "skip with metadata" do
+        let(:group) do
+          RSpec.describe do
+            extend RSpec::Its
+
+            xits(:class) { true }
+          end
+        end
+        let(:reporter) { RSpec::Core::Reporter.new(RSpec::Core::Configuration.new) }
+
+        it "generates a focused example" do
+          group.run(reporter)
+          expect(group.descendants.last.examples.first.metadata[:skip]).to be_truthy
+        end
+      end
+    end
   end
 end

spec/spec_helper.rb

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