site_prism 2.1 → 2.2

data/README.md

@@ -5,6 +5,8 @@ SitePrism gives you a simple, clean and semantic DSL for describing your site us
 
 Find the pretty documentation here: http://rdoc.info/gems/site_prism/frames
 
+[![Build Status](https://travis-ci.org/natritmeyer/site_prism.png)](https://travis-ci.org/natritmeyer/site_prism)
+
 ## Synopsis
 
 Here's an overview of how SitePrism is designed to be used:
@@ -751,6 +753,60 @@ Then /^the home page menu contains a link to the various search functions$/ do
 end
 ```
 
+#### Getting a section's parent
+
+It is possible to ask a section for its parent (page, or section if this
+section is a subsection). For example, given the following setup:
+
+```ruby
+class MySubSection < SitePrism::Section
+  element :some_element, "abc"
+end
+
+class MySection < SitePrism::Section
+  section :my_subsection, MySubSection, "def"
+end
+
+class MyPage < SitePrism::Page
+  section :my_section, MySection, "ghi"
+end
+```
+
+...then calling `#parent` will return the following:
+
+```ruby
+@my_page = MyPage.new
+@my_page.load
+
+@my_page.my_section.parent #=> returns @my_page
+@my_page.my_section.my_subsection.parent #=> returns @my_section
+```
+
+#### Getting a section's parent page
+
+It is possible to ask a section for the page that it belongs to. For example,
+given the following setup:
+
+```ruby
+class MenuSection < SitePrism::Section
+  element :search, "a.search"
+  element :images, "a.image-search"
+  element :maps, "a.map-search"
+end
+
+class Home < SitePrism::Page
+  section :menu, MenuSection, "#gbx3"
+end
+```
+
+...you can get the section's parent page:
+
+```ruby
+@home = Home.new
+@home.load
+@home.menu.parent_page #=> returns @home
+```
+
 #### Testing for the existence of a section
 
 Just like elements, it is possible to test for the existence of a

data/lib/site_prism/element_container.rb

@@ -1,6 +1,6 @@
 module SitePrism::ElementContainer
 
-  def element element_name, *find_args 
+  def element element_name, *find_args
     build element_name, *find_args do
       define_method element_name.to_s do
         find_first *find_args
@@ -20,7 +20,7 @@ module SitePrism::ElementContainer
   def section section_name, section_class, *find_args
     build section_name, *find_args do
       define_method section_name do
-        section_class.new find_first *find_args
+        section_class.new self, find_first(*find_args)
       end
     end
   end
@@ -29,7 +29,7 @@ module SitePrism::ElementContainer
     build section_collection_name, *find_args do
       define_method section_collection_name do
         find_all(*find_args).collect do |element|
-          section_class.new element
+          section_class.new self, element
         end
       end
     end
@@ -56,7 +56,7 @@ module SitePrism::ElementContainer
   end
 
   private
-  
+
   def build name, *find_args
     if find_args.empty?
       create_no_selector name
@@ -66,14 +66,14 @@ module SitePrism::ElementContainer
     end
     add_checkers_and_waiters name, *find_args
   end
-  
+
   def add_checkers_and_waiters name, *find_args
     create_existence_checker name, *find_args
     create_waiter name, *find_args
     create_visibility_waiter name, *find_args
     create_invisibility_waiter name, *find_args
   end
-  
+
   def build_checker_or_waiter element_name, proposed_method_name, *find_args
     if find_args.empty?
       create_no_selector element_name, proposed_method_name
@@ -123,7 +123,9 @@ module SitePrism::ElementContainer
     build_checker_or_waiter element_name, method_name, *find_args do
       define_method method_name do |timeout = Capybara.default_wait_time|
         Timeout.timeout timeout, SitePrism::TimeOutWaitingForElementInvisibility do
-          sleep 0.1 while element_exists?(*find_args) && find_first(*find_args).visible?
+          Capybara.using_wait_time 0 do
+            sleep 0.05 while element_exists?(*find_args) && find_first(*find_args).visible?
+          end
         end
       end
     end

data/lib/site_prism/section.rb

@@ -4,10 +4,10 @@ module SitePrism
     include ElementChecker
     extend ElementContainer
 
-    attr_reader :root_element
+    attr_reader :root_element, :parent
 
-    def initialize root_element
-      @root_element = root_element
+    def initialize parent, root_element 
+      @parent, @root_element = parent, root_element
     end
 
     def visible?
@@ -22,6 +22,14 @@ module SitePrism
       Capybara.current_session.evaluate_script input
     end
 
+    def parent_page
+      candidate_page = self.parent
+      until candidate_page.is_a?(SitePrism::Page)
+        candidate_page = candidate_page.parent
+      end
+      candidate_page
+    end
+
     private
 
     def find_first *find_args
@@ -33,7 +41,9 @@ module SitePrism
     end
 
     def element_exists? *find_args
-      root_element.has_selector? *find_args
+      unless root_element.nil?
+        root_element.has_selector? *find_args
+      end
     end
   end
 end

data/lib/site_prism/version.rb

@@ -1,4 +1,4 @@
 module SitePrism
-  VERSION = "2.1"
+  VERSION = "2.2"
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: site_prism
 version: !ruby/object:Gem::Version
-  version: '2.1'
+  version: '2.2'
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-06 00:00:00.000000000 Z
+date: 2013-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -51,8 +51,7 @@ dependencies:
         version: '2.0'
 description: SitePrism gives you a simple, clean and semantic DSL for describing your
   site using the Page Object Model pattern, for use with Capybara
-email:
-- nat@natontesting.com
+email: nat@natontesting.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -77,7 +76,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: