rybellion 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 55c62f827e200417ea0463a7f8be0b842d3e1ce4
+  data.tar.gz: c69364f87d705a465b2ae8be5bf981b9b2aba2fc
+SHA512:
+  metadata.gz: abb9c208a4739fdbd11d47f5efa84cf51f682f4bb971239db8967324b768cbd1dbaa6345bb0d7145c0ab0f0d038ee8b94a1aaea2a2cdeac1ce123f6d763ab86c
+  data.tar.gz: 1425dbfd1d3e077a9fe349ac371c034e6851df94fdd8ac3d71007f7a5e4ef77668c1675245b38a5656cb486952807552535a91b05c5de99b860551f909423810

data/lib/core/CommonSteps.rb

@@ -0,0 +1,138 @@
+require_relative './TestEngine'
+
+## ------------------------------------------------------
+##  Given steps definition
+## ------------------------------------------------------
+
+Given "User has [$page_name] page open" do |page_name|
+	page = TestEngine.FindPage(page_name)
+ 	page.Go()
+end
+
+## ------------------------------------------------------
+##  When steps definition
+## ------------------------------------------------------
+
+When "User enters '$value' to the [$element_name]" do |value, element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.SendKeys(value)
+end
+
+When "User clicks the [$element_name]" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.Click
+end
+
+When "User selects the [$element_name]" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.Click
+end
+
+When "User selects '$value' on the [$element_name]" do |value, element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.SelectItem(value)
+end
+
+When "User checks the [$element_name]" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.Check
+end
+
+When "User unchecks the [$element_name]" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.Uncheck
+end
+
+## ------------------------------------------------------
+##  Then steps definition
+## ------------------------------------------------------
+
+Then "The browser shows [$page_name] page" do |page_name|
+	page = TestEngine.FindPage(page_name)
+	page.VerifyURL
+end
+
+Then "The [$element_name] exists" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.Exists
+end
+
+Then "The [$element_name] does not exist" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.NotExists
+end
+
+Then "The [$element_name] value is empty" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIsEmpty
+end
+
+Then "The [$element_name] value is not empty" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIsNotEmpty
+end
+
+Then "The [$element_name] value is '$value'" do |element_name, value|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIs(value)
+end
+
+Then "The [$element_name] value is not '$value'" do |element_name, value|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIsNot(value)
+end
+
+Then "The [$element_name] value contains '$value'" do |element_name, value|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueContains(value)
+end
+
+Then "The [$element_name] value is more than '$value'" do |element_name, value|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIsMoreThan(value)
+end
+
+Then "The [$element_name] value is more than or equal '$value'" do |element_name, value|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIsMoreThanOrEqual(value)
+end
+
+Then "The [$element_name] value is less than '$value'" do |element_name, value|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIsLessThan(value)
+end
+
+Then "The [$element_name] value is less than or equal '$value'" do |element_name, value|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIsLessThanOrEqual(value)
+end
+
+Then "The [$element_name] value is between '$value1' and '$value2'" do |element_name, value1, value2|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.ValueIsBetween(value1, value2)
+end
+
+Then "The [$element_name] has item '$value'" do |element_name, value|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.HasItem(value)
+end
+
+Then "The [$element_name] is selected" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.IsSelected
+end
+
+Then "The [$element_name] is not selected" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.IsNotSelected
+end
+
+Then "The [$element_name] is checked" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.IsChecked
+end
+
+Then "The [$element_name] is unchecked" do |element_name|
+	element = TestEngine.CurrentPage.FindElement(element_name)
+	element.IsUnchecked
+end

data/lib/core/PageObject.rb

