selenium_plus 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YjE1MThkNTIwYzVlOGM4YTA4NzAwZWM0NGU5ZGQxODEyNDMxNmFjMw==
+  data.tar.gz: !binary |-
+    YWVkZjU0ODMxNmY4MjBhYjExNjExNjQ2ZDJlMGJlOWNmMTM1MjgyMA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    Y2JmNmVkYjAwM2Q1NTBmOGMyYTk3ZGFkZTAzMTAxMDQ0NWZlOGU5YmM0NjAy
+    ZDY4OWFiNWYwZWUyZTFjMjkzYjBkNzZmMzYzYmM4YjU3Nzc0M2E3ODI5NGRl
+    M2U4NTU5OWVjY2E4NTRjMjdiZjg2YjRlMzIyZDkyMjlmMjhhYjQ=
+  data.tar.gz: !binary |-
+    NDc4N2Q0NGQ2ZDVlYTI3MTQzZjdjZDIwMmU1MzQ2MDFlMjg5ZjUyYmNkZWZm
+    ZTM0ZTBmYjU1YjBjZjk2YTkyZDA3OWQ4MTliMjUyNDhiZGMxNjU5ZmE4YWQy
+    NzBiMmU5NGRmMjBlZWFiNzlkYzM2ZWQ5N2E2MzJiYWEwZjkwYWE=

data/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+Gemfile.lock
+.idea/
+.yardoc/
+.rvmrc
+chromedriver.log

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'bundler', '>= 1.2.0'
+
+# Specify your gem's dependencies in selenium_plus.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Shipu Yao
+
+MIT License
+
+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,29 @@
+# SeleniumPlus
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'selenium_plus'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install selenium_plus
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/selenium_plus/driver.rb

@@ -0,0 +1,71 @@
+module SeleniumPlus
+  class Driver
+
+    DEFAULT_OPTIONS = { :browser => :firefox }
+
+    attr_reader :browser, :options
+
+    def initialize(options={})
+      @browser = nil
+      @exit_status = nil
+      @options = DEFAULT_OPTIONS.merge(options)
+    end
+
+    def browser
+      unless @browser
+        @browser = Selenium::WebDriver.for(options[:browser])
+        main = Process.pid
+        at_exit do
+          # Store the exit status of the test run since it goes away after calling the at_exit proc...
+          @exit_status = $!.status if $!.is_a?(SystemExit)
+          quit if Process.pid == main
+          exit @exit_status if @exit_status # Force exit with stored status
+        end
+      end
+      @browser
+    end
+
+    def visit(url)
+      browser.navigate.to(url)
+    end
+
+    def find(*args)
+      browser.find_element(*args)
+    end
+
+    def all(*args)
+      browser.find_elements(*args)
+    end
+
+    def execute_script(script)
+      browser.execute_script script
+    end
+
+    def evaluate_script(script)
+      browser.execute_script "return #{script}"
+    end
+
+    def save_screenshot(path, options={})
+      browser.save_screenshot(path)
+    end
+
+    def reset!
+      # Use instance variable directly so we avoid starting the browser just to reset the session
+      if @browser
+        begin @browser.manage.delete_all_cookies
+        rescue Selenium::WebDriver::Error::UnhandledError
+          # delete_all_cookies fails when we've previously gone
+          # to about:blank, so we rescue this error and do nothing
+          # instead.
+        end
+        @browser.navigate.to('about:blank')
+      end
+    end
+
+    def quit
+      @browser.quit
+    rescue Errno::ECONNREFUSED
+      # Browser must have already gone
+    end
+  end
+end

data/lib/selenium_plus/page_obj/container.rb

@@ -0,0 +1,75 @@
+module SeleniumPlus
+  module Container
+
+    # Public: Define a new method with the name of the symbol after locator returns element
+    # and highlight element
+    #
+    # Example
+    #   element(:username_tb, 'username')
+    #
+    # Returns element
+    def element(element_name, *find_args)
+      define_method(element_name.to_sym) do
+        driver.find(*find_args)
+      end
+      add_existence_checker(element_name, *find_args)
+      private element_name
+    end
+
+    # Public: Define a new method with the name of the symbol after locator returns elements
+    #
+    # Example
+    #   elements(:aria_message_div, xpath: "//div[@id='ariaErrors']//li")
+    #   # => <Capybara::Elements>
+    #
+    # Returns elements
+    def elements(element_name, *find_args)
+      define_method(:define_method, element_name) do
+        driver.all(*find_args)
+      end
+      private element_name
+    end
+
+    # Public: Define Partial section of the page
+    #
+    # Returns page object
+    def section(section_name, section_class, *find_args)
+      send(:define_method, section_name) do
+        section_class.new(driver, driver.find(*find_args))
+      end
+    end
+
+    # Public: Add element name into list
+    #
+    # Returns nothing
+    def add_element_name(element_name)
+      @element_names ||= []
+      @element_names << element_name
+    end
+
+    # Public: Element names in the page object
+    #
+    # return element names array
+    def element_names
+      @element_names
+    end
+
+    private
+    # Define an existence check method
+    # This method tries to find all elements by given locator with no wait time
+    # please make sure your page/section is fully loaded before use this method
+    #
+    # Example
+    #   login_page.has_username_tb?
+    #   # => true
+    #
+    # Returns
+    def add_existence_checker(element_name, *find_args)
+      method_name = "has_#{element_name}?"
+      define_method(method_name.to_sym) do
+        all(*find_args).size > 0
+      end
+    end
+  end
+end
+

