pageify 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: eebd76157633930a94ba1e764ec548a15726ff46
-  data.tar.gz: 83a2ec1bea6aaf9703a3a7f903f76147b254b211
+  metadata.gz: 79f70b1d1b54b94a46aac17cc21306777a6e88e9
+  data.tar.gz: 6aaefb805f16b5610ada28ef173ef53ee705a6b3
 SHA512:
-  metadata.gz: 15d42705f83d0a63f511b1dfc084602ecb048c671cf85b2f67168c179d020e1a21c46f97bce3613a94f10e6c7af954bcec1fed099522e0924fb2280d0fa74d7e
-  data.tar.gz: 0f8bcbf39bff06546ec529d9dd2bc84c6b858911a2f9586833de706727261e650ebc22fca2d063c2637ffa0d3946689ecb28c471b93dbdc990cf5f9fcb8146f7
+  metadata.gz: df29c5b9b1dd89e59a69264d9d944b54b0a5f5537de77e4c6f6da717782c0957b9dedb60d141be4b53ed0991037e5784ba013db1524ae8ea9580806885494b84
+  data.tar.gz: b2c869a51faca11d22e9ff82b68b410b082d34776cec7607b720a3250cfb1a9b02790ee81627f50e3e08cea742d1c5e3c49a68a3d06bda1171671f305af52283

data/README.md

