capybara-wheel 0.0.5 → 0.0.6

data/README.md

@@ -32,6 +32,25 @@ Specs are always written in one uniform, clean, way - always calling the same mo
 
 The Element model DSL is still eaily customisable just like "normal" page model classes so domain specfic applications are just as easy, resulting in descriptive, easy to read specs.
 
+## Example spec:
+
+    feature "Supervillan Console" do
+
+     let(:supervillan_console) { SuperVillanConsole.new }
+
+     it 'can destroy the world with the push of a button' do
+        supervillan_console.visit do |page|
+          page.button_of_doom.should be_present
+          page.button_of_doom.click
+
+          # assert that world was destroyed
+        end
+     end
+
+    end
+
+More spec goodness below.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -117,7 +136,11 @@ Out of the box, Element accepts all the old familar Capybara Element actions / q
 
 Passing a block to element gives access to the Element object for the purpose of implamenting a subelement (see below) or rolling your own customised methods:
 
-**The `capybara_element` method is the direct accessor to the native Capybara element callback.**
+**The following messages are delegated to the native Capybara element callback.**
+
+```
+  #find, #click, #has_content?, #checked?, #text, #visible?, #present?, #selected?, #disabled?, #tag_name, #value, #set, #select_option, #unselect_option, #hover
+```
 
 **_Example:_**
 
@@ -156,7 +179,7 @@ When called inside an element block, the element behaves like an Element but is
         element 'ArmingKey', 'li.key' do
 
           def turn
-            capybara_element.click
+            click
           end
 
         end
@@ -168,7 +191,7 @@ When called inside an element block, the element behaves like an Element but is
        element 'ArmingKey', 'li.key' do
 
          def turn
-           capybara_element.click
+           click
          end
 
        end
@@ -176,6 +199,52 @@ When called inside an element block, the element behaves like an Element but is
 
      #=> SuperVillanConsole.new.button_of_world_peace.arming_key.turn
      #=> SuperVillanConsole.new.button_of_doom.arming_key.turn
+
+## Specs
+
+Wheel specs are written to always refer to the models and to never refer to Capybara directly. The page methods we implemented above allows us the do:
+
+    let(:some_page) { SomePageModel.new }
+
+    it 'can visit a page' do
+      some_page.visit
+    end
+
+The visit page would use the `on_page?` method to determine if we are indeed on the page. It will use Capyara's internal wait to poll the page until it is ready. We can then even excute within the scope of the page:
+
+    it 'can visit a page and pass a block to execute' do
+      some_page.visit do | page |
+        page.some_element.should be_visible
+      end
+    end
+
+    it 'can also just check if we're on the page without visiting it'
+      some_page.on do | page |
+        page.some_element.should be_visible
+      end
+    end
+
+
+**_Example:_**
+
+    feature "Supervillan Console" do
+
+      let(:supervillan_console) { SuperVillanConsole.new }
+
+      before :each do
+        supervillan_console.visit
+      end
+
+      scenario 'can arm doom button' do
+        supervillan_console.on do | con |
+          con.button_of_doom.arming_key.turn
+          con.button_of_doom.armed?.should be_true
+        end
+      end
+
+
+    end
+
 ***
 ***
 ***

data/lib/capybara/wheel/element.rb

@@ -17,6 +17,7 @@ module Capybara
         end
 
         def_delegators  :capybara_element,
+                        :find,
                         :click,
                         :has_content?,
                         :checked?,
@@ -79,8 +80,7 @@ module Capybara
           @selector
         end
 
-        protected
-
+        private
 
         # Finds a capybara element representing this thing
         def capybara_element

data/lib/capybara/wheel/page.rb

@@ -21,7 +21,7 @@ module Capybara
       # execute a block in the context of this page
       def on
         unless on_page?
-          raise "We don't appear to be on #{description}"
+          raise "We don't appear to be on the #{self.class}"
         end
         yield self if block_given?
         self
@@ -38,7 +38,7 @@ module Capybara
       end
 
       def has_title?(expected_title)
-        capybara.has_css?("head title", :text => expected_title)
+        capybara.has_css?("head title", text: expected_title)
       end
 
       def self.element(name, selector, &block)

data/lib/capybara/wheel/version.rb

@@ -1,5 +1,5 @@
 module Capybara
   module Wheel
-    VERSION = "0.0.5"
+    VERSION = "0.0.6"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capybara-wheel
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-17 00:00:00.000000000 Z
+date: 2013-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara