symbiont 0.0.3 → 0.0.4

data/HISTORY.md

@@ -1,6 +1,12 @@
 Change Log and History
 ======================
 
+Version 0.0.4 / 2012-04-14
+--------------------------
+
+A very minor update to make sure all tests are in place and working correctly. This release is in preparation to getting the minor release schedule going.
+
+
 Version 0.0.3 / 2012-04-11
 --------------------------
 

data/cucumber.yml

@@ -0,0 +1,4 @@
+<% browser = "BROWSER=firefox" %>
+<% std_opts = "--color --format pretty --no-source" %>
+
+default: <%= browser %> <%= std_opts %> -r specs specs

data/lib/symbiont/version.rb

@@ -1,3 +1,3 @@
 module Symbiont
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/specs/button.feature

@@ -0,0 +1,41 @@
+Feature: Ability to Support Button Web Objects
+
+  Scenario: Reference a button
+    When on the test page
+    Then the click me button should exist
+    And the click me button should be visible
+    And the click me button should be enabled
+    And the click me button object should be usable
+
+  Scenario: Get text from a button
+    When on the test page
+    Then the text of the click me button should be "Click Me"
+
+  Scenario: Click a button
+    When the click me button on the test page is clicked
+    Then the success page appears
+
+  Scenario: A non-existent button
+    When on the test page
+    Then the fake button should not exist
+    But the fake button object should be usable
+
+  Scenario: A disabled button
+    When on the test page
+    Then the disabled button should exist
+    And the disabled button should be visible
+    And the disabled button should not be enabled
+    And the text of the disabled button should be "Can't Click Me"
+    But the disabled button object should be usable
+    
+  Scenario Outline: Finding buttons with locators
+    When the click me button on the test page is clicked by "<locator>"
+    Then the success page appears
+    
+    Scenarios:
+      | locator |
+      | id      |
+      | name    |
+      | class   |
+      | xpath   |
+      | index   |

data/specs/definitions/pages.rb

@@ -0,0 +1,58 @@
+class LoggingIn
+  include Symbiont
+  begin_at "http://localhost:4567"
+  
+  within_frame(id: "loginSection") do |frame|
+    text_field :clientCode, id: "clientCode", frame: frame
+    text_field :loginName, id: "loginName", frame: frame
+    text_field :loginPassword, id: "password", frame: frame
+    button :login, id: "btnSubmit", frame: frame
+  end
+end
+
+class LandingPage
+  include Symbiont
+  
+  url_is "http://localhost:4567"
+  title_is "Login | Test App"
+  look_for :static_test_page
+  
+  link :static_test_page, id: "testPage"
+  link :test_app, id: "home_link"
+  link :fake_link, id: "fakeLink"
+end
+
+class TestPage
+  include Symbiont
+
+  url_is "http://localhost:4567/test_page"
+  title_is "Test Page | Test App"
+  
+  link :avengersID, id: "avengers_assemble_id"
+  link :avengersName, name: "avengers_assemble_name"
+  link :avengersClass, class: "avengers_assemble_class"
+  link :avengersXPath, xpath: "id('avengers_assemble_id')"
+  link :avengersIndex, {id: "avengers_assemble_id", index: 0}
+  
+  button :clickme, id: "clickme_id"
+  
+  button :clickmeID, id: "clickme_id"
+  button :clickmeName, name: "clickme_name"
+  button :clickmeClass, class: "clickme_class"
+  button :clickmeXPath, xpath: "//input[@id='clickme_id']"
+  button :clickmeIndex, {id: "clickme_id", index: 0}
+  
+  button :fake_button, id: "fakeButton"
+  button :disabled_button, id: "cantclickme_id"
+  
+  text_field :book_title, id: "title"
+  
+  text_field :bookTitleID, id: "title"
+  text_field :bookTitleName, name: "bookName"
+  text_field :bookTitleClass, class: "bookClass"
+  text_field :bookTitleXPath, xpath: "//input[@id='title']"
+  text_field :bookTitleIndex, {id: "title", index: 0}
+  
+  text_field :fake_text_field, id: "fakeTextField"
+  text_field :disabled_text_field, id: "pub_id"
+end

data/specs/frame.feature

@@ -0,0 +1,5 @@
+Feature: Ability to Support Frame Web Objects
+  
+  Scenario: Access web objects within a frame
+    When the login form on the login page is filled in with standard data
+    Then the entities page appears   

data/specs/link.feature

@@ -0,0 +1,32 @@
+Feature: Ability to Support Link Web Objects
+
+  Scenario: Reference a link
+    When on the landing page
+    Then the test page link should exist
+    And the test page link should be visible
+    And the test page link object should be usable
+
+  Scenario: Get text from a link
+    When on the landing page
+    Then the text of the home page link should be "Test App"
+    
+  Scenario: Click a link
+    When the test page link on the landing page is clicked
+    Then the static test page appears
+
+  Scenario: A non-existent link
+    When on the landing page
+    Then the fake link should not exist
+    But the fake page link object should be usable
+
+  Scenario Outline: Finding links with locators
+    When the avengers link on the test page is clicked by "<locator>"
+    Then the success page appears
+    
+    Scenarios:
+      | locator |
+      | id      |
+      | name    |
+      | class   |
+      | xpath   |
+      | index   |

data/specs/simple_test.feature

@@ -0,0 +1,13 @@
+Feature: Simple Test of Symbiont and Cucumber
+
+  Scenario: Browser is started for first scenario.
+    When the first scenario is executed
+    Then a browser should be available
+  
+  Scenario: Browser is started for second scenario.
+    When the second scenario is executed
+    Then a browser should be available
+  
+  Scenario: Browser is started for third scenario.
+    When the third scenario is executed
+    Then a browser should be available

data/specs/support/env.rb

@@ -0,0 +1,18 @@
+require 'symbiont'
+
+module Symbiont
+  module Browser
+    
+    def self.start
+      unless @browser
+        @browser = Watir::Browser.new(ENV['BROWSER'])
+      end
+      @browser
+    end
+    
+    def self.stop
+      @browser.quit if @browser
+    end
+    
+  end # module: Browser
+end # module: Symbiont

data/specs/support/hooks.rb

@@ -0,0 +1,11 @@
+AfterConfiguration do |config|
+  puts("Tests are being executed from: #{config.feature_dirs}")
+end
+
+Before do
+  @browser = Symbiont::Browser.start
+end
+
+at_exit do
+  Symbiont::Browser.stop
+end

data/specs/support/test_steps/action_steps.rb

