kameleon 0.2.0.alpha.2 → 0.2.0

data/README.md

@@ -0,0 +1,247 @@
+# Kameleon [chameleon]
+
+[![Build Status](https://secure.travis-ci.org/cs3b/kameleon.png?branch=master)](http://travis-ci.org/cs3b/kameleon)
+
+Kameleon is a high abstraction dsl for better writing acceptance and integrationtests using Capybara.
+And "better" means: more easily to mimic how user interact with browser.
+
+## Setup
+
+Kameleon requires:
+
+* rspec
+* capybara
+
+Optionally is nice to use:
+
+* selenium-wedriver && capybara-webkit for testing together with javascript
+* thin (if you want run your specs faster - add gem 'thin' to Gemfile in your app)
+
+Gemfile
+
+``` ruby
+gem 'kameleon', '>= 0.2.0.alpha.2'
+```
+
+Before you start using Kameleon ensure that capybara is properly loaded (in your test helper file)
+
+``` ruby
+require 'kameleon/ext/rspec/all'
+```
+
+or just components you want; `kemeleon/ext/rspec/all` by default loads:
+
+``` ruby
+require 'kameleon/ext/rspec/dsl'
+require 'kameleon/ext/rspec/garbage_collector'
+require 'kameleon/ext/rspec/headless'
+```
+
+## Usage
+
+checkout this [slides from wrocloverb 2012](http://www.slideshare.net/cs3b/2012wrocloverbuserperspectivetestingusingruby)
+
+### Example One [listing products > should list existing products with correct sorting ]
+
+kameleon
+
+``` ruby
+click "Products"
+within('table.index') do
+  see :ordered => [ "apache baseball cap",
+                    "zomg shirt" ]
+end
+click "admin_products_listing_name_title"
+within('table.index') do
+  see :ordered => [ "zomg shirt",
+                    "apache baseball cap"]
+end
+```
+
+vs capybara
+
+``` ruby
+click_link "Products"
+within('table.index tr:nth-child(2)') { page.should have_content("apache baseball cap") }
+within('table.index tr:nth-child(3)') { page.should have_content("zomg shirt") }
+click_link "admin_products_listing_name_title"
+within('table.index tr:nth-child(2)') { page.should have_content("zomg shirt") }
+within('table.index tr:nth-child(3)') { page.should have_content("apache baseball cap") }
+```
+
+taken from: https://github.com/spree/spree/blob/master/core/spec/requests/admin/products/products_spec.rb#L22
+
+
+### Example Two [should allow an admin to create a new product and variants from a prototype]
+
+kameleon
+
+``` ruby
+click "Products",
+      "admin_new_product"
+fill_in "Baseball Cap" => "product_name",
+        "B100" => "product_sku",
+        "100" => "product_price",
+        "2012/01/24" => "product_available_on",
+        :select => { "Size" => "Prototype" },
+        :check => "Large"
+click "Create"
+see "successfully created!"
+```
+
+vs capybara
+
+``` ruby
+click_link "Products"
+click_link "admin_new_product"
+fill_in "product_name", :with => "Baseball Cap"
+fill_in "product_sku", :with => "B100"
+fill_in "product_price", :with => "100"
+fill_in "product_available_on", :with => "2012/01/24"
+select "Size", :from => "Prototype"
+check "Large"
+click_button "Create"
+page.should have_content("successfully created!")
+```
+
+taken from: https://github.com/spree/spree/blob/master/core/spec/requests/admin/products/products_spec.rb#L77
+
+
+### Example Three [admin editing an adjustment > successfully > should update the adjustment]
+
+kameleon
+
+``` ruby
+within(:row => 2).click "Edit"
+fill_in 99 => "adjustment_amount",
+        "rebate 99" => "adjustment_label"
+click "Continue"
+see "successfully updated!",
+    "rebate 99",
+    "$99.00"
+```
+
+vs capybara
+
+``` ruby
+within(:css, 'table.index tr:nth-child(2)') { click_link "Edit" }
+fill_in "adjustment_amount", :with => "99"
+fill_in "adjustment_label", :with => "rebate 99"
+click_button "Continue"
+page.should have_content("successfully updated!")
+page.should have_content("rebate 99")
+page.should have_content("$99.00")
+```
+
+taken from: https://github.com/spree/spree/blob/master/core/spec/requests/admin/orders/adjustments_spec.rb#L48
+
+### Example Four [payment method > should be able to list, edit, and create payment methods for an order]
+
+kameleon
+
+``` ruby
+click "Orders"
+within('table#listing_orders', :row => 1).click_link "R100"
+click "Payments"
+within('#payment_status').see "Payment: balance due"
+within(:cell => [2, 2]).see "$39.98"
+within(:cell => [2, 3]).see "Credit Card"
+within(:cell => [2, 4]).see "pending"
+```
+vs capybara
+
+``` ruby
+visit spree.admin_path
+click_link "Orders"
+within('table#listing_orders tbody tr:nth-child(1)') { click_link "R100" }
+click_link "Payments"
+within('#payment_status') { page.should have_content("Payment: balance due") }
+find('table.index tbody tr:nth-child(2) td:nth-child(2)').text.should == "$39.98"
+find('table.index tbody tr:nth-child(2) td:nth-child(3)').text.should == "Credit Card"
+find('table.index tbody tr:nth-child(2) td:nth-child(4)').text.should == "pending"
+```
+
+#### part II
+
+kameleon
+
+``` ruby
+click "Void"
+within('#payment_status').see "Payment: balance due"
+see "Payment Updated"
+within(:cell => [2,2]).see "$39.98"
+within(:cell => [2,3]).see "Credit Card"
+within(:cell => [2,4]).see "void"
+```
+
+vs capybara
+
+``` ruby
+click_button "Void"
+within('#payment_status') { page.should have_content("Payment: balance due") }
+page.should have_content("Payment Updated")
+find('table.index tbody tr:nth-child(2) td:nth-child(2)').text.should == "$39.98"
+find('table.index tbody tr:nth-child(2) td:nth-child(3)').text.should == "Credit Card"
+find('table.index tbody tr:nth-child(2) td:nth-child(4)').text.should == "void"
+```
+
+#### part III
+
+kameleon
+
+``` ruby
+click "New Payment"
+see "New Payment"
+click "Continue",
+      "Capture"
+within('#payment_status').see "Payment: paid"
+see :element => '#new_payment_section'
+
+click "Shipments",
+      "New Shipment"
+within('table.index', :row => 2).check "#inventory_unit"
+
+click "Create"
+see "successfully created!"
+```
+vs capybara
+
+``` ruby
+click_on "New Payment"
+page.should have_content("New Payment")
+click_button "Continue"
+click_button "Capture"
+within('#payment_status') { page.should have_content("Payment: paid") }
+page.should_not have_css('#new_payment_section')
+
+click_link "Shipments"
+click_on "New Shipment"
+within('table.index tbody tr:nth-child(2)') { check "#inventory_unit" }
+click_button "Create"
+page.should have_content("successfully created!")
+```
+
+taken from: https://github.com/spree/spree/blob/master/core/spec/requests/admin/orders/payments_spec.rb#L32
+
+
+## Tips & Tricks
+
+* You have access to page variable. So if you think that something cannot be accomplished by the Kameleon DSL, you can just write using RSpec matchers and page variable. Like this: `page.should have_css("li.banner_message", :count => 10)`. Of course, after you've submitted feature request to the owner of the original repository ;)
+* It is handy to define a common set of areas, that user often follows navigating on the site. Here is an example
+
+``` ruby
+Kameleon::Session.defined_areas.merge!({ :menu => [:xpath, "//nav/ul"],
+                                         :main => '.main_body',
+                                         :right_column => '.col_aside',
+                                         :ordered_list => '.ordered_list',
+                                         :favourites => '.favourites_list',
+                                         :gallery_tiny => '.gallery_tiny',
+                                         :gallery_list => '.gallery_list',
+                                         :content => '.col_content',
+                                         :col_aside => '.col_aside' })
+```
+
+## Credits
+* [Michał Czyż](http://selleo.com/people/michal-czyz)
+* [Radosław Jędryszczak](http://selleo.com/people/radoslaw-jedryszczak)
+* [Szymon Kieloch](http://selleo.com/people)

data/lib/kameleon/dsl.rb

@@ -56,8 +56,7 @@ module Kameleon
       if block_given?
         super(*parse_selector(scope).selector)
       else
-        #! we need proxy object to make it working
-        raise 'not impelemented'
+        ScopeProxy.new(self, scope)
       end
     end
 
@@ -94,5 +93,18 @@ module Kameleon
     def parse_selector(scope)
       Kameleon::DSL::Context::Scope.new(scope)
     end
+
+
+    class ScopeProxy < Struct.new(:world, :scope)
+
+      Kameleon::DSL.instance_methods.each do |method|
+        define_method method do |args|
+          world.within(scope) do
+            world.send(method, args)
+          end
+        end
+      end
+
+    end
   end
 end

data/lib/kameleon/dsl/act/mouse.rb

@@ -22,11 +22,44 @@ module Kameleon
             case param
               when String
                 actions << Action.new(:click_on, param)
+              when Symbol
+                prepare_actions(:element => param)
               when Hash
                 param.each_pair do |type, values|
                   case type
-                    when :non_implemented
-                      raise "not implemented"
+                    when :element
+                      actions << Action.new(:block, values) do |element|
+                        selector = Kameleon::DSL::Context::Scope.new(element).selector
+                        find(*selector).click
+                      end
+
+                    when :image
+                      #! Looks like Rack Test doesn't propagate click event up - this is simply hack
+                      # It's not perfect it would work only when "a" is parent of image (not one of ancestor)
+                      prepend_text = "/.." if ::Capybara.current_driver == :rack_test
+
+                      prepare_actions(:element => [:xpath, ".//img[@alt=\"#{values}\"]#{prepend_text}"])
+
+                    when :and_accept
+                      unless Capybara.current_driver == :rack_test
+                        #! js hack - problem with selenium native alerts usage
+                        #! it switch to alert window but no reaction on accept or dismiss
+                        actions << Action.new(:block, values) do |element|
+                          evaluate_script("window.alert = function(msg) { return true; }")
+                          evaluate_script("window.confirm = function(msg) { return true; }")
+                        end
+                      end
+                      prepare_actions(values)
+
+                    when :and_dismiss
+                      unless Capybara.current_driver == :rack_test
+                        actions << Action.new(:block, values) do |element|
+                          evaluate_script("window.alert = function(msg) { return true; }")
+                          evaluate_script("window.confirm = function(msg) { return false; }")
+                        end
+                        prepare_actions(values)
+                      end
+
                     else
                       raise "not implemented"
                   end
@@ -54,6 +87,4 @@ module Kameleon
 end
 
 #! click and dismiss
-#! click and accept
-#! click on image
-#! click on element
+#! click and accept

data/lib/kameleon/dsl/context/scope.rb

@@ -44,8 +44,10 @@ module Kameleon
                 normalize(default_selector)
               elsif params.size == 1
                 [::Capybara.default_selector] + params
-              else
+              elsif [:xpath, :css].include?(params.first)
                 params
+              else
+                JoinInToOne.new(params, self).selector
               end
           end
         end
@@ -72,7 +74,7 @@ module Kameleon
           end
         end
 
-        def self.row_and_column(param)
+        def self.cell(param)
           value_in_row, value_in_column = *param
           if value_in_row.is_a?(Fixnum) and value_in_column.is_a?(Fixnum)
             [:xpath, "//tbody/tr[#{value_in_row}]/td[#{value_in_column}]"]
@@ -89,6 +91,32 @@ module Kameleon
           #            return [:xpath, ".//table//th[#{position + 1}] | .//table//td[#{position + 1}]", :select_multiple]
         end
       end
+
+      class JoinInToOne < Struct.new(:params, :scope)
+
+        def selector
+          [:xpath, xpath_selector]
+        end
+
+        private
+
+        def xpath_selector
+          ([xpaths.first] + cleanup(xpaths[1..-1])).join("//")
+        end
+
+        def cleanup(others)
+          others.collect { |xpath| xpath.gsub(/^\.+/, '').gsub(/^\/+/, '') }
+        end
+
+        def xpaths
+          @xpaths ||= normalized.map { |param| param.first == :css ? ::Nokogiri::CSS.xpath_for(param.last).first : param.last }
+        end
+
+        # TODO detect_selector should be in module
+        def normalized
+          params.map { |param| scope.send(:detect_selector, param) }
+        end
+      end
     end
   end
 end

data/lib/kameleon/dsl/verify/presence.rb

@@ -22,6 +22,8 @@ module Kameleon
           case param
             when String
               conditions << Condition.new(:have_content, param)
+            when Symbol
+              prepare_conditions(:element => param)
             when Hash
               param.each_pair do |type, values|
                 case type
@@ -47,6 +49,8 @@ module Kameleon
                     conditions.concat TextInput.new(nil, values).conditions
                   when :empty
                     conditions.concat EmptyInput.new(values).conditions
+                  when :element
+                    conditions.concat Element.new(values).conditions
                   else
                     raise "not implemented"
                 end
@@ -123,6 +127,33 @@ module Kameleon
         end
       end
 
+      class Element
+        attr_reader :conditions, :expression
+
+        def initialize(expression)
+          @expression = expression
+          @conditions = [condition]
+        end
+
+        private
+
+        def condition
+          Condition.new(have_selector_method, selector_expression)
+        end
+
+        def have_selector_method
+          "have_#{selector.first}".to_sym
+        end
+
+        def selector
+          @selector ||= Kameleon::DSL::Context::Scope.new(expression).selector
+        end
+
+        def selector_expression
+          selector.last
+        end
+      end
+
       class Quantity
         attr_reader :conditions
         attr_reader :quantity

metadata

@@ -1,8 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: kameleon
 version: !ruby/object:Gem::Version
-  version: 0.2.0.alpha.2
-  prerelease: 6
+  version: 0.2.0
+  prerelease: 
 platform: ruby
 authors:
 - Michał Czyż [cs3b]
@@ -11,11 +11,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-08 00:00:00.000000000 Z
+date: 2012-05-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &18233400 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -23,10 +23,15 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *18233400
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: capybara
-  requirement: &18232320 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -34,10 +39,15 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *18232320
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: headless
-  requirement: &18231100 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -45,10 +55,15 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *18231100
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &18230160 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -56,10 +71,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *18230160
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: capybara
-  requirement: &18469680 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -67,10 +87,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *18469680
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: headless
-  requirement: &18468320 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -78,10 +103,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *18468320
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: guard-rspec
-  requirement: &18467220 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -89,10 +119,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *18467220
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
-  requirement: &18466000 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -100,10 +135,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *18466000
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: capybara-webkit
-  requirement: &18465140 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -111,7 +151,12 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *18465140
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: high abstraction dsl for end user perspective tests, kameleon - it's
   a polish word for chameleon
 email: michalczyz@gmail.com
@@ -119,30 +164,30 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/kameleon/utils/configuration.rb
+- lib/kameleon.rb
 - lib/kameleon/utils/debug_console.rb
+- lib/kameleon/utils/configuration.rb
+- lib/kameleon/session.rb
+- lib/kameleon/dsl.rb
+- lib/kameleon/dsl/verify/presence.rb
+- lib/kameleon/dsl/verify/absence.rb
+- lib/kameleon/dsl/utils/debug.rb
 - lib/kameleon/dsl/act/form.rb
 - lib/kameleon/dsl/act/mouse.rb
 - lib/kameleon/dsl/context/scope.rb
-- lib/kameleon/dsl/utils/debug.rb
-- lib/kameleon/dsl/verify/absence.rb
-- lib/kameleon/dsl/verify/presence.rb
-- lib/kameleon/dsl.rb
-- lib/kameleon/ext/active_record/shared_single_connection.rb
-- lib/kameleon/ext/capybara/server.rb
 - lib/kameleon/ext/capybara/session_pool.rb
-- lib/kameleon/ext/rspec/all.rb
-- lib/kameleon/ext/rspec/dsl.rb
+- lib/kameleon/ext/capybara/server.rb
+- lib/kameleon/ext/session/devise.rb
+- lib/kameleon/ext/ruby/deferred_garbage_collector.rb
 - lib/kameleon/ext/rspec/garbage_collector.rb
-- lib/kameleon/ext/rspec/headless.rb
+- lib/kameleon/ext/rspec/dsl.rb
 - lib/kameleon/ext/rspec/pool.rb
 - lib/kameleon/ext/rspec/transactional_examples.rb
-- lib/kameleon/ext/ruby/deferred_garbage_collector.rb
-- lib/kameleon/ext/session/devise.rb
-- lib/kameleon/session.rb
-- lib/kameleon.rb
+- lib/kameleon/ext/rspec/headless.rb
+- lib/kameleon/ext/rspec/all.rb
+- lib/kameleon/ext/active_record/shared_single_connection.rb
 - LICENCE
-- README.textile
+- README.md
 homepage: https://github.com/cs3b/kameleon
 licenses:
 - MIT
@@ -159,12 +204,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.17
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: high abstraction dsl for end user perspective tests

data/README.textile

@@ -1,157 +0,0 @@
-h1. Kameleon [chameleon]
-
-"!https://secure.travis-ci.org/cs3b/kameleon.png?branch=master!":http://travis-ci.org/cs3b/kameleon
-
-Kameleon is a high abstraction dsl for better writing acceptance and integrationtests using Capybara.
-And "better" means: more easily to mimic how user interact with browser.
-
-h2. Setup:
-
-Kameleon requires:
-* rspec
-* capybara
-
-Optional is nice to use
-* devise ( Kameleon uses paths suplied by devise. So if you're using some other authentication solution, you might want to overwrite it )
-* selenium-wedriver && capybara-webkit for testing full site
-* thin (if you want run your specs faster - add gem 'thin' to Gemfile in your app)
-
-Gemfile
-
-<pre>
-gem 'kameleon', '>= 0.2.0'
-</pre>
-
-Before you start using Kameleon ensure that capybara is properly loaded (in your test helper file)
-
-<pre>
-require 'kameleon/ext/rspec/all'
-</pre>
-
-or just components you want, kemeleon/ext/rspec/all by default loads:
-
-<pre>
-require 'kameleon/ext/rspec/dsl'
-require 'kameleon/ext/rspec/garbage_collector'
-require 'kameleon/ext/rspec/headless'
-</pre>
-
-h2. Usage:
-
-below few examples for more please check spec/integration tests suite
-
-bc. background do
-      @admin = Factory.create(:user)
-    end
-
-    scenario "opening list of news", :status => 'done' do
-      click "homepage",
-            "community",
-            "news"
-
-      see "new medicine developed last weekend"
-      within(:row => 'some cell text') do
-        see 'see all values in row that contains that text'
-      end
-      see :ordered => 'Z', 'X', 'Y'
-      click :and_confirm => "Cancel", :and_dismiss => "Cancel"
-    end
-
-Another example
-
-bc.   feature "Products", :driver => :selenium do
-          background do
-            @admin = Factory.create(:user)
-            create_session(:admin)
-            visit spree.admin_path
-          end
-
-          context "listing products" do
-            scenario "products sorting" do
-              Factory(:product, :name => 'apache baseball cap',
-                                :available_on => '2011-01-06 18:21:13:',
-                                :count_on_hand => '0')
-              Factory(:product, :name => 'zomg shirt',
-                                :available_on => '2125-01-06 18:21:13',
-                                :count_on_hand => '5')
-
-              act_as(:admin) do
-                click "Products"
-                see :ordered => ["apache baseball cap", "zomg shirt"]
-
-                click "admin_products_listing_name_title"
-                see :ordered => ["zomg shirt", "apache baseball cap"]
-              end
-            end
-          end
-
-And more complex example, with two user sessions:
-
-bc.    scenario "admin adds a product and user buys it", :status => "done", :driver => :selenium do
-          create_session(:admin)
-          @admin = Factory.create(:admin_user)
-          create_session(:user)
-
-          act_as(:admin) do
-            visit spree.admin_path
-            click "Products", "admin_new_product"
-            within('#new_product') do
-              see "SKU"
-            end
-            fill_in "product_name" => "Baseball Cap",
-                    "product_sku" => "B100",
-                    "product_price"=> "100",
-                    "product_available_on"=> "2012/01/24"
-
-            click "Create"
-            see "successfully created!"
-
-            fill_in "product_on_hand" => "100"
-            click "Update"
-            see "successfully updated!"
-          end
-
-          act_as(:user) do
-            visit spree.root_path
-            click "Baseball Cap", "add-to-cart-button", "Checkout"
-            within("span.out-of-stock") do
-              see "Baseball Cap added to your cart"
-            end
-          end
-        end
-
-
-h2. Tips & Tricks:
-* You have access to page variable. So if you think that something cannot be accomplished by the Kameleon DSL, you can just write using RSpec matchers and page variable. Like this: <pre>  page.should have_css("li.banner_message", :count => 10) </pre>  Of course, after you've submitted feature request to the owner of the original repository ;)
-* It is handy to define a common set of areas, that user often follows navigating on the site. Here is an example:
-<pre> Kameleon::Session.defined_areas.merge!({
-                                           :menu => [:xpath, "//nav/ul"],
-                                           :main => '.main_body',
-                                           :right_column => '.col_aside',
-                                           :ordered_list => '.ordered_list',
-                                           :favourites => '.favourites_list',
-                                           :gallery_tiny => '.gallery_tiny',
-                                           :gallery_list => '.gallery_list',
-                                           :content => '.col_content',
-                                           :col_aside => '.col_aside'
-                                       })
-
-</pre>
-
-soon we will merge with new capybara approach for that
-
-h2. Tips & Tricks:
-
-h3. Session pooling
-
-Kameleon has useful technique of session pooling implemented, that can speed up test suite greatly.
-In order to enable it, you need to pass this to the RSpec.configure block, in spec_helper.rb:
-
-bc. config.after(:each) do
-  ::SessionPool.release_all
-end
-
-h2. Credits:
-* <a href="http://selleo.com/people/michal-czyz">Michał Czyż</a>
-* <a href="http://selleo.com/people/radoslaw-jedryszczak">Radosław Jędryszczak</a>
-* <a href="http://selleo.com/people">Szymon Kieloch</a>