watir-formhandler 2.1.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b92e73452df613d4cebbab78ba085259a504b00e
-  data.tar.gz: 078a6861a8b11e88e9c1675c3b7c877d1991b062
+  metadata.gz: 56ab0c2b068798ca27c07cb6f83f617d9ccb8315
+  data.tar.gz: 32008f45d343055e6e9f30210d14d6feaffee9d1
 SHA512:
-  metadata.gz: 12d2941e5e8b6f3de215eaa2e5bc8088e6629c7f8dc3c6b452d83aeb1475b4ae94c614b50942f085ba973c10e40491aea575b53262708b759d9956692802b3c5
-  data.tar.gz: 0231e8ffe1c62f472da7626c69ce5821b0a552c1dcd19d7b9353d7a9e2435d1b5b8e194bdeaab8cb5ad8ab2d2367ea45181f273c0c63586ce61b52fc8ac3d2ba
+  metadata.gz: a0df8ee522f0540a9b4190b3a99d87ebb5fef276cb5262de23aae70f586d67a2246ca5a9007da2701297e30031d2d5ad7a1725a73181049261cbcda5e345ac09
+  data.tar.gz: f8b78f130d760a25dd3c47e4a9de326d74c78d83bc8c6f3c73346a0843d508ab2c291a76cc1176ef026c73822eeeed096db9f98f147f1657dcec38e5674ecdd1

data/README.md