@@ -0,0 +1,207 @@
+When (/^on the landing page$/) do
+  @page = LandingPage.new(@browser, true)
+end
+
+When (/^on the test page$/) do
+  @page = TestPage.new(@browser, true)
+end
+
+When (/^the test page link on the landing page is clicked$/) do
+  step %{on the landing page}
+  @page.static_test_page
+end
+
+When (/^the avengers link on the test page is clicked by "([^"]*)"$/) do |locator|
+  @page = TestPage.new(@browser, true)
+  @page.avengersID if locator == "id"
+  @page.avengersName if locator == "name"
+  @page.avengersClass if locator == "class"
+  @page.avengersXPath if locator == "xpath"
+  @page.avengersIndex if locator == "index"
+end
+
+When (/^the book title on the test page is set to "([^"]*)"$/) do |text|
+  step %{on the test page}
+  @page.book_title = "Revelation Space"
+end
+
+When (/^the book title on the test page is set by "([^"]*)"$/) do |locator|
+  title = "Revelation Space"
+  @page = TestPage.new(@browser, true)
+  @page.bookTitleID = title if locator == "id"
+  @page.bookTitleName = title if locator == "name"
+  @page.bookTitleClass = title if locator == "class"
+  @page.bookTitleXPath = title if locator == "xpath"
+  @page.bookTitleIndex = title if locator == "index"
+end
+
+When (/^the login form on the login page is filled in with standard data$/) do
+  @activity = LoggingIn.new(@browser)
+  @activity.start
+  @activity.clientCode = "Testing"
+  @activity.loginName = "jnyman"
+  @activity.loginPassword = "P@ssw0rd!"
+  @activity.login
+end
+
+Then (/^the test page link should exist$/) do
+  @page.static_test_page_exists?.should == true
+  @page.static_test_page?.should == true
+end
+
+Then (/^the fake link should not exist$/) do
+  @page.fake_link_exists?.should == false
+end
+
+Then (/^the test page link should be visible$/) do
+  @page.static_test_page_visible?.should == true
+  @page.static_test_page_?.should == true
+end
+
+Then (/^the text of the home page link should be "([^"]*)"$/) do |text|
+  @page.test_app_text.should == text
+end
+
+Then (/^the test page link object should be usable$/) do
+  @object = @page.static_test_page_link
+  @object.should be_instance_of Symbiont::WebObjects::Link
+end
+
+Then (/^the fake page link object should be usable$/) do
+  @object = @page.fake_link_object
+  @object.should be_instance_of Symbiont::WebObjects::Link
+end
+
+Then (/^the click me button should exist$/) do
+  @page.clickme_exists?.should == true
+  @page.clickme?.should == true
+end
+
+Then (/^the click me button should be visible$/) do
+  @page.clickme_visible?.should == true
+  @page.clickme_?.should == true
+end
+
+Then (/^the click me button should be enabled$/) do
+  @page.clickme_enabled?.should == true
+  @page.clickme!.should == true
+end
+
+Then (/^the click me button object should be usable$/) do
+  @object = @page.clickme_button
+  @object.should be_instance_of Symbiont::WebObjects::Button
+end
+
+Then (/^the text of the click me button should be "([^"]*)"$/) do |text|
+  @page.clickme_text.should == text
+end
+
+When (/^the click me button on the test page is clicked$/) do
+  step %{on the test page}
+  @page.clickme
+end
+
+When (/^the click me button on the test page is clicked by "([^"]*)"$/) do |locator|
+  @page = TestPage.new(@browser, true)
+  @page.clickmeID if locator == "id"
+  @page.clickmeName if locator == "name"
+  @page.clickmeClass if locator == "class"
+  @page.clickmeXPath if locator == "xpath"
+  @page.clickmeIndex if locator == "index"
+end
+
+Then (/^the fake button should not exist$/) do
+  @page.fake_button_exists?.should == false
+end
+
+Then (/^the fake button object should be usable$/) do
+  @object = @page.fake_button_object
+  @object.should be_instance_of Symbiont::WebObjects::Button
+end
+
+Then (/^the disabled button should exist$/) do
+  @page.disabled_button_exists?.should == true
+end
+
+Then (/^the disabled button should be visible$/) do
+  @page.disabled_button_visible?.should == true
+end
+
+Then (/^the disabled button should not be enabled$/) do
+  @page.disabled_button_enabled?.should == false
+end
+
+Then (/^the disabled button object should be usable$/) do
+  @object = @page.disabled_button_object
+  @object.should be_instance_of Symbiont::WebObjects::Button
+end
+
+Then (/^the text of the disabled button should be "([^"]*)"$/) do |text|
+  @page.disabled_button_text.should == text
+end
+
+Then (/^the book title text field should exist$/) do
+  @page.book_title_exists?.should == true
+  @page.book_title?.should == true
+end
+
+Then (/^the book title text field should be visible$/) do
+  @page.book_title_visible?.should == true
+  @page.book_title_?.should == true
+end
+
+Then (/^the book title text field should be enabled$/) do
+  @page.book_title_enabled?.should == true
+  @page.book_title!.should == true
+end
+
+Then (/^the book title text field object should be usable$/) do
+  @object = @page.book_title_object
+  @object.should be_instance_of Symbiont::WebObjects::TextField
+end
+
+Then (/^the book title should be "([^"]*)"$/) do |text|
+  @page.book_title.should == text
+end
+
+Then (/^the fake text field should not exist$/) do
+  @page.fake_text_field_exists?.should == false
+end
+
+Then (/^the fake text field object should be usable$/) do
+  @object = @page.fake_text_field_object
+  @object.should be_instance_of Symbiont::WebObjects::TextField
+end
+
+Then (/^the disabled text field should exist$/) do
+  @page.disabled_text_field_exists?.should == true
+end
+
+Then (/^the disabled text field should be visible$/) do
+  @page.disabled_text_field_visible?.should == true
+end
+
+Then (/^the disabled text field should not be enabled$/) do
+  @page.disabled_text_field_enabled?.should == false
+end
+
+Then (/^the text of the disabled text field should be "([^"]*)"$/) do |text|
+  @page.disabled_text_field.should == text
+end
+
+Then (/^the disabled text field object should be usable$/) do
+  @object = @page.disabled_text_field_object
+  @object.should be_instance_of Symbiont::WebObjects::TextField
+end
+
+Then (/^the success page appears$/) do
+  @browser.title.should == "Success Page: 1 | Test App"
+end
+
+Then (/^the static test page appears$/) do
+  @browser.title.should == "Test Page | Test App"
+end
+
+Then (/^the entities page appears$/) do
+  @browser.title.should == "Landing Page | Test App"
+end

data/specs/support/test_steps/simple_test_steps.rb

@@ -0,0 +1,8 @@
+When /^the (.*) scenario is executed$/ do |name|
+  puts ("The #{name} scenario was started.")
+end
+
+Then /^a browser should be available$/ do
+  @browser.nil?
+  puts ("Browser (#{@browser}) appeared.")
+end

data/specs/text_field.feature

