ae_page_objects 0.5.1 → 0.5.2.mw1

data/lib/ae_page_objects.rb

@@ -26,6 +26,7 @@ module AePageObjects
   autoload :Window,            'ae_page_objects/window'
   autoload :Node,              'ae_page_objects/node'
   autoload :Document,          'ae_page_objects/document'
+  autoload :VariableDocument,  'ae_page_objects/variable_document'
   autoload :Element,           'ae_page_objects/element'
   autoload :ElementProxy,      'ae_page_objects/element_proxy'
   

data/lib/ae_page_objects/document.rb

@@ -2,6 +2,60 @@ module AePageObjects
   class Document < Node
     include Concerns::Visitable
 
+    class << self
+
+      def find(&extra_condition)
+        original_window = AePageObjects::Window.current
+
+        # Loop through all the windows and attempt to instantiate the Document. Continue to loop around
+        # until finding a Document that can be instantiated or timing out.
+        Capybara.wait_until do
+          find_window(&extra_condition)
+        end
+
+      rescue Capybara::TimeoutError
+        original_window.switch_to
+
+        all_windows = AePageObjects::Window.all.map do |window|
+          name = window.current_document && window.current_document.to_s || "<none>"
+          {:window_handle => window.handle, :document => name }
+        end
+
+        raise PageNotFound, "Couldn't find page #{self.name} in any of the open windows: #{all_windows.inspect}"
+      end
+
+    private
+
+      def find_window(&extra_condition)
+        AePageObjects::Window.all.each do |window|
+          window.switch_to
+
+          if inst = attempt_to_load(&extra_condition)
+            return inst
+          end
+        end
+
+        nil
+      end
+
+      def attempt_to_load(&extra_condition)
+        inst = new
+
+        if extra_condition.nil? || inst.instance_eval(&extra_condition)
+          return inst
+        end
+
+        nil
+      rescue AePageObjects::LoadingFailed
+        # These will happen from the new() call above.
+        nil
+      end
+
+      def site
+        @site ||= AePageObjects::Site.from(self)
+      end
+    end
+
     attr_reader :window
     
     def initialize
@@ -14,12 +68,5 @@ module AePageObjects
     def document
       self
     end
-    
-    class << self
-    private
-      def site
-        @site ||= AePageObjects::Site.from(self)
-      end
-    end
   end
 end

data/lib/ae_page_objects/elements/collection.rb

@@ -2,13 +2,11 @@ module AePageObjects
   class Collection < Element
     include Enumerable
 
+    attr_reader :item_locator
+
     class << self
       attr_accessor :item_class
 
-      def default_item_locator
-        @default_item_locator ||= [:xpath, ".//*"]
-      end
-
       private
       def inherited(subclass)
         subclass.item_class = self.item_class
@@ -21,10 +19,6 @@ module AePageObjects
       self.class.item_class
     end
 
-    def item_xpath
-      @item_xpath ||= Capybara::Selector.normalize(*eval_locator(@item_locator)).xpaths.first
-    end
-
     def at(index, &block)
       if index >= size || index < 0
         nil
@@ -56,7 +50,7 @@ module AePageObjects
     def configure(options)
       super
       
-      @item_locator = options.delete(:item_locator) || self.class.default_item_locator
+      @item_locator = options.delete(:item_locator) || default_item_locator
     end
 
     def item_at(index, &block)
@@ -67,8 +61,16 @@ module AePageObjects
       item_class
     end
 
+    def item_xpath
+      @item_xpath ||= Capybara::Selector.normalize(*eval_locator(@item_locator)).xpaths.first
+    end
+
     def item_locator_at(index)
       [:xpath, "#{item_xpath}[#{index + 1}]"]
     end
+
+    def default_item_locator
+      @default_item_locator ||= [:xpath, ".//*"]
+    end
   end
 end

data/lib/ae_page_objects/exceptions.rb

@@ -1,10 +1,19 @@
 module AePageObjects
-  class StalePageObject < StandardError
+  class Error < StandardError; end
+
+  class StalePageObject < Error
+  end
+
+  class LoadingFailed < Error
   end
 
-  class LoadingFailed < StandardError
+  class PathNotResolvable < Error
   end
 
-  class PathNotResolvable < StandardError
+  class PageNotFound < Error
   end
+
+  class CastError     < Error; end
+  class InvalidCast   < CastError; end
+  class IncorrectCast < CastError; end
 end

data/lib/ae_page_objects/variable_document.rb

@@ -0,0 +1,50 @@
+module AePageObjects
+  class VariableDocument
+
+    # Remove all instance methods so even things like class()
+    # get handled by method_missing(). <lifted from activerecord>
+    instance_methods.each do |m|
+      unless m.to_s =~ /^(?:nil\?|send|object_id|to_a|tap)$|^__|^respond_to|is_a?/
+        undef_method m
+      end
+    end
+
+    def initialize(*documents)
+      @documents = documents
+    end
+
+    def is_a?(document_class)
+      super || !! as_a(document_class)
+    rescue AePageObjects::Error
+      false
+    end
+
+    def as_a(document_class)
+      unless @documents.include?(document_class)
+        raise InvalidCast, "Cannot cast as #{document_class.name} from #{@documents.map(&:name).inspect}"
+      end
+
+      document_class.new
+    rescue AePageObjects::LoadingFailed => e
+      raise IncorrectCast, "Failed instantiating a #{document_class}: #{e.message}\nDocuments: #{@documents.map(&:name).inspect}"
+    end
+
+  private
+
+    def implicit_document_class
+      @implicit_document_class ||= @documents.first
+    end
+
+    def implicit_document
+      @implicit_document ||= implicit_document_class.new
+    end
+
+    def method_missing(name, *args, &block)
+      implicit_document.__send__(name, *args, &block)
+    end
+
+    def respond_to?(*args)
+      super || implicit_document_class.allocate.respond_to?(*args)
+    end
+  end
+end

data/lib/ae_page_objects/version.rb

@@ -1,3 +1,3 @@
 module AePageObjects
-  VERSION = '0.5.1'.freeze
+  VERSION = '0.5.2.mw1'.freeze
 end

metadata

@@ -1,13 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: ae_page_objects
 version: !ruby/object:Gem::Version 
-  hash: 9
-  prerelease: 
+  hash: 807327821
+  prerelease: 6
   segments: 
   - 0
   - 5
+  - 2
+  - mw
   - 1
-  version: 0.5.1
+  version: 0.5.2.mw1
 platform: ruby
 authors: 
 - Donnie Tognazzini
@@ -15,7 +17,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-10-26 00:00:00 Z
+date: 2013-10-29 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: capybara
@@ -66,6 +68,7 @@ files:
 - lib/ae_page_objects/util/inflector.rb
 - lib/ae_page_objects/util/internal_helpers.rb
 - lib/ae_page_objects/util/singleton.rb
+- lib/ae_page_objects/variable_document.rb
 - lib/ae_page_objects/version.rb
 - lib/ae_page_objects/window.rb
 homepage: http://github.com/appfolio/ae_page_objects