druid-s 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0b09d4fbd7519d447203a1308bb7d3baf9d552f4715156b8fb855c561ed9d544
+  data.tar.gz: 311276d42192ec7967ec33ddd44d7e9dd8babc0e0f922889f700472858a19016
+SHA512:
+  metadata.gz: 5a336ff08053e75934ec6ab743b4322940e1fa92c561bedebf614b4f4ad496e0fe7955600fa252cb68303cf3c6adc391fef4a61b95b334f9502152b00105e4e0
+  data.tar.gz: a8f449fba8a94408275c81f61b9c5d180aeff5fadd063e1bdf192701ed56401ae93316629e58ffecea09fd3138dc60c107817e74385197b87be009155043bb4a

data/.gitignore

@@ -0,0 +1,7 @@
+Gemfile.lock
+coverage
+druid*.gem
+.idea/
+pkg
+*.swp
+.DS_Store

data/.rspec

@@ -0,0 +1 @@
+--color --format doc

data/.rvmrc

@@ -0,0 +1 @@
+rvm 2.3.0

data/.travis.yml

@@ -0,0 +1,27 @@
+sudo: required
+dist: trusty
+rvm:
+  - 2.2.5
+  - 2.2.7
+  - 2.3.4
+  - 2.3.1
+  - 2.4.1
+  - 3.2.2
+cache: bundler
+before_script:
+  - export CHROME_BIN=/usr/bin/google-chrome
+  - "export DISPLAY=:99.0"
+  - "sh -e /etc/init.d/xvfb start"
+  - sudo apt-get update
+  - sudo apt-get install -y libappindicator1 fonts-liberation
+  - wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
+  - sudo dpkg -i google-chrome*.deb
+  - CHROMEDRIVER_VERSION=$(curl -s http://chromedriver.storage.googleapis.com/LATEST_RELEASE)
+  - curl -L -O "http://chromedriver.storage.googleapis.com/${CHROMEDRIVER_VERSION}/chromedriver_linux64.zip"
+  - unzip chromedriver_linux64.zip
+  - chmod +x chromedriver
+  - sudo mv chromedriver /usr/local/bin
+script: bundle exec rake $RAKE_TASK
+env:
+  - RAKE_TASK=spec
+  - RAKE_TASK=features:watir

data/ChangeLog

@@ -0,0 +1,541 @@
+=== Version 1.2.6/ 2019-04-09
+* Enhancements
+  * populate_page_with will work with anything that can be converted to a Hash
+* Fixes
+  * Fixed present? when using with ActiveSupport
+  * Fixed issues with when_visible and when_not_visible
+=== Version 1.2.5/ 2017-10-16
+* Enhancements
+  * Added the ability to get the values of a table column
+  * Added the ability to populate sections with a nested entry from data_magic
+=== 2017-10-15
+* Enhancements
+  * Added the preceding_sibling method to Element
+  * Added the following_sibling method to Element
+  * Added the siblings method to Element
+  * Added the children method to Element
+  * Added the preceding_siblings method to Element
+  * Added the following_siblings method to Element
+* Fixes
+  * Fixed issue that occurred when things were moved around in Watir 6.8
+=== 2017-10-12
+* Enhancements
+  * Fix bug in integration of frames and sections
+  * delegate select list text method directly to watir
+  * optimize the way to generate a array of symbol
+=== Version 1.2.4/ 2017-06-12
+* Add cookies method to druid
+=== Version 1.2.3/ 2017-04-24
+* Removed all direct delegateds. Now relies on method_missing to call Watir methods.
+  * You may have to change RSpec matchers to use method instead of predicate.
+=== Version 1.2.2/ 2017/02-14
+* Enhancements
+  * Added wait method to page class(wait document readystate as complete)
+  * When_visible and when_not_visible now wait for element to be present before checking
+  * Populate_page_with can populate select_list using values
+  * Remove all custom locator mappings
+=== Version 1.2.1/ 2017-01-26
+* Enhancements
+  * Added array methods to section collections
+  * Added ability to call style method with no parameters
+  * clean up frame and iframe nesting
+  * Update travis.yml
+  * Added numerous missing element types
+  * Added two new methods that check without throwing exception
+  * Update to use watir 6 instead of watir-webdriver
+=== 2017-01-25
+* Enhancements
+  * Added list_items method to UnorderedList to get an array of children.
+  * Speed optimizations for UnorderedList
+  * Added list_items method to OrderedList to get an array of children
+  * Speed optimization for OrderedList
+  * Added support for the Italic(i) element
+  * Added size and location methods to all elements
+  * Added width, height, and centre methods for elements
+===Version 1.2.0/ 2017-01-24
+* Enhancements
+  * Added new page_section/ page_sections method to accessor
+  * Added row accessors method and support for finding row elements directly
+  * Default element tag to element
+=== Version 1.1.9/2017-01-22
+* Enhancements
+  * Populate_page_with now supports radio groups
+  * Added new page_url_value mehod that is created when you define page_url to return the value
+  * Checking the name of accessors to ensure it does not conflict with an existing druid method name
+  * Added support for dynamically finding elements inside iframes
+  * Reverted the method name check due to unintended consequences
+  * Added support to use multiple identifiers when locating nested frames / iframes
+  * Remove methods for clearing radio buttons
+  * Add support bold tag
+  * Fixed wait_for_expected_title so it detects if the title changes
+=== 2017-01-20
+* Enhancements
+  * Super called when factory method invoked with non Druid class
+  * populate_page_with
+=== 2017-01-19
+* Enhancements
+  * Added elements method to accessor so one can generate methods for generic collections of elements
+  * Added class_name method to Element
+  * Added wait_for_expected_title and expected_element_visible methods
+  * Added select_text method to Element
+  * Added ability for execute_scripts to accept arguments
+  * Added ability to identify frame using a regular expression when using Watir
+  * Added href method to Link
+  * Added generation of plural version of basic types on class
+  * added accessor to support radio_button_group method
+  * Updated in_iframe methods to match the updates to the watir-webdriver gem
+=== Version 1.1.8/2017-01-18
+* Enhancements
+  * Added ability to find elements using any valid attribute
+  * Updated populate_page_with to also check if the element is visible prior to setting value
+  * Added plural _elements methods for the following types:
+    * area
+    * canvas
+    * audio
+    * video
+    * svg
+  * Added basic element support for the following types:
+    * as
+    * blockquote
+    * body
+    * br
+    * caption
+    * col
+    * colgroup
+    * command
+    * data
+    * datalist
+    * del
+    * details
+    * dialog
+    * dl
+    * embed
+    * fieldset
+    * head
+    * hr
+    * ins
+    * keygen
+    * legend
+    * map
+    * menu
+    * meta
+    * meter
+    * object
+    * optgroup
+    * output
+    * param
+    * pre
+    * progress
+    * small
+    * strong
+    * style
+    * time
+    * title
+    * track
+* Fixes
+  * Fixed issue when using the page and element accessors for html 5 elements
+=== 2017-01-17
+* Enhancements
+  * Added :using_params parameter to both on_page and if_page methods
+  * Fixed issue with generic element calls
+  * Added support for the svg element
+  * Support label locators on TextArea, SelectList, RadioButton and FileField
+=== Version-1.1.7/2017-01-16
+* Enhancements
+  * Updated expected_element to use the global default element wait by default
+  * Added scroll_into_view method to Element
+  * Updated routes to accept more than two entries in the array which are passed as arguments
+  * Added *_element and *_elements methods to Druid and Element for the following types
+    * addr
+    * address
+    * article
+    * aside
+    * bdi
+    * bdo
+    * cite
+    * code
+    * dd
+    * dfn
+    * dt
+    * em
+    * figcaption
+    * figure
+    * footer
+    * header
+    * hgroup
+    * kbd
+    * mark
+    * nav
+    * noscript
+    * rp
+    * rt
+    * ruby
+    * samp
+    * section
+    * sub
+    * summary
+    * sup
+    * var
+    * wbr
+=== 2017-01-15
+* Fixes
+  * Fixed issue when calling new multi-element class methods using a block
+=== Version 1.1.6/2017-01-13
+* Enhancement
+  * Added callback to initialize_accessors method during initialization
+  * Added html method to Element
+  * Added generated method to return text for a table
+  * Added generated method to return text for an unordered list
+  * Added generated method to return text for an ordered list
+  * Added the following class level methods to return all elements matching the locator
+    * divs
+    * buttons
+    * text_fields
+    * hidden_fields
+    * text_areas
+    * select_lists
+    * links
+    * checkboxes
+    * radio_buttons
+    * spans
+    * tables
+    * cells
+    * images
+    * forms
+    * list_items
+    * unordered_lists
+    * ordered_lists
+    * h1s
+    * h2s
+    * h3s
+    * h4s
+    * h5s
+    * h6s
+    * paragraphs
+    * labels
+    * file_fields
+=== 2017-01-09
+* Enhancement
+  * Added params class instance variable to hold hash values that can be used in the page
+  * Added ability to insert ERB into page_url string and have it access params
+* Fixes
+  * Fixed issue when passing symbol to page_url and calling multiple times
+=== 2017-01-03
+* Enhancement
+  * Added selected_values method to SelectList to get values of all selected elements
+  * Added ability to pass classname as string to visit_page, on_page, and if_page methods
+=== Version v1.1.5/ 2016-12-31
+* Enhancement
+  * Added method to get the id of an Element
+=== 2016-12-30
+* Enhancement
+  * Added hover method to Element. Browser support is limited
+=== 2016-12-28
+* Enhancement
+  * Updated Table [] method to return a row that has matching partial text in any column
+  * Updated TableRow [] method to return column that matching partial text in any column
+  * Added the following aliased methods to their corresponding Accessors method
+    a => link
+    hidden => hidden_field
+    img => image
+    li => list_item
+    ol => ordered_list
+    p => paragraph
+    radio => radio_button
+    select => select_list
+    td => cell
+    textarea => text_area
+    ul => unordered_list
+  * Added support for the following new elements
+    Area
+    Canvas
+    Audio
+    Video
+  * Added ability to find list_item by :text
+===Version v1.1.4/ 2016-12-27
+* Enhancement
+  * Added ability to find span's by title
+  * Changed order of initialization so initialize_page is called after goto
+  * Added flash method to Element to temporarily change the background color
+  * Added when_not_present method to Element
+  * Added default override of page level waits - Druid.default_page_wait
+  * Added default override of element level waits - Druid.default_element_wait
+  * Added the ability to find a TableRow by providing a String to the [] method
+  * Added the ability to find a TableCell by providing a String to the [] method from TableRow
+  * Updated link to be able to identify by title
+  * Updated div to be able to identify by title
+  * Added ability to find text_field by :text and :label
+  * Added select_value method to SelectList
+* Fixes
+  * Modified text area methods so it clears before setting new text
+  * Updated [] method on Table to return nil when bad row header is provided
+  * Updated [] method on TableRow to return nil when bad column header is provided
+  * Fixed populate_page_with to work with text areas
+=== 2016-12-26
+* Enhancement
+  * Changed page_url to accept a symbol that will cause it to call a corresponding method
+  * Updated all accessor methods to take a default identifier of {:index => 0}
+  * Added a page level element method to return a generic Element object
+  * Updated all page level element locators to take a default identifier of {:index => 0}
+  * Added a method to retrieve all file fields on a page
+=== 2016-12-23
+* Enhancement
+  * Added #execute_script method to Druid
+  * Added support for finding the following using :css
+      Button
+      Link
+  * Added method to fetch generic element
+  * Support alias method 'on' for 'on_page', 'visit' for 'visit_page' on PageFactory
+  * Changed Elements.element_class_for so parameters can be strings or symbols
+  * Added element_with_focus method to return the element that has focus
+  * Added support for the label element
+=== 2016-12-20
+* Fixes
+  WARNING: This change breaks existing code
+  * Changed the generated getter for select_list to return the text instead of the value
+* Enhancements
+  * Added #expected_title method to Druid
+  * Added #expected_element method to Druid
+=== Version 1.1.2 /2016-12-19
+* Enhancements
+  * Added #include? and #selected? to SelectList
+  * Added #append to TextField
+  * Added #wait_for_ajax support for the jQuery framework
+  * Added #wait_for_ajax support for the Prototype framework
+  * Added the ability to add new Javascript Frameworks to Druid via the #add_framework method
+* Fixes
+  * Fixed [] methods on OrderedList and UnOrderedList so it only gets direct children
+  * Fixed items methods on OrderedList and UnOrderedList so it returns count of direct children
+=== 2016-12-14
+* Enhancements
+  * Added shortcut method to check element exists
+  * Added #disabled? method to Element
+  * Added #selected_options method to SelectList
+=== Version 1.1.1 / 2016-12-13
+* Enhancements
+  * Added ?_elements to ElementLocators so you can find all elements that match an identifier
+  * Added ?_elements to NestedElements so you can find all elements nested within others
+
+=== 2016-11-15
+* Enhancements
+  * Added #navigate_to method to PageFactory to navigate to a page through previous pages
+  * Added routes to PageFactory to collect routes through the site
+  * Added #continue_navigation_to method to PageFactory which begins at @current_page
+******1.1.0******
+=== 2016-11-14
+* Enhancements
+  * Added ability to find a parent of an Element
+  * Added #focus method to Element
+=== 2016-08-05
+* Enhancements
+  * Added ability to find Checkbox by :value
+  * Added ability to find HiddenField by :value
+  * Added #fire_event method to Element
+* Fixes
+  * Updated #populate_page_with to no longer attempt to set a value in a field that is disabled
+=== 2016-08-04
+* Enhancements
+  * Added ability to find TextField by :title
+  * Added ability to find Image by :alt
+  * Added ability to find Form by :action
+  * Added ability to find Image by :src
+=== 2016-08-03
+* Enhancements
+  * Added ability to find image buttons by src
+  * Added ability to find image buttons by alt
+  * Added first_row and last_row methods to table
+  * Added new module PagePopulator with single method populate_page_with
+  * Added deprecation warning to the method_missing method on Element.
+  * Added all of the file_field locators
+  * Added full support for file_field element
+=== 2016-08-02
+* Enhancements
+  * Added all of the h5 locators
+  * Added all of the h6 locators
+  * Added all of the paragraph locators
+  * Added the Paragraph class
+  * Added #current_url to Druid
+  * Added #style to Element
+  * Added #inspect to Element
+  * Added #clear_cookies to Druid
+  * Added #save_screenshot to Druid
+  * Changed PageFactory so it also sets and instance variable @current_page to the newly created page
+  * now can find radio buttons by value
+  * Added instance level in_frame, in_iframe method
+  * Support for nesting all *_element instance methods inside in_frame call
+  * Support for nesting alerts inside an in_frame call
+  * Support for nesting confirms inside an in_frame call
+  * Support for nesting prompts inside an in_frame call
+=== 2016-08-01
+* Enhancements
+  * Added #clear method for TextArea
+  * Element#when_present now returns the element object
+  * Element#when_visible now returns the element object
+  * Element#when_not_visible now returns the element object
+  * Added all of the h2 locators
+  * Added all of the h3 locators
+  * Added all of the h4 locators
+=== 2016-07-31
+* Enhancements
+  * Added support for Heading element
+  * Added all of the h1 locators
+=== 2016-07-29
+* Enhancements
+  * Support for locating the following elements when nested
+    * Link
+    * Button
+    * TextField
+    * HiddenField
+    * TextArea
+    * SelectList
+    * CheckBox
+    * RadioButton
+    * Div
+    * Span
+    * Table
+    * TableCell
+    * Image
+    * Form
+    * OrderedList
+    * UnOrderedList
+    * ListItem
+  * Added #modal_dialog to Druid to override the default modal dialog behavior
+=== 2016-07-11
+* Enhancements
+  * Added the following instance methods to Druid via ElementLocators
+  * #button_element
+  * #text_field_element
+  * #hidden_field_element
+  * #text_area_element
+  * #select_list_element
+  * #link_element
+  * #checkbox_element
+  * #radio_button_element
+  * #div_element
+  * #span_element
+  * #table_element
+  * #cell_element
+  * #image_element
+  * #form_element
+  * #list_item_element
+  * #unordered_list_element
+  * #ordered_list_element
+=== 2016-07-05
+* Enhancements
+  * Added #value= to TextField and TextArea
+  * Added #select to SelectList
+  * Added #check, #uncheck, and #checked? to CheckBox
+  * Added #select, #clear, and #selected? to RadioButton
+=== 2016-07-04
+* Enhancements
+  * Can now find span by :text
+  * Can now find button by :value
+  * Added #forward and #back methods to druid object
+  * Added #right_click and #double_click methods to Element
+=== 2016-07-03
+* Enhancements
+  * Will call callback method #initialize_page method if it exists on a page object
+  * Renamed all *_<element_type> methods to *_element. Created alias for backward compatibility
+  * Delegating unknown method calls on Element to the driver element object
+
+=== 2016-06-30
+* Enhancements
+  * Can now find a TableCell by its' text
+  * If we receive an error calling #attach_to_window, wait one second and try again
+=== 2016-06-29
+* Enhancements
+  * Added ability to locate div by the contained text
+  * Added #attach_to_window so a page object can operate on another window
+  * Added #send_keys to Druid::Elements::Element
+  * Added #refresh to page object
+  * Added #clear method to Element
+  * Added #in_frame to Accessors to handle frame and iframe access
+=== 2016-06-21
+* Enhancements
+  * Handling popups
+    * Added #alert to page object to override default alert popup behavior
+    * Added #confirm to page object to override default confirm popup behavior
+    * Added #prompt to page object to override default prompt popup behavior
+=== 2016-06-20
+* Enhancements
+  * Async handling
+    * Added #wait_until to page object to support for async events at page level
+    * Added the following methods to Druid::Elements::Element
+      * #when_present
+      * #when_visible
+      * #when_not_visible
+      * #wait_until
+=== Version 1.0.0
+=== 2016-06-04
+* Enhancements
+  * Support for using multiple identifiers when locating the following element:
+    * Link
+    * TextField
+    * HiddenField
+    * TextArea
+    * SelectList
+    * CheckBox
+    * RadioButton
+    * Button
+    * Div
+    * Span
+    * Table
+    * TableCell
+    * Image
+    * Form
+    * ListItem
+    * UnorderedList
+    * OrderedList
+
+  * Support name for identification across all elements in Watir
+  * Added [] method to SelectList to index Options
+  * Added options method to Select
+
+=== 2016-06-2
+* Enhancements
+  * Added rows method to Table to return number of rows
+  * Added [] method to Table to index table row element
+  * Added columns method to TableRow to return the number of columns
+  * Added [] method to TableRow to index table cell element
+  * Added each method to Table to iterate over the TableRows
+  * Added each method to TableRow to iterate over TableCells
+  * Added items method to UnorderedList to return number of ListItems
+  * Added items method to OrderedList to return number of ListItems
+  * Added each method to UnorderedList to iterate over the ListItems
+  * Added each method to OrderedList to iterate over the ListItems
+  * Created PageFactory module to add factory methods to your step definitions
+
+
+=== 2016-05-31
+* Enhancements
+  * Added support for the following elements
+    * hidden field
+    * form
+    * list item
+    * unordered list
+    * ordered list
+    * text area
+
+=== 2016-05-30
+* Enhancements
+  * Added support for the following elements
+    * div
+    * button
+    * table
+    * table row
+    * table cell
+    * span
+    * image
+
+=== 2016-05-22
+* Enhancements
+  * Support for the following elements
+    * check box
+    * link
+    * radio button
+    * select list
+    * text field
+  * Support for the following page level functions
+    * text
+    * html
+    * title

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# adding rake so travis-ci will build properly
+gem 'rake'
+gem 'rb-fsevent', :require => false if RUBY_PLATFORM =~ /darwin/i
+gem 'listen', '~> 3.8'
+
+gemspec

data/README.md

@@ -0,0 +1,78 @@
+# druid
+[![Build Status](https://travis-ci.org/timsheng/druid.png)](https://travis-ci.org/timsheng)
+
+
+A simple gem that assists in creating flexible page objects for testing browser based applications. The goal is to facilitate creating abstraction layers in your tests to decouple the tests from the item they are testing and to provide a simple interface to the elements on a page.  It works with watir
+
+### Defining your page object
+
+You define a new druid by including the Druid module:
+
+````ruby
+class LoginPage
+  include Druid
+end
+````
+
+When you include this module numerous methods are added to your class that allow you to easily define your page.  For the login page you might add the following:
+
+````ruby
+class LoginPage
+  include Druid
+
+  text_field(:username, :id => 'username')
+  text_field(:password, :id => 'password')
+  button(:login, :id => 'login')
+end
+````
+
+Calling the _text_field_ and _button_ methods adds several methods to our druid that allow us to interact with the items on the page.  To login using this page we could simply write the following code:
+
+````ruby
+login_page.username = 'cheezy'
+login_page.password = 'secret'
+login_page.login
+````
+
+Another approach might be to create higher level methods on our druid that hide the implementation details even further.  Our druid might look like this:
+
+````ruby
+class LoginPage
+  include Druid
+
+  text_field(:username, :id => 'username')
+  text_field(:password, :id => 'password')
+  button(:login, :id => 'login')
+
+  def login_with(username, password)
+    self.username = username
+    self.password = password
+    login
+  end
+end
+````
+and your usage of the page would become:
+
+````ruby
+login_page.login_with 'cheezy', 'secret'
+````
+
+### Creating your druid
+druid supports [watir](https://github.com/watir/watir)
+The page object can be create like this:
+
+````ruby
+browser = Watir::Browser.new :firefox
+my_druid = MyDruid.new(browser)
+````
+
+
+
+## Contribute
+
+* Fork the project.
+* Test drive your feature addition or bug fix. Adding specs is important and I will not accept a pull request that does not have tests
+* Make sure you describe your new feature with a cucumber feature.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.