@@ -0,0 +1,6 @@
+[![Code Climate](https://codeclimate.com/github/Dervol03/watir-formhandler/badges/gpa.svg)](https://codeclimate.com/github/Dervol03/watir-formhandler)
+
+watir-formhandler
+=================
+
+Provides comfort methods for watir to fill in forms

data/lib/watir_formhandler/check_box.rb

@@ -1,5 +1,7 @@
+require 'watir-webdriver/elements/checkbox'
 module Watir
-  require 'watir-webdriver/elements/checkbox'
+
+  # Extends the Watir::Checkbox class with set and field_value methods.
   class CheckBox
 
     # Will click the CheckBox unless the #checked? returns the same value as the given one.

data/lib/watir_formhandler/container.rb

@@ -5,11 +5,19 @@ module Watir
     # @param [String, Watir::Label] label the label for which to find the form field.
     # @param [Watir::Element] start_node the node where to start searching for the label.
     # @param [Boolean] include_groups whether to detect the group of a given label.
+    # @param [Boolean] placeholder whether to handle label as Watir::Label or as placeholder
+    #                              attribute for an input field.
+    #
     # @return [Watir::Element] form field of the given label.
-    def field(label, start_node: nil, include_groups: false)
+    def field(label, start_node: nil, include_groups: false, placeholder: false)
       start_node ||= self
-      field_label = label.respond_to?(:for) ? label : start_node.label(text: label)
-      determine_field(start_node, field_label, include_groups)
+
+      if placeholder
+        start_node.element(placeholder: label).to_subtype
+      else
+        field_label = label.respond_to?(:for) ? label : start_node.label(text: label)
+        determine_field(start_node, field_label, include_groups)
+      end
     end
 
 
@@ -19,8 +27,14 @@ module Watir
     # @param [Watir::Element] start_node the node where to start searching for the label.
     # @param [String, Boolean, Array] value to be set.
     # @param [Boolean] include_groups whether to detect the group of a given label.
-    def fill_in(label, value, start_node: nil, include_groups: nil)
-      field(label, start_node: start_node, include_groups: include_groups).set(value)
+    # @param [Boolean] placeholder whether to handle label as Watir::Label or as placeholder
+    #                              attribute for an input field.
+    def fill_in(label, value, start_node: nil, include_groups: nil, placeholder: false)
+      field(label,
+            start_node:     start_node,
+            include_groups: include_groups,
+            placeholder:    placeholder
+      ).set(value)
     end
 
 
@@ -41,8 +55,7 @@ module Watir
         return option_group(label.parent) if group_member_count > 1
       end
 
-      field_id = label.for
-      found_field = start_node.element(id: field_id)
+      found_field = start_node.element(id: label.for)
       found_field ? found_field.to_subtype : nil
     end
   end

data/lib/watir_formhandler/element.rb

@@ -1,4 +1,6 @@
 module Watir
+
+  # Extends the Watir::Element class to get public access on the :selector.
   class Element
     attr_reader :selector
   end

data/lib/watir_formhandler/file_field.rb

@@ -1,4 +1,6 @@
 module Watir
+
+  # Extends the Watir::FileField class for #field_value.
   class FileField
     # Returns the file name of this FileField as a string.
     # @return [String] file name.

data/lib/watir_formhandler/radio.rb

@@ -1,5 +1,7 @@
+require 'watir-webdriver/elements/radio'
 module Watir
-  require 'watir-webdriver/elements/radio'
+
+  # Extends the Watir::Radio class to add #set and #field_value methods.
   class Radio
     # Clicks this Radio unless #checked? returns the same value as the given one.
     # @param [Boolean] value to be set.

data/lib/watir_formhandler/select.rb

@@ -1,5 +1,8 @@
+require 'watir-webdriver/elements/select'
 module Watir
-  require 'watir-webdriver/elements/select'
+
+  # Extends the Watir::Select class for the #set and #field_value methods and also adds the means
+  # to select multiple options when possible.
   class Select
     # Selects the given option(s) of this Select. If this Select has the 'multiple' attribute, it
     # accept an array, otherwise it will call the internal '#select' method.

data/lib/watir_formhandler/text_area.rb

@@ -1,4 +1,6 @@
 module Watir
+
+  # Extends the Watir::TextArea class to add #field_value.
   class TextArea
     # Returns the text currently set in this TextField
     # @return [String] the current text in the field. If the field is not set at all, it will return

data/lib/watir_formhandler/text_field.rb

@@ -1,4 +1,6 @@
 module Watir
+
+  # Extends the Watir::TextField to add #field_value.
   class TextField
     # Returns the text currently set in this TextField
     # @return [String] the current text in the field. If the field is not set at all, it will return

data/lib/watir_formhandler/watir.rb

@@ -10,4 +10,13 @@ module Watir
     @tag_to_class = @tag_to_class.dup.merge(tag => tag_class)
     @tag_to_class.freeze
   end
+
+
+  # Adds the placeholder attribute to input fields to allow them to be searched by it. I tried to
+  # call the attribute method on Input and even TextField at first, but HTMLElement was the only one
+  # with which it was successfully added. This should surely be fixed some day.
+  class HTMLElement
+    # TODO: find a way to move this call into TextField and TextArea where it belongs.
+    attribute('String', :placeholder, :placeholder)
+  end
 end

data/spec/container_spec.rb

@@ -118,6 +118,17 @@ module Watir
           end
         end
       end # describe sybtype
+
+
+      describe 'using placeholder: true' do
+        it 'returns Watir::TextField for a text field with a placeholder' do
+          expect(browser.field('Placeholder Text', placeholder: true)).to be_an Watir::TextField
+        end
+
+        it 'returns Watir::TextArea for a text area with a placeholder' do
+          expect(browser.field('Placeholder Area', placeholder: true)).to be_an Watir::TextArea
+        end
+      end
     end # #field
 
 
@@ -236,6 +247,21 @@ module Watir
           expect(option_group.selected_options).to eq(%w(Checkbox5 Radio7))
         end
       end # descibe: with a start node
+
+
+      describe 'with placeholder: true' do
+        it 'fills a Watir::TextField with given text' do
+          target_field = browser.text_field(id: 'placeholder_text')
+          browser.fill_in('Placeholder Text', 'Test Text', placeholder: true)
+          expect(target_field.value).to eq('Test Text')
+        end
+
+        it 'fills a Watir::TextArea with given text' do
+          target_field = browser.textarea(id: 'placeholder_area')
+          browser.fill_in('Placeholder Area', 'Test Text', placeholder: true)
+          expect(target_field.value).to eq('Test Text')
+        end
+      end# with placeholder: true
     end # #fill_in
   end
 

data/spec/html/form.html

@@ -1,4 +1,4 @@
-<html>
+<html xmlns="http://www.w3.org/1999/html">
   <head>
       <title>Example Form</title>
   </head>
@@ -39,7 +39,15 @@
       <br />
 
       <label for="file">File</label>
-      <input type="file" id="file">
+      <input type="file" id="file" />
+      <br />
+      <br />
+
+      <input type="text" id="placeholder_text" placeholder="Placeholder Text" />
+      <br />
+      <br />
+
+      <textarea id="placeholder_area" placeholder="Placeholder Area"></textarea>
       <br />
       <br />
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: watir-formhandler
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Yves Komenda
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-14 00:00:00.000000000 Z
+date: 2014-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir
@@ -30,35 +30,23 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.6.10
+        version: 0.6.11
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.6.10
-- !ruby/object:Gem::Dependency
-  name: selenium-webdriver
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 2.42.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 2.42.0
+        version: 0.6.11
 description: Adds some convenience methods to fill out forms in Watir
 email:
 - b_d_v@web.de
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
+- README.md
 - lib/watir_formhandler.rb
 - lib/watir_formhandler/check_box.rb
 - lib/watir_formhandler/container.rb
@@ -81,7 +69,7 @@ files:
 - spec/text_area_spec.rb
 - spec/text_field_spec.rb
 - spec/watir_spec.rb
-homepage: http://rubygems.org/gems/watir-formhandler
+homepage: http://github.com/Dervol03/watir-formhandler
 licenses:
 - MIT
 metadata: {}
@@ -91,12 +79,12 @@ 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: []