capybara-widgets 0.0.2 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4486c4e504621dc18e76de0e990848aad563d821
-  data.tar.gz: 055b95ae49d0a92266c13dc62e3cec6a444392f8
+  metadata.gz: e196b230cb55720ba9f662b0c2b8ee8d6a18971e
+  data.tar.gz: 63b356fc9d51fa05057123d99285935910d090f1
 SHA512:
-  metadata.gz: 00fd373bc52d8be429a29602db3ba2353e6a69e5962d10e926de7abd15efda38f5ddef8fc87e3c83acf8eb5d13472c20e05fcc3a77137adae6a3488e48fa5b97
-  data.tar.gz: 50343fac4b224bf14bb6a086ef1673e1ddcdb0d4ba5578270ebee01f1a78d917bc1d1537812f4d230a8cbb19e9b865cd153f7478ba2170f4bce23af8bc094686
+  metadata.gz: 42fe69573483dee2b0b15d4ed193a3dd8ae1230c5f672c453963eeef6f4cb124cd5eb1e9b8b77c67a723059d547906c2cb0aa230a5716b30892350bd7183a51e
+  data.tar.gz: 0a92d4cb0a543b119b0c664b9cf009137264fb187989a503d531c0f0e82fce047ec0bf355922783868ebd0d6a62b80ae96316e11ace9e3c0355421c73b27e15e

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+ - "2.1.4"
+script: bundle exec rspec spec/features
+

data/README.md

@@ -1,5 +1,7 @@
 # Capybara::Widgets
 
