specify 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 51a6a40ea1a8835716239602449fa4b8feb22a8f
-  data.tar.gz: c96cf0c60973e219a2546ec7ff04a5767392a855
+  metadata.gz: 3c481008f53c158790b8973606e46818aa144aa2
+  data.tar.gz: d1650d893f25b1c2a58084d1309d25f159df06d5
 SHA512:
-  metadata.gz: 34052922c3cbc64d2fc96215996ce4b23f44c3abea5e2b9e6480322f2da1be17755e71d53198b29e75143b837bf23d54498aa6e31b5739e865e253bd69e27926
-  data.tar.gz: c7df422b9314f06096b123549c949aaa1652580bcd28d1d6d6f6e198500ce494040734fa366399c5c06569bc1f288df50b8d4c24d7a3c26d7965ca54eef08e53
+  metadata.gz: 37b8be3fed44a9fea07ddf144bc20f80488ac04990d35176c3274467707fcc30bed0114d7bc28c4b79f823728df92f1680f08ecef1f53af6f6957c3b0f6656e0
+  data.tar.gz: ef72dc01b56e3deee8709ce44a0138f2f6a97b414a9a61c3a1832bf4879cee29357c1fe414ca15b1014a62bc551e411eb9d6a7ad25e972c5a17fc720ed2f9440

data/Gemfile

@@ -1,6 +1,7 @@
 source 'https://rubygems.org'
 
 gem 'simplecov', '~> 0.9.0', require: false
+gem 'coveralls', require: false
 
 # Specify your gem's dependencies in specify.gemspec
 gemspec

data/README.md

