uptime_monitor 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 2.1.0
+  - 1.9.3
+  - jruby-19mode # JRuby in 1.9 mode
+
+script: bundle exec rspec -fd spec

data/Gemfile

@@ -0,0 +1,19 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+gem 'headless'
+gem 'watir-webdriver'
+gem 'watir-webdriver-performance'
+gem 'activesupport'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 1.8.7"
+  #gem "rcov", ">= 0"
+  gem "pry"
+end

data/Gemfile.lock

@@ -0,0 +1,102 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (4.0.2)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    addressable (2.3.5)
+    atomic (1.1.14)
+    builder (3.2.2)
+    childprocess (0.4.0)
+      ffi (~> 1.0, >= 1.0.11)
+    coderay (1.1.0)
+    diff-lcs (1.2.4)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
+    ffi (1.9.3)
+    git (1.2.6)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    headless (1.0.1)
+    highline (1.6.20)
+    httpauth (0.2.0)
+    i18n (0.6.9)
+    jeweler (1.8.8)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    method_source (0.8.2)
+    minitest (4.7.5)
+    multi_json (1.8.2)
+    multi_xml (0.5.5)
+    multipart-post (1.2.0)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    pry (0.9.12.4)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rack (1.5.2)
+    rake (10.1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.6)
+    rspec-expectations (2.14.3)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    rubyzip (1.1.0)
+    selenium-webdriver (2.39.0)
+      childprocess (>= 0.2.5)
+      multi_json (~> 1.0)
+      rubyzip (~> 1.0)
+      websocket (~> 1.0.4)
+    slop (3.4.7)
+    thread_safe (0.1.3)
+      atomic
+    tzinfo (0.3.38)
+    watir-webdriver (0.6.6)
+      selenium-webdriver (>= 2.18.0)
+    watir-webdriver-performance (0.2.3)
+      watir-webdriver
+    websocket (1.0.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  bundler (~> 1.0)
+  headless
+  jeweler (~> 1.8.7)
+  pry
+  rdoc (~> 3.12)
+  rspec
+  watir-webdriver
+  watir-webdriver-performance

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Obi Akubue
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,110 @@
+uptime_monitor (Hercules)
+==========================
+[![Build Status](https://travis-ci.org/obi-a/uptime_monitor.png?branch=master)](https://travis-ci.org/obi-a/uptime_monitor)
+
+Using a real web browser, this plugin checks pages of a website at the specified time intervals, to ensure that the specified elements of the pages and features of the site are still working correctly.
+
+##Specification:
+
+<pre lang="ruby">
+monitor = {monitor: "My Website",
+            url: "http://mysite.com",
+            every: "5m",
+            contact: "admin@mail.com",
+            via: "email_notifier",
+            plugin: "uptime_monitor",
+            exists?: [
+                        [:title, [text: "Welcome to my site"]],
+                        [{div: {id:"test", class: "test-section"}}, [text: "this is a test"]],
+                        [a: {href: "/aboutus" }],
+                        [:h1],
+                        [:h2,[text: "Login"]],
+                        [form: {action: "/signup", method: "get"}],
+                        [{element: {css: "#submit-button"}}, [:click]],
+                        [{text_field: {id: "username"}}, [set: "admin"]],
+                        [{text_field: {id: "password"}}, [set: "pass"]],
+                        [link: {text: "Contact Us"}],
+                        [wait_until_exists?: [div: {id:"open-section"}]]
+                     ],
+            browser: ["firefox", headless: true]
+          }
+ragios.add [monitor]
+</pre>
+
+###Monitor login process of a real site
+<pre lang="ruby">
+login_process = [
+                    [:title, [text: "Website Uptime Monitoring | SouthMunn.com"]],
+                    [{link: {text:"Login"}}, [:click]],
+                    [:title, [text: "Sign in - Website Uptime Monitoring | SouthMunn.com"]],
+                    [{text_field: {id: "username"}}, [set: "admin"]],
+                    [{text_field: {id: "password"}}, [set: "pass"]],
+                    [:button, [:click]],
+                    [:title, [text: "Dashboard - Website Uptime Monitoring | SouthMunn.com"]]
+                ]
+
+monitor = {monitor: "My Website",
+            url: "https:/southmunn.com",
+            every: "5m",
+            contact: "admin@mail.com",
+            via: "email_notifier",
+            plugin: "uptime_monitor",
+            exists?: login_process,
+            browser: ["firefox", headless: true]
+          }
+ragios.add [monitor]
+</pre>
+
+###Real site test:
+<pre lang="ruby">
+monitor = {monitor: "About Us page",
+            url: "https://www.southmunn.com/aboutus",
+            browser: ["firefox", headless: false],
+            exists?: [
+                        [{div: {class: "box_content"}}, [includes_text: "SouthMunn is a Website Uptime Monitoring SASS created and maintained by"]],
+                        [img: {src: "https://fc03.deviantart.net/fs14/f/2007/047/f/2/Street_Addiction_by_gizmodus.jpg"}],
+                     ],
+          }
+
+u = Ragios::Plugin::UptimeMonitor.new
+u.init monitor
+u.test_command?
+#=> true
+u.test_result
+#=> {[{:div=>{:class=>"box_content"}},
+#  [{:includes_text=>
+#     "SouthMunn is a Website Uptime Monitoring SASS created and maintained by"}]]=>
+#  :exists_as_expected,
+# [{:img=>
+#    {:src=>
+#      "https://fc03.deviantart.net/fs14/f/2007/047/f/2/Street_Addiction_by_gizmodus.jpg"}}]=>
+#  :exists_as_expected}
+
+
+#test result during downtime
+u.test_command?
+#=> false
+u.test_result
+#=> {[{:div=>{:class=>"box_content"}},
+#  [{:includes_text=>
+#     "SouthMunn is a Website Uptime Monitoring SASS created and maintained by"}]]=>
+#  :does_not_exist_as_expected,
+# [{:img=>
+#    {:src=>
+#      "https://fc03.deviantart.net/fs14/f/2007/047/f/2/Street_Addiction_by_gizmodus.jpg"}}]=>
+#  :does_not_exist_as_expected}
+</pre>
+
+###Supported browsers:
+Firefox, Chrome, Safari, Phantomjs
+
+### Browser Format:
+<pre lang="ruby">
+browser: ["firefox", headless: true]
+browser: ["firefox", headless: false]
+browser: ["firefox"]
+browser: ["chrome"]
+</pre>
+Running a browser headless requires xvfb installed.
+
+###More details coming soon

data/Rakefile

@@ -0,0 +1,61 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "uptime_monitor"
+  gem.homepage = "http://github.com/obi-a/uptime_monitor"
+  gem.license = "MIT"
+  gem.summary = %Q{Real browser website uptime monitoring plugin for Ragios}
+  gem.description = %Q{Uses a real web browser to monitor a web app for uptime}
+  gem.email = "obioraakubue@yahoo.com"
+  gem.authors = ["obi-a"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+#require 'rcov/rcovtask'
+#Rcov::RcovTask.new do |test|
+#  test.libs << 'test'
+#  test.pattern = 'test/**/test_*.rb'
+#  test.verbose = true
+#  test.rcov_opts << '--exclude "gems/*"'
+#end
+
+task :repl do
+  uptime_monitor_file = File.expand_path(File.join(File.dirname(__FILE__), '..', 'uptime_monitor/lib/uptime_monitor'))
+  irb = "bundle exec pry -r #{uptime_monitor_file}"
+  sh irb
+end
+
+task :r => :repl
+
+task :default => :test
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "uptime_monitor #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/uptime_monitor.rb

@@ -0,0 +1,13 @@
+require 'headless'
+require 'watir-webdriver'
+require 'watir-webdriver-performance'
+require 'ostruct'
+require 'active_support'
+
+def require_all(path)
+  Dir.glob(File.dirname(__FILE__) + path + '/*.rb') do |file|
+    require File.dirname(__FILE__)  + path + '/' + File.basename(file, File.extname(file))
+  end
+end
+
+require_all '/uptime_monitor'

data/lib/uptime_monitor/browser.rb

@@ -0,0 +1,144 @@
+module Hercules
+  module UptimeMonitor
+    class Browser
+      def initialize(url, browser_name = "firefox", is_headless = false)
+        start_headless if is_headless
+        goto(url,browser_name)
+      end
+      def close
+        @browser.close
+        @headless.destroy if @headless
+      end
+      def rest(page_element)
+        page_element[1..-1]
+      end
+      def exists?(page_element)
+        message = "Invalid page element format: #{page_element.inspect}"
+        raise(Hercules::UptimeMonitor::InvalidPageElementForm.new(error: message), message) unless page_element.is_a?(Array)
+        is_wait_until?(page_element.first) ? apply_wait_until?(page_element.first[:wait_until_exists?]) : page_element_exists?(page_element)
+      end
+      def page_element_exists?(page_element)
+        element = get_element(page_element.first)
+        begin
+          first_exists = element.exists?
+        rescue Exception => e
+          message = "Cannot find page element in this form: #{page_element.first.inspect}, you may use a css query form"
+          raise(Hercules::UptimeMonitor::UnknownPageElement.new(error: message), message)
+        end
+        if first_exists && !rest(page_element).empty?
+          rest_exists?(element, rest(page_element))
+        else
+          first_exists
+        end
+      end
+      def get_element(first)
+        if first.is_a? Symbol
+          @browser.send(first)
+        elsif first.is_a? Hash
+          key, value = first.first
+          @browser.send(key, value)
+        else
+          message = "Invalid page element #{first.inspect}"
+          raise(Hercules::UptimeMonitor::InvalidPageElement.new(error: message), message)
+        end
+      end
+      def rest_exists?(element, array)
+       results = array.map { |e| apply_rest?(element, e) }
+       results.include?(false) ? false : true
+      end
+      def apply_rest?(element, array)
+        if is_a_text?(array)
+          apply_text?(element.text, array.first)
+        elsif is_an_action?(array)
+          apply_action?(element, array.first)
+        else
+          message = "Invalid options: #{array.inspect}"
+          raise(Hercules::UptimeMonitor::InvalidRest.new(error: message), message)
+        end
+      end
+      def is_a_text?(text_array)
+        if text_array.is_a? Array
+          if text_array.first.is_a? Hash
+            text_hash = text_array.first
+            key, value = text_hash.first
+            if (([:text, :includes_text].include?(key)) && (value.is_a? String))
+             return true
+            end
+          end
+        end
+        return false
+      end
+      def is_an_action?(array)
+        if array.is_a? Array
+          if array.first.is_a?(Symbol) || array.first.is_a?(Hash)
+            return true
+          end
+        end
+        return false
+      end
+      def is_wait_until?(hash)
+        return false unless hash.is_a? Hash
+        key, value = hash.first
+        key == :wait_until_exists?
+      end
+      def apply_text?(assert_eq_text, text_hash)
+        if text_hash[:text]
+          text_hash[:text] == assert_eq_text
+        elsif text_hash[:includes_text]
+          assert_eq_text.include? text_hash[:includes_text]
+        else
+          message = "Could not evaluate page_element text: #{text_hash.inspect}"
+          raise(Hercules::UptimeMonitor::InvalidText.new(error: message), message)
+        end
+      end
+      def apply_action?(element, action)
+        if action.is_a? Symbol
+          element.send(action)
+        elsif action.is_a? Hash
+          key, value = action.first
+          element.send(key, value)
+        else
+          message = "Cannot apply action: #{action.inspect}"
+          raise(Hercules::UptimeMonitor::InvalidAction.new(error: message), message)
+        end
+        true
+      end
+      def apply_wait_until?(page_element)
+        Watir::Wait.until { page_element_exists?(page_element) }
+        true
+      rescue Watir::Wait::TimeoutError
+        false
+      end
+    private
+      def goto(url, browser_name)
+        @browser = Watir::Browser.new browser_name
+        @browser.goto url
+      end
+      def start_headless
+        @headless = Headless.new
+        @headless.start
+        @headless
+      end
+    end
+  end
+end
+
+class String
+  def exists?
+    true
+  end
+  def text
+    self
+  end
+end
+
+module Hercules
+  module UptimeMonitor
+    class InvalidAction < StandardError; end
+    class InvalidText < StandardError; end
+    class InvalidRest < StandardError; end
+    class InvalidPageElement < StandardError; end
+    class UnknownPageElement < StandardError; end
+    class InvalidPageElementForm < StandardError; end
+  end
+end

data/lib/uptime_monitor/browser_reader.rb

@@ -0,0 +1,41 @@
+module Hercules
+  module UptimeMonitor
+    class BrowserReader
+      attr_reader :browser
+      attr_reader :browser_name
+      def initialize(browser)
+        @browser = browser
+        @browser_name = eval
+      end
+      def headless
+        @browser[1] ? @browser[1][:headless] : false
+      end
+    private
+      #browser form
+      #["firefox", headless: true]
+      #["firefox", headless: false]
+      #["firefox"]
+      def read
+        message = "Invalid Browser: #{@browser.inspect}"
+        raise(Hercules::UptimeMonitor::InvalidBrowserForm.new(error: message), message) unless @browser.is_a? Array
+        raise(Hercules::UptimeMonitor::InvalidBrowserForm.new(error: message), message) unless @browser.first.is_a? String
+        if browser.length > 1
+          error_message = "Invalid setting for headless browser in #{@browser.inspect}"
+          raise(Hercules::UptimeMonitor::InvalidHeadlessForm.new(error: message), message) unless @browser[1].is_a? Hash
+          raise(Hercules::UptimeMonitor::InvalidHeadlessForm.new(error: message), message) unless [TrueClass, FalseClass].include? @browser[1][:headless].class
+        end
+      end
+      def eval
+        read
+        @browser.first
+      end
+    end
+  end
+end
+
+module Hercules
+  module UptimeMonitor
+    class InvalidBrowserForm < StandardError; end
+    class InvalidHeadlessForm < StandardError; end
+  end
+end

data/lib/uptime_monitor/uptime_monitor.rb

@@ -0,0 +1,62 @@
+module Ragios
+  module Plugin
+    class UptimeMonitor
+      attr_reader :monitor
+      attr_reader :test_result
+      attr_reader :success
+
+      def initialize
+        @test_result = ActiveSupport::OrderedHash.new
+      end
+
+      def init(monitor)
+        @monitor = OpenStruct.new(monitor)
+        message = "A url must be provided for uptime_monitor: #{@monitor.monitor}"
+        raise(Hercules::UptimeMonitor::NoUrlProvided.new(error: message), message) if @monitor.url.nil?
+        message = "A browser must be provided for uptime_monitor: #{@monitor.monitor}"
+        raise(Hercules::UptimeMonitor::NoBrowserProvided.new(error: message), message) if @monitor.browser.nil?
+        message = "A validation (exists?) must be provided for uptime_monitor: #{@monitor.monitor}"
+        raise(Hercules::UptimeMonitor::NoValidationProvided.new(error: message), message) if @monitor.exists?.nil?
+      end
+
+      def test_command?
+        @success = true
+        browser_reader = Hercules::UptimeMonitor::BrowserReader.new(@monitor.browser)
+        start_browser(@monitor.url, browser_reader.browser_name, browser_reader.headless)
+        exists(@monitor.exists?)
+        close_browser
+        @success
+      rescue Exception => e
+        close_browser
+        raise e
+      end
+
+      def close_browser
+        @browser.close
+      end
+
+      def start_browser(url, browser_name, headless)
+        @browser = Hercules::UptimeMonitor::Browser.new(url, browser_name, headless)
+      end
+
+      def exists(page_elements)
+        page_elements.each do |page_element|
+          @browser.exists?(page_element) ? result!(page_element, true) : result!(page_element, false)
+        end
+      end
+
+      def result!(page_element, state)
+        @success = state
+        result = state ? {page_element => :exists_as_expected} : {page_element => :does_not_exist_as_expected}
+        @test_result.merge!(result)
+      end
+    end
+  end
+end
+module Hercules
+  module UptimeMonitor
+    class NoUrlProvided < StandardError; end
+    class NoValidationProvided < StandardError; end
+    class NoBrowserProvided < StandardError; end
+  end
+end

data/spec/browser_reader_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+describe Hercules::UptimeMonitor::BrowserReader do
+  before(:each) do
+    @browser = "safari"
+  end
+  it "reads a browser with no headless option" do
+    reader = Hercules::UptimeMonitor::BrowserReader.new([@browser])
+    reader.browser_name.should == @browser
+    reader.headless.should == false
+  end
+  it "reads a browser with headless false" do
+    browser = [@browser, headless: false]
+    reader = Hercules::UptimeMonitor::BrowserReader.new(browser)
+    reader.browser_name.should == @browser
+    reader.headless.should == false
+  end
+  it "reads a browser with headless true" do
+    browser = [@browser, headless: true]
+    reader = Hercules::UptimeMonitor::BrowserReader.new(browser)
+    reader.browser_name.should == @browser
+    reader.headless.should == true
+  end
+  it "cannot read a browser in wrong form" do
+    browser = 1
+    expect{Hercules::UptimeMonitor::BrowserReader.new(browser)}.to raise_error(Hercules::UptimeMonitor::InvalidBrowserForm)
+    browser = [1]
+    expect{Hercules::UptimeMonitor::BrowserReader.new(browser)}.to raise_error(Hercules::UptimeMonitor::InvalidBrowserForm)
+    browser = [@browser, 1]
+    expect{Hercules::UptimeMonitor::BrowserReader.new(browser)}.to raise_error(Hercules::UptimeMonitor::InvalidHeadlessForm)
+    browser = [@browser, something: :wrong]
+    expect{Hercules::UptimeMonitor::BrowserReader.new(browser)}.to raise_error(Hercules::UptimeMonitor::InvalidHeadlessForm)
+    browser = [@browser, something: true]
+    expect{Hercules::UptimeMonitor::BrowserReader.new(browser)}.to raise_error(Hercules::UptimeMonitor::InvalidHeadlessForm)
+    browser = [@browser, headless: "true"]
+    expect{Hercules::UptimeMonitor::BrowserReader.new(browser)}.to raise_error(Hercules::UptimeMonitor::InvalidHeadlessForm)
+    browser = [@browser, "headless" => true]
+    expect{Hercules::UptimeMonitor::BrowserReader.new(browser)}.to raise_error(Hercules::UptimeMonitor::InvalidHeadlessForm)
+  end
+end

data/spec/browser_spec.rb

@@ -0,0 +1,170 @@
+require 'spec_helper'
+
+describe Hercules::UptimeMonitor::Browser do
+  before(:all) do
+    url= "http://obi-akubue.org"
+    headless = true
+    browser_name = "firefox"
+    @browser = Hercules::UptimeMonitor::Browser.new(url, browser_name, headless)
+  end
+  it "can wait until a page element exists" do
+    @browser.apply_wait_until?([:title]).should == true
+  end
+  it "times out if the page element never exists after 30 secs" do
+    @browser.apply_wait_until?([{text_field: {id: "abc_dont_exist"}}]).should == false
+  end
+
+  it "can apply an action" do
+    element = @browser.get_element({text_field: {id: "s"}})
+    element.exists?.should ==  true
+    @browser.apply_action?(element, {set: "github"}).should ==  true
+    element = @browser.get_element({button: {id: "searchsubmit"}})
+    element.exists?.should ==  true
+    @browser.apply_action?(element, :click).should ==  true
+    element = @browser.get_element({link: {text:"Obi Akubue"}})
+    element.exists?.should == true
+    @browser.apply_action?(element, :click).should ==  true
+  end
+  it "cannot apply an action with unknown element" do
+    element = @browser.get_element({text_field: {id: "abc_dont_exist"}})
+    expect{@browser.apply_action?(element, {set: "github"})}.to raise_error(Watir::Exception::UnknownObjectException)
+  end
+  it "cannot apply an action on element that can't respond to it " do
+    element = @browser.get_element({button: {id: "searchsubmit"}})
+    element.exists?.should ==  true
+    expect{@browser.apply_action?(element, {set: "github"})}.to raise_error
+  end
+  it "cannot apply action in wrong form" do
+    element = @browser.get_element({text_field: {id: "s"}})
+    element.exists?.should ==  true
+    expect{@browser.apply_action?(element, "wrong form action")}.to raise_error(Hercules::UptimeMonitor::InvalidAction)
+  end
+  it "returns true for matching text form" do
+   @browser.apply_text?("hello world", {text: "hello world"}).should == true
+  end
+  it "returns false for non-matching text form" do
+   @browser.apply_text?("hello world", {text: "something else"}).should == false
+  end
+  it "returns true for matching includes_text form" do
+   @browser.apply_text?("hello world", {includes_text: "hello"}).should == true
+  end
+   it "returns false for non-matching includes_text form" do
+   @browser.apply_text?("hello world", {includes_text: "something else"}).should == false
+  end
+  it "cannot match unknown text form" do
+    expect{@browser.apply_text?("hello world", {something_else: "something else"})}.to raise_error(Hercules::UptimeMonitor::InvalidText)
+  end
+  it "can detect correct wait_until form" do
+    @browser.is_wait_until?({wait_until_exists?: :anything}).should == true
+  end
+  it "can detect incorrect wait_until form" do
+    @browser.is_wait_until?({something_else: :anything}).should == false
+    @browser.is_wait_until?("something_else").should == false
+  end
+  it "can detect a valid action form" do
+    @browser.is_an_action?([set: "admin"]).should == true
+    @browser.is_an_action?([:click]).should == true
+  end
+  it "can detect invalid action form" do
+    @browser.is_an_action?("something_else").should == false
+    @browser.is_an_action?(["something_else"]).should == false
+  end
+  it "can detect valid text form" do
+    @browser.is_a_text?([{text: "hello world"}]).should == true
+    @browser.is_a_text?([{includes_text: "hello world"}]).should == true
+  end
+  it "can detect invalid text form" do
+    @browser.is_a_text?("something_else").should == false
+    @browser.is_a_text?(["something_else"]).should == false
+    @browser.is_a_text?([{"something_else"=> :anything}]).should == false
+    @browser.is_a_text?([{something_else: :anything}]).should == false
+    @browser.is_a_text?([{text: :anything}]).should == false
+  end
+  it "can apply rest to text form" do
+    @browser.apply_rest?("hello world",[{text: "hello world"}]).should == true
+  end
+  it "can apply rest to action form" do
+    element = @browser.get_element({text_field: {id: "s"}})
+    element.exists?.should ==  true
+    @browser.apply_rest?(element,[{set: "github"}]).should == true
+  end
+  it "cannot apply rest for unknown form" do
+    expect{@browser.apply_rest?(:element,:something_else)}.to raise_error(Hercules::UptimeMonitor::InvalidRest)
+  end
+  it "returns true when all expressions are true for rest exists" do
+    element = @browser.get_element(:title)
+    element.exists?.should ==  true
+    @browser.rest_exists?(element, [[{text: "Obi Akubue"}],[{includes_text: "Akubue"}]]).should == true
+  end
+  it "returns false when any expression is false for rest exists" do
+    element = @browser.get_element(:title)
+    element.exists?.should ==  true
+    @browser.rest_exists?(element, [[{text: "Obi Akubue"}],[{includes_text: "something_else"}]]).should == false
+  end
+  it "returns an element from symbol" do
+    element = @browser.get_element(:div)
+    element.exists?.should ==  true
+  end
+  it "returns an element from hash with element and attributes" do
+    element = @browser.get_element({a: {href:"http://obi-akubue.org/?feed=rss", id: "rss-link"}})
+    element.exists?.should ==  true
+  end
+  it "returns false for an element doesn't exist" do
+    element = @browser.get_element({div: {class: "something_else", id: "something_else"}})
+    element.exists?.should ==  false
+  end
+  it "cannot check an element exists using unusual attributes unless its a css query" do
+    element = @browser.get_element({div: {unusual_attribute: "something_else", id: "something_else"}})
+    expect{element.exists?}.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+  end
+  it "can check an element exists using unusual attributes with css query" do
+    element = @browser.get_element({element: {css: '[data-name="message"]'}})
+    element.exists?.should ==  false
+    element = @browser.get_element({element: {css: '[something_else="something_else"]'}})
+    element.exists?.should ==  false
+  end
+  it "can use css query to check an element exists" do
+    element = @browser.get_element({element: {css: '#rss-link'}})
+    element.exists?.should ==  true
+  end
+  it "cannot check if an element exists if element has incorrect form" do
+    expect{@browser.get_element("something_else")}.to raise_error(Hercules::UptimeMonitor::InvalidPageElement)
+  end
+  it "can check if a symbol form page element exists" do
+    @browser.page_element_exists?([:title]).should == true
+  end
+  it "can check if an array form page element exists" do
+    @browser.page_element_exists?([{a: {href:"http://obi-akubue.org/?feed=rss", id: "rss-link"}}]).should == true
+  end
+  it "can check if element exists with rest options in text and/or action form and applies any action form" do
+    element = {link: {text:"Obi Akubue"}}, [:click], [text: "Obi Akubue"], [includes_text: "Obi"], [:click]
+    @browser.page_element_exists?(element).should == true
+    element = {link: {text:"something_else"}}, [:click], [text: "Obi Akubue"], [includes_text: "Obi"], [:click]
+    @browser.page_element_exists?(element).should == false
+    element = {link: {text:"Obi Akubue"}}, [text: "something_else"], [includes_text: "Obi"], [:click]
+    @browser.page_element_exists?(element).should == false
+    element = {link: {text:"Obi Akubue"}}, [:click], [text: "Obi Akubue"], [includes_text: "something_else"], [:click]
+    @browser.page_element_exists?(element).should == false
+  end
+  it "cannot check if page_element_exists if first is in wrong form" do
+   element = [{div: {unusual_attribute: "something_else", id: "something_else"}}]
+   expect{@browser.page_element_exists?(element)}.to raise_error(Hercules::UptimeMonitor::UnknownPageElement)
+  end
+  it "can check if page_element_exists" do
+    @browser.exists?([{text_field: {id: "s"}}]).should == true
+    @browser.exists?([{wait_until_exists?: [{text_field: {id: "s"}}]}]).should == true
+    @browser.exists?([{text_field: {id: "something_else"}}]).should == false
+    #returns false if element doesn't exist after waiting for 30 seconds
+    @browser.exists?([{wait_until_exists?: [{text_field: {id: "something_else"}}]}]).should == false
+  end
+  it "cannot check if page_element_exists when in a wrong form" do
+    expect{@browser.exists?("something_else")}.to raise_error(Hercules::UptimeMonitor::InvalidPageElementForm)
+  end
+  it "returns the cdr of an array" do
+    @browser.rest((1..5).to_a).should == (2..5).to_a
+  end
+
+  after(:all) do
+    @browser.close
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'rubygems'
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib/uptime_monitor'))

data/spec/uptime_monitor_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+
+describe Ragios::Plugin::UptimeMonitor do
+  before(:each) do
+    @uptime_monitor = Ragios::Plugin::UptimeMonitor.new
+  end
+  it "sets the correct test result for success" do
+    @uptime_monitor.result!("page_element", state = true)
+    @uptime_monitor.test_result.should == {"page_element" => :exists_as_expected}
+    @uptime_monitor.success.should == true
+  end
+  it "sets the correct test result for failure" do
+    @uptime_monitor.result!(:page_element, state = false)
+    @uptime_monitor.test_result.should == {:page_element => :does_not_exist_as_expected}
+    @uptime_monitor.success.should == false
+  end
+  it "must include a url" do
+    monitor = {exists?: :exists, browser: :browser}
+    expect{@uptime_monitor.init(monitor)}.to raise_error(Hercules::UptimeMonitor::NoUrlProvided)
+  end
+  it "must include a browser" do
+    monitor = {exists?: :exists, url: :url}
+    expect{@uptime_monitor.init(monitor)}.to raise_error(Hercules::UptimeMonitor::NoBrowserProvided)
+  end
+  it "must include a validation" do
+    monitor = {browser: :browser, url: :url}
+    expect{@uptime_monitor.init(monitor)}.to raise_error(Hercules::UptimeMonitor::NoValidationProvided)
+  end
+  it "returns true if page element exists" do
+    monitor = {browser: :browser, exists?: :exists, url: :url}
+    @uptime_monitor.init(monitor)
+    @uptime_monitor.start_browser("http://obi-akubue.org","firefox", headless = true)
+    page_element = [:title]
+    @uptime_monitor.exists([page_element])
+    @uptime_monitor.test_result.should == {page_element => :exists_as_expected}
+    @uptime_monitor.success.should == true
+    @uptime_monitor.close_browser
+  end
+  it "returns false if page element don't exists" do
+    monitor = {browser: :browser, exists?: :exists, url: :url}
+    @uptime_monitor.init(monitor)
+    @uptime_monitor.start_browser("http://obi-akubue.org","firefox", headless = true)
+    page_element = [:title, [text: "dont_exist"]]
+    @uptime_monitor.exists([page_element])
+    @uptime_monitor.test_result.should == {page_element => :does_not_exist_as_expected}
+    @uptime_monitor.success.should == false
+    @uptime_monitor.close_browser
+  end
+  it "runs a test that passes" do
+    page_element = [:title]
+    monitor = {url: "http://obi-akubue.org",
+                browser: ["firefox", headless: true],
+                exists?: [page_element]
+              }
+    @uptime_monitor.init(monitor)
+    @uptime_monitor.test_command?.should == true
+    @uptime_monitor.test_result.should == {page_element => :exists_as_expected}
+  end
+  it "runs a test that fails" do
+    page_element = [:title, [text: "dont_exist"]]
+    monitor = {url: "http://obi-akubue.org",
+                browser: ["firefox", headless: true],
+                exists?: [page_element]
+              }
+    @uptime_monitor.init(monitor)
+    @uptime_monitor.test_command?.should == false
+    @uptime_monitor.test_result.should == {page_element => :does_not_exist_as_expected}
+  end
+end

metadata

@@ -0,0 +1,210 @@
+--- !ruby/object:Gem::Specification
+name: uptime_monitor
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- obi-a
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: headless
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: watir-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: watir-webdriver-performance
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Uses a real web browser to monitor a web app for uptime
+email: obioraakubue@yahoo.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+files:
+- .document
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- lib/uptime_monitor.rb
+- lib/uptime_monitor/browser.rb
+- lib/uptime_monitor/browser_reader.rb
+- lib/uptime_monitor/uptime_monitor.rb
+- spec/browser_reader_spec.rb
+- spec/browser_spec.rb
+- spec/spec_helper.rb
+- spec/uptime_monitor_spec.rb
+homepage: http://github.com/obi-a/uptime_monitor
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -845472848363939348
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Real browser website uptime monitoring plugin for Ragios
+test_files: []