page_magic 1.2.7 → 1.2.8.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3958a4d16d7ed2f76f9b58dd90e88c0e30a29dfb
-  data.tar.gz: 55f5d9af299438f3630ac2208a3c7e38eb02b735
+  metadata.gz: 53d354fcdf720993752439b9b8a914fa96562d26
+  data.tar.gz: c98b16fec58b146c3b97f024037566dd7b731bf6
 SHA512:
-  metadata.gz: dca1340ab4d09dd01f8b86614c33dd8e079ddc58d7897ebdb1a1d8dd44b750aa2aea85a7ec49935a8a79cb6f2533a7db3791cee1aa0226a806c513fb48148762
-  data.tar.gz: 415b1f023d0902de1a9933a426de9a5604a43765c09dd1a3af6e01fa29f876930f9c79dc23509441c8bdf1cad0ed0493a78202da56574816faa1e2549c7887a9
+  metadata.gz: 0d03b030f90c3f49227769099ee0c158fc541c20c6dd5abffed4756de4b8c000208f343b6756b9b761eaf5a1afd2ea65235cb196103cb7c3757e11a73e1d9037
+  data.tar.gz: e732614138d46c8924877c872453f48f17f79cdbeda7ecf8637dbf01f4c92f49fbc687e7ddd92e56b3e494b7145fb030cc52319c1e9ddbb250cf76c726b33491

data/Gemfile.lock

@@ -7,7 +7,8 @@ GEM
       minitest (~> 5.1)
       thread_safe (~> 0.3, >= 0.3.4)
       tzinfo (~> 1.1)
-    addressable (2.4.0)
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
     arbre (1.1.1)
       activesupport (>= 3.0.0)
     ast (2.3.0)
@@ -15,7 +16,7 @@ GEM
       descendants_tracker (~> 0.0.4)
       ice_nine (~> 0.11.0)
       thread_safe (~> 0.3, >= 0.3.1)
-    builder (3.2.2)
+    builder (3.2.3)
     capybara (2.7.1)
       addressable
       mime-types (>= 1.16)
@@ -43,65 +44,67 @@ GEM
     ffi (1.9.14)
     git (1.3.0)
     github-markup (1.4.0)
-    github_api (0.14.5)
-      addressable (~> 2.4.0)
-      descendants_tracker (~> 0.0.4)
+    github_api (0.11.3)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.1)
       faraday (~> 0.8, < 0.10)
-      hashie (>= 3.4)
-      oauth2 (~> 1.0)
-    hashie (3.4.4)
+      hashie (>= 1.2)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.0)
+      oauth2
+    hashie (3.5.6)
     highline (1.7.8)
     i18n (0.7.0)
     ice_nine (0.11.2)
-    jeweler (2.1.1)
+    jeweler (2.3.5)
       builder
       bundler (>= 1.0)
       git (>= 1.2.5)
-      github_api
+      github_api (~> 0.11.0)
       highline (>= 1.6.15)
       nokogiri (>= 1.5.10)
+      psych (~> 2.2)
       rake
       rdoc
-      semver
-    json (1.8.3)
-    jwt (1.5.4)
+      semver2
+    json (1.8.6)
+    jwt (1.5.6)
     mime-types (3.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2016.0521)
     mini_portile2 (2.1.0)
     minitest (5.9.0)
-    multi_json (1.12.1)
-    multi_xml (0.5.5)
+    multi_json (1.12.2)
+    multi_xml (0.6.0)
     multipart-post (2.0.0)
-    nokogiri (1.6.8)
+    nokogiri (1.6.8.1)
       mini_portile2 (~> 2.1.0)
-      pkg-config (~> 1.1.7)
-    oauth2 (1.2.0)
-      faraday (>= 0.8, < 0.10)
+    oauth2 (1.4.0)
+      faraday (>= 0.8, < 0.13)
       jwt (~> 1.0)
       multi_json (~> 1.3)
       multi_xml (~> 0.5)
       rack (>= 1.2, < 3)
     parser (2.3.1.2)
       ast (~> 2.2)
-    pkg-config (1.1.7)
     poltergeist (1.10.0)
       capybara (~> 2.1)
       cliver (~> 0.3.1)
       websocket-driver (>= 0.2.0)
     powerpack (0.1.1)
+    psych (2.2.4)
+    public_suffix (3.0.0)
     pullreview-coverage (0.0.5)
       certifi
       simplecov (>= 0.7.1, < 1.0.0)
-    rack (1.6.4)
+    rack (1.6.8)
     rack-protection (1.5.3)
       rack
     rack-test (0.6.3)
       rack (>= 1.0)
     rainbow (2.1.0)
