druid-ts 0.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 181b245e5051d6a93aeb37fb0bcc085df08af882
-  data.tar.gz: 811f5667bce43ddbd185e0b981dc8910c25b0491
+  metadata.gz: 1081889b9173a02ac8c5786c09771d230af18226
+  data.tar.gz: da6be1406dcb433fde5f47d4a699abb5c80bf9d7
 SHA512:
-  metadata.gz: 41377cfa4542f102a921be37370dcc350d0b76c97e5764437e7d4eab1ff486392271e181f188b2d2f85c040f86f47e6116d4123e0c7c7fc19585315a08d31b2b
-  data.tar.gz: d03f1173add3fdc7ac149e299405c960e9ae752d383aaa6b28e6d7f697498d57da5ef94b90df038cddab8264ce50b0ad948ad1567a144ad61ba07afdce75b946
+  metadata.gz: ebb267bdf529e1b094d287883bb3422ff5d41ab0377a6b3e4f6421a0205a0a7dadf74f7a7ee6bdff335ccdccdd21e85cd31da43b3e481e9684c1225c0ac794fd
+  data.tar.gz: 79e0be33f4dfe5f136731d6b7c388e1dc3f69aa9c2680b8bbc3766518506e2d88b8b25167d703ae71e950817ba5181fd6d652d42e32358f3e8c295f0a4201487

data/.gitignore

@@ -1,2 +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

@@ -4,5 +4,4 @@ rvm:
 before_script:
   - "export DISPLAY=:99.0"
   - "sh -e /etc/init.d/xvfb start"
-script: rake features:watir
-
+script: rake features:watir_webdriver

data/ChangeLog

@@ -0,0 +1,218 @@
+******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

@@ -2,6 +2,7 @@ source "http://rubygems.org"
 
 gem 'simplecov', :require => false, :group => :test
 gem 'rake'
-gem 'watir-webdriver'
+gem 'watir-webdriver', '0.9.3'
+gem 'selenium-webdriver', '2.53.4'
 gem 'rspec'
 gem 'cucumber'

data/README.md

@@ -1,11 +1,68 @@
 # druid
+[![Build Status](https://travis-ci.org/timsheng/druid.png)](https://travis-ci.org/timsheng)
 
- A simple gem that assists testers in creating flexible page objects for testing browser based applications
 
-# Note on Patches/Pull Requests
+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-webdriver
 
-Fork the project
-Test drive your feature addition or bug fix. Adding specs is importing so I don't break it in a future version unintentionally.
-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.
+### Defining your page object
+
+You define a new druid by including the Druid module:
+
+    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:
+
+    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:
+
+    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:
+
+    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:
+
+    login_page.login_with 'cheezy', 'secret'
+
+### Creating your druid
+druid supports [watir-webdriver](https://github.com/jarib/watir-webdriver)
+The page object can be create like this:
+
+    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.

data/Rakefile

@@ -27,7 +27,7 @@ task :default => :spec
 
 
 namespace :features do
-  Cucumber::Rake::Task.new(:watir, "Run features with Watir") do |t|
+  Cucumber::Rake::Task.new(:watir_webdriver, "Run features with Watir webdriver") do |t|
     t.profile = "watir"
   end
 end

data/druid.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "druid/version"
+
+Gem::Specification.new do |s|
+  s.name = "druid-ts"
+  s.platform = Gem::Platform::RUBY
+  s.version = Druid::VERSION
+  s.date = '2016-06-07'
+  s.authors = ["Tim Sheng"]
+  s.email = ["278570038@qq.com"]
+  s.homepage = "http://github.com/timsheng/druid"
+  s.summary = %q{Druid DSL for browser testing}
+  s.description = %q{Druid DSL that works with Watir}
+  s.license = 'MIT'
+  s.rubyforge_project = "druid"
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f)}
+  s.require_paths = ["lib"]
+
+  s.add_dependency "watir-webdriver", "0.9", ">= 0.9.1"
+  s.add_development_dependency "rspec", ">= 3.4.0"
+  s.add_development_dependency "cucumber", ">= 1.3.20"
+end

data/features/async.feature

@@ -0,0 +1,18 @@
+Feature: Handling Asynch calls
+
+  Scenario: Link element methods
+    Given I am on the static elements page
+    When I retrieve a link element
+    Then I should be able to wait until it is present
+    And I should be able to wait until it is visible
+    And I should be able to wait until it is not visible
+    And I should be able to wait until a block returns true
+
+  Scenario: Click a button when it is visible
+    Given I am on the async elements page
+    When I make the button invisible
+    Then I should be able to click it when it becomes visible
+
+  Scenario: Wait until something is not visible
+    Given I am on the async elements page
+    Then I should be able to wait until the button becomes invisible

data/features/button.feature

@@ -5,10 +5,23 @@ Feature: Button
   Background:
     Given I am on the static elements page
 
-  Scenario: Selecting a button
+  Scenario: Clicking a button (type=submit)
     When I click the button
     Then I should be on the success page
 
+  Scenario: Clicking a button (type=image)
+    When I click the button with type image
+    Then I should be on the success page
+
+  Scenario: Clicking an image button by src
+    When I click the image button using src
+    Then I should be on the success page
+
+  Scenario: Clicking an image button by alt
+    When I click the image button using alt
+    Then I should be on the success page
+
+  @name
   Scenario Outline: Locating buttons on the page
     When I locate the button by "<locate_by>"
     Then I should be able to click the button
@@ -21,6 +34,19 @@ Feature: Button
     | xpath     |
     | index     |
     | text      |
+    | value     |
+
+  Scenario Outline: Locating real buttons on the page
+    When I locate the button by "<locate_by>"
+    Then I should be able to click the real button
+
+    Examples:
+    | locate_by |
+    | id        |
+    | class     |
+    | name      |
+    | index     |
+    | value     |
 
   Scenario: Retrieve a button element
     When I retrieve a button element
@@ -36,3 +62,18 @@ Feature: Button
     | param1  | param2  |
     | class   | index   |
     | name    | index   |
+
+  @multi
+  Scenario Outline: Locating real button using multiple parameters
+    When I search for the button by "<param1>" and "<param2>"
+    Then I should be able to click the real button
+
+    Examples:
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |
+
+  @locator
+  Scenario: Finding a button dynamically
+    When I find a button while the script is executing
+    Then I should be able to click the button element