@@ -0,0 +1,383 @@
+require 'uri'
+require 'yaml'
+require 'watir-webdriver'
+
+require 'timeout'
+
+require_relative './TestLogger'
+
+class Element
+	attr_accessor :name, :xpath
+
+	def initialize(page, object)
+		@page = page
+		@name = object['name']
+		@xpath = object['xpath']
+	end
+
+	##
+	## Basic element properties
+	##
+
+	def get
+		return @page.browser.element(:xpath => @xpath)
+	end
+
+	def value
+		element = self.get
+		
+		if element.tag_name == 'select'
+			select = self.get_select
+
+			text = []
+			for option in select.selected_options
+				text << option.text
+			end
+
+			return text.join('\n')
+		elsif ['input', 'button'].include? element.tag_name
+			return element.value
+		else
+			return element.text
+		end
+	end
+
+	def exists
+		element = self.get
+		
+		if element.exists?
+			return true
+		else
+			return false
+		end
+	end
+
+	def enabled
+		return false
+	end
+
+	def get_checkbox
+		element = self.get
+
+		if element.tag_name == 'input' and element.attribute_value('type') == 'checkbox'
+			checkbox = @page.browser.checkbox(:xpath => @xpath)
+			return checkbox
+		end
+
+		Log.Failed("The element '#{@name}' is not type 'checkbox'\n")
+		return nil
+	end
+
+	def get_radio
+		element = self.get
+
+		if element.tag_name == 'input' and element.attribute_value('type') == 'radio'
+			radio = @page.browser.radio(:xpath => @xpath)
+			return radio
+		end
+
+		Log.Failed("The element '#{@name}' is not type 'radio'\n")
+		return nil
+	end
+
+	def get_select
+		element = self.get
+
+		if element.tag_name == 'select'
+			select = @page.browser.select_list(:xpath => @xpath)
+			return select
+		end
+
+		Log.Failed("The element '#{@name}' is not type 'select'\n")
+		return nil
+	end
+
+	##
+	## Action methods
+	##
+
+	def SendKeys(value)
+		element = self.get
+		element.send_keys(value)
+		return true
+	end
+
+	def Click()
+		element = self.get
+		element.click
+		return true
+	end
+
+	#def Select() ## for radio button
+	#	radio = self.get_radio
+	#	radio.set
+	#	return true
+	#end
+
+	def SelectItem(value) ## for select list
+		select = self.get_select
+		select.select(value)
+		return true
+	end
+
+	def Check()
+		checkbox = self.get_checkbox
+		checkbox.set
+		return true
+	end
+
+	def Uncheck()
+		checkbox = self.get_checkbox
+		checkbox.clear
+		return true
+	end
+
+	##
+	## Verification methods will raise error if failed, don't use for check condition logic
+	##
+
+	def Exists()
+		if self.exists
+			return true
+		end
+
+		Log.Failed("Value not matched", '<not exists>', '<exists>')
+		return false
+	end
+
+	def NotExists()
+		if not self.exists
+			return true
+		end
+
+		Log.Failed("Value not matched", '<exists>', '<not exists>')
+		return false
+	end
+
+	def ValueIsEmpty()
+		if self.value == ''
+			return true
+		end
+
+		Log.Failed("Value not matched", self.value, '<empty>')
+		return false
+	end
+
+	def ValueIsNotEmpty()
+		if self.value != ''
+			return true
+		end
+
+		Log.Failed("Value not matched", '<empty>', '<not empty>')
+		return false
+	end
+
+	def ValueIs(value)
+		if self.value == value
+			return true
+		end
+
+		Log.Failed("Value not matched", self.value, value)
+		return false
+	end
+
+	def ValueIsNot(value)
+		if self.value != value
+			return true
+		end
+
+		Log.Failed("Value not matched", self.value, value)
+		return false
+	end
+
+	def ValueContains(value)
+		if self.value.include? value
+			return true
+		end
+
+		Log.Failed("Value not matched", self.value, value)
+		return false
+	end
+
+	def ValueIsMoreThan(value)
+		if self.value > value
+			return true
+		end
+
+		Log.Failed("Value not matched", self.value, "( x > #{value} )")
+		return false
+	end
+
+	def ValueIsMoreThanOrEqual(value)
+		if self.value >= value
+			return true
+		end
+
+		Log.Failed("Value not matched", self.value, "( x >= #{value} )")
+		return false
+	end
+
+	def ValueIsLessThan(value)
+		if self.value < value
+			return true
+		end
+
+		Log.Failed("Value not matched", self.value, "( x < #{value} )")
+		return false
+	end
+
+	def ValueIsLessThanOrEqual(value)
+		if self.value <= value
+			return true
+		end
+
+		Log.Failed("Value not matched", self.value, "( x <= #{value} )")
+		return false
+	end
+
+	def ValueIsBetween(value1, value2)
+		if value1 < value2
+			if self.value >= value1 and self.value <= value2
+				return true
+			end
+		else
+			if self.value <= value1 and self.value >= value2
+				return true
+			end
+		end
+
+		Log.Failed("Value not matched", self.value, " x in (#{value1} - #{value2})")
+		return false
+	end
+
+	def HasItem(value)
+		select = self.get_select
+
+		options = []
+		for option in select.options
+			options << option.text
+		end
+
+		if options.include? value
+			return true
+		end
+
+		Log.Failed("Item not found in list", "\n\t" + options.join("\n\t"), value)
+		return false
+	end
+
+	def IsSelected()
+		radio = self.get_radio
+
+		if radio.set?
+			return true
+		end
+
+		Log.Failed("Value not matched", '<not selected>', '<selected>')
+		return false
+	end
+
+	def IsNotSelected()
+		radio = self.get_radio
+
+		if not radio.set?
+			return true
+		end
+
+		Log.Failed("Value not matched", '<selected>', '<not selected>')
+		return false
+	end
+
+	def IsChecked()
+		checkbox = self.get_checkbox
+
+		if checkbox.set?
+			return true
+		end
+
+		Log.Failed("Value not matched", '<not checked>', '<checked>')
+		return false
+	end
+
+	def IsUnchecked()
+		checkbox = self.get_checkbox
+
+		if not checkbox.set?
+			return true
+		end
+
+		Log.Failed("Value not matched", 'checked>', '<unchecked>')
+		return false
+	end
+end
+
+
+class Page
+	attr_accessor :name, :url, :title, :elements, :browser
+
+	def initialize(browser, pageobject)
+		@browser = browser
+		@name = pageobject['page']['name']
+		@url = pageobject['page']['url']
+		@title = pageobject['page']['title']
+
+		@elements = Hash.new
+
+		if pageobject.key? 'elements'
+			for object in pageobject['elements']
+				element = Element.new(self, object)
+
+				if @elements.key? element.name
+					Log.Info "#{@name}\nDuplicate element name: '#{element.name}'"
+				else
+					@elements[element.name] = element
+				end
+			end
+		end
+	end
+
+	def Go()
+		begin
+			@browser.goto @url
+		rescue Timeout::Error
+			raise "Page load timeout\nURL: #{@url} (15 sec)\n"
+		end
+
+		return true
+	end
+
+	def FindElement(name)
+		if @elements.key? name
+			return @elements[name]
+		end
+
+		raise "Element not found in list: '#{name}'\n"
+		return nil
+	end
+
+	def VerifyTitle()
+		@browser.windows.last.use
+
+		if @title == @browser.title
+			return true
+		end
+
+		Log.Failed("Title not matched", @browser.title, @title)
+		return false
+	end
+	
+	def VerifyURL()
+		@browser.windows.last.use
+
+		uri = URI(@url)
+		url = "#{uri.scheme}://#{uri.host}#{uri.path}"
+		
+		begin
+			Watir::Wait.until(15) { browser.url.include? url }
+			return true
+		rescue
+			Log.Failed("URL not matched", @browser.url, url)
+			return false
+		end
+	end
+end