data/lib/selenium_plus/page_obj/page.rb

@@ -0,0 +1,15 @@
+module SeleniumPlus
+  class Page
+    extend Container
+
+    attr_reader :driver
+
+    def initialize(driver)
+      @driver = driver
+    end
+
+    def visit(url)
+      driver.visit(url)
+    end
+  end
+end

data/lib/selenium_plus/page_obj/section.rb

@@ -0,0 +1,21 @@
+module SeleniumPlus
+  class Section
+    extend Container
+
+    attr_reader :driver, :root_element
+
+    def initialize(driver, root_element)
+      @driver = driver
+      @root_element = root_element
+    end
+
+    private
+    def find(*args)
+      root_element.find(*args)
+    end
+
+    def all(*args)
+      root_element.all(*args)
+    end
+  end
+end

data/lib/selenium_plus/page_obj/site.rb

@@ -0,0 +1,9 @@
+module SeleniumPlus
+  class Site
+    attr_reader :driver
+
+    def initialize
+      @driver = SeleniumPlus.using_driver
+    end
+  end
+end

data/lib/selenium_plus/selenium/element.rb

@@ -0,0 +1,52 @@
+# Public: Add extension method to Element class
+#
+class Selenium::WebDriver::Element
+  include SeleniumPlus::Elements::Table
+
+  def [](name)
+    self.attribute(name.to_s)
+  rescue Selenium::WebDriver::Error::WebDriverError
+    nil
+  end
+
+  def set(value)
+    tag_name = self.tag_name
+    type = self[:type]
+    if (Array === value) && !self[:multiple]
+      raise ArgumentError.new "Value cannot be an Array when 'multiple' attribute is not present. Not a #{value.class}"
+    end
+    if tag_name == 'input' and type == 'radio'
+      click
+    elsif tag_name == 'input' and type == 'checkbox'
+      click if value ^ native.attribute('checked').to_s.eql?("true")
+    elsif tag_name == 'input' and type == 'file'
+      path_names = value.to_s.empty? ? [] : value
+      self.send_keys(*path_names)
+    elsif tag_name == 'textarea' or tag_name == 'input'
+      self.send_keys(value.to_s)
+    end
+  end
+
+  # Public: type text into text field
+  #
+  # Example
+  #   element.type_text("hello")
+  #
+  # Returns nothing
+  def type(value)
+    self.clear
+    self.set(value)
+  end
+
+  # Public: append text into text field
+  #
+  # Example
+  #   element.append_text("hello")
+  #
+  # Returns nothing
+  def append(value)
+    old = self.value
+    self.set(old + value)
+  end
+
+end

data/lib/selenium_plus/selenium/table.rb

@@ -0,0 +1,10 @@
+module SeleniumPlus
+  module Elements
+    module Table
+      def raw
+        # ToDO
+      end
+    end
+
+  end
+end

data/lib/selenium_plus/version.rb

@@ -0,0 +1,3 @@
+module SeleniumPlus
+  VERSION = '0.0.1'
+end

data/lib/selenium_plus.rb

@@ -0,0 +1,49 @@
+require 'selenium-webdriver'
+
+require 'selenium_plus/version'
+require 'selenium_plus/driver'
+require 'selenium_plus/page_obj/site'
+require 'selenium_plus/page_obj/container'
+require 'selenium_plus/page_obj/page'
+require 'selenium_plus/page_obj/section'
+require 'selenium_plus/selenium/table'
+require 'selenium_plus/selenium/element'
+
+module SeleniumPlus
+  class SeleniumPlusError < StandardError; end
+  class DriverNotFoundError < SeleniumPlusError; end
+
+  class << self
+    attr_accessor :default_driver, :current_driver, :default_wait_time, :driver
+
+    def configure
+      yield self
+    end
+
+    def register_driver(name, &block)
+      drivers[name] = block
+    end
+
+    def drivers
+      @drivers ||= {}
+    end
+
+    def current_driver
+      @current_driver || default_driver
+    end
+
+    def using_driver
+      drivers[current_driver].call
+    end
+  end
+
+end
+
+SeleniumPlus.configure do |config|
+  config.default_wait_time =10
+  config.default_driver = :firefox
+end
+
+SeleniumPlus.register_driver :firefox do
+  SeleniumPlus::Driver.new(:browser => :firefox)
+end

