fluent 0.1.0 → 0.2.0

data/spec/mock_app.rb

@@ -1,14 +1,31 @@
 require 'watir-webdriver'
+require 'selenium-webdriver'
 
 def mock_browser_for_watir
   watir_browser = double('watir')
   watir_browser.stub(:is_a?).with(Watir::Browser).and_return(true)
+  watir_browser.stub(:is_a?).with(Selenium::WebDriver::Driver).and_return(false)
   watir_browser
 end
 
+def mock_browser_for_selenium
+  selenium_browser = double('selenium')
+  selenium_browser.stub(:is_a?).with(Watir::Browser).and_return(false)
+  selenium_browser.stub(:is_a?).with(Selenium::WebDriver::Driver).and_return(true)
+  selenium_browser
+end
+
 class TestDefinition
   include Fluent
 
   url_is 'http://localhost:4567'
   title_is 'Test App'
+  
+  look_for :name
+  
+  text_field :name, id: 'name'
+  
+  within_frame(id: 'frame') do |frame|
+    text_field :framedName, id: 'framedName', frame: frame
+  end
 end

data/spec/platform_object_spec.rb

@@ -6,7 +6,10 @@ end
 
 describe Fluent do
   let(:watir_browser)    { mock_browser_for_watir }
+  let(:selenium_browser) { mock_browser_for_selenium }
+  
   let(:watir_definition) { PageDefinition.new(watir_browser) }
+  let(:selenium_definition) { PageDefinition.new(selenium_browser) }
 
   context 'a definition using watir-webdriver' do
     it 'should return a watir platform object' do
@@ -14,6 +17,12 @@ describe Fluent do
     end
   end
 
+  context 'a definition using selenium-webdriver' do
+    it 'should return a selenium platform object' do
+      selenium_definition.platform.should be_kind_of Fluent::Platforms::SeleniumWebDriver::PlatformObject
+    end
+  end
+  
   context 'a definition using an unrecognized driver' do
     it 'should raise an exception' do
       msg = 'Unable to create a platform object for unknown_browser.'

data/spec/web_element_spec.rb

@@ -4,6 +4,11 @@ describe 'Web Elements' do
   let(:watir_browser)    { mock_browser_for_watir }
   let(:watir_definition) { ::Fluent::WebElements::WebElement.new(watir_browser, :platform => :watir_webdriver) }
 
+  it 'should return the text contained by a web element' do
+    watir_browser.should_receive(:text).and_return('testing')
+    watir_definition.text.should == 'testing'
+  end
+  
   it 'should perform a click event on a web element' do
     watir_browser.should_receive(:click)
     watir_definition.click
@@ -20,4 +25,14 @@ describe 'Web Elements' do
     watir_definition.disabled?.should == true
     watir_definition.should be_disabled
   end
+
+  it 'should retrieve the style of a web element' do
+    watir_browser.should_receive(:style).with('display').and_return('none')
+    watir_definition.style('display').should == 'none'
+  end
+
+  it 'should retrieve the class name of a web element' do
+    watir_browser.should_receive(:attribute_value).and_return('class')
+    watir_definition.class_name
+  end
 end

data/spec/web_element_watir_spec.rb

@@ -4,11 +4,6 @@ describe 'Web Elements for Watir' do
   let(:watir_browser)    { mock_browser_for_watir }
   let(:watir_definition) { ::Fluent::WebElements::WebElement.new(watir_browser, :platform => :watir_webdriver) }
 
-  it 'should return the text contained by a web element' do
-    watir_browser.should_receive(:text).and_return('testing')
-    watir_definition.text.should == 'testing'
-  end
-
   it 'should determine if a web element exists' do
     watir_browser.should_receive(:exists?).and_return(true)
     watir_definition.exists?.should == true
@@ -29,4 +24,127 @@ describe 'Web Elements for Watir' do
     watir_browser.should_receive(:present?).and_return(false)
     watir_definition.visible?.should == false
   end
+
+  it 'should simulate a double-click event on a web element' do
+    watir_browser.should_receive(:double_click)
+    watir_definition.double_click
+  end
+
+  it 'should allow a clear event on a web element' do
+    watir_browser.should_receive(:clear)
+    watir_definition.clear
+  end
+  
+  it 'should be able to flash a web element' do
+    watir_browser.should_receive(:flash).exactly(5).times.and_return(watir_definition)
+    watir_browser.should_receive(:exists?).and_return(watir_definition)
+    watir_definition.flash.should be_instance_of Fluent::WebElements::WebElement
+  end
+
+  it 'should be able to flash a web element a specified number of times' do
+    watir_browser.should_receive(:flash).exactly(1).times.and_return(watir_definition)
+    watir_browser.should_receive(:exists?).and_return(watir_definition)
+    watir_definition.flash(1).should be_instance_of Fluent::WebElements::WebElement
+  end
+
+  it 'should retrieve the tag of a web element' do
+    watir_browser.should_receive(:tag_name).and_return('div')
+    watir_definition.tag_name.should == 'div'
+  end
+
+  it 'should retrieve the html of a web element' do
+    watir_browser.should_receive(:html).and_return('<p>Testing</p>')
+    watir_definition.html.should == '<p>Testing</p>'
+  end
+  
+  it 'should retrieve the value of an attribute' do
+    watir_browser.should_receive(:attribute_value).and_return(true)
+    watir_definition.attribute('readonly').should be_true
+  end
+
+  it 'should be able to fire an event on a web element' do
+    watir_browser.should_receive(:fire_event).and_return('onclick')
+    watir_definition.fire_event('onclick')
+  end
+
+  it 'should retrieve the value of a web element' do
+    watir_browser.should_receive(:value).and_return("value")
+    watir_definition.value.should == 'value'
+  end
+
+  it 'should retrieve the id of a web element' do
+    watir_browser.should_receive(:id).and_return('id')
+    watir_definition.id.should == 'id'
+  end
+
+  it 'should send key presses to a web element' do
+    watir_browser.should_receive(:send_keys).with([:control, 'a'])
+    watir_definition.send_keys([:control, 'a'])
+  end
+
+  it 'should scroll elements into view' do
+    watir_browser.should_receive(:wd).and_return(watir_browser)
+    watir_browser.should_receive(:location_once_scrolled_into_view)
+    watir_definition.scroll_into_view
+  end
+
+  it 'should be able to focus on a web element' do
+    watir_browser.should_receive(:focus).and_return(watir_definition)
+    watir_definition.focus
+  end
+
+  it 'should be able to hover over a web element' do
+    watir_browser.should_receive(:hover).and_return(watir_definition)
+    watir_definition.hover
+  end
+
+  it 'should wait for a web element to be present' do
+    watir_browser.should_receive(:wait_until_present).twice.with(5)
+    watir_definition.when_actionable(5)
+    watir_definition.when_present(5)
+  end
+
+  it 'should use the provided element wait time for presence checks' do
+    Fluent.element_level_wait = 30
+    watir_browser.should_receive(:wait_until_present).with(30)
+    watir_definition.when_present
+  end
+
+  it 'should reference a web element when it is present' do
+    watir_browser.should_receive(:wait_until_present).with(5)
+    web_element = watir_definition.when_actionable(5)
+    web_element.should === watir_definition
+  end
+
+  it 'should wait for a web element to become non-present' do
+    watir_browser.should_receive(:wait_while_present).and_return(false)
+    watir_definition.when_not_present(5)
+  end
+
+  it 'should wait for a web element to become visible' do
+    watir_browser.should_receive(:present?).and_return(true)
+    watir_definition.when_visible(5)
+  end
+
+  it 'should reference a web element when it is visible' do
+    watir_browser.should_receive(:present?).and_return(true)
+    web_element = watir_definition.when_visible(5)
+    web_element.should === watir_definition
+  end
+
+  it 'should wait for a web element to become invisible' do
+    watir_browser.should_receive(:present?).and_return(false)
+    watir_definition.when_not_visible(5)
+  end
+
+  it 'should reference a web element when it is not visible' do
+    watir_browser.stub(:present?).and_return(false)
+    web_element = watir_definition.when_not_visible(5)
+    web_element.should === watir_definition
+  end
+
+  it 'should wait until a specific condition occurs' do
+    Object::Watir::Wait.stub(:until).with(5, 'Condition occurred.')
+    watir_definition.wait_until(5, 'Condition occurred.') { true }
+  end
 end

data/spec/web_elements/checkbox_spec.rb