-    rake (11.2.2)
-    rdoc (4.2.2)
-      json (~> 1.4)
+    rake (12.1.0)
+    rdoc (5.1.0)
     redcarpet (3.3.4)
     reek (4.2.3)
       codeclimate-engine-rb (~> 0.3.1)
@@ -132,7 +135,7 @@ GEM
       childprocess (~> 0.5)
       rubyzip (~> 1.0)
       websocket (~> 1.0)
-    semver (1.0.1)
+    semver2 (3.4.2)
     simplecov (0.12.0)
       docile (~> 1.1.0)
       json (>= 1.8, < 3)
@@ -142,7 +145,7 @@ GEM
       rack (~> 1.5)
       rack-protection (~> 1.4)
       tilt (>= 1.3, < 3)
-    thread_safe (0.3.5)
+    thread_safe (0.3.6)
     tilt (2.0.5)
     tzinfo (1.2.2)
       thread_safe (~> 0.1)
@@ -184,4 +187,4 @@ DEPENDENCIES
   yard (~> 0.8)
 
 BUNDLED WITH
-   1.11.2
+   1.15.4

data/README.md

@@ -20,6 +20,25 @@ Well PageMagic might just be the answer!
 
 Give it a try and let us know what you think! There will undoubtedly be things that can be improved and issues that 
 we are not aware of so your feedback/pull requests are greatly appreciated!
+
+##Under the hood
+Under the hood PageMagic uses the totally brilliant [Capybara](https://github.com/teamcapybara/capybara) to benefit from its amazing cross browser support.
+ 
+PageMagic builds on top of Capybara to build resuable models for webpages and website structure.
+ 
+##What about the other PageObject frameworks out there?
+PageMagic isn't the first [PageObject](https://martinfowler.com/bliki/PageObject.html) framework to be written, indeed there are others out there that are totaly awesome e.g:
+- [PageObject](https://github.com/cheezy/page-object)
+- [SitePrism](https://github.com/natritmeyer/site_prism)
+
+Whilst these APIs are great, PageMagic goes much further in the power it provides for:
+ - [modelling pages](defining-pages) and page components 
+ - defining the [wait logic](#hooks) and [watchers](#watchers) that are required to build robust page objects that work reliably with javascript rich webpages.
+ - Supporting [page transitions](#page-mapping)
+ 
+Check it out :)
+
+ 
 # Contents
 
 - [Installation](#installation)
@@ -157,6 +176,19 @@ After visiting a page you are will get a `Session` object. Elements can be acces
 ```ruby
 page.search_field.set 'page_magic'
 ```
+PageMagic sits on top of [Capybara](https://github.com/teamcapybara/capybara) and ultimately returns capybara elements elements for you interact with. Interacting with the element types above is done by calling the following methods:
+
+ element     | method 
+ ---         | --- 
+ text_field  | set(String)
+ checkbox    | set(Boolean)
+ radio       | choose(String)
+ link        | click
+ text_area   | set(String)
+ select_list | select(String)
+ 
+Typically you will not need to know much about Capybara itself but there will be times when you want to interact with elements at a lower level.In this case please see Capybara's [API](http://www.rubydoc.info/github/jnicklas/capybara/Capybara/Node/Element) For more information.
+ 
 
 ### Sub Elements
 If your pages are complex you can use PageMagic to compose pages, their elements and subelements to as many levels as 

data/VERSION

@@ -1 +1 @@
-1.2.7
+1.2.8.alpha

data/lib/page_magic/elements.rb

@@ -67,6 +67,7 @@ module PageMagic
       end
     end
 
+    alias elements element
     TYPES.each { |type| alias_method type, :element }
 
     # @return [Hash] element definition names mapped to blocks that can be used to create unique instances of

data/spec/page_magic/elements_spec.rb

@@ -150,6 +150,13 @@ module PageMagic
       end
     end
 
+    describe '#elements' do
+      it 'is an alias of #element allowing page_magic to find multiple results' do
+        expected = described_class.public_instance_method(:element)
+        expect(described_class.public_instance_method(:elements)).to eq(expected)
+      end
+    end
+
     describe '#element_definitions' do
       it 'should return your a copy of the core definition' do
         subject.text_field :alias, child_selector

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: page_magic
 version: !ruby/object:Gem::Version
-  version: 1.2.7
+  version: 1.2.8.alpha
 platform: ruby
 authors:
 - Leon Davis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-02-17 00:00:00.000000000 Z
+date: 2017-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -196,12 +196,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.8
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: Framework for modeling and interacting with webpages