@@ -2,7 +2,7 @@
 
 [![Code Climate](https://codeclimate.com/github/paramadeep/pageify.png)](https://codeclimate.com/github/paramadeep/pageify)    [![Dependency Status](https://gemnasium.com/paramadeep/pageify.svg)](https://gemnasium.com/paramadeep/pageify)  [![Build Status](https://travis-ci.org/paramadeep/pageify.svg?branch=master)](https://travis-ci.org/paramadeep/pageify)
 
-Lets you define page objects for your UI tests, written in Ruby. 
+Simplest way to define page objects. Bonus, tremendously fast tests.
 
 ##Example
 
@@ -19,12 +19,12 @@ home_page: ".home"
 ```
 Test steps looks like this
 ```ruby
-home_page.login.user_name[].set "hi"
-home_page.login.password[].set "bla"
-home_page.login.submit[].click
+home_page.login.user_name.f.set "hi"
+home_page.login.password.f.set "bla"
+home_page.login.submit.f.click
 
-home_page.profile_name[].should match_text "hi"
-hoem_page.settings[].should be_visible
+home_page.profile_name.f.should match_text "hi"
+hoem_page.settings.f.should be_visible
 ```
 
 We will be able element whose locators are dynamic
@@ -35,17 +35,19 @@ products_page: ".products"
       cost: ".cost"
 ```
 ```ruby
-products_page.product("candy").details_row(1).cost[].should have_text "Rs.10"
-products_page.product("tyres").details_row(2).cost[].should have_text "Rs.20"
+products_page.product("candy").details_row(1).cost.f.should have_text "Rs.10"
+products_page.product("tyres").details_row(2).cost.f.should have_text "Rs.20"
 ```
 
     
 ## Key benefits
 
+- [Tests runs tremendously fast.] (https://github.com/paramadeep/pageify#how-tests-gets-faster-with-pageify)
 - Your test will be more **readable**.
 - **Eliminates duplicate** definition of selectors across test.
 - **Easy Maintenance**.
 
+
 ## Usage
 In your project Gemfile add 
 ```ruby
@@ -64,26 +66,31 @@ gem 'pageify'
 
 ##Methods
 
-###Get Element '[]'
+###Get Element 'f' or 'find'
 ```ruby
-home_page.login.user_name[] #=> user_name text box
-home_page.login.user_name[].set "hi" # set text box value
-home_page.login.user_name[].should have_value "hi" # assert value
-home_page.login.submit[].click
+home_page.login.user_name.f #=> user_name text box
+home_page.login.user_name.f.set "hi" # set text box value
+home_page.login.user_name.find.should have_value "hi" # assert value
+home_page.login.submit.find.click
 ```
 
+###Get Element Collection 'find_all'
+```ruby
+home_page.product.find_all #=> all products in page
+home_page.product.find_all[0] #=> first product in page
+```
 
-###Get Selector 'p'
+###Get Selector 'selector'
 At times we would need selector of the object 
 ```ruby
-home_page.login.user_name.p #=> ".home div.login input.user"
+home_page.login.user_name.selector #=> ".home div.login input.user"
 
 #check element doesn't exist
-page.should_not have_selector home_page.login.user_name.p
+page.should_not have_selector home_page.login.user_name.selector
 
 #using capybara actions
 fill_in  home_page.login.user_name.p, :with=> "hi"
-click_on home_page.login.submit.p
+click_on home_page.login.submit.selector
 ```
 
 ##Splitting Long Page Definitions
@@ -106,3 +113,39 @@ search_results: '.search_results'
   :section/product
 
 ```
+
+## Experimental Feature
+
+Making the test more readable is a constant persuite. Currently working on removing use of "find" or "f" in every step
+
+```
+#currently
+home_page.login.user_name.find.set "used"
+home_page.login.user_name.find.click "used"
+
+#with experimaental work under progress the above will look like
+home_page.login.user_name.set "used"
+home_page.login.user_name.click "used"
+```
+You can try this in your test suite by 
+```
+#instead of the adding the below line 
+require 'pageify/capybara'
+
+# use this
+require 'pageify/capybara_experimental'
+```
+**Note:** There will be a considrable drop in performance, with the use of this experimental feature. Once this performance drop is fixed, this could used in main stream.
+
+## How tests gets faster with Pageify
+
+Finding a street in a country, would be much faster when given state -> city -> area -> street, against searching just the street name.
+
+Since we used entire hirerchy of the selector to locate an element, against specific selector, the identification of element gets really faster.  
+For example,
+```
+page.find(".user_name")
+page.find(".home_page .login .user_name")
+# The later would be much faster, scope for search is reduced to particular container at every level.
+```
+The effect gets magnified when the same is done on each and every step of, hundreds and thousand steps, tests. 

data/lib/pageify.rb

@@ -14,9 +14,9 @@ module Pageify
     element = PageObject.create(raw_row)
     define_method(element.name) do |*arguments|
       unless arguments.eql? []
-        $global_selector = (element.self_selector % arguments).strip_quotes.strip
+        element.full_selector = (element.self_selector % arguments).strip_quotes.strip
       else
-        $global_selector = (element.self_selector % '').strip_quotes.strip
+        element.full_selector = (element.self_selector % '').strip_quotes.strip
       end
       element
     end

data/lib/pageify/page_object.rb

@@ -1,5 +1,5 @@
 class PageObject
-  attr_accessor :name,:parent,:self_selector,:intend
+  attr_accessor :name,:parent,:self_selector,:intend,:full_selector
 
   def createChild (raw_row)
     child = PageObject.create(raw_row)
@@ -11,9 +11,9 @@ class PageObject
         child_selector = (child.self_selector % '').strip_quotes.strip
       end
       if child_selector.start_with? "&"
-        $global_selector += child_selector.gsub(/^&/, "")
+        child.full_selector = @full_selector + child_selector.gsub(/^&/, "")
       else
-        $global_selector += " " + child_selector
+        child.full_selector = @full_selector + " " + child_selector
       end
       child
     end
@@ -28,7 +28,7 @@ class PageObject
   end
 
   def selector
-    $global_selector.strip
+    @full_selector.strip
   end
 
   def initialize (name,self_selector,intend)

data/spec/page_object_spec.rb

@@ -37,11 +37,11 @@ describe Pageify do
     expect(@page.root.complex.arg(1).arg_nested.selector).to eq(".root .complex .arg:nth-of-type(1) .arg_nested")
   end
 
-  it "does not support multiple pages at the same time" do
+  it "support multiple pages at the same time" do
     p1 = @page.root.simple
     p2 = @page.root.complex.nested
 
-    expect(p1.selector).to eq(".root .complex .nested")
+    expect(p1.selector).to eq(".root .simple")
     expect(p2.selector).to eq(".root .complex .nested")
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pageify
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
 platform: ruby
 authors:
 - Deepak
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-10 00:00:00.000000000 Z
+date: 2014-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec