Skip to content

Commit

Permalink
Initial commit
Browse files Browse the repository at this point in the history
  • Loading branch information
obscurerichard committed Aug 19, 2014
0 parents commit 550cee8
Show file tree
Hide file tree
Showing 16 changed files with 922 additions and 0 deletions.
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
/.bundle
/vendor
1 change: 1 addition & 0 deletions .ruby-version
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
2.0.0-p353
15 changes: 15 additions & 0 deletions Gemfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
source 'http://rubygems.org'

#ruby "2.0.0"
#ruby "1.9.3"

gem 'cucumber'
gem 'watir-webdriver'
gem 'nokogiri'
gem 'bundler'
gem 'headless'
gem 'chronic'
gem 'selenium-webdriver'
gem 'syntax'
gem 'watir-webdriver-performance'
gem 'rake'
51 changes: 51 additions & 0 deletions Gemfile.lock
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
GEM
remote: http://rubygems.org/
specs:
builder (3.2.2)
childprocess (0.5.3)
ffi (~> 1.0, >= 1.0.11)
chronic (0.10.2)
cucumber (1.3.15)
builder (>= 2.1.2)
diff-lcs (>= 1.1.3)
gherkin (~> 2.12)
multi_json (>= 1.7.5, < 2.0)
multi_test (>= 0.1.1)
diff-lcs (1.2.5)
ffi (1.9.3)
gherkin (2.12.2)
multi_json (~> 1.3)
headless (1.0.2)
mini_portile (0.6.0)
multi_json (1.10.1)
multi_test (0.1.1)
nokogiri (1.6.2.1)
mini_portile (= 0.6.0)
rake (10.3.2)
rubyzip (1.1.4)
selenium-webdriver (2.42.0)
childprocess (>= 0.5.0)
multi_json (~> 1.0)
rubyzip (~> 1.0)
websocket (~> 1.0.4)
syntax (1.2.0)
watir-webdriver (0.6.9)
selenium-webdriver (>= 2.18.0)
watir-webdriver-performance (0.2.4)
watir-webdriver
websocket (1.0.7)

PLATFORMS
ruby

DEPENDENCIES
bundler
chronic
cucumber
headless
nokogiri
rake
selenium-webdriver
syntax
watir-webdriver
watir-webdriver-performance
21 changes: 21 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
The MIT License

Copyright (c) 2014 Modus Create, Inc.

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.
154 changes: 154 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
Cucumber-Watir Test Harness
===========================

