testable 0.3.0 → 0.8.0

data/examples/testable-capybara-rspec.rb

@@ -0,0 +1,70 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << "./lib"
+
+# Run this with:
+# rspec ./examples/testable-capybara-rspec.rb
+
+require "rspec"
+include RSpec::Matchers
+
+require "testable"
+include Testable::Context
+
+require "capybara/rspec"
+
+RSpec.configure do |config|
+  config.expose_dsl_globally = true
+end
+
+Capybara.configure do |config|
+  config.run_server = false
+  config.default_driver = :selenium
+  config.app_host = "https://veilus.herokuapp.com"
+end
+
+class HomePage < Testable::Page
+  element :login_form, "#open"
+  element :username,   "#username"
+  element :password,   "#password"
+  element :login,      "#login-button"
+
+  def path
+    "/"
+  end
+
+  def login_as_admin
+    login_form.click
+    username.set "admin"
+    password.set "admin"
+    login.click
+  end
+end
+
+class Navigation < Testable::Node
+  elements :items, "a"
+
+  element :page_list, "#navlist"
+  element :overlord,  "#overlord"
+  element :planets,   "#planets"
+  element :warp,      "#warp"
+  element :stardate,  "#stardate"
+end
+
+class LandingPage < Testable::Page
+  component :navigation, Navigation, "#areas"
+
+  def go_to_overlord
+    navigation.page_list.click
+    navigation.overlord.click
+  end
+end
+
+feature "navigation" do
+  background do
+    on_visit(HomePage).login_as_admin
+  end
+
+  scenario "navigates to overlord" do
+    on(LandingPage).go_to_overlord
+  end
+end

data/examples/testable-capybara.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << "./lib"
+
+require "rspec"
+include RSpec::Matchers
+
+require "testable"
+
+Capybara.configure do |config|
+  config.run_server = false
+  config.default_driver = :selenium
+  config.app_host = "https://veilus.herokuapp.com"
+end
+
+class HomePage < Testable::Page
+  element :login_form, "#open"
+  element :username,   "#username"
+  element :password,   "#password"
+  element :login,      "#login-button"
+
+  def path
+    "/"
+  end
+end
+
+home_page = HomePage.visit
+
+puts home_page.current?
+expect(home_page).to be_current
+
+puts home_page.find("article").text
+
+puts home_page.login_form.inspect
+
+puts home_page.has_login_form?
+puts home_page.has_no_login_form?
+
+expect(home_page).to have_login_form
+
+# The next statement would (correctly) fail.
+# expect(home_page).to have_no_login_form
+
+home_page.login_form.click
+home_page.username.set "admin"
+home_page.password.set "admin"
+home_page.login.click

data/examples/testable-info.rb

@@ -0,0 +1,65 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << "./lib"
+
+require "testable"
+
+require "rspec"
+# rubocop:disable Style/MixinUsage
+include RSpec::Matchers
+# rubocop:enable Style/MixinUsage
+
+puts Testable::VERSION
+
+puts "================================="
+puts "Testable's Version"
+puts "================================="
+puts Testable.version
+
+puts "================================="
+puts "Testable's Dependencies"
+puts "================================="
+puts Testable.dependencies
+
+puts "================================="
+puts "Testable's API"
+puts "================================="
+puts Testable.api
+
+class Home
+  include Testable
+end
+
+Testable.start_browser :firefox, headless: true
+
+page = Home.new
+
+expect(Testable.browser).to be_an_instance_of(Watir::Browser)
+expect(Testable.browser.driver).to be_an_instance_of(
+  Selenium::WebDriver::Firefox::Marionette::Driver
+)
+
+expect(page).to be_a_kind_of(Testable)
+expect(page).to be_an_instance_of(Home)
+
+puts "================================="
+puts "Testable's Watir API"
+puts "================================="
+puts Testable.watir_api
+
+puts "================================="
+puts "Testable's Selenium API"
+puts "================================="
+puts Testable.selenium_api
+
+puts "================================="
+puts "Testable's Definition API"
+puts "================================="
+puts page.definition_api
+
+puts "================================="
+puts "Testable's Elements"
+puts "================================="
+puts Testable.elements?
+puts Testable.recognizes?("div")
+
+Testable.quit_browser

data/examples/testable-watir-context.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << "./lib"
+
+require "rspec"
+# rubocop:disable Style/MixinUsage
+include RSpec::Matchers
+# rubocop:enable Style/MixinUsage
+
+require "testable"
+# rubocop:disable Style/MixinUsage
+include Testable::Context
+# rubocop:enable Style/MixinUsage
+
+class Home
+  include Testable
+
+  url_is "https://veilus.herokuapp.com/"
+  url_matches(/heroku/)
+  title_is "Veilus"
+
+  # Elements can be defined with HTML-style names as found in Watir.
+  p          :login_form, id:    "open", visible: true
+  text_field :username,   id:    "username"
+  text_field :password
+  button     :login,      id:    "login-button"
+  div        :message,    class: "notice"
+
+  # Elements can be defined with a generic name.
+  # element :login_form, id:    "open", visible: true
+  # element :username,   id:    "username"
+  # element :password
+  # element :login,      id:    "login-button"
+  # element :message,    class: "notice"
+
+  def begin_with
+    move_to(0, 0)
+    resize_to(screen_width, screen_height)
+  end
+end
+
+class Navigation
+  include Testable
+
+  p     :page_list,     id: "navlist"
+  link  :planets,       id: "planets"
+
+  image :planet_logo,   id: "planet-logo"
+end
+
+Testable.start_browser :firefox
+
+on_visit(Home) do
+  @context.login_form.click
+  @context.username.set "admin"
+  @context.password(id: 'password').set "admin"
+  @context.login.click
+  expect(@context.message.text).to eq('You are now logged in as admin.')
+end
+
+on(Navigation) do |page|
+  page.page_list.click
+  # page.page_list.wait_until(&:dom_updated?).click
+  page.planets.click
+  expect(page.planet_logo.exists?).to be true
+end
+
+Testable.quit_browser

