less-form 0.0.2

data/less-form.gemspec

@@ -0,0 +1,81 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "less-form"
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["easonhan"]
+  s.date = "2013-04-20"
+  s.description = "form element wrapper for selenium-webdriver, make your test code more readable and make your form element handing easy"
+  s.email = "nbkhic@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "chromedriver.log",
+    "lib/less-form.rb",
+    "lib/less-form/button.rb",
+    "lib/less-form/checkbox.rb",
+    "lib/less-form/element.rb",
+    "lib/less-form/errors.rb",
+    "lib/less-form/form.rb",
+    "lib/less-form/options.rb",
+    "lib/less-form/radio.rb",
+    "lib/less-form/select.rb",
+    "lib/less-form/table.rb",
+    "lib/less-form/text_field.rb",
+    "lib/webdriver-ext/element.rb",
+    "spec/html/form.html",
+    "spec/less-form_spec.rb",
+    "spec/spec_helper.rb",
+    "usage.rb"
+  ]
+  s.homepage = "https://github.com/easonhan007/less-form"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.16"
+  s.summary = "form element wrapper for selenium-webdriver"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<selenium-webdriver>, ["~> 2.31.0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.13.0"])
+      s.add_development_dependency(%q<selenium-webdriver>, ["~> 2.31.0"])
+    else
+      s.add_dependency(%q<selenium-webdriver>, ["~> 2.31.0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_dependency(%q<rspec>, ["~> 2.13.0"])
+      s.add_dependency(%q<selenium-webdriver>, ["~> 2.31.0"])
+    end
+  else
+    s.add_dependency(%q<selenium-webdriver>, ["~> 2.31.0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    s.add_dependency(%q<rspec>, ["~> 2.13.0"])
+    s.add_dependency(%q<selenium-webdriver>, ["~> 2.31.0"])
+  end
+end
+

data/lib/less-form.rb

@@ -0,0 +1,14 @@
+require 'selenium-webdriver'
+require 'webdriver-ext/element'
+require 'less-form/errors'
+require 'less-form/element'
+require 'less-form/text_field'
+require 'less-form/radio'
+require 'less-form/checkbox'
+require 'less-form/table'
+require 'less-form/select'
+require 'less-form/options'
+require 'less-form/button'
+require 'less-form/form'
+
+

data/lib/less-form/button.rb

@@ -0,0 +1,5 @@
+module LessForm
+	class Button < Element
+	end
+
+end #LessForm

data/lib/less-form/checkbox.rb

@@ -0,0 +1,17 @@
+module LessForm
+	class Checkbox < Radio
+
+		def set what
+			if what
+				(set?)? nil : @element.click
+			else
+				(set?)? @element.click : nil
+			end #if
+		end
+
+		def clear
+			set false
+		end	
+	end
+
+end #LessForm

data/lib/less-form/element.rb

@@ -0,0 +1,42 @@
+module LessForm
+	class Element 
+		attr_reader :element
+		def initialize wd_element
+			@element = wd_element		
+		end 
+
+		def valid_element? wd_element
+			raise InvalidWebDriverElementError unless wd_element.is_a?(Selenium::WebDriver::Element)
+		end
+
+		def set what=nil
+			@element.send_keys(what)
+		end
+
+		def click
+			@element.click
+		end
+
+		def text
+			@element.text
+		end
+
+		def displayed?
+			@element.displayed?
+		end
+
+		def flash
+			@element.flash
+		end
+
+		def method_missing m, *args, &blk
+			if @element.respond_to?(m)
+				@element.send m, *args, &blk
+			else
+				value = @element.attribute(m.to_s)
+				(value.nil?)? super : value
+			end #if
+		end 
+
+	end
+end #LessForm

data/lib/less-form/errors.rb

@@ -0,0 +1,5 @@
+module LessForm
+	class LessFormError < StandardError; end
+	class InvalidDriverError < LessFormError; end
+	class InvalidWebDriverElementError < LessFormError; end
+end #LessForm

data/lib/less-form/form.rb

@@ -0,0 +1,47 @@
+module LessForm
+	class Form
+		attr_reader :wd
+
+		def initialize wd
+			@wd ||= wd if valid_wd?(wd)
+		end 
+
+		def valid_wd?(wd)
+			raise InvalidDriverError unless wd.is_a?(Selenium::WebDriver::Driver)
+			true
+		end 
+
+		def text_field(how, what)
+			TextField.new(locate(how, what))
+		end 
+
+		def text_area(how, what)
+			TextArea.new(locate(how, what))
+		end 
+
+		def radio how, what
+			Radio.new locate(how, what)
+		end 
+
+		def table how, what
+			Table.new locate(how, what)
+		end
+
+		def checkbox how, what
+			Checkbox.new locate(how, what)
+		end
+
+		def select how, what
+			Select.new locate(how, what)
+		end
+
+		def button how, what
+			Button.new locate(how, what)
+		end
+		
+		def locate how, what
+			@wd.find_element(how ,what)
+		end
+
+	end 
+end #LessForm

data/lib/less-form/options.rb

@@ -0,0 +1,28 @@
+module LessForm
+	class Options 
+		def initialize select_element
+			@elements = select_element.find_elements(:css, 'option')
+		end			
+
+		def all
+			@elements.map {|e| e.text }
+		end
+		
+		def by_value value
+			Option.new @elements.detect {|e| e.attribute('value') == value}
+		end
+
+		def by_text text
+			Option.new @elements.detect {|e| e.text == text}
+		end
+
+		def selected
+			Option.new @elements.detect {|e| e.selected?}
+		end
+
+	end
+
+	class Option < Element
+	end
+
+end #LessForm

data/lib/less-form/radio.rb

@@ -0,0 +1,14 @@
+module LessForm
+	class Radio < Element
+		
+		def set?
+			@element.selected?
+		end	
+
+		def set
+			@element.click
+		end
+		
+	end
+
+end #LessForm

data/lib/less-form/select.rb

@@ -0,0 +1,30 @@
+module LessForm
+	class Select < Element
+		def initialize element
+			super 
+			@options = Options.new(element)
+		end	
+
+		def options
+			@options.all	
+		end	
+
+		def select_by_value(value)
+			@options.by_value(value).click
+		end
+
+		def select_by_text text
+			@options.by_text(text).click
+		end
+
+		def select text
+			select_by_text text
+		end
+
+		def selected
+			@options.selected
+		end
+		
+	end
+
+end #LessForm

data/lib/less-form/table.rb

@@ -0,0 +1,6 @@
+module LessForm
+	class Table < Element
+		
+	end
+
+end #LessForm

data/lib/less-form/text_field.rb

@@ -0,0 +1,8 @@
+module LessForm
+	class TextField < Element
+	end
+
+	class TextArea < TextField
+	end
+
+end #LessForm

data/lib/webdriver-ext/element.rb

@@ -0,0 +1,8 @@
+class Selenium::WebDriver::Element
+	def flash
+		high_light_script = 'arguments[0].style.border = "3px solid red"'
+		@bridge.executeScript(high_light_script, self)
+	end
+	alias_method :high_light, :flash
+end 
+

data/spec/html/form.html

@@ -0,0 +1,25 @@
+<html>
+	<head>
+		<title>form</title>
+	</head>
+	<body>
+		<form>
+			<input type="text" id="text_field" />
+			<hr />
+			<textarea rows="10" id="area"></textarea>
+			<hr />
+			<span>Radio1</span><input type="radio" id="radio1" />
+			<span>Radio2</span><input type="radio" id="radio2" />
+			<hr />
+			<span>Checkbox</span><input type="checkbox" id="checkbox" />
+			<hr />
+			<select id="select">
+				<option value="car">Car</option>
+				<option value="bus">Bus</option>
+				<option value="bike">Bike</option>
+			</select>
+			<br />
+			<input type="submit" value="submit" name="btn" />
+		</form>
+	</body>
+</html>

data/spec/less-form_spec.rb

@@ -0,0 +1,73 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe LessForm do
+	before :all do
+		@dr = Selenium::WebDriver.for :chrome
+		@dr.get html_path('form')
+	end
+
+	it 'should set value to text field' do
+		LessForm::Form.new(@dr).text_field(:id, 'text_field').set 'ok'
+		LessForm::Form.new(@dr).text_field(:id, 'text_field').value.should eq('ok')
+		@dr.find_element(id: 'text_field').attribute('value').should eq('ok')
+	end
+
+	it 'should set value to text area' do
+		LessForm::Form.new(@dr).text_area(:id, 'area').set 'ok'
+		LessForm::Form.new(@dr).text_area(:id, 'area').value.should eq('ok')
+		@dr.find_element(id: 'area').attribute('value').should eq('ok')
+	end
+
+	it 'should set raido' do
+		LessForm::Form.new(@dr).radio(:id, 'radio1').set  
+		LessForm::Form.new(@dr).radio(:id, 'radio1').should be_set
+		@dr.find_element(id: 'radio1').should be_selected
+	end
+
+	it 'should set checkbox' do
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').set true
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').should be_set
+		@dr.find_element(id: 'checkbox').should be_selected
+	end
+
+	it 'should clear checkbox' do
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').set true
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').should be_set
+		@dr.find_element(id: 'checkbox').should be_selected
+		
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').set false
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').should_not be_set
+		@dr.find_element(id: 'checkbox').should_not be_selected
+
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').set true
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').clear
+		LessForm::Form.new(@dr).checkbox(:id, 'checkbox').should_not be_set
+		@dr.find_element(id: 'checkbox').should_not be_selected
+	end
+
+	it 'should have correct selected item' do
+		LessForm::Form.new(@dr).select(:id, 'select').selected.value.should eq('car')
+		@dr.find_elements(css: 'option').detect {|e| e.selected?}.attribute('value').should eq('car')
+	end
+
+	it 'should select by value' do
+		select = LessForm::Form.new(@dr).select(:id, 'select')
+		select.select_by_value('bike')
+		select.selected.value.should eq('bike')
+		@dr.find_elements(css: 'option').detect {|e| e.selected?}.attribute('value').should eq('bike')
+	end
+
+	it 'should select by text' do
+		LessForm::Form.new(@dr).select(:id, 'select').select_by_text('Bus')
+		@dr.find_elements(css: 'option').detect {|e| e.selected?}.attribute('value').should eq('bus')
+	end
+
+	it 'should click button' do
+		LessForm::Form.new(@dr).button(:name, 'btn').click
+	end
+
+	after :all do
+		@dr.close
+	end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'less-form'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+
+	def html_path(file_name)  
+		'file:///' + File.expand_path(File.join('.', 'spec', 'html', "#{file_name}.html"))
+	end
+
+end