pageify 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fcfb4cfc0efdca4c41e31bcbb76eaa16865772b3
-  data.tar.gz: 266c6196459b4b9a1c8935b36b37314b86ff15f0
+  metadata.gz: 9d21aa14b7f880ca329b8ca5062400711cd9b414
+  data.tar.gz: f617f59a06c6f7dbf308d8c7276d2a0c2a9adc59
 SHA512:
-  metadata.gz: cb6b5f73249579dcab64ee693b9e7531e0920ee08c044a2bb2e4bbe9099667ab292a802f28bed335095442dffa9342c3cc42cf7b8a56eaa2d6ff2a4b46477fa4
-  data.tar.gz: 3276acbaaf49ab5a59bda5df61748c90132e47c634e23c87964090ea61d9dc72ada8bd17a470a93695038babb03022ebdce7445e353a647c984358e66fb45ad6
+  metadata.gz: 3e5c75dfb031ef3dce726ed4bcfe35eb96ca75c300b59a381ba41c684f8fc675fb6f87de079d2b239b2b7a0162634df26594be30da54c4403a8d740fb85df1ac
+  data.tar.gz: 3a7cb6709aa29dc03edcce762f5d724054abc7cb3d86f3b06b475af385aee3a092b980fa4abc98cf0f70d987a431aea9c66e5a0149f6a6ef54a5fa121df1bc76

data/README.md

@@ -0,0 +1,46 @@
+#Pageify
+
+Lets you define page objects for your UI tests, written in Ruby. 
+
+##Example
+
+Page definition looks like this
+```yaml
+home_page: ".home"
+  login: "div.login"
+    user_name: "input.user"
+    password: "input.password"
+    submit: "[name='submit']"
+  profile_name: "a.profile"
+  settings: "a.settings"
+  sign_up: "a.sign_up"
+```
+Test steps looks like this
+```ruby
+fill_in home_page.login.user_name :with => "hi"
+fill_in home_page.login.password :with => "bla"
+click_on home_page.login.submit
+
+home_page.profile_name.should match_text "hi"
+hoem_pafe.settings.should be_visible
+```
+    
+## Key benefits
+
+- Your test will be more **readable**.
+- **Eliminates duplicate** definition of selectors across test.
+- **Easy Maintenance**.
+
+## Usage
+In your project Gemfile add 
+```ruby
+gem 'pageify'
+```
+###Cucumber
+ In env.rb
+ ```ruby
+ include Pageify
+ pageify("features/pages")
+ ```
+ Place all the page defenitions under "features/pages"
+

data/lib/pageify.rb

@@ -5,17 +5,15 @@ module Pageify
   def pageify(base_dir)
     base_dir.chomp! '/'
     all_pages = []
-    Dir["#{base_dir}/**/"].each do |dir|
-      Dir["#{dir}*.page"].each do |file|
-        to_page_objects file
-      end
+    Dir["#{base_dir}/**/*.page"].each do |file|
+      to_page_objects file
     end
   end
 
   def createElement(raw_row)
     element = PageObject.create(raw_row)
-    define_method(element.name) do 
-      $selector = element.selector
+    define_method(element.name) do
+      $selector = element.selector.strip_quotes.strip
       element
     end
     element
@@ -30,7 +28,7 @@ module Pageify
     until rawArray.empty? do
       thisElement = rawArray.first
       nextElement = rawArray[1]
-      until parent.last.intend < thisElement.lspace do 
+      until parent.last.intend < thisElement.lspace do
         parent.pop
       end
       element = parent.last.createChild(thisElement)

data/lib/pageify/element.rb

@@ -1,11 +1,16 @@
-class PageObject 
+class PageObject
   attr_accessor :name,:parent,:selector,:intend
 
   def createChild (raw_row)
     child = PageObject.create(raw_row)
     child.parent = self
     define_singleton_method(child.name) do |*arguments|
-      $selector += child.selector % arguments
+      child_selector = (child.selector % arguments).strip_quotes.strip
+      if child_selector.start_with? "&"
+        $selector += child_selector.gsub(/^&/, "")
+      else
+        $selector += " " + child_selector
+      end
       child
     end
     return child
@@ -19,7 +24,7 @@ class PageObject
   end
 
   def p
-    $selector.gsub("\"","").strip
+    $selector.strip
   end
 
   def initialize (name,selector,intend)

data/lib/pageify/string.rb

@@ -2,8 +2,8 @@ class String
   def lspace
     self[/\A */].size
   end
-end
-
-
-
 
+  def strip_quotes
+    self.gsub("\"", "")
+  end
+end

data/spec/pages/sample.page

@@ -0,0 +1,11 @@
+root: ".root"
+  simple: ".simple"
+  complex: ".complex"
+    nested: ".nested"
+    whitespace: "   .whitespace   "
+      whitespace_nested: "  .whitespace_nested  "
+    arg: ".arg:nth-of-type(%s)"
+      arg_nested: ".arg_nested"
+    nth: "&:nth-of-type(%d)"
+      nth_variant: "&.nth_variant"
+        nth_nested: ".nth_nested"

data/spec/sample_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe Pageify do
+  before :each do
+    base_dir = File.expand_path File.join __FILE__, '..', 'pages'
+    @pageModule = Module.new.extend(Pageify)
+    @pageModule.pageify base_dir
+    @page = Class.new.send(:include, @pageModule).new
+  end
+
+  it "should have root" do
+    @page.root.p.should == ".root"
+  end
+
+  it "should have simple page" do
+    @page.root.simple.p.should == ".root .simple"
+  end
+
+  it "should have nested pages" do
+    @page.root.complex.p.should == ".root .complex"
+    @page.root.complex.nested.p.should == ".root .complex .nested"
+  end
+
+  it "should check arguments" do
+    @page.root.complex.arg(1).p.should == ".root .complex .arg:nth-of-type(1)"
+  end
+
+  it "should check pages nested inside arguments" do
+    @page.root.complex.arg(1).arg_nested.p.should == ".root .complex .arg:nth-of-type(1) .arg_nested"
+  end
+
+  it "does not support multiple pages at the same time" do
+    p1 = @page.root.simple
+    p2 = @page.root.complex.nested
+
+    p1.p.should == ".root .complex .nested"
+    p2.p.should == ".root .complex .nested"
+  end
+
+  it "should normalize whitespace" do
+    @page.root.complex.whitespace.p.should == ".root .complex .whitespace"
+    @page.root.complex.whitespace.whitespace_nested.p.should == ".root .complex .whitespace .whitespace_nested"
+  end
+
+  it "& should add to previous selector" do
+    @page.root.complex.nth(1).nth_variant.nth_nested.p.should == ".root .complex:nth-of-type(1).nth_variant .nth_nested"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'bundler/setup'
+Bundler.setup
+
+require 'pageify'
+
+RSpec.configure do |config|
+end

metadata

@@ -1,24 +1,56 @@
 --- !ruby/object:Gem::Specification
 name: pageify
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Deepak
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-28 00:00:00.000000000 Z
-dependencies: []
+date: 2014-04-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Simplify page object definition for UI tests
 email: anandhadeepak@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
+- lib/pageify.rb
 - lib/pageify/element.rb
 - lib/pageify/string.rb
-- lib/pageify.rb
+- spec/pages/sample.page
+- spec/sample_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/paramadeep/pageify
 licenses:
 - MIT
@@ -29,18 +61,21 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: Added selector for the parent node
-test_files: []
+summary: Simplify page object definition for UI tests
+test_files:
+- spec/pages/sample.page
+- spec/spec_helper.rb
+- spec/sample_spec.rb