data/examples/testable-watir-datasetter.rb

@@ -0,0 +1,52 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << "./lib"
+
+require "rspec"
+# rubocop:disable Style/MixinUsage
+include RSpec::Matchers
+# rubocop:enable Style/MixinUsage
+
+require "testable"
+# rubocop:disable Style/MixinUsage
+include Testable::Context
+# rubocop:enable Style/MixinUsage
+
+class Home
+  include Testable
+
+  url_is "https://veilus.herokuapp.com/"
+
+  p          :login_form, id: "open", visible: true
+  text_field :username,   id: "username"
+  text_field :password
+  button     :login,      id: "login-button"
+  div        :message,    class: 'notice'
+
+  def begin_with
+    move_to(0, 0)
+    resize_to(screen_width, screen_height)
+  end
+end
+
+class WarpTravel
+  include Testable
+
+  url_is "https://veilus.herokuapp.com/warp"
+
+  text_field :warp_factor, id: 'warpInput'
+  text_field :velocity,    id: 'velocityInput'
+  text_field :distance,    id: 'distInput'
+end
+
+Testable.start_browser :firefox
+
+on_visit(Home) do
+  @active.login_form.click
+  @active.username.set "admin"
+  @active.password(id: 'password').set "admin"
+  @active.login.click
+end
+
+on_visit(WarpTravel).using_data("warp factor": 1, velocity: 1, distance: 4.3)
+
+Testable.quit_browser

data/examples/testable-watir-events.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << "./lib"
+
+require "rspec"
+# rubocop:disable Style/MixinUsage
+include RSpec::Matchers
+# rubocop:enable Style/MixinUsage
+
+require "testable"
+
+class Dynamic
+  include Testable
+
+  url_is "https://veilus.herokuapp.com/practice/dynamic_events"
+
+  button :long,  id: 'long'
+  button :quick, id: 'quick'
+  button :stale, id: 'stale'
+  button :fade,  id: 'fade'
+
+  div :dom_events,    id: 'container1'
+  div :stale_event,   id: 'container2'
+  div :effect_events, id: 'container3'
+end
+
+Testable.start_browser :firefox
+
+page = Dynamic.new
+
+page.visit
+
+expect(page.dom_events.dom_updated?).to be_truthy
+expect(page.dom_events.wait_until(&:dom_updated?).spans.count).to eq(0)
+
+page.long.click
+
+expect(page.dom_events.dom_updated?).to be_falsey
+expect(page.dom_events.wait_until(&:dom_updated?).spans.count).to eq(4)
+
+page.quick.click
+
+expect(page.dom_events.wait_until(&:dom_updated?).spans.count).to eq(23)
+
+Testable.quit_browser

data/examples/testable-watir-ready.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << "./lib"
+
+require "rspec"
+# rubocop:disable Style/MixinUsage
+include RSpec::Matchers
+# rubocop:enable Style/MixinUsage
+
+require "testable"
+
+class PageReady
+  include Testable
+
+  url_is "https://veilus.herokuapp.com"
+
+  element :logo, id: 'site-'
+  element :login_form, id: 'openski'
+
+  page_ready { [logo.exists?, "Test Gorilla logo is not present"] }
+end
+
+Testable.start_browser :firefox
+
+page = PageReady.new
+
+page.visit
+
+# Uncomment one of these at a time to see that the page_ready part
+# is working. The element definitions above are purposely incorrect.
+
+# page.when_ready { page.login_form.click }
+# page.login_form.click
+
+Testable.quit_browser

data/examples/testable-watir-test.rb

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << "./lib"
+
+require "rspec"
+include RSpec::Matchers
+
+require "testable"
+
+class Home
+  include Testable
+
+  url_is "https://veilus.herokuapp.com/"
+  url_matches(/heroku/)
+  title_is "Veilus"
+
+  # Elements can be defined with HTML-style names as found in Watir.
+  p          :login_form, id:    "open", visible: true
+  text_field :username,   id:    "username"
+  text_field :password
+  button     :login,      id:    "login-button"
+  div        :message,    class: "notice"
+
+  # Elements can be defined with a generic name.
+  # element :login_form, id:    "open", visible: true
+  # element :username,   id:    "username"
+  # element :password
+  # element :login,      id:    "login-button"
+  # element :message,    class: "notice"
+
+  def begin_with
+    move_to(0, 0)
+    resize_to(screen_width, screen_height)
+  end
+end
+
+class Navigation
+  include Testable
+
+  p     :page_list,     id: "navlist"
+  link  :planets,       id: "planets"
+
+  image :planet_logo,   id: "planet-logo"
+end
+
+Testable.start_browser :firefox
+
+# Will default to UNKNOWN.
+puts Testable.log_level
+
+# Will not actually log.
+Testable.logger.info("Testing an info log message.")
+
+# Change the log.
+Testable.log_level = :debug
+
+# Will actually log.
+Testable.logger.debug("Testing a debug log message.")
+
+# Sets the Watir wire protocol level logging.
+Testable.wire_level_logging = :info
+
+page = Home.new
+
+page.visit
+
+page.login_form.click
+page.username.set "admin"
+page.password(id: 'password').set "admin"
+page.login.click
+expect(page.message.text).to eq('You are now logged in as admin.')
+
+page = Navigation.new
+
+page.page_list.click
+# page.page_list.wait_until(&:dom_updated?).click
+
+page.planets.click
+expect(page.planet_logo.exists?).to be true
+
+Testable.quit_browser