capy_time 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6b9ad1333c6c57cda02af89e1163bf30d3669e8d
+  data.tar.gz: a4c561a1bd78b85f391015f257bfd777dd8eb578
+SHA512:
+  metadata.gz: 745c3b2fe7266d408926a57d49b5938fbd94a22f82e8d4082f2d117b068818610334bb1dacd64f73baa60d4247f019ddc9fd0c17d6812ce4d54008e885d71832
+  data.tar.gz: 9984d9e718bb8af77ad1de0b4b8ed061eb1b5040a9e48e8d419f54f376945af18f471b21c663ff202bd66dcbd4379aecfd956b611c375d688253c1b53f497e88

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.0.0
+before_install: gem install bundler -v 1.10.4

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in capy_time.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 bem29
+
+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,109 @@
+# CapyTime
+
+CapyTime is a tool that allows you to use Capybara without having to worry about the timing issues.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'capy_time'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install capy_time
+
+## Usage
+Add the lines: require 'capy_time' and World(CapyTime) to your env file.
+
+Method : load_element(statement,*options)
+
+Description : This takes the css for an element and then makes sure the element is loaded or fails after timeout is reached if method doesn't load
+
+Options :  
+    
+    :text  this allows you to select an element based on it's text 
+    
+    example: load_element('a', :text =>/welcome/)
+    
+    :time this allows you to set an explicit timeout for just this call
+    
+    example: load_element('a', :text =>/welcome/,:time =>60)
+
+Method : load_true(statement,*options) 
+
+Description : This takes a statement that evaluates to a boolean and waits for it to evaluate to true or fails after timeout is reached if still false
+
+Options:
+
+    :time this allows you to set an explicit timeout for just this call
+    
+    example: load_true(all('div.result').length==0, :time =>60)
+    
+    :refresh this allows you to tell the page to refresh before it attempts to evaluate the statement
+    
+    example: load_true(all('div.result').length==0, :refresh =>true)
+   
+Method: should_have_content(statement,*options)
+
+Description : This takes a string that is expected to be in the page (or a given parent) and waits for it to load or fails after timeout is reached and the content wasn't loaded within the parent
+
+Options:
+    
+    :time this allows you to set an explicit timeout for just this call
+    
+    example: should_have_content('welcome', :time => 60)
+    
+    :refresh this allows you to tell the page to refresh before it attempts to evaluate the statement
+    
+    example: should_have_content('welcome', :refresh => true)
+    
+    :parent this allows you to make sure that the content is inside a given element
+    
+    example: should_have_content('welcome', :parent =>"div#welcomeMsg")
+    
+Method: should_have_css(statement,*options)
+
+Description : This takes the css for an element and then makes sure the element is loaded within the parent element or fails after timeout is reached and the css wasn't loaded within the parent
+
+Options:
+
+    :time this allows you to set an explicit timeout for just this call
+    
+    example: should_have_css('p', :time => 60)
+    
+    :refresh this allows you to tell the page to refresh before it attempts to evaluate the statement
+    
+    example: should_have_css('p', :refresh => true)
+    
+    :parent this allows you to make sure that the content is inside a given element NOTE:if not used it will default to page
+    
+    example: should_have_css('p', :parent =>"div#welcomeMsg")
+   
+Method: should_open_tab(url,prevTabTotal,*options)
+
+Description: This takes a partial or full url and waits for the browser to open the url in a new tab or fails if the timeout is reached and the url wasn't opened in a new tab
+
+Options:
+
+    :time this allows you to set an explicit timeout for just this call
+    
+    example: should_open_tab('rubygems.org',4,:time =>60)
+    
+    :close this allows you to specify that after opening the tab it should close the tab and go back to the first tab
+    
+    example: should_open_tab('rubygems.org',3,:close =>true)
+    
+Method: wait_for_page_change(prevUrl)
+
+Description: This takes the url of a page before an action occurred and then makes sure that the url changes before continuing or fails if timeout is reached and url never changed
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

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

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "capy_time"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/capy_time.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capy_time/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "capy_time"
+  spec.version       = CapyTime::VERSION
+  spec.authors       = ["Bradley Maynard"]
+  spec.email         = ["maynard_bradley@yahoo.com"]
+
+  spec.summary       = %q{Tool for handling timing issues in capybara.}
+  spec.description   = %q{capy_time is a tool that allows you to use Capybara without having to worry about the timing issues.}
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/capy_time/version.rb

@@ -0,0 +1,3 @@
+module CapyTime
+  VERSION = "0.1.0"
+end

data/lib/capy_time.rb

