capybara-widgets 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 243b219f6926b422cc9195f4aa9274dc814258e0
+  data.tar.gz: dc286684ad060709665a68e87debbd164a7d4421
+SHA512:
+  metadata.gz: cc2e60040d367d6cd9188d032f2b85fe2359c8398e5ef2e8c1b0cabafde436ae885ede8b79a535933bd6f74cf80080045619df0e1dac5c8d11fa7aa6f141861c
+  data.tar.gz: b1a19e794f2a2476c306ecba086928408ef149b40f30150196e69a1e86fe50a50208101d439eb745e2a9a3b80157565d448d9cf676ffad8cb3ca06ff6e1a2a4d

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.idea/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in capybara-widgets.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Vitalii Grygoruk
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,31 @@
+# Capybara::Widgets
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'capybara-widgets'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install capybara-widgets
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/vgrigoruk/capybara-widgets/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/capybara-widgets.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capybara/widgets/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "capybara-widgets"
+  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.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "cucumber"
+
+  spec.add_dependency "capybara", "~> 2.0"
+  spec.add_dependency "activesupport"
+end

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

@@ -0,0 +1,21 @@
+require_relative 'widget'
+require 'active_support/core_ext/class/attribute'
+
+module Capybara
+  module Widgets
+
+    class Page < Widget
+
+      class_attribute :path
+
+      def initialize
+        super(page)
+      end
+
+      def reload!
+        visit(current_url)
+      end
+    end
+  end
+end
+

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

@@ -0,0 +1,54 @@
+require 'capybara/dsl'
+
+module Capybara
+  module Widgets
+    class Widget
+      include Capybara::DSL
+
+      def initialize(*search_scope)
+        case search_scope.length
+          when 0
+            @root = page
+          when 1
+            @root = search_scope[0].respond_to?(:find) ? search_scope[0] : page.find(search_scope[0])
+          else
+            @root = page.find(*search_scope)
+        end
+        @narrowed = false
+      end
+
+      # running narrow only before a first call to root,
+      # useful when you want to call a method on widget that uses "page" and you don't want to run "narrow" during init
+      def root
+        unless @narrowed
+          @narrowed = true
+          @root = narrow
+        end
+        @root
+      end
+
+      # override this method if you need to narrow down search context for a particular UI widget / block
+      def narrow
+        @root
+      end
+
+      class << self
+        def component(name, klass, *query)
+          define_method name do
+            component_root = query.length > 0 ? root.find(*query) : root
+            klass.new(component_root)
+          end
+        end
+      end
+
+      # delegate missing methods to the @root node
+      def method_missing(method_sym, *arguments, &block)
+        if root.respond_to? method_sym
+          root.send(method_sym, *arguments, &block)
+        else
+          super
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,61 @@
+module Capybara::Widgets::Cucumber
+
+  include 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
+
+  When(/^I click "([^"]*)" in a "([^"]*)"$/) do |action, widget_name|
+    within_widget(to_widget_class(widget_name)) do |widget|
+      widget.send(to_widget_action(action, '!'))
+    end
+  end
+
+  Then(/^the "([^"]*)" should( not)? be displayed$/) do |widget_name, negated|
+    widget_class = to_widget_class(widget_name)
+    within_widget(widget_class) do |widget|
+      if negated
+        expect(widget).to be_not_displayed, "#{widget_class} should not be displayed"
+      else
+        expect(widget).to be_displayed, "#{widget_class} should be displayed"
+      end
+    end
+  end
+
+  When(/^I set "([^"]*)" to "([^"]*)" in a "([^"]*)"$/) do |field_name, value, widget_name|
+    within_widget(to_widget_class(widget_name)) do |widget|
+      widget.send(to_widget_action(field_name, '='), value)
+    end
+  end
+
+  And(/^I should see the following "([^"]*)" in a "([^"]*)"$/) do |field_name, widget_name, table|
+    expected_values = table.raw.flatten
+    within_widget(to_widget_class(widget_name)) do |widget|
+      actual_values = widget.send(to_widget_action(field_name))
+      expect(actual_values).to eq(expected_values)
+    end
+  end
+
+  When(/^I fill in the following in a "([^"]*)"$/) do |widget_name, table|
+    fields = table.rows_hash
+    within_widget(to_widget_class(widget_name)) do |widget|
+      fields.each do |k,v|
+        widget.send(to_widget_action(k, '='), v)
+      end
+    end
+  end
+
+  And(/^the "([^"]*)" should be "([^"]*)" in a "([^"]*)"$/) do |field_name, expected, widget_name|
+    within_widget(to_widget_class(widget_name)) do |widget|
+      action = to_widget_action(field_name)
+      if widget.respond_to? "has_#{action}?"
+        expect(widget.send("has_#{action}?", expected)).to be_true
+      else
+        actual = widget.send(action)
+        expect(actual).to eq(expected)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+module Capybara::Widgets::StringHelpers
+  def to_widget_class(name)
+    name.to_s.gsub(' ','_').classify.constantize
+  end
+
+  def to_widget_action(name, suffix=nil)
+    "#{name.to_s.downcase.gsub(' ','_')}#{suffix}"
+  end
+end