+[![Build Status](https://travis-ci.org/vgrigoruk/capybara-widgets.svg?branch=master)](https://travis-ci.org/vgrigoruk/capybara-widgets)
+
 TODO: Write a gem description
 
 ## Installation

data/capybara-widgets.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.version       = Capybara::Widgets::VERSION
   spec.authors       = ["Vitalii Grygoruk"]
   spec.email         = ["vitalii[dot]grygoruk[at]gmail[dot]com"]
-  spec.summary       = %q{Page object implementation for Capybara}
-  spec.description   = %q{Another implementation of page object pattern for Capybara}
+  spec.summary       = %q{Page objects and page components for Capybara}
+  spec.description   = %q{Easily create well-structured page and ui component classes in your Capybara + Cucumber or Rspec tests}
   spec.homepage      = ""
   spec.license       = "MIT"
 
@@ -20,7 +20,7 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "bundler", "~> 1.7"
   spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rspec", "~> 3.2"
   spec.add_development_dependency "cucumber"
 
   spec.add_dependency "capybara", "~> 2.0"

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

@@ -0,0 +1,10 @@
+module Capybara
+  module Widgets
+    module DSL
+      def within_widget(klass)
+        raise "#{klass.name} is not a subclass of Widget" unless klass < Capybara::Widgets::Widget
+        yield klass.new
+      end
+    end
+  end
+end

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

@@ -1,4 +1,5 @@
 require_relative 'widget'
+require_relative 'page_collection'
 require 'active_support/core_ext/class/attribute'
 
 module Capybara
@@ -6,13 +7,26 @@ module Capybara
     class Page < Widget
 
       class_attribute :path
+      class_attribute :path_matcher
+
+      def self.inherited(subclass)
+        PageCollection.instance.registry << subclass
+      end
 
       def initialize
         super(page)
       end
 
       def loaded?
-        true
+        result = opened?
+        if self.respond_to?(:elements_loaded?)
+          result = result && elements_loaded?
+        end
+        result
+      end
+
+      def opened?
+        current_path =~ %r{#{Regexp.quote(self.path)}}
       end
 
       def reload!

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

@@ -0,0 +1,47 @@
+require 'active_support/core_ext/class/attribute'
+require 'singleton'
+
+module Capybara
+  module Widgets
+    class PageCollection
+      include Singleton
+
+      attr_accessor :registry
+
+      class_attribute :load_path
+
+      def initialize
+        self.registry = Array.new
+        @loaded = false
+      end
+
+      def current_page_class
+        load_classes unless @loaded
+        klass = registry.detect do |page_class|
+          if page_class.path_matcher
+            if page_class.path_matcher.is_a?(Regexp)
+              Capybara.current_path =~ page_class.path_matcher
+            elsif page_class.path_matcher.is_a?(String)
+              Capybara.current_path.include?(page_class.path_matcher)
+            end
+          else
+            Capybara.current_path.include?(page_class.path)
+          end
+        end
+        raise "Not found" if klass.nil?
+        klass
+      end
+
+      private
+
+      def load_classes
+        Dir[File.join(load_path, "**/*.rb")].each{|f| require f}
+        @loaded = true
+      end
+    end
+  end
+end
+
+def current_page
+  Capybara::Widgets::PageCollection.instance.current_page_class.new
+end

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

@@ -53,6 +53,12 @@ module Capybara
           define_method("#{name}=") { |arg| root.find(*query).set(arg) }
           define_method("has_#{name}?") { root.has_selector?(*query) }
         end
+
+        def required_element(*element_names)
+          define_method(:elements_loaded?) { element_names.each {|name| self.send("has_#{name}?")} }
+        end
+
+        alias_method :required_elements, :required_element
       end
 
       # delegate missing methods to the @root node

data/lib/capybara/widgets/cucumber/page_steps.rb

@@ -1,22 +1,35 @@
 require 'cucumber'
 require_relative '../helpers/string_helpers'
+require_relative '../helpers/async_helper'
+require_relative '../core/dsl'
 
-  World Capybara::Widgets::StringHelpers
+World Capybara::Widgets::StringHelpers
+World Capybara::Widgets::AsyncHelper
+World Capybara::Widgets::DSL
 
-  Given(/^I am on a (.* page)/) do |page_name|
-    within_widget(to_widget_class(page_name)) do |page|
-      page.open!
-    end
+Given(/^I am on a (.* page)/) do |page_name|
+  within_widget(to_widget_class(page_name)) do |page|
+    page.open!
   end
+end
 
-  When(/^I navigate to a (.* page)/) do |page_name|
-    within_widget(to_widget_class(page_name)) do |page|
-      page.open!
-    end
+When(/^I navigate to a (.* page)/) do |page_name|
+  within_widget(to_widget_class(page_name)) do |page|
+    page.open!
   end
+end
 
-  Then(/^I should be on a (.* page)/) do |page_name|
-    within_widget(to_widget_class(page_name)) do |page|
-      expect(page).to be_opened
-    end
+Then(/^I should be on a (.* page)/) do |page_name|
+  within_widget(to_widget_class(page_name)) do |page|
+    eventually { expect(page).to be_loaded }
   end
+end
+
+When(/^I click "([^"]*)"$/) do |action|
+  current_page.send(to_widget_action(action, '!'))
+end
+
+When(/^I set "([^"]*)" to "([^"]*)"$/) do |field_name, value|
+  current_page.send(to_widget_action(field_name, '='), value)
+end
+

data/lib/capybara/widgets/cucumber/widget_steps.rb

@@ -1,12 +1,9 @@
 require 'cucumber'
 require_relative '../helpers/string_helpers'
+require_relative '../core/dsl'
 
 World Capybara::Widgets::StringHelpers
-
-def within_widget(klass)
-  raise "#{klass.name} is not a subclass of Widget" unless klass < Capybara::Widgets::Widget
-  yield klass.new
-end
+World Capybara::Widgets::DSL
 
 def resolve_widget(widget_chain)
   elements = widget_chain.split('->')
@@ -17,7 +14,7 @@ def resolve_widget(widget_chain)
   apply_action_chain(top_widget, action_chain)
 end
 
-When(/^I click "([^"]*)" in a "([^"]*)"$/) do |action, widget_path|
+When(/^I click "([^"]*)" [o|i]n a "([^"]*)"$/) do |action, widget_path|
   target_widget = resolve_widget(widget_path)
   target_widget.send(to_widget_action(action, '!'))
 end

data/lib/capybara/widgets/helpers/async_helper.rb

@@ -0,0 +1,20 @@
+module Capybara
+  module Widgets
+    module AsyncHelper
+      def eventually(options = {})
+        timeout = options[:timeout] || 10
+        interval = options[:interval] || 0.1
+        time_limit = Time.now + timeout
+        loop do
+          begin
+            result = yield
+          rescue => error
+          end
+          return result if error.nil?
+          raise error if Time.now >= time_limit
+          sleep interval
+        end
+      end
+    end
+  end
+end

data/lib/capybara/widgets/rspec.rb

@@ -0,0 +1 @@
+require_relative 'core/dsl'

data/lib/capybara/widgets/version.rb

@@ -1,5 +1,5 @@
 module Capybara
   module Widgets
-    VERSION = "0.0.2"
+    VERSION = "0.1.0"
   end
 end

data/lib/capybara/widgets.rb

@@ -4,5 +4,6 @@ module Capybara
   module Widgets
     autoload :Widget, 'capybara/widgets/core/widget'
     autoload :Page, 'capybara/widgets/core/page'
+    autoload :PageCollection, 'capybara/widgets/core/page_collection'
   end
 end

data/spec/features/widget_spec.rb

@@ -33,8 +33,8 @@ describe Capybara::Widgets::Widget do
     end
     # Act and Assert
     widget = MyWidget.new
-    expect(widget.loaded).to be_false
+    expect(widget.loaded).to be false
     widget.root
-    expect(widget.loaded).to be_true
+    expect(widget.loaded).to be true
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: capybara-widgets
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.1.0
 platform: ruby
 authors:
 - Vitalii Grygoruk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-24 00:00:00.000000000 Z
+date: 2015-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -42,16 +42,16 @@ dependencies:
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: cucumber
   requirement: !ruby/object:Gem::Requirement
@@ -94,7 +94,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Another implementation of page object pattern for Capybara
+description: Easily create well-structured page and ui component classes in your Capybara
+  + Cucumber or Rspec tests
 email:
 - vitalii[dot]grygoruk[at]gmail[dot]com
 executables: []
@@ -102,18 +103,23 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - capybara-widgets.gemspec
 - lib/capybara/widgets.rb
+- lib/capybara/widgets/core/dsl.rb
 - lib/capybara/widgets/core/page.rb
+- lib/capybara/widgets/core/page_collection.rb
 - lib/capybara/widgets/core/widget.rb
 - lib/capybara/widgets/cucumber.rb
 - lib/capybara/widgets/cucumber/page_steps.rb
 - lib/capybara/widgets/cucumber/widget_steps.rb
+- lib/capybara/widgets/helpers/async_helper.rb
 - lib/capybara/widgets/helpers/string_helpers.rb
+- lib/capybara/widgets/rspec.rb
 - lib/capybara/widgets/version.rb
 - spec/features/page_spec.rb
 - spec/features/widget_spec.rb
@@ -141,7 +147,7 @@ rubyforge_project:
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: Page object implementation for Capybara
+summary: Page objects and page components for Capybara
 test_files:
 - spec/features/page_spec.rb
 - spec/features/widget_spec.rb