capybara-widgets 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dc8ba6872d65c984e482da032b16bc77918c6847
-  data.tar.gz: e7f0e2119a36f16bbbca1c2e35b05ba6375f5229
+  metadata.gz: 021a642e1232afc2aab0834d80b3aae72c3d353c
+  data.tar.gz: 6ba634d5670248068aebf111885c325366fb3ad9
 SHA512:
-  metadata.gz: 5552b63d66512fa9fe7f621c482094c2c94d4df939d3020bc38ade8775a16d1dc86f6ae191f86355b41a381e82b8d1f116ec621c3b510396448190354ca21f78
-  data.tar.gz: 12f25e3b3c24ed0e4935ff9a60ed3cd034aa7b6398676a6be1c68d082d271574b7242cd9c74efd38adb4dd9bd577cb68395bdab48b6e5a96a5e4b3cc5cf9f433
+  metadata.gz: 41fc9fa61acf8649785b65dcfb95507f82c0ff738f31e68d801582bf00a4bb036272449b27e76f1fab4cbf4e2083f66205d6212f799ab942fa60016209acb93c
+  data.tar.gz: dbe2892d04280e780d174180de57f3dd37325f99ddac1d1af36c263b748f1d6880d9c1243cda17a882ea64013e70c00c8beefe89a2caaf8075258a7f35a3224e

data/README.md