data/lib/capybara/widgets/version.rb

@@ -0,0 +1,5 @@
+module Capybara
+  module Widgets
+    VERSION = "0.0.1"
+  end
+end

data/lib/capybara/widgets.rb

@@ -0,0 +1,8 @@
+require "capybara/widgets/version"
+
+module Capybara
+  module Widgets
+    autoload :Widget, 'capybara/widgets/core/widget'
+    autoload :Page, 'capybara/widgets/core/page'
+  end
+end

data/spec/features/page_spec.rb

@@ -0,0 +1,9 @@
+require_relative '../spec_helper'
+
+describe Capybara::Widgets::Page do
+  let(:klass) { Capybara::Widgets::Page }
+
+  it 'has page as a root' do
+    expect(klass.new.root).to eq(page)
+  end
+end

data/spec/features/widget_spec.rb

@@ -0,0 +1,40 @@
+require_relative '../spec_helper'
+
+describe Capybara::Widgets::Widget do
+  let(:klass) { Capybara::Widgets::Widget }
+  let(:stub_node) { Capybara::Node::Base.new(nil, nil) }
+
+  it 'has capybara page as a default root node' do
+    expect(subject.root).to eq(page)
+  end
+
+  it 'can be initialized with Capybara::Node::Base' do
+    expect(klass.new(stub_node).root).to eq(stub_node)
+  end
+
+  it 'can be initialized with string query' do
+    allow_any_instance_of(Capybara::Session).to receive(:driver).and_return(nil)
+    allow_any_instance_of(Capybara::Session).to receive(:find).with('.css-class').and_return(stub_node)
+    expect(klass.new('.css-class').root).to eq(stub_node)
+  end
+
+  it 'can be initialized with full query' do
+    allow_any_instance_of(Capybara::Session).to receive(:driver).and_return(nil)
+    allow_any_instance_of(Capybara::Session).to receive(:find).with(:xpath, '//somexpath', text: 'text', wait: 2).and_return(stub_node)
+    expect(klass.new(:xpath, '//somexpath', text: 'text', wait: 2).root).to eq(stub_node)
+  end
+
+  it 'can have lazy-initialized root node' do
+    # Arrange 
+    class MyWidget < klass   
+      attr_accessor :loaded
+      def initialize; self.loaded = false; end
+      def narrow; self.loaded = true; @root; end
+    end
+    # Act and Assert
+    widget = MyWidget.new
+    expect(widget.loaded).to be_false
+    widget.root
+    expect(widget.loaded).to be_true
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require 'rspec'
+require 'capybara/dsl'
+require 'capybara/widgets'
+
+Capybara.run_server = false
+
+RSpec.configure do |c|
+  c.include Capybara::Widgets
+  c.include Capybara::DSL
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: capybara-widgets
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Vitalii Grygoruk
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Another implementation of page object pattern for Capybara
+email:
+- vitalii[dot]grygoruk[at]gmail[dot]com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- capybara-widgets.gemspec
+- lib/capybara/widgets.rb
+- lib/capybara/widgets/core/page.rb
+- lib/capybara/widgets/core/widget.rb
+- lib/capybara/widgets/cucumber/widget_steps.rb
+- lib/capybara/widgets/helpers/string_helpers.rb
+- lib/capybara/widgets/version.rb
+- spec/features/page_spec.rb
+- spec/features/widget_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Page object implementation for Capybara
+test_files:
+- spec/features/page_spec.rb
+- spec/features/widget_spec.rb
+- spec/spec_helper.rb