@@ -2,6 +2,7 @@
 
 [![Codeship Status for jnyman/specify](https://www.codeship.io/projects/6fd98900-39d1-0132-7358-4e57ec3927cd/status)](https://www.codeship.io/projects/42264)
 
+[![Coverage Status](https://img.shields.io/coveralls/jnyman/specify.svg)](https://coveralls.io/r/jnyman/specify?branch=master)
 [![Gem Version](https://badge.fury.io/rb/specify.svg)](http://badge.fury.io/rb/specify)
 [![Dependency Status](https://gemnasium.com/jnyman/specify.svg)](https://gemnasium.com/jnyman/specify)
 [![Code Climate](https://codeclimate.com/github/jnyman/specify/badges/gpa.svg)](https://codeclimate.com/github/jnyman/specify)

data/lib/specify/rspec/example_group.rb

@@ -1,6 +1,14 @@
 module RSpec
   module Specify
     module ExampleGroup
+
+      # In Rspec, example group bodies are delimited by 'describe' and
+      # 'context' methods. These encapsulate examples, which are
+      # delimited by 'it' methods. Example groups are evaluated in the
+      # context of an ExampleGroup instance. Individual examples are
+      # evaluated in the context of an instance of the ExampleGroup
+      # to which they belong.
+
       def include_steps(*args)
         name = args.shift
         shared_block = ::RSpec.world.shared_example_steps[name]
@@ -9,27 +17,46 @@ module RSpec
       end
 
       def Given(message, options={}, &block)
-        RSpec.world.reporter.process_example_step(self, :given, message, options, &block)
+        Step :given, message, options, &block
       end
 
       def When(message, options={}, &block)
-        RSpec.world.reporter.process_example_step(self, :when, message, options, &block)
+        Step :when, message, options, &block
       end
 
       def Then(message, options={}, &block)
-        RSpec.world.reporter.process_example_step(self, :then, message, options, &block)
+        Step :then, message, options, &block
       end
 
       def And(message, options = {}, &block)
-        RSpec.world.reporter.process_example_step(self, :and, message, options, &block)
+        Step :and, message, options, &block
       end
 
       def But(message, options = {}, &block)
-        RSpec.world.reporter.process_example_step(self, :but, message, options, &block)
+        Step :but, message, options, &block
       end
 
       def _(message, options = {}, &block)
-        RSpec.world.reporter.process_example_step(self, :_, message, options, &block)
+        Step :_, message, options, &block
+      end
+
+      private
+
+      def Step(type, message, options = {}, &block)
+        ::RSpec.world.reporter.example_step_started(self, type, message, options)
+
+        if block_given? && !options[:pending]
+          begin
+            yield
+          rescue Exception => e
+            ::RSpec.world.reporter.example_step_failed(self, type, message, options)
+            raise e
+          end
+          ::RSpec.world.reporter.example_step_passed(self, type, message, options)
+        else
+          ::RSpec.world.reporter.example_step_pending(self, type, message, options)
+        end
+
       end
     end
   end

data/lib/specify/rspec/notification.rb

@@ -1,5 +1,8 @@
 module RSpec
   module Specify
+
+    # In RSpec, notifications are value objects that are passed to formatters
+    # to provide those formatters with information about a particular event.
     class Notification < Struct.new(:example, :type, :message, :options)
     end
   end

data/lib/specify/rspec/reporter.rb

@@ -1,21 +1,9 @@
 module RSpec
   module Specify
     module Reporter
-      def process_example_step(example, type, message, options)
-        example_step_started(self, type, message, options)
 
-        if block_given? && !options[:pending]
-          begin
-            yield
-          rescue Exception => e
-            example_step_failed(self, type, message, options)
-            raise e
-          end
-          example_step_passed(self, type, message, options)
-        else
-          example_step_pending(self, type, message, options)
-        end
-      end
+      # An RSpec reporter sends notifications to listeners. The listeners
+      # are usually formatters for a specific test run.
 
       def example_step_started(example, type, message, options)
         notify :example_step_started, Notification.new(example, type, message, options)

data/lib/specify/rspec/world.rb

@@ -1,6 +1,10 @@
 module RSpec
   module Specify
     module World
+
+      # RSpec's world is an internal container for global
+      # non-configuration data.
+
       def shared_example_steps
         @shared_example_steps ||= {}
       end

data/lib/specify/spec.rb

@@ -0,0 +1,19 @@
+module Specify
+  module Spec
+    def self.included(base)
+      base.instance_eval do
+        alias :Background :before
+      end
+    end
+  end
+end
+
+def self.Feature(*args, &block)
+  describe(*args, &block)
+end
+
+def self.Ability(*args, &block)
+  describe(*args, &block)
+end
+
+RSpec.configuration.include Specify::Spec

data/lib/specify/version.rb

@@ -1,3 +1,3 @@
 module Specify
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/specify.rb

@@ -11,6 +11,7 @@ require 'rspec/core/formatters'
 require 'rspec/core/formatters/console_codes'
 require 'rspec/core/formatters/documentation_formatter'
 
+require 'specify/spec'
 require 'specify/rspec/example_group'
 require 'specify/rspec/notification'
 require 'specify/rspec/reporter'

data/spec/shared_steps_spec.rb

@@ -30,7 +30,19 @@ shared_steps 'pull steps' do
   end
 end
 
-describe 'shared steps' do
+context 'duplicate shared steps' do
+  it 'will raise an error' do
+    expect {
+      shared_steps 'duplicate' do
+      end
+
+      shared_steps 'duplicate' do
+      end
+    }.to raise_error
+  end
+end
+
+Feature 'shared steps' do
   let(:pipe) do
     Class.new do
       def initialize
@@ -55,22 +67,26 @@ describe 'shared steps' do
     end.new
   end
 
-  steps 'push and pull steps' do
+  Scenario 'push and pull steps' do
     include_steps 'push steps'
     include_steps 'pull steps'
   end
 
-  steps 'push, count and pull' do
+  Scenario 'push, count and pull' do
     include_steps 'push steps'
+
     Then 'pipe should have one item' do
       expect(pipe.items.size).to eq(1)
     end
+
     include_steps 'pull steps'
   end
 
-  steps 'push with arguments and pull' do
-    include_steps 'push with argument steps', 'testing'
-    expect(pipe.items).to eq(['testing'])
+  Scenario 'push with arguments and pull' do
+    include_steps 'push with argument steps', 'specify'
+
+    expect(pipe.items).to eq(['specify'])
+
     include_steps 'pull steps'
   end
 end

data/spec/spec_helper.rb

@@ -1,6 +1,12 @@
 require 'simplecov'
+require 'coveralls'
 
-SimpleCov.formatter = SimpleCov::Formatter::HTMLFormatter
+Coveralls.wear!
+
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+                                                          ]
 
 SimpleCov.start do
   add_filter '/spec/'

data/spec/steps_spec.rb

@@ -1,6 +1,6 @@
 require 'spec_helper'
 
-describe 'specify steps' do
+Ability 'specify steps' do
   describe 'Given/When/Then' do
     steps 'should execute blocks' do
       Given 'context' do
@@ -41,6 +41,19 @@ describe 'specify steps' do
       Given 'step without block'
       When  'step without block'
       Then  'step without block'
+
+      Given 'step without block and tag', pending: true
+      Given 'step without block and message', pending: 'wip'
+    end
+  end
+
+  describe 'Failing steps' do
+    steps 'will fail' do
+      expect {
+        _ 'expectation alerts failure' do
+          expect(2 + 2).to eq 5
+        end
+      }.to raise_error
     end
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: specify
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Jeff Nyman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-19 00:00:00.000000000 Z
+date: 2014-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -88,6 +88,7 @@ files:
 - lib/specify/rspec/reporter.rb
 - lib/specify/rspec/shared_steps.rb
 - lib/specify/rspec/world.rb
+- lib/specify/spec.rb
 - lib/specify/version.rb
 - spec/shared_steps_spec.rb
 - spec/spec_helper.rb
@@ -98,7 +99,7 @@ licenses:
 - MIT
 metadata: {}
 post_install_message: "\n(::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)\n\n
-  \ Specify 0.2.0 has been installed.\n\n(::) (::) (::) (::) (::) (::) (::) (::) (::)
+  \ Specify 0.3.0 has been installed.\n\n(::) (::) (::) (::) (::) (::) (::) (::) (::)
   (::) (::) (::)\n  "
 rdoc_options: []
 require_paths: