pincers 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9be2262d6757498e82ec195e8e8e5109226df675
-  data.tar.gz: 73e0e4943ec46e3dcbd35a043dda468bbb1e75f2
+  metadata.gz: feda6bb5061f196c604a1dc79dfd32ec4bec842c
+  data.tar.gz: 54b99547bdb963def619ef399e39b166de4c6720
 SHA512:
-  metadata.gz: a7fcc330eb821333f73e1d9f4989084e5d7a0d161703542725ab606a244ac10305f69430bb3522e1c7cc5d8a1746a8bb974f4d9585170aa27b59822980c9afd5
-  data.tar.gz: 917e6139161b82a3a817b9fb6deb3d31295e60658e138d9004efcb8712f27f41e691c963fedc200c8de22d12c4d398ef5a0e4f2f1176c9523a68b0605b21ab53
+  metadata.gz: acc759a2464e7ec81ad88d75b44824e1f3d7dddeaa68511ce851a7e5bd4d06b5dc2c3410a1f92a362a4789a2d1e1950bf4a7889b15d063a1d12b51204b832da8
+  data.tar.gz: 084a161f77fe5e52eec66d84188a98b55dc70d945acdb8b3a5bce34f2ed70e57fba73be3f3768b90abf41fc0fedca87987e76fae05fd8a4177df26fd1cda0b98

data/lib/pincers/backend/base.rb

@@ -20,10 +20,6 @@ module Pincers::Backend
       ensure_implementation :document_title
     end
 
-    def document_source
-      ensure_implementation :document_source
-    end
-
     def fetch_cookies
       ensure_implementation :fetch_cookies
     end
@@ -52,6 +48,10 @@ module Pincers::Backend
       ensure_implementation :search_by_xpath
     end
 
+    def extract_element_tag(_element)
+      ensure_implementation :extract_element_tag
+    end
+
     def extract_element_text(_element)
       ensure_implementation :extract_element_text
     end
@@ -68,18 +68,30 @@ module Pincers::Backend
       ensure_implementation :clear_input
     end
 
-    def fill_input(_element, _value)
-      ensure_implementation :fill_input
+    def set_element_text(_element, _value)
+      ensure_implementation :set_element_text
+    end
+
+    def click_on_element(_element)
+      ensure_implementation :click_on_element
+    end
+
+    def switch_to_frame(_element)
+      ensure_implementation :switch_to_frame
+    end
+
+    def switch_to_top_frame
+      ensure_implementation :switch_to_top_frame
     end
 
-    def load_frame_element(_element)
-      ensure_implementation :load_frame_element
+    def switch_to_parent_frame
+      ensure_implementation :switch_to_parent_frame
     end
 
   private
 
     def ensure_implementation(_name)
-      raise MissingFeatureError.new _name
+      raise Pincers::MissingFeatureError.new _name
     end
 
   end

data/lib/pincers/backend/nokogiri.rb

@@ -4,6 +4,14 @@ module Pincers::Backend
 
   class Nokogiri < Base
 
+    def document_root
+      [document]
+    end
+
+    def document_title
+      document.title
+    end
+
     def search_by_css(_element, _selector)
       _element.css _selector
     end
@@ -12,16 +20,32 @@ module Pincers::Backend
       _element.xpath _selector
     end
 
+    def extract_element_tag(_element)
+      _element.name
+    end
+
     def extract_element_text(_element)
-      # _element.text
+      _element.content
     end
 
     def extract_element_html(_element)
-      # _element['outerHTML']
+      _element.to_html
     end
 
     def extract_element_attribute(_element, _name)
-      # _element[_name]
+      _name = _name.to_sym
+
+      value = _element[_name]
+      value = checkbox_value_fix _element, value if _name == :value
+      value
+    end
+
+  private
+
+    def checkbox_value_fix(_element, _value)
+      if _value.nil? and _element.name.downcase == 'input' and ['checkbox', 'radio'].include? _element[:type].downcase
+        'on'
+      else _value end
     end
 
   end

data/lib/pincers/backend/webdriver.rb

@@ -23,10 +23,6 @@ module Pincers::Backend
       @driver.title
     end
 
-    def document_source
-      @driver.page_source
-    end
-
     def fetch_cookies
       @driver.manage.all_cookies
     end
@@ -55,30 +51,43 @@ module Pincers::Backend
       _element.find_elements xpath: _selector
     end
 
-    def extract_element_text(_element)
+    def extract_element_tag(_element)
+      _element = ensure_element _element
+      _element.tag_name
+    end
 
+    def extract_element_text(_element)
+      _element = ensure_element _element
       _element.text
     end
 
     def extract_element_html(_element)
-      if _element == @driver then @driver.page_source else _element.attribute('outerHTML') end
+      return @driver.page_source if _element == @driver
+      _element.attribute 'outerHTML'
     end
 
     def extract_element_attribute(_element, _name)
+      _element = ensure_element _element
       _element[_name]
     end
 
-    def clear_input(_element)
+    def set_element_text(_element, _value)
+      _element = ensure_element _element
       _element.clear
+      _element.send_keys _value
     end
 
-    def fill_input(_element, _value)
-      _element.send_keys _value
+    def click_on_element(_element)
+      _element = ensure_element _element
+      _element.click
+    end
+
+    def switch_to_frame(_element)
+      @driver.switch_to.frame _element
     end
 
-    def load_frame_element(_element)
-      driver.switch_to.frame _element
-      self
+    def switch_to_top_frame
+      @driver.switch_to.default_content
     end
 
     # wait contitions
@@ -103,6 +112,13 @@ module Pincers::Backend
       not _elements.any? { |e| e.displayed? }
     end
 
+  private
+
+    def ensure_element(_element)
+      return @driver.find_element tag_name: 'html' if _element == @driver
+      _element
+    end
+
   end
 
 end

data/lib/pincers/core/root_context.rb

@@ -32,16 +32,24 @@ module Pincers::Core
       wrap_errors { backend.document_title }
     end
 
-    def source
-      wrap_errors { backend.document_source }
-    end
-
     def cookies
       @cookies ||= CookieJar.new backend
     end
 
-    def goto(_url)
-      wrap_errors { backend.navigate_to _url }
+    def goto(_urlOrOptions)
+      wrap_errors do
+        if _urlOrOptions.is_a? String
+          _urlOrOptions = { url: _urlOrOptions }
+        end
+
+        if _urlOrOptions.key? :frame
+          goto_frame _urlOrOptions[:frame]
+        elsif _urlOrOptions.key? :url
+          backend.navigate_to _urlOrOptions[:url]
+        else
+          raise ArgumentError.new "Must provide a valid target when calling 'goto'"
+        end
+      end
       self
     end
 
@@ -68,5 +76,22 @@ module Pincers::Core
       @config[:wait_interval]
     end
 
+  private
+
+    def goto_frame(_frame)
+      case _frame
+      when :top
+        backend.switch_to_top_frame
+      when :parent
+        backend.switch_to_parent_frame
+      when String
+        backend.switch_to_frame css(_frame).element!
+      when SearchContext
+        backend.switch_to_frame _frame.element!
+      else
+        raise ArgumentError.new "Invalid :frame option #{_frame.inspect}"
+      end
+    end
+
   end
 end

data/lib/pincers/core/search_context.rb

@@ -1,7 +1,12 @@
+require 'pincers/extension/queries'
+require 'pincers/extension/actions'
+
 module Pincers::Core
   class SearchContext
     include Enumerable
     extend Forwardable
+    include Pincers::Extension::Queries
+    include Pincers::Extension::Actions
 
     attr_accessor :parent, :elements
 
@@ -51,6 +56,10 @@ module Pincers::Core
       if elements.first.nil? then nil else wrap_elements [elements.first] end
     end
 
+    def first!
+      first or raise Pincers::EmptySetError.new(self)
+    end
+
     def last
       if elements.last.nil? then nil else wrap_elements [elements.last] end
     end
@@ -67,16 +76,15 @@ module Pincers::Core
       end
     end
 
-    def text
+    def tag
       wrap_errors do
-        backend.extract_element_text element!
+        backend.extract_element_tag(element!).downcase
       end
     end
 
-    def classes
+    def text
       wrap_errors do
-        class_attr = backend.extract_element_attribute element!, 'class'
-        (class_attr || '').split(' ')
+        backend.extract_element_text element!
       end
     end
 
@@ -88,49 +96,22 @@ module Pincers::Core
 
     # Input related
 
-    def set(_value)
+    def set_text(_value)
       wrap_errors do
-        backend.clear_input element!
-        backend.fill_input element!
+        backend.set_element_text element!, _value
       end
     end
 
-    def select(_value)
-      # TODO.
-    end
-
-    # context related
-
-    def enter
+    def click
       wrap_errors do
-        RootContext.new backend.load_frame_element(element!), root.config
+        backend.click_on_element element!
       end
     end
 
-    # Any methods missing are forwarded to the main element (first)
-
-    def method_missing(_method, *_args, &_block)
-      wrap_errors do
-        m = /^(.*)_all$/.match _method.to_s
-        if m then
-          return [] if empty?
-          elements.map { |e| e.send(m[1], *_args, &_block) }
-        else
-          element!.send(_method, *_args, &_block)
-        end
-      end
-    end
+    # context related
 
-    def respond_to?(_method, _include_all=false)
-      return true if super
-      m = /^.*_all$/.match _method.to_s
-      if m then
-        return true if empty?
-        elements.first.respond_to? m[1], _include_all
-      else
-        return true if empty?
-        elements.first.respond_to? _method, _include_all
-      end
+    def goto
+      root.goto frame: self
     end
 
   private

data/lib/pincers/extension/actions.rb

@@ -0,0 +1,56 @@
+module Pincers::Extension
+  module Actions
+
+    def set(_value=true, _options={})
+
+      if _value.is_a? Hash
+        _options = _value
+        _value = true
+      end
+
+      case input_mode
+      when :text
+        set_text _value.to_s
+      when :select
+        return set_selected _value, _options
+      when :checkbox, :radio
+        return set_checked _value
+      when :button
+        click if _value
+      else
+        return false
+      end
+      true
+    end
+
+  private
+
+    def set_selected(_value, _options)
+      click
+      option = if _options.key? :by_value then
+        find_option_by_value _options.delete(:by_value), _options
+      else
+        find_option_by_label _value, _options
+      end
+
+      return false if option.nil? or option.selected?
+      option.click
+      true
+    end
+
+    def set_checked(_value)
+      return false if _value == checked?
+      click
+      true
+    end
+
+    def find_option_by_label(_label, _options)
+      css("option", _options).find { |o| o.text == _label }
+    end
+
+    def find_option_by_value(_value, _options)
+      css("option", _options).find { |o| o[:value] == _value.to_s }
+    end
+
+  end
+end

data/lib/pincers/extension/queries.rb

@@ -0,0 +1,45 @@
+module Pincers::Extension
+  module Queries
+
+    TEXT_INPUTS = ['text', 'email', 'number', 'email', 'color', 'password', 'search', 'tel', 'url']
+
+    def value
+      case input_mode
+      when :checkbox, :radio
+        if checked? then self[:value] else nil end
+      else
+        self[:value]
+      end
+    end
+
+    [:selected, :checked, :disabled, :required].each do |attr_name|
+      define_method "#{attr_name}?" do
+        not self[attr_name].nil?
+      end
+    end
+
+    def classes
+      (self[:class] || '').split(' ')
+    end
+
+    def selected(_options={})
+      first!.css('option', _options).select { |opt| opt.selected? }
+    end
+
+    def checked(_options={})
+      first!.css('input', _options).select { |opt| opt.checked? }
+    end
+
+    def input_mode
+      return :select if tag == 'select'
+      return :button if tag == 'button' # TODO: button types
+      return :text if tag == 'textarea'
+      return nil if tag != 'input'
+
+      type = (self[:type] || 'text').downcase
+      return :text if TEXT_INPUTS.include? type
+      type.to_sym
+    end
+
+  end
+end

data/lib/pincers/version.rb

@@ -1,3 +1,3 @@
 module Pincers
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pincers
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Ignacio Baixas
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-11 00:00:00.000000000 Z
+date: 2015-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -178,6 +178,34 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  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: thin
+  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'
 description: 
 email:
 - ignacio@platan.us
@@ -191,6 +219,8 @@ files:
 - lib/pincers/core/root_context.rb
 - lib/pincers/core/search_context.rb
 - lib/pincers/errors.rb
+- lib/pincers/extension/actions.rb
+- lib/pincers/extension/queries.rb
 - lib/pincers/factory.rb
 - lib/pincers/support/configuration.rb
 - lib/pincers/support/cookie_jar.rb