data/lib/core/TestEngine.rb

@@ -0,0 +1,59 @@
+require 'yaml'
+require 'watir-webdriver'
+
+require_relative './PageObject'
+
+
+module TestEngine
+
+	@@browser = nil
+	@@current_page = nil
+
+	@@pages = Hash.new
+
+	def self.OpenBrowser(browser="default")
+		if browser.downcase == 'chrome'
+			@@browser = Watir::Browser.new :chrome
+		elsif browser.downcase == 'firefox'
+			@@browser = Watir::Browser.new :firefox
+		else
+			@@browser = Watir::Browser.new
+		end
+	end
+
+	def self.CloseBrowser()
+		@@browser.close
+	end
+
+	def self.LoadPageDefinitions(path)
+		if not @@pages.empty?
+			return true
+		end
+
+		for filename in Dir.glob(path)
+			pageobject = YAML.load_file(filename)
+			page = Page.new(@@browser, pageobject)
+			
+			if @@pages.key? page.name
+				raise "Duplicate page name: '#{page.name}'\n"
+			else
+				@@pages[page.name] = page
+			end
+		end
+	end
+
+	def self.FindPage(name)
+		if @@pages.key? name
+			@@current_page = @@pages[name]
+			return @@current_page
+		end
+
+		raise "Page not found in list: '#{name}'\n"
+		return nil
+	end
+
+	def self.CurrentPage
+		return @@current_page
+	end
+
+end

data/lib/core/TestLogger.rb

@@ -0,0 +1,15 @@
+module Log
+	def self.Info(message)
+		puts message
+	end
+
+	def self.Failed(message, actual="---", expect="---")
+		details = message
+		
+		if actual != "---" and expect != "---"
+			details = "#{message}\nactual: '#{actual}'\nexpect: '#{expect}'\n"
+		end
+
+		raise details
+	end
+end

data/lib/rybellion.rb

@@ -0,0 +1,2 @@
+require "core/TestEngine"
+require "core/CommonSteps"

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: rybellion
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Peerapat Sungkasem
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-02 00:00:00.000000000 Z
+dependencies: []
+description: A tester-friendly web automated testing framework.
+email:
+- gigapixel7@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/core/CommonSteps.rb
+- lib/core/PageObject.rb
+- lib/core/TestEngine.rb
+- lib/core/TestLogger.rb
+- lib/rybellion.rb
+homepage: https://github.com/gigapixel/rybellion
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Initial version
+test_files: []