@@ -0,0 +1,37 @@
+Feature: Ability to Support Text Field Web Objects
+
+  Scenario: Reference a text field
+    When on the test page
+    Then the book title text field should exist
+    And the book title text field should be visible
+    And the book title text field should be enabled
+    And the book title text field object should be usable
+
+  Scenario: Set text in a text field and get text from it
+    When the book title on the test page is set to "Revelation Space"
+    Then the book title should be "Revelation Space"
+
+Scenario: A non-existent text field
+    When on the test page
+    Then the fake text field should not exist
+    But the fake text field object should be usable
+
+  Scenario: A disabled text field
+    When on the test page
+    Then the disabled text field should exist
+    And the disabled text field should be visible
+    And the disabled text field should not be enabled
+    And the text of the disabled text field should be "ESC:001678:FNC"
+    But the disabled text field object should be usable
+
+  Scenario Outline: Finding text fields with locators
+    When the book title on the test page is set by "<locator>"
+    Then the book title should be "Revelation Space"
+    
+    Scenarios:
+      | locator |
+      | id      |
+      | name    |
+      | class   |
+      | xpath   |
+      | index   |

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: symbiont
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-11 00:00:00.000000000Z
+date: 2012-04-14 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &25978452 !ruby/object:Gem::Requirement
+  requirement: &25920216 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 2.9.0
   type: :development
   prerelease: false
-  version_requirements: *25978452
+  version_requirements: *25920216
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &25978140 !ruby/object:Gem::Requirement
+  requirement: &25919832 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 0.6.1
   type: :development
   prerelease: false
-  version_requirements: *25978140
+  version_requirements: *25919832
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: &25977696 !ruby/object:Gem::Requirement
+  requirement: &25919460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -43,7 +43,7 @@ dependencies:
         version: 0.5.3
   type: :runtime
   prerelease: false
-  version_requirements: *25977696
+  version_requirements: *25919460
 description: An endosymbiotic facultative library for web application testing.
 email:
 - jeffnyman@gmail.com
@@ -57,6 +57,7 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- cucumber.yml
 - lib/symbiont.rb
 - lib/symbiont/enclosers.rb
 - lib/symbiont/factory.rb
@@ -80,8 +81,17 @@ files:
 - spec/symbiont/platform_object_spec.rb
 - spec/symbiont/symbiont_spec.rb
 - spec/symbiont/web_object_spec.rb
+- specs/button.feature
+- specs/definitions/pages.rb
+- specs/frame.feature
+- specs/link.feature
+- specs/simple_test.feature
+- specs/support/env.rb
+- specs/support/hooks.rb
+- specs/support/test_steps/action_steps.rb
+- specs/support/test_steps/simple_test_steps.rb
+- specs/text_field.feature
 - symbiont.gemspec
-- test/symbiont_test.rb
 homepage: https://github.com/jnyman/symbiont
 licenses:
 - MIT

data/test/symbiont_test.rb