@@ -2,23 +2,19 @@
 
 [![Build Status](https://travis-ci.org/vgrigoruk/capybara-widgets.svg?branch=master)](https://travis-ci.org/vgrigoruk/capybara-widgets)
 
-TODO: Write a gem description
+Page objects / fragments implementation for Capybara.
+- Support lambda element selectors.
+- RSpec & Cucumber integration.
+- Work for web & mobile (appium driver).
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add this line to your application's Gemfile and run `bundle`:
 
 ```ruby
 gem 'capybara-widgets'
 ```
 
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install capybara-widgets
 
 ## Usage
 

data/lib/capybara/widgets/core/execution_hooks.rb

@@ -0,0 +1,66 @@
+module ExecutionHooks
+  def self.included(base)
+    base.send :extend, ClassMethods
+  end
+
+  module ClassMethods
+    # this method is invoked whenever a new instance method is added to a class
+    def method_added(method_name)
+      # do nothing if the method that was added was an actual hook method, or
+      # if it already had hooks added to it
+      return if hooks.include?(method_name) || ignored_methods.include?(method_name) || hooked_methods.include?(method_name)
+      add_hooks_to(method_name)
+    end
+
+    # this is the DSL method that classes use to add before hooks
+    def before_hook(method_name, opts={})
+      hooks << method_name
+      ignored_methods.concat Array(opts[:ignore])
+    end
+
+    # keeps track of all before hooks
+    def hooks
+      @hooks ||= []
+    end
+
+    # keeps track of all before hooks
+    def ignored_methods
+      @ignored_methods ||= []
+    end
+
+    private
+
+    # keeps track of all currently hooked methods
+    def hooked_methods
+      @hooked_methods ||= []
+    end
+
+    def add_hooks_to(method_name)
+      # add this method to known hook mappings to avoid infinite
+      # recursion when we redefine the method below
+      hooked_methods << method_name
+
+      # grab the original method definition
+      original_method = instance_method(method_name)
+
+      # re-define the method, but notice how we reference the original
+      # method definition
+      define_method(method_name) do |*args, &block|
+        # invoke the hook methods
+        hooks_to_run = []
+        klass = self.class
+        while klass != BasicObject do
+          hooks_to_run.concat(klass.hooks) if klass.respond_to? :hooks
+          klass = klass.superclass
+        end
+        hooks_to_run.each do |h|
+          # LOGGER.debug "calling hook #{h} for method: #{method_name}"
+          method(h).call
+        end
+
+        # now invoke the original method
+        original_method.bind(self).call(*args, &block)
+      end
+    end
+  end
+end

data/lib/capybara/widgets/core/page.rb

@@ -53,6 +53,17 @@ module Capybara
         loaded?
         self
       end
+
+      class << self
+        def iframe(name, page_class, selector)
+          define_method name do |&block|
+            raise "No iframe found: #{selector}" unless page.has_selector?(selector)
+            within_frame page.find(selector) do
+              block.call page_class.new
+            end
+          end
+        end
+      end
     end
   end
 end

data/lib/capybara/widgets/core/widget.rb

@@ -1,5 +1,8 @@
 require 'capybara/dsl'
+require 'active_support/core_ext/class/attribute'
 require_relative '../helpers/async_helper'
+require_relative 'execution_hooks'
+
 
 module Capybara
   module Widgets
@@ -7,6 +10,21 @@ module Capybara
       include Capybara::DSL
       include Capybara::Widgets::AsyncHelper
 
+      include ExecutionHooks
+
+      before_hook :set_target_app,
+                  ignore: [
+                      :driver, :driver=, :driver?,
+                      :session_name, :session_name=, :session_name?,
+                      :default_selector, :default_selector=, :default_selector?
+                  ]
+
+      class_attribute :driver, :session_name, :default_selector
+
+      self.driver = Capybara.current_driver
+      self.session_name = Capybara.session_name
+      self.default_selector = Capybara.default_selector
+
       def initialize(*search_scope)
         case search_scope.length
           when 0
@@ -106,6 +124,17 @@ module Capybara
           super
         end
       end
+
+      private
+
+      def set_target_app
+        if Capybara.current_driver != driver || Capybara.session_name != session_name || Capybara.default_selector != default_selector
+          puts "Switching target: #{driver}:#{session_name}:#{default_selector}"
+          Capybara.current_driver = self.driver
+          Capybara.session_name = self.session_name
+          Capybara.default_selector = self.default_selector
+        end
+      end
     end
   end
 end

data/lib/capybara/widgets/rspec.rb

@@ -39,6 +39,45 @@ module Capybara
           "Expected that '#{widget.class.name}' not to be visible"
         end
       end
+      #
+      # RSpec::Matchers.define :be_loaded do
+      #   match do |page|
+      #     page_opened = page.opened?
+      #     if page.respond_to?(:components_loaded?)
+      #       components_loaded = page.components_loaded?
+      #     end
+      #     if page.respond_to?(:elements_loaded?)
+      #       elements_loaded = page.elements_loaded?
+      #     end
+      #     page_opened && components_loaded && elements_loaded
+      #   end
+      #
+      #   match_when_negated do |_|
+      #     raise "Unsupported negated matcher"
+      #   end
+      #
+      #   failure_message do |page|
+      #     page_opened = page.opened?
+      #     components_loaded = page.respond_to?(:components_loaded?) ? page.components_loaded? : true
+      #     elements_loaded = page.respond_to?(:elements_loaded?) ? page.elements_loaded? : true
+      #     message = "Failed: "
+      #     unless page_opened
+      #       message = "#{page.class} is not opened.\n Actual: #{page.current_path}\nExpected: #{page.path_matcher || page.url_matcher || page.path }"
+      #     end
+      #     unless components_loaded
+      #       message = "Some components are not loaded on #{page.class}"
+      #     end
+      #     unless elements_loaded
+      #       message = "Some elements are not loaded on #{page.class}"
+      #     end
+      #     message
+      #   end
+      #
+      #   failure_message_when_negated do |_|
+      #     raise "Unsupported negated matcher"
+      #   end
+      # end
+      #
     end
   end
 end

data/lib/capybara/widgets/version.rb

@@ -1,5 +1,5 @@
 module Capybara
   module Widgets
-    VERSION = "0.4.0"
+    VERSION = "0.5.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: capybara-widgets
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Vitalii Grygoruk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-24 00:00:00.000000000 Z
+date: 2016-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -125,6 +125,7 @@ files:
 - capybara-widgets.gemspec
 - lib/capybara/widgets.rb
 - lib/capybara/widgets/core/dsl.rb
+- lib/capybara/widgets/core/execution_hooks.rb
 - lib/capybara/widgets/core/page.rb
 - lib/capybara/widgets/core/page_collection.rb
 - lib/capybara/widgets/core/widget.rb