@@ -0,0 +1,348 @@
+require "capy_time/version"
+
+module CapyTime
+    def load_element(statement,*options)
+        #initialize
+        loaded=false
+        
+        #retrieve options (if any)
+        if(options!=[] && ((x=options.pop)!=nil))then
+            @options = []
+            @options.push(x.dup)
+            for o in options do
+                @options.push(options[o])
+            end
+        else
+            @options=[]
+        end
+        
+        #if option has known key put val for key in var
+        @t=nil
+        @r=nil
+        @te=nil
+        for o in @options do
+            val = @options.pop.dup
+            if(val.has_key?(:time))then
+                @t = val[:time]
+            elsif(val.has_key?(:refresh))then
+                @r = val[:refresh]
+            elsif(val.has_key?(:text))then
+                @te = val[:text]
+            end
+        end
+        
+        #set vars or default if option not provided
+        @time=nil
+        @time=@t ||=ENV['STIME'].to_i
+        @refresh=nil
+        @refresh=@r ||=false
+        @text=@te ||=nil
+
+        Timeout.timeout(@time)do
+          begin
+            urlPopulated= false
+            while(!urlPopulated)
+            urlPopulated= current_url.length>0
+            end
+            if(@refresh)then
+                page.evaluate_script('window.history.go()')
+                found=false
+                while(!found)
+                    begin
+                        if(@text==nil)then
+                            found = (all(statement)!=nil && all(statement).length>0)
+                        else
+                            found = (all(statement,:text =>@text)!=nil && all(statement,:text =>@text).length>0)
+                        end
+                    rescue
+                        retry
+                    end
+                end
+                if(@text==nil)then
+                    return all(statement)
+                else
+                    return all(statement,:text =>@text)
+                end
+            end
+            found=false
+                while(!found)
+                    begin
+                        if(@text==nil)then
+                            found = (all(statement)!=nil && all(statement).length>0)
+                        else
+                            found = (all(statement,:text =>@text)!=nil && all(statement,:text =>@text).length>0)
+                        end
+                    rescue
+                        retry
+                    end
+                end
+            if(@text==nil)then
+                    return all(statement)
+                else
+                    return all(statement,:text =>@text)
+                end
+          rescue
+            retry
+          end
+        end
+    end
+
+    def should_have_content(content,*options)
+        #retrieve options (if any)
+        if(options!=[] && ((x=options.pop)!=nil))then
+            @options = []
+            @options.push(x.dup)
+            for o in options do
+                @options.push(options[o])
+            end
+        else
+            @options=[]
+        end
+        
+        #if option has known key put val for key in var
+        @t=nil
+        @r=nil
+        @p=nil
+        for o in @options do
+            val = @options.pop.dup
+            if(val.has_key?(:time))then
+                @t = val[:time]
+            elsif(val.has_key?(:refresh))then
+                @r = val[:refresh]
+            elsif(val.has_key?(:parent))then
+                @p = val[:parent]
+            end
+        end
+        
+        #set vars or default if option not provided
+        @time=nil
+        @time=@t ||=ENV['STIME'].to_i
+        @refresh=nil
+        @refresh=@r ||=false
+        @parent=nil
+        @parent=@p ||=nil
+        
+        @content=content
+        Timeout.timeout(@time)do
+            urlPopulated= false
+            while(!urlPopulated)
+            urlPopulated= current_url.length>0
+            end
+            if(@refresh && (@content!=nil) && @parent!=nil)then
+                page.evaluate_script('window.history.go()')
+                load_element(@parent)
+                status=false
+                while(!status)
+                    status=load_element(@parent)[0].has_content?(@content)
+                end
+            elsif(@refresh && (@content!=nil) && @parent==nil)then
+                page.evaluate_script('window.history.go()')
+                status=false
+                while(!status)
+                    status=page.has_content?(@content)
+                end
+            elsif((!@refresh) && (@content!=nil) && @parent!=nil)then
+                load_element(@parent)
+                status=false
+                while(!status)
+                    status=load_element(@parent)[0].has_content?(@content)
+                end
+            elsif((!@refresh) && (@content!=nil) && @parent==nil)then
+                status=false
+                while(!status)
+                    status=page.has_content?(@content)
+                end
+            else
+                raise 'Error: Invalid options passed to method- should_have_content'
+            end 
+        end
+    end
+    
+    def should_have_css(content,*options)
+        #retrieve options (if any)
+        if(options!=[] && ((x=options.pop)!=nil))then
+            @options = []
+            @options.push(x.dup)
+            for o in options do
+                @options.push(options[o])
+            end
+        else
+            @options=[]
+        end
+        
+        #if option has known key put val for key in var
+        @t=nil
+        @r=nil
+        @p=nil
+        for o in @options do
+            val = @options.pop.dup
+            if(val.has_key?(:time))then
+                @t = val[:time]
+            elsif(val.has_key?(:refresh))then
+                @r = val[:refresh]
+            elsif(val.has_key?(:parent))then
+                @p = val[:parent]
+            end
+        end
+        
+        #set vars or default if option not provided
+        @time=nil
+        @time=@t ||=ENV['STIME'].to_i
+        @refresh=nil
+        @refresh=@r ||=false
+        @parent=nil
+        @parent=@p ||=nil
+        
+        @content=content
+        Timeout.timeout(@time)do
+            urlPopulated= false
+            while(!urlPopulated)
+            urlPopulated= current_url.length>0
+            end
+            if(@refresh && (@content!=nil) && @parent!=nil)then
+                page.evaluate_script('window.history.go()')
+                load_element(@parent)
+                status=false
+                while(!status)
+                    status=load_element(@parent+" "+@content)
+                end
+            elsif(@refresh && (@content!=nil) && @parent==nil)then
+                page.evaluate_script('window.history.go()')
+                status=false
+                while(!status)
+                    status=load_element(@content)
+                end
+            elsif((!@refresh) && (@content!=nil) && @parent!=nil)then
+                load_element(@parent)
+                status=false
+                while(!status)
+                    status=load_element(@parent+" "+@content)
+                end
+            elsif((!@refresh) && (@content!=nil) && @parent==nil)then
+                status=false
+                while(!status)
+                    status=load_element(@content)
+                end
+            else
+                raise 'Error: Invalid options passed to method- should_have_css'
+            end 
+        end
+    end
+
+    def should_open_tab(url,numtabs,*options)
+        
+        #retrieve options (if any)
+    if(options!=[] && ((x=options.pop)!=nil))then
+        @options = []
+        @options.push(x.dup)
+        for o in options do
+            @options.push(options[o])
+        end
+    else
+        @options=[]
+    end
+    
+    #if option has known key put val for key in var
+    @c=nil
+    @t=nil
+    for o in @options do
+        val = @options.pop.dup
+        if(val.has_key?(:close))then
+            @c = val[:close]
+        elsif(val.has_key?(:time))then
+            @t = val[:time]
+        end
+    end
+    
+    #set vars or default if option not provided
+    @close=nil
+    @close=@c ||=false
+    @time=nil
+    @time=@t  ||=ENV['STIME'].to_i
+        
+        Timeout::timeout(@time) {
+            status=false
+            while(!status)
+                status=page.driver.browser.window_handles.length > numtabs
+            end
+        }
+        
+        page.driver.browser.switch_to.window(page.driver.browser.window_handles.last)
+        Timeout::timeout(@time) {
+            status=false
+            while(!status)
+                status=current_url.length > 1
+            end
+        }
+            
+        begin
+            load_true(current_url.include?(url))
+        rescue
+            raise 'Error: Failed to navigate to '+url
+        end
+        if(@close==true)then
+            current_window.close
+  
+  
+            Timeout::timeout(@time) {
+                status=false
+                while(!status)
+                    status=(page.driver.browser.window_handles.length) == numtabs
+                end
+            }
+  
+            page.driver.browser.switch_to.window(page.driver.browser.window_handles.first)
+        end
+    end    
+    
+    def load_true(statement,*options)
+        loaded=false
+        
+        if(options!=[] && ((x=options.pop)!=nil))then
+            @options = []
+            @options.push(x.dup)
+            for o in options do
+                @options.push(options[o])
+            end
+        else
+            @options=[]
+        end
+        for o in @options do
+            val = @options.pop.dup
+            if(val.has_key?(:time))then
+                @t = val[:time]
+            elsif(val.has_key?(:refresh))then
+                @r = val[:refresh]
+            end
+        end
+        @time=@t ||=ENV['STIME'].to_i
+        @refresh=@r ||=false
+        Timeout.timeout(@time)do
+            while(!statement)
+                if(@refresh && !statement)then
+                    page.evaluate_script('window.history.go()')
+                    while(!statement)
+                    end
+                end 
+            end
+            return statement
+        end
+    end
+    
+    def wait_for_page_change(prevUrl)
+        $url = prevUrl
+        Timeout.timeout(ENV['STIME'].to_i)do
+            urlChanged=false
+            while(!urlChanged)
+                begin
+                    if(current_url != prevUrl)then
+                        urlChanged=true
+                    end
+                rescue
+                    retry
+                end
+            end
+        end
+    end
+    
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: capy_time
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Bradley Maynard
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-10-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: capy_time is a tool that allows you to use Capybara without having to
+  worry about the timing issues.
+email:
+- maynard_bradley@yahoo.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- capy_time.gemspec
+- lib/capy_time.rb
+- lib/capy_time/version.rb
+homepage: 
+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.4.8
+signing_key: 
+specification_version: 4
+summary: Tool for handling timing issues in capybara.
+test_files: []