@@ -0,0 +1,21 @@
+require_relative '../spec_helper'
+
+describe 'WebElements::CheckBox' do
+  let(:checkbox_object) { double('checkbox_object') }
+  let(:checkbox_definition) { ::Fluent::WebElements::CheckBox.new(checkbox_object, :platform => :watir_webdriver) }
+
+  it 'should be able to determine if the checkbox element is checked' do
+    checkbox_object.should_receive(:set?).and_return(true)
+    checkbox_definition.checked?
+  end
+
+  it 'should be able to check the checkbox' do
+    checkbox_object.should_receive(:set)
+    checkbox_definition.check
+  end
+
+  it 'should be able to uncheck the checkbox' do
+    checkbox_object.should_receive(:clear)
+    checkbox_definition.uncheck
+  end
+end

data/spec/web_elements/radio_spec.rb

@@ -0,0 +1,21 @@
+require_relative '../spec_helper'
+
+describe 'WebElements::Radio' do
+  let(:radio_object) { double('radio_object') }
+  let(:radio_definition) { ::Fluent::WebElements::Radio.new(radio_object, :platform => :watir_webdriver) }
+
+  it 'should be able to see if a radio is selected' do
+    radio_object.should_receive(:set?).and_return(true)
+    radio_definition.selected?
+  end
+
+  it 'should be able to select a radio' do
+    radio_object.should_receive(:set).and_return(true)
+    radio_definition.select
+  end
+
+  it 'should be able to clear a radio' do
+    radio_object.should_receive(:clear).and_return(true)
+    radio_definition.clear
+  end
+end

data/spec/web_elements/select_list_spec.rb

@@ -0,0 +1,41 @@
+require_relative '../spec_helper'
+
+describe 'WebElements::SelectList' do
+  let(:select_list_object) { double('select_list_object') }
+  let(:select_list_definition) { ::Fluent::WebElements::SelectList.new(select_list_object, :platform => :watir_webdriver) }
+  let(:select_list_options) { [select_list_object, select_list_object] }
+  
+  # select_list_actual == select_list_definition
+  
+  it 'should determine if an option is selected' do
+    select_list_object.stub(:selected?).with('testing').and_return(true)
+    select_list_definition.selected?('testing')
+  end
+
+  it 'should be able to select an item by option' do
+    select_list_object.should_receive(:select).and_return(true)
+    select_list_definition.select('testing')
+  end
+
+  it 'should be able to select an item by value' do
+    select_list_object.should_receive(:select_value).and_return(true)
+    select_list_definition.select_value('testing')
+  end
+
+  it 'should return an array of selected options' do
+    select_list_object.stub(:selected_options).and_return(select_list_options)
+    select_list_object.stub(:text).and_return(select_list_object)
+    select_list_definition.selected_options.should == select_list_options
+  end
+
+  it 'should get the values for any selected options' do
+    select_list_object.stub(:selected_options).and_return(select_list_options)
+    select_list_object.stub(:value).and_return(select_list_object)
+    select_list_definition.selected_values.should == select_list_options
+  end
+
+  it 'should determine if an option is available in the list' do
+    select_list_object.stub(:include?).with('testing').and_return(true)
+    select_list_definition.include?('testing')
+  end
+end

data/spec/web_elements/text_field_spec.rb

@@ -0,0 +1,16 @@
+require_relative '../spec_helper'
+
+describe 'WebElements::TextField' do
+  let(:text_field_object) { double('text_field_object') }
+  let(:text_field_definition) { ::Fluent::WebElements::TextField.new(text_field_object, :platform => :watir_webdriver) }
+  
+  it 'should append text to a text field' do
+    text_field_object.should_receive(:send_keys).with('testing')
+    text_field_definition.append 'testing'
+  end
+
+  it 'should set the value of a text field' do
+    text_field_object.should_receive(:set).with('testing')
+    text_field_definition.value = 'testing'
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fluent
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jeff Nyman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-18 00:00:00.000000000 Z
+date: 2013-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -110,38 +110,69 @@ files:
 - Rakefile
 - fluent.gemspec
 - lib/fluent.rb
+- lib/fluent/enclosers.rb
 - lib/fluent/errors.rb
+- lib/fluent/evaluators.rb
+- lib/fluent/factory.rb
 - lib/fluent/generators.rb
 - lib/fluent/logger.rb
+- lib/fluent/platform_selenium.rb
+- lib/fluent/platform_selenium/platform_object.rb
 - lib/fluent/platform_watir.rb
 - lib/fluent/platform_watir/platform_object.rb