This is a test harness for automated functional testing of web applications, using the [Cucumber](http://cukes.info/) and [Watir](http://watir.com/) test frameworks. It can be used to support Behavioral Driven Design (BDD) or just automated functional testing of arbitrary web applications.

By using this collection of frameworks, you can quickly start a suite of functional tests for an application using a basic vocabulary inspired by tests that have been used successfully on many production projects.

The built in steps in `features/step-definitions/common_steps.rb` cover a variety of common use cases that occur in the functional testing of web applications, including common operations such as visiting pages, filling in form fields, finding text in a page, and checking that operations complete successfully.

This approach might not be as pure as some would advocate for BDD, but it strikes a good balance between being implementation specific and being fast to write and execute.

Here's an example of a Cucumber scenario written with the common steps:

```
@smoke @regression @desktop
Scenario: User views profile page
Given I am on the desktop home page
Then I must see the page title "example.com"
Given I fill in the text field "login_email" with "foobar@example.com"
And I fill in the text field "login_password" with "password"
And I click the "Login" span
And I wait for the "Dashboard" text to be displayed
Given I click the "foobar@example.com" link
And I wait for the "Profile" text to be displayed
And I send the "tab" keys
And I send the "06/01/2014" keys
And I send the "tab" keys
And I send the "06/06/2014" keys
And I click the "Save & Continue" span
And I fill in the text field "short_description" with "Modus Kickstart short description"
Then I must see the text "Thank You" displayed
```

License
=======

This test framework is licensed under the (MIT License)[http://opensource.org/licenses/MIT], a permissive free software license.

See the file LICENSE for full copyright and license information.


Setup on Mac OS X
=================

Tools Used:
-----------

1. Mac with Sudo Access
2. Xcode with command line tools installed (command line tools can be installed from Xcode -> Preferences -> Downloads)
3. RVM - Optional
4. Ruby 2.0
5. Watir-Webdriver
6. webdriver-user-agent
7. cucumber
8. homebrew - Optional
9. chromedriver


Steps To Install:
-----------------

**Install Xcode and then install commandline tools.**
>*Command line tools can be installed from going to Xcode-> Preferences -> Downloads*
**Install RVM**

\curl -L https://get.rvm.io | bash

**Install Ruby**

rvm install ruby-2.0.0-p247

*To make this the default ruby on your Mac run the below command. However It is not necessary to make it the default ruby. The gemfile in the folder has the builin workflow to use Ruby 2.0 when you cd into the tests/web folder.*

rvm use ruby-2.0.0-p247 --default

**Install Homebrew**

ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"

brew doctor

>*if the above command fails, please follow the steps in the output to fix the errors.*
**Install chromedriver**

brew install chromedriver

>*Installing Homebrew is Optional. The only reason I use it is to install chromedriver*
>*You can download chromedriver from http://chromedriver.storage.googleapis.com/index.html?path=2.4/*
>*Unzip and move the driver to anyplace in your path like /usr/local/bin*
>*you can skip the brew install chromedriver below if you download it*
>*Advantage of installing via brew is that you can update it with a single command. (brew update && brew upgrade)*
**Install the bundler gem**

gem install bundler --no-ri --no-rdoc

**Install necessary gems using bundler**

cd test
bundle install

**Running tests**

cucumber features

>*The above command runs all the tests inside the feature folder but that i snot what you want sometimes. To run single individual tests yo have to specify the line numbers as below*
cucumber features/main.feature:217

This will run the Test scenario at line number 217

**To see a list of Tasks**

rake -T

**To run the whole regression Suite**

rake regression:all

>*The HTML report will be saved to the results folder with screenshots of failures if any.*

Tips and Troubleshooting:
--------------------------

*Sencha Command integration*

*Please note that Sencha command needs ruby < 2.0 to be able to build apps successfully.*

If you have made Ruby 2.0 your default then run the below command before you use the sencha build script.

rvm use 1.9.3

>*You can simply create Alias in your bash profile to run tests. Instead of typing the whole cucumber command create this function in your bashrc or .profile file*
vi ~/.bash_profile

c() { cucumber features/main.feature:"$@" ;}


**Save, Exit and source the file or simply restart your terminal**

**Then you can run the test at line 217 by simply running the command below from the test folder**

c 217


**If you run into libxml erorrs fix it as suggested in this post**

https://gist.github.com/vparihar01/5856524


31 changes: 31 additions & 0 deletions Rakefile
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
require 'cucumber/rake/task'
require 'fileutils'
FileUtils::mkdir_p 'results'

task :default => 'regression:all'

namespace :regression do

Cucumber::Rake::Task.new(:all, 'Regression test suite') do |t|
t.cucumber_opts = "features/*.feature
--format html --out=results/ptp-regression-report-#{Time.now.strftime("%Y-%m-%d-%H-%M-%S")}.html
--format pretty --no-source
--format rerun --out results/ptp-regression-rerun.txt
--tag @regression"
end
Cucumber::Rake::Task.new(:smoke, 'smoke test suite') do |t|
t.cucumber_opts = "features/*.feature
--format html --out=results/ptp-regression-report-#{Time.now.strftime("%Y-%m-%d-%H-%M-%S")}.html
--format pretty --no-source
--format rerun --out results/ptp-smoke-rerun.txt
--tag @smoke"
end
Cucumber::Rake::Task.new(:jenkins_all, 'Regression test suite') do |t|
t.cucumber_opts = "features/*.feature
--format html --out=results/ptp-regression-report-#{Time.now.strftime("%Y-%m-%d-%H-%M-%S")}.html
--format pretty --no-source
--format rerun --out results/ptp-regression-rerun.txt
--tag @regression
'HEADLESS=true'"
end
end
1 change: 1 addition & 0 deletions config/cucumber.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
default: features -t ~@wip -t ~@manual
Loading

0 comments on commit 550cee8

Please sign in to comment.