kelp 0.1.5 → 0.1.6

data/.gitignore

@@ -1,8 +1,10 @@
 *.swp
 .bundle
 coverage
+coverage.data
 docs/_build
 .rvmrc
 doc
 .yardoc
 examples/sinatra_app/features/step_definitions
+pkg

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    kelp (0.1.5)
+    kelp (0.1.6)
       capybara (>= 0.4.0)
 
 GEM

data/History.md

@@ -1,6 +1,14 @@
 Kelp History
 ============
 
+0.1.6
+-----
+
+- Improved generated step definitions in kelp_steps.rb, fixed some bugs therein
+- Expanded cucumber self-tests for generated step definitions
+- Fixed bug with field_should_be_empty; now works with textarea
+
+
 0.1.5
 -----
 

data/README.md

@@ -94,6 +94,20 @@ See the
 for more information.
 
 
+Rails generator
+---------------
+
+Kelp provides a generator for Rails 2.x projects, to quickly add some generic
+step definitions. Simply run:
+
+    $ script/generate kelp
+
+This will create `features/step_definitions/kelp_steps.rb` with some example
+step definitions using Kelp's helper methods.
+
+A Rails 3.x generator is not currently provided. Contributions are welcome!
+
+
 Development
 -----------
 
@@ -122,24 +136,26 @@ then [submit a pull request](http://github.com/wapcaplet/kelp/pulls).
 Testing
 -------
 
-Kelp comes with a `Rakefile`, so you can run the RSpec tests like so:
+Kelp comes with a `Rakefile`, so you can run the RSpec tests and generate an
+[rcov](http://eigenclass.org/hiki.rb?rcov) coverage report via:
 
     $ rake spec
 
-You can also generate an [rcov](http://eigenclass.org/hiki.rb?rcov)
-coverage report via:
+This will write an HTML report to `coverage/index.html`. Finally, there are
+some Cucumber self-tests included, mainly for testing the `kelp_steps.rb`
+file used by the Rails generator. Run via:
 
-    $ rake rcov
+    $ rake cucumber
 
-This will write an HTML report to `coverage/index.html`.
+This self-test is a single scenario that exercises scenarios in
+`examples/sinatra_app/features`, and ensures that they perform as expected.
 
 
 Future plans
 ------------
 
-* Write Cucumber integration tests
+* Generator for Rails 3
 * Support other stuff besides Capybara
-* Turn the project into a proper Rails plugin, with generators
 
 
 Copyright

data/Rakefile

@@ -1,16 +1,39 @@
 require 'rubygems'
 require 'rspec/core/rake_task'
+require 'cucumber/rake/task'
 
-RSpec::Core::RakeTask.new do |spec|
-  spec.pattern = 'spec/**/*_spec.rb'
-  spec.rspec_opts = ['--color', '--format doc']
+desc "Run RSpec tests with coverage analysis"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+  t.rspec_opts = ['--color', '--format doc']
+  t.rcov = true
+  t.rcov_opts = [
+    '--exclude /.gem/,/gems/,spec,features,examples',
+    '--include lib/**/*.rb',
+    '--aggregate coverage.data',
+  ]
 end
 
-desc "Generate RCov coverage report"
-RSpec::Core::RakeTask.new(:rcov) do |spec|
-  spec.pattern = 'spec/**/*_spec.rb'
-  spec.rspec_opts = ['--color', '--format doc']
-  spec.rcov = true
-  spec.rcov_opts = %w{--exclude osx\/objc,gems\/,spec\/,features\/}
+desc "Run Cucumber tests with coverage analysis"
+Cucumber::Rake::Task.new(:cucumber) do |t|
+  t.cucumber_opts = [
+    "--format pretty",
+    "--tags ~@wip",
+  ]
+  t.rcov = true
+  t.rcov_opts = [
+    '--exclude /.gem/,/gems/,spec,features,examples',
+    '--include lib/**/*.rb',
+    '--aggregate coverage.data',
+  ]
 end
 
+desc "Run RSpec and Cucumber tests with coverage analysis"
+task :all do |t|
+  rm 'coverage.data' if File.exist?('coverage.data')
+  Rake::Task['rcov:spec'].invoke
+  Rake::Task['rcov:cucumber'].invoke
+end
+
+task :default => ['all']
+

data/examples/sinatra_app/features/checkbox.feature

@@ -0,0 +1,12 @@
+Feature: Checkboxes
+
+  Background:
+    Given I visit "/form"
+
+  Scenario: Checkbox should be checked
+    Then the "Like" checkbox next to "Apple" should be checked
+    And the "Like" checkbox next to "Apple" should not be unchecked
+
+  Scenario: Checkbox should not be checked
+    Then the "Like" checkbox next to "Banana" should be unchecked
+    And the "Like" checkbox next to "Banana" should not be checked

data/examples/sinatra_app/features/dropdown.feature

@@ -17,6 +17,12 @@ Feature: Dropdowns
       | Single 'quotes' |
       | "Double" quotes |
       | 'Single' and "Double" quotes |
+    And the "Favorite Colors" dropdown should include:
+      """
+      Red
+      Green
+      Blue
+      """
 
   Scenario: Dropdown should not include
     Then the "Height" dropdown should not include "Midget"

data/examples/sinatra_app/features/field.feature

@@ -0,0 +1,18 @@
+Feature: Fields
+
+  Background:
+    Given I visit "/form"
+
+  Scenario: Field should be empty
+    Then the "First name" field should be empty
+    And the "First name" field within "#person_form" should be empty
+    And the "Last name" field should be empty
+    And the "Last name" field within "#person_form" should be empty
+
+  Scenario: Fields should contain
+    Then the fields should contain:
+      | First name |                        |
+      | Last name  |                        |
+      | Weight     | Light                  |
+      | Height     | Average                |
+      | Message    | Your message goes here |

data/examples/sinatra_app/features/visibility.feature

@@ -11,6 +11,7 @@ Feature: Visibility
     And I should not see the following:
       | Goodbye cruel world |
 
+
   Scenario: Should or shouldn't see in same row
     Then I should see a table row containing:
       | Eric | Edit |
@@ -26,3 +27,9 @@ Feature: Visibility
       | John  | Delete |
       | Terry | Delete |
 
+
+  Scenario: Should or shouldn't see next to
+    Then I should see "Edit" next to "John"
+    And I should not see "Delete" next to "John"
+
+

data/examples/sinatra_app/views/form.erb

@@ -13,6 +13,10 @@
         <label for="last_name">Last name</label>
         <input id="last_name" type="text" />
       </p>
+      <p>
+        <label for="biography">Life story</label>
+        <textarea id="biography" cols="80" rows="10" />
+      </p>
       <p>
         <label for="height">Height</label>
         <select id="height">
@@ -53,6 +57,10 @@
         <label for="like_salami">I like salami</label>
         <input id="like_salami" type="checkbox" />
       </p>
+      <p>
+        <label for="message">Message</label>
+        <input id="message" type="text" value="Your message goes here" />
+      </p>
       <p><input type="submit" value="Submit" /></p>
     </form>
   </div>
@@ -68,16 +76,18 @@
     <form action="/thanks" method="get">
       <table>
         <tr>
-          <td><label for="check_a">Apple</label></td>
-          <td><input id="check_a" type="checkbox"/></td>
-        </tr>
-        <tr>
-          <td><label for="check_b">Banana</label></td>
-          <td><input id="check_b" type="checkbox"/></td>
+          <th>Apple</th>
+          <td>
+            <label for="like_apple">Like</label>
+            <input id="like_apple" type="checkbox" checked="checked"/>
+          </td>
         </tr>
         <tr>
-          <td><label for="check_c">Carrot</label></td>
-          <td><input id="check_c" type="checkbox"/></td>
+          <th>Banana</th>
+          <td>
+            <label for="like_banana">Like</label>
+            <input id="like_banana" type="checkbox"/>
+          </td>
         </tr>
       </table>
     </form>

data/features/kelp_step_definitions.feature

@@ -3,12 +3,38 @@ Feature: Kelp Step Definitions
   As a Kelp developer
   I want to be sure the step definitions Kelp provides work correctly
 
-  Scenario: Regression test
-    Given a sinatra application with the latest Kelp step definitions
-    When I run "cucumber features -q --no-color" in the sinatra app
+  Background:
+    Given the latest Kelp step definitions
+
+  Scenario: Checkbox test
+    When I run cucumber on "checkbox.feature"
+    Then the results should be:
+      """
+      2 scenarios (2 passed)
+      6 steps (6 passed)
+      """
+
+  Scenario: Dropdown test
+    When I run cucumber on "dropdown.feature"
+    Then the results should be:
+      """
+      3 scenarios (3 passed)
+      11 steps (11 passed)
+      """
+
+  Scenario: Field test
+    When I run cucumber on "field.feature"
+    Then the results should be:
+      """
+      2 scenarios (2 passed)
+      7 steps (7 passed)
+      """
+
+  Scenario: Visibility test
+    When I run cucumber on "visibility.feature"
     Then the results should be:
       """
-      5 scenarios (5 passed)
-      18 steps (18 passed)
+      3 scenarios (3 passed)
+      11 steps (11 passed)
       """
 

data/features/step_definitions/app_steps.rb

@@ -2,8 +2,8 @@
 
 require 'fileutils'
 
-Given /^a (\w+) application with the latest Kelp step definitions$/ do |platform|
-  app_dir = File.join(root_dir, 'examples', "#{platform}_app")
+Given /^the latest Kelp step definitions$/ do
+  app_dir = File.join(root_dir, 'examples', "sinatra_app")
   installed_steps = File.join(app_dir, 'features', 'step_definitions', 'kelp_steps.rb')
   latest_steps = File.join(root_dir, 'rails_generators', 'kelp', 'templates', 'kelp_steps.rb')
   # Remove the installed kelp_steps.rb, if any, then install the latest one
@@ -12,15 +12,23 @@ Given /^a (\w+) application with the latest Kelp step definitions$/ do |platform
   FileUtils.cp_r(latest_steps, installed_steps)
 end
 
-When /^I run "(.+)" in the (\w+) app$/ do |command, platform|
-  command.gsub!('cucumber', "#{Cucumber::RUBY_BINARY} #{Cucumber::BINARY}")
-  app_dir = File.join(root_dir, 'examples', "#{platform}_app")
+
+When /^I run cucumber on "(.+)"$/ do |feature|
+  cucumber = "#{Cucumber::RUBY_BINARY} #{Cucumber::BINARY}"
+  opts = "-q --no-color"
+  command = "#{cucumber} #{opts} features/#{feature}"
+  app_dir = File.join(root_dir, 'examples', "sinatra_app")
   Dir.chdir(app_dir) do
     @output = `#{command}`
   end
 end
 
+
 Then /^the results should be:$/ do |expected_results|
-  @output.should include(expected_results)
+  if !@output.include?(expected_results)
+    got = @output.collect {|line| "  #{line}"}.join
+    want = expected_results.collect {|line| "  #{line}"}.join
+    raise("Expected:\n#{want}\nGot:\n#{got}")
+  end
 end
 

data/kelp.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = "kelp"
-  s.version = "0.1.5"
+  s.version = "0.1.6"
   s.summary = "Cucumber helper methods"
   s.description = <<-EOS
     Kelp is a collection of helper methods for Cucumber to ease the process of

data/lib/kelp/field.rb

@@ -57,12 +57,12 @@ module Kelp
 
 
     # Verify that the given field is empty or nil.
-    def field_should_be_empty(field)
-      _field = nice_find_field(field)
-      if _field.nil? || _field.value.nil?
-        return true
-      else
-        raise RuntimeError, "Expected field '#{field}' to be empty, but value is '#{_field.value}'"
+    def field_should_be_empty(field, scope={})
+      in_scope(scope) do
+        _field = nice_find_field(field)
+        if !(_field.nil? || _field.value.nil? || _field.value == '')
+          raise RuntimeError, "Expected field '#{field}' to be empty, but value is '#{_field.value}'"
+        end
       end
     end
 

data/lib/kelp/scoping.rb

@@ -3,9 +3,9 @@ module Kelp
   # verifications on a webpage.
   #
   module Scoping
-    # Execute a block of code within a given scope.
-    # `locator` may be in css or xpath form, depending on what type
-    # is set in Capybara.default_locator.
+    # Execute a block of code within a given scope. If `locator` begins with
+    # `/` or `./`, then it's assumed to be an XPath selector; otherwise, it's
+    # assumed to be a CSS selector.
     def scope_within(locator)
       if locator
         # Use the selector_for method if it's defined
@@ -15,7 +15,11 @@ module Kelp
         # and fall back on the Capybara locator syntax (CSS or XPath)
         else
           locator.gsub!(/^"(.*?)"$/, '\1')
-          within(locator) { yield }
+          if locator =~ /\.?\//
+            within(:xpath, locator) { yield }
+          else
+            within(:css, locator) { yield }
+          end
         end
       else
         yield

data/rails_generators/kelp/templates/kelp_steps.rb

@@ -14,11 +14,30 @@
 #
 
 require 'kelp'
-World(Kelp::Visibility)
+World(Kelp::Attribute)
+World(Kelp::Checkbox)
 World(Kelp::Dropdown)
+World(Kelp::Field)
+World(Kelp::Navigation)
+World(Kelp::Scoping)
+World(Kelp::Visibility)
+
+module KelpStepHelper
+  # Convert a Cucumber::Ast::Table or multiline string into
+  # a list of strings
+  def listify(items)
+    if items.class == Cucumber::Ast::Table
+      strings = items.raw.flatten
+    else
+      strings = items.split(/[\r\n]+/)
+    end
+  end
+end
+World(KelpStepHelper)
 
 SHOULD_OR_NOT = /(should|should not)/
 WITHIN = /(?: within "([^\"]+)")?/
+ELEMENT = /(?:field|checkbox|dropdown|button)/
 STR = /([^\"]+)/
 
 # Verify the presence or absence of multiple text strings in the page,
@@ -30,23 +49,19 @@ STR = /([^\"]+)/
 # `items` may be a Cucumber table, or a multi-line string. Examples:
 #
 #   Then I should see the following:
-#     | First thing |
-#     | Next thing |
-#     | Last thing |
+#     | Apple crumble    |
+#     | Banana cream pie |
+#     | Cherry tart      |
 #
 #   Then I should see the following:
 #     """
-#     First thing
-#     Next thing
-#     Last thing
+#     Bacon & Eggs
+#     Biscuits & Gravy
+#     Hash Browns
 #     """
 #
 Then /^I #{SHOULD_OR_NOT} see the following#{WITHIN}:$/ do |expect, selector, items|
-  if items.class == Cucumber::Ast::Table
-    strings = items.raw.flatten
-  else
-    strings = items.split("\n")
-  end
+  strings = listify(items)
   if expect == 'should'
     should_see strings, :within => selector
   else
@@ -58,6 +73,15 @@ end
 # Verify that one or more table rows containing the correct values exist (or do
 # not exist). Rows do not need to match exactly, and fields do not need to be
 # in the same order.
+#
+# Examples:
+#
+#   Then I should see table rows containing:
+#     | Eric | Edit |
+#     | John | Edit |
+#   And I should not see a table row containing:
+#     | Eric | Delete |
+#
 Then /^I #{SHOULD_OR_NOT} see (?:a table row|table rows)#{WITHIN} containing:$/ do |expect, selector, rows|
   rows.raw.each do |fields|
     if expect == 'should'
@@ -72,12 +96,22 @@ end
 # Verify that a dropdown has a given value selected. This verifies the visible
 # value shown to the user, rather than the value attribute of the selected
 # option element.
+#
+# Examples:
+#
+#   Then the "Height" dropdown should equal "Average"
+#
 Then /^the "#{STR}" dropdown#{WITHIN} should equal "#{STR}"$/ do |dropdown, selector, value|
   dropdown_should_equal(dropdown, value, :within => selector)
 end
 
 
 # Verify that a dropdown includes or doesn't include the given value.
+#
+# Examples:
+#
+#   Then the "Height" dropdown should include "Tall"
+#
 Then /^the "#{STR}" dropdown#{WITHIN} #{SHOULD_OR_NOT} include "#{STR}"$/ do |dropdown, selector, expect, value|
   if expect == 'should'
     dropdown_should_include(dropdown, value, :within => selector)
@@ -87,9 +121,25 @@ Then /^the "#{STR}" dropdown#{WITHIN} #{SHOULD_OR_NOT} include "#{STR}"$/ do |dr
 end
 
 
-# Verify that a dropdown includes or doesn't include all values in the given table.
+# Verify that a dropdown includes or doesn't include all values in the given
+# table or multiline string.
+#
+# Examples:
+#
+#   Then the "Height" dropdown should include:
+#     | Short   |
+#     | Average |
+#     | Tall    |
+#
+#   Then the "Favorite Colors" dropdown should include:
+#     """
+#     Red
+#     Green
+#     Blue
+#     """
+#
 Then /^the "#{STR}" dropdown#{WITHIN} #{SHOULD_OR_NOT} include:$/ do |dropdown, selector, expect, values|
-  values.raw.flatten.each do |value|
+  listify(values).each do |value|
     if expect == 'should'
       dropdown_should_include(dropdown, value, :within => selector)
     else
@@ -99,30 +149,73 @@ Then /^the "#{STR}" dropdown#{WITHIN} #{SHOULD_OR_NOT} include:$/ do |dropdown,
 end
 
 
-# Verify that a given field is empty or nil
+# Verify that a given field is empty or nil.
+#
+# Examples:
+#
+#   Then the "First name" field should be empty
+#
 Then /^the "#{STR}" field#{WITHIN} should be empty$/ do |field, selector|
-  with_scope(selector) do
-    field_should_be_empty field
-  end
+  field_should_be_empty(field, :within => selector)
 end
 
 
 # Verify multiple fields in a form, optionally restricted to a given selector.
-# Fields may be text inputs or dropdowns
+# Fields may be text inputs or dropdowns.
+#
+# Examples:
+#
+#   Then the fields should contain:
+#     | First name | Eric   |
+#     | Last name  | Pierce |
+#
 Then /^the fields#{WITHIN} should contain:$/ do |selector, fields|
   fields_should_contain_within(selector, fields.rows_hash)
 end
 
 
 # Verify that expected text exists or does not exist in the same row as
-# identifier text. This can be used to ensure the presence or absence of "Edit"
+# some text. This can be used to ensure the presence or absence of "Edit"
 # or "Delete" links, or specific data associated with a row in a table.
-Then /^I #{SHOULD_OR_NOT} see "#{STR}" next to "#{STR}"#{WITHIN}$/ do |expect, expected, identifier, selector|
-  with_scope(selector) do
+#
+# Examples:
+#
+#   Then I should see "Edit" next to "John"
+#   And I should not see "Delete" next to "John"
+#
+Then /^I #{SHOULD_OR_NOT} see "#{STR}" next to "#{STR}"#{WITHIN}$/ do |expect, text, next_to, selector|
+  if expect == 'should'
+    should_see_in_same_row([text, next_to], :within => selector)
+  else
+    should_not_see_in_same_row([text, next_to], :within => selector)
+  end
+end
+
+
+# Verify that several expected text strings exist or do not exist in the same
+# row as some text. Prevents multiple "should see X next to Y" calls. Similar
+# to "should see a row containing", but targeted toward a specific row.
+#
+# Examples:
+#
+#   Then I should see the following next to "Terry":
+#     | Copy   |
+#     | Edit   |
+#     | Delete |
+#
+#   Then I should see the following next to "John":
+#     """
+#     Copy
+#     Edit
+#     Delete
+#     """
+#
+Then /^I #{SHOULD_OR_NOT} see the following next to "#{STR}"#{WITHIN}:$/ do |expect, next_to, selector, items|
+  listify(items).each do |text|
     if expect == 'should'
-      should_see_in_same_row [expected, identifier]
+      should_see_in_same_row([text, next_to], :within => selector)
     else
-      should_not_see_in_same_row [expected, identifier]
+      should_not_see_in_same_row([text, next_to], :within => selector)
     end
   end
 end
@@ -130,19 +223,34 @@ end
 
 # Click a link in a table row that contains the given text.
 # This can be used to click the "Edit" link for a specific record.
-When /^I follow "#{STR}" next to "#{STR}"$/ do |link, identifier|
-  click_link_in_row(link, identifier)
+#
+# Examples:
+#
+#   When I follow "Edit" next to "John"
+#
+When /^I follow "#{STR}" next to "#{STR}"$/ do |link, next_to|
+  click_link_in_row(link, next_to)
 end
 
 
-# Verify that a checkbox in a certain table row is checked or unchecked
-Then /^the "#{STR}" checkbox next to "#{STR}"#{WITHIN} should be (checked|unchecked)$/ do |checkbox, text, selector, state|
-  within(:xpath, xpath_row_containing(text)) do
-    if state == 'checked'
-      checkbox_should_be_checked(checkbox, text, :within => selector)
+# Verify that a checkbox in a certain table row is checked or unchecked.
+# "should not be checked" and "should be unchecked" are equivalent, and
+# "should be checked" and "should not be unchecked" are equivalent.
+#
+# Examples:
+#
+#   Then the "Like" checkbox next to "Apple" should be checked
+#   And the "Like" checkbox next to "Banana" should be unchecked
+#
+Then /^the "#{STR}" checkbox next to "#{STR}"#{WITHIN} #{SHOULD_OR_NOT} be (checked|unchecked)$/ do |checkbox, next_to, selector, expect, state|
+
+  within(:xpath, xpath_row_containing(next_to)) do
+    if (expect == 'should' && state == 'checked') || (expect == 'should not' && state == 'unchecked')
+      checkbox_should_be_checked(checkbox, :within => selector)
     else
-      checkbox_should_not_be_checked(checkbox, text, :within => selector)
+      checkbox_should_not_be_checked(checkbox, :within => selector)
     end
   end
 end
 
+

data/spec/field_spec.rb

@@ -10,6 +10,7 @@ describe Kelp::Field, "field_should_be_empty" do
       it "is empty" do
         field_should_be_empty "first_name"
         field_should_be_empty "last_name"
+        field_should_be_empty "biography"
       end
     end
 
@@ -17,6 +18,7 @@ describe Kelp::Field, "field_should_be_empty" do
       it "is empty" do
         field_should_be_empty "First name"
         field_should_be_empty "Last name"
+        field_should_be_empty "Life story"
       end
     end
   end

data/spec/visibility_spec.rb

@@ -19,9 +19,13 @@ describe Kelp::Visibility, "should_see" do
         ]
       end
 
-      it "is within the scope" do
+      it "is within a CSS scope" do
         should_see "Hello world", :within => "#greeting"
       end
+
+      it "is within an XPath scope" do
+        should_see "Hello world", :within => "//div[@id='greeting']"
+      end
     end
 
     context "Regexp" do
@@ -29,10 +33,15 @@ describe Kelp::Visibility, "should_see" do
         should_see /(Hello|Goodbye) world/
       end
 
-      it "matches within the scope" do
+      it "matches within a CSS scope" do
         should_see /(Hello|Goodbye) world/, :within => "#greeting"
         should_see /(Hello|Goodbye) world/, :within => "#farewell"
       end
+
+      it "matches within an XPath scope" do
+        should_see /(Hello|Goodbye) world/, :within => "//div[@id='greeting']"
+        should_see /(Hello|Goodbye) world/, :within => "//div[@id='farewell']"
+      end
     end
   end
 
@@ -54,11 +63,23 @@ describe Kelp::Visibility, "should_see" do
         end.should raise_error(RSpec::Expectations::ExpectationNotMetError)
       end
 
-      it "is not within the scope" do
+      it "is not within a given CSS scope" do
         lambda do
           should_see "Goodbye world", :within => "#greeting"
         end.should raise_error(RSpec::Expectations::ExpectationNotMetError)
       end
+
+      it "is not within a given XPath scope" do
+        lambda do
+          should_see "Goodbye world", :within => "//div[@id='greeting']"
+        end.should raise_error(RSpec::Expectations::ExpectationNotMetError)
+      end
+
+      it "is given a nonexistent XPath scope" do
+        lambda do
+          should_see "Goodbye world", :within => "//div[@id='nonexistent']"
+        end.should raise_error(Capybara::ElementNotFound)
+      end
     end
 
     context "Regexp" do
@@ -97,9 +118,13 @@ describe Kelp::Visibility, "should_not_see" do
         ]
       end
 
-      it "exists but is not within the scope" do
+      it "exists but is not within the given CSS scope" do
         should_not_see "Goodbye world", :within => "#greeting"
       end
+
+      it "exists but is not within the given XPath scope" do
+        should_not_see "Goodbye world", :within => "//div[@id='greeting']"
+      end
     end
 
     context "Regexp" do
@@ -139,11 +164,17 @@ describe Kelp::Visibility, "should_not_see" do
         end.should raise_error(RSpec::Expectations::ExpectationNotMetError)
       end
 
-      it "exists within the scope" do
+      it "exists within the given CSS scope" do
         lambda do
           should_not_see "Hello world", :within => "#greeting"
         end.should raise_error(RSpec::Expectations::ExpectationNotMetError)
       end
+
+      it "exists within the given XPath scope" do
+        lambda do
+          should_not_see "Hello world", :within => "//div[@id='greeting']"
+        end.should raise_error(RSpec::Expectations::ExpectationNotMetError)
+      end
     end
 
     context "Regexp" do

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: kelp
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 23
   prerelease: false
   segments: 
   - 0
   - 1
-  - 5
-  version: 0.1.5
+  - 6
+  version: 0.1.6
 platform: ruby
 authors: 
 - Eric Pierce
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-15 00:00:00 -06:00
+date: 2011-04-20 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -139,7 +139,9 @@ files:
 - Rakefile
 - examples/sinatra_app/app.rb
 - examples/sinatra_app/config.ru
+- examples/sinatra_app/features/checkbox.feature
 - examples/sinatra_app/features/dropdown.feature
+- examples/sinatra_app/features/field.feature
 - examples/sinatra_app/features/support/env.rb
 - examples/sinatra_app/features/visibility.feature
 - examples/sinatra_app/features/web_steps.rb