@@ -1,158 +0,0 @@
-$LOAD_PATH.unshift(File.expand_path('../lib', File.dirname(__FILE__)))
-
-require 'symbiont'
-require 'symbiont/factory'
-
-class LoginPage
-  include Symbiont
-  
-  url_is "http://localhost:4567"
-  title_is "Login | Test App"
-  look_for(:testPage)
-  
-  link :testPage, id: "testPage"
-end
-
-class LoggingIn
-  include Symbiont
-  begin_at "http://localhost:4567"
-  
-  within_frame(id: "loginSection") do |frame|
-    text_field :clientCode, id: "clientCode", frame: frame
-    text_field :loginName, id: "loginName", frame: frame
-    text_field :loginPassword, id: "password", frame: frame
-    button :login, id: "btnSubmit", frame: frame
-  end
-end
-
-class TestPage
-  include Symbiont
-
-  begin_at "http://localhost:4567/test_page"
-  title_is "Test Page | Test App"
-
-  link :fake_link, id: "fakeLink"
-  button :clickme, id: "clickme_id"
-  button :fake_button, id: "fakeButton"
-  button :disabled_button, id: "cantclickme_id"
-  text_field :book_title, id: "title"
-  text_field :fake_text_field, id: "fakeTextField"
-  text_field :disabled_text_field, id: "pub_id"
-end
-
-@browser = Watir::Browser.new(:firefox)
-
-puts "* Frame Tests"
-
-action = LoggingIn.new(@browser)
-action.start
-
-clientCode = action.clientCode_object
-puts "\t'Client Code' text field object is type: #{clientCode}"
-puts "\t'Client Code' text field exists? #{action.clientCode_exists?}"
-puts "\t'Client Code' text field visible? #{action.clientCode_visible?}"
-puts "\t'Client Code' text field enabled? #{action.clientCode_enabled?}"
-action.clientCode = "QA"
-action.loginName = "jnyman"
-action.loginPassword = "password"
-loginName = action.loginName
-puts "\t'Login Name' text field value is: #{loginName}"
-
-login = action.login_object
-puts "\t'Log In' text field object is type: #{login}"
-puts "\t'Log In' text field exists? #{action.login_exists?}"
-puts "\t'Log In' text field visible? #{action.login_visible?}"
-puts "\t'Log In' text field enabled? #{action.login_enabled?}"
-puts "\t'Log In' button object text is: #{action.login_text}"
-
-action = LoginPage.new(@browser)
-action.view
-action.has_title?
-action.has_object?
-
-puts "* Link Tests"
-
-puts "** Basic Text Link Tests"
-
-puts "\t'Test Page' link object exists? #{action.testPage_exists?}"
-puts "\t'Test Page' link object exists? #{action.testPage?}"
-puts "\t'Test Page' link object visible? #{action.testPage_visible?}"
-puts "\t'Test Page' link object visible? #{action.testPage_?}"
-test_page = action.testPage_object
-puts "\t'Test Page' link object is type: #{test_page}"
-puts "\t'Test Page' link object text is: #{action.testPage_text}"
-puts "\t'Test Page' link object text is: #{test_page.text}"
-
-action.testPage
-action = TestPage.new(@browser)
-
-puts "** Fake Link Tests"
-
-test_link = action.fake_link_object
-puts "\tFake link object is type: #{test_link}"
-puts "\tFake link exists? #{action.fake_link?}"
-
-puts "* Text Field Tests"
-
-puts "** Enabled Text Field Tests"
-
-puts "\t'Book Title' text field object exists? #{action.book_title_exists?}"
-puts "\t'Book Title' text field object exists? #{action.book_title?}"
-puts "\t'Book Title' text field object visible? #{action.book_title_visible?}"
-puts "\t'Book Title' text field object exists? #{action.book_title_?}"
-puts "\t'Book Title' text field object enabled? #{action.book_title_enabled?}"
-puts "\t'Book Title' text field object enabled? #{action.book_title!}"
-
-bookTitle = action.book_title_object
-puts "\t'Book Title' text field object is type: #{bookTitle}"
-action.book_title = "Revelation Space"
-book = action.book_title
-puts "\t'Book Title' text field value is: '#{book}'"
-
-puts "** Disabled Text Field Tests"
-
-disabledTextField = action.disabled_text_field_object
-puts "\tDisabled text field object is type: #{disabledTextField}"
-puts "\tDisabled text field object exists? #{action.disabled_text_field?}"
-puts "\tDisabled text field object visible? #{action.disabled_text_field_?}"
-puts "\tDisabled text field object enabled? #{action.disabled_text_field!}"
-
-puts "** Fake Text Field Tests"
-
-fakeTextField = action.fake_text_field_object
-puts "\tFake text field object is type: #{fakeTextField}"
-puts "\tFake text field object exists? #{action.fake_text_field_exists?}"
-
-puts "* Button Tests"
-
-puts "** Enabled Button Tests"
-
-puts "\t'Click Me' button object exists? #{action.clickme_exists?}"
-puts "\t'Click Me' button object exists? #{action.clickme?}"
-puts "\t'Click Me' button object visible? #{action.clickme_visible?}"
-puts "\t'Click Me' button object exists? #{action.clickme_?}"
-puts "\t'Click Me' button object enabled? #{action.clickme_enabled?}"
-puts "\t'Click Me' button object enabled? #{action.clickme!}"
-click_me = action.clickme_object
-puts "\t'Click Me' button object is type: #{click_me}"
-puts "\t'Click Me' button object text is: #{action.clickme_text}"
-puts "\t'Click Me' button object text is: #{click_me.text}"
-
-puts "** Disabled Button Tests"
-
-cant_click_me = action.disabled_button_object
-puts "\t'Can't Click Me' button object is type: #{cant_click_me}"
-puts "\t'Can't Click Me' button object exists? #{action.disabled_button?}"
-puts "\t'Can't Click Me' button object visible? #{action.disabled_button_?}"
-puts "\t'Can't Click Me' button object enabled? #{action.disabled_button!}"
-puts "\t'Can't Click Me' button object text is: #{action.disabled_button_text}"
-
-puts "** Fake Button Tests"
-
-fake_button = action.fake_button_object
-puts "\tFake button object is type: #{fake_button}"
-puts "\tFake button object exists? #{action.fake_button?}"
-
-action.clickme
-
-@browser.close