data/selenium_plus.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'selenium_plus/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'selenium_plus'
+  gem.version       = SeleniumPlus::VERSION
+  gem.authors       = ['Spark Yao']
+  gem.email         = %w(shipuyao@gmail.com)
+  gem.description   = ''
+  gem.summary       = ''
+  gem.homepage      = ''
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = %w(lib)
+
+  gem.add_dependency('rake')
+  gem.add_dependency('selenium-webdriver', ['>= 2.25.0'])
+  gem.add_dependency('rspec', ['>= 2.1.0'])
+  gem.add_development_dependency('cucumber', ['>= 1.2.1'])
+end

data/test_project/test_project.rb

@@ -0,0 +1,21 @@
+$:.unshift(File.dirname(__FILE__))
+require 'selenium_plus'
+require 'rspec'
+require 'test_site/test_site'
+
+SeleniumPlus.register_driver :chrome do
+  SeleniumPlus::Driver.new(:browser => :chrome)
+end
+#
+SeleniumPlus.current_driver = :chrome
+
+driver = SeleniumPlus.using_driver
+driver.visit('http://www.google.com.hk')
+driver.find(:id,'lst-ib').type('hello')
+driver.find(:css,'input[name=btnK]').click
+driver.browser.title.should == 'Google'
+
+@Test = TestSite.new
+@Test.home_page.visit('file:///Users/shipuy/Github/selenium_plus/test_project/test_site/html/home.html')
+@Test.home_page.show
+@Test.home_page.info_section.names_table_rows

data/test_project/test_site/html/home.html

@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title></title>
+    <script type="text/javascript">
+        function load() {
+
+        }
+        window.onload = load;
+    </script>
+</head>
+<body>
+    <input type='text' id='keywords' value=''/>
+    <input type='submit' name='Submit' value='Show'/>
+    <div id='info'>
+        <table class='view'>
+            <tr>
+                <th>ID</th>
+                <th>Name</th>
+            </tr>
+            <tr>
+                <td>1</td>
+                <td>Alex</td>
+            </tr>
+            <tr>
+                <td>2</td>
+                <td>James</td>
+            </tr>
+        </table>
+        <table class='view'>
+            <tr>
+                <th>ID</th>
+                <th>Company</th>
+            </tr>
+            <tr>
+                <td>1</td>
+                <td>EMC</td>
+            </tr>
+            <tr>
+                <td>2</td>
+                <td>VMware</td>
+            </tr>
+        </table>
+    </div>
+</body>
+</html>

data/test_project/test_site/pages/home_page.rb

@@ -0,0 +1,18 @@
+module Test
+  # This class provides actions for google search page
+  class HomePage < SeleniumPlus::Page
+
+    section(:info_section, InfoSection, :id, 'info')
+
+    # Private elements
+    #
+    element(:search_input, :id, 'keyword')
+    element(:submit_btn, :css, 'input[name=Submit]')
+
+    def show
+      search_input.type('hello world')
+      submit_btn.click
+    end
+  end
+end
+

data/test_project/test_site/sections/info_section.rb

@@ -0,0 +1,13 @@
+module Test
+  # This class provides actions for add new admin section
+  class InfoSection < SeleniumPlus::Section
+
+    # Private elements
+    #
+    element(:names_table, :css, 'table.view:first-child')
+
+    def names_table_rows
+       # Not implemented
+    end
+  end
+end

data/test_project/test_site/test_site.rb

@@ -0,0 +1,13 @@
+$:.unshift(File.dirname(__FILE__))
+
+require 'sections/info_section'
+require 'pages/home_page'
+
+class TestSite < SeleniumPlus::Site
+
+  def home_page
+    Test::HomePage.new(driver)
+  end
+
+end
+

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: selenium_plus
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Spark Yao
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.25.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.25.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+description: ''
+email:
+- shipuyao@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/selenium_plus.rb
+- lib/selenium_plus/driver.rb
+- lib/selenium_plus/page_obj/container.rb
+- lib/selenium_plus/page_obj/page.rb
+- lib/selenium_plus/page_obj/section.rb
+- lib/selenium_plus/page_obj/site.rb
+- lib/selenium_plus/selenium/element.rb
+- lib/selenium_plus/selenium/table.rb
+- lib/selenium_plus/version.rb
+- selenium_plus.gemspec
+- test_project/features/search.feature
+- test_project/features/step_definitions/search_steps.rb
+- test_project/test_project.rb
+- test_project/test_site/html/home.html
+- test_project/test_site/pages/home_page.rb
+- test_project/test_site/sections/info_section.rb
+- test_project/test_site/test_site.rb
+homepage: ''
+licenses: []
+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.0.0
+signing_key: 
+specification_version: 4
+summary: ''
+test_files: []