+- lib/fluent/platform_watir/platform_web_elements/checkbox.rb
+- lib/fluent/platform_watir/platform_web_elements/radio.rb
 - lib/fluent/platform_watir/platform_web_elements/select_list.rb
+- lib/fluent/platform_watir/platform_web_elements/text_field.rb
 - lib/fluent/platform_watir/platform_web_elements/web_element.rb
 - lib/fluent/platforms.rb
 - lib/fluent/version.rb
 - lib/fluent/web_elements/button.rb
+- lib/fluent/web_elements/cell.rb
 - lib/fluent/web_elements/checkbox.rb
+- lib/fluent/web_elements/div.rb
 - lib/fluent/web_elements/link.rb
+- lib/fluent/web_elements/list_item.rb
 - lib/fluent/web_elements/option.rb
+- lib/fluent/web_elements/ordered_list.rb
 - lib/fluent/web_elements/paragraph.rb
 - lib/fluent/web_elements/radio.rb
 - lib/fluent/web_elements/select_list.rb
+- lib/fluent/web_elements/span.rb
+- lib/fluent/web_elements/table.rb
+- lib/fluent/web_elements/text_area.rb
 - lib/fluent/web_elements/text_field.rb
+- lib/fluent/web_elements/unordered_list.rb
 - lib/fluent/web_elements/web_element.rb
+- spec/enclosers_spec.rb
+- spec/evaluators_spec.rb
+- spec/factory_spec.rb
 - spec/fluent_spec.rb
 - spec/generators/button_generators_spec.rb
+- spec/generators/cell_generators_spec.rb
 - spec/generators/checkbox_generators_spec.rb
+- spec/generators/div_generators_spec.rb
 - spec/generators/link_generators_spec.rb
+- spec/generators/list_item_generators_spec.rb
+- spec/generators/ordered_list_generators_spec.rb
 - spec/generators/paragraph_generators_spec.rb
 - spec/generators/radio_generators_spec.rb
 - spec/generators/select_list_generators_spec.rb
+- spec/generators/span_generators_spec.rb
+- spec/generators/table_generators_spec.rb
+- spec/generators/text_area_generators_spec.rb
 - spec/generators/text_field_generators_spec.rb
+- spec/generators/unordered_list_generators_spec.rb
 - spec/generators_spec.rb
 - spec/mock_app.rb
 - spec/platform_object_spec.rb
 - spec/spec_helper.rb
 - spec/web_element_spec.rb
 - spec/web_element_watir_spec.rb
+- spec/web_elements/checkbox_spec.rb
+- spec/web_elements/radio_spec.rb
+- spec/web_elements/select_list_spec.rb
+- spec/web_elements/text_field_spec.rb
 homepage: https://github.com/jnyman/fluent
 licenses:
 - MIT
@@ -167,17 +198,32 @@ signing_key:
 specification_version: 4
 summary: A Semantically Clean Fluent Interface Test Framework
 test_files:
+- spec/enclosers_spec.rb
+- spec/evaluators_spec.rb
+- spec/factory_spec.rb
 - spec/fluent_spec.rb
 - spec/generators/button_generators_spec.rb
+- spec/generators/cell_generators_spec.rb
 - spec/generators/checkbox_generators_spec.rb
+- spec/generators/div_generators_spec.rb
 - spec/generators/link_generators_spec.rb
+- spec/generators/list_item_generators_spec.rb
+- spec/generators/ordered_list_generators_spec.rb
 - spec/generators/paragraph_generators_spec.rb
 - spec/generators/radio_generators_spec.rb
 - spec/generators/select_list_generators_spec.rb
+- spec/generators/span_generators_spec.rb
+- spec/generators/table_generators_spec.rb
+- spec/generators/text_area_generators_spec.rb
 - spec/generators/text_field_generators_spec.rb
+- spec/generators/unordered_list_generators_spec.rb
 - spec/generators_spec.rb
 - spec/mock_app.rb
 - spec/platform_object_spec.rb
 - spec/spec_helper.rb
 - spec/web_element_spec.rb
 - spec/web_element_watir_spec.rb
+- spec/web_elements/checkbox_spec.rb
+- spec/web_elements/radio_spec.rb
+- spec/web_elements/select_list_spec.rb
+- spec/web_elements/text_field_spec.rb