testnow 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ae0cf9383a41fbc919cc941e81f1038a2aa433db
-  data.tar.gz: 55aec4f25dc6d5ae5e16a6249876feaa9023ada1
+  metadata.gz: b68ad6887680969d5c0c5368a4f3fce814b3c546
+  data.tar.gz: b43f18122dcc3179a8d46e87edd6929bf7724a92
 SHA512:
-  metadata.gz: e80b5ccb07185d74e869680261943257392276799c61b7621f1421841ebd731c779e7e542cd06b4a339e44e6b3ea52bfc47269193e4e3bcf865388ddd6558f0a
-  data.tar.gz: c4cf070963d7e018c3906f871cffcf50e4d2110791c8c840a11f4501c4e48bac4cc4914658c9531fc118dc23337ffe84766eb7e8ead9103cccfd82bf15647c4b
+  metadata.gz: 0ba0dc401ac6c946b64670cc94ba7bf489bdbd82c2d7ecb8f69add69bafa07b9b87e0ebb6464c2a1a5bc70c91300a2645bebac9f71208797697f2d3eece2c474
+  data.tar.gz: e3049cb81ae6e560f6351dd585cd0d57ce36066e051b614553e6c663f83f847482d0053db1c263b1abf7d2e734d38576ef4d644011aacddb163a7a26eb9c157c

data/LICENCE

@@ -1,20 +1,20 @@
-Copyright (c) 2015-2016 Kaushal Rupani
-
-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. 
+Copyright (c) 2015-2016 Kaushal Rupani
+
+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

@@ -1,197 +1,213 @@
-# testnow
-
-An instant WebDriver-Ruby-Cucumber or WebDriver-Ruby-RSpec framework which has ability to do cross browser testing on any of the popular browsers, Firefox, Chrome, Opera, Internet Explorer, Safari, Android Browser. It uses the selenium-webdriver to driver the browsers already installed on your box.
-
-[NOTE] -- This gem does not provide any webdrivers or install any browsers, it is related to browser configuration and framework generation. For the tests to run, browsers should be installed and webdrivers should be present in the path variable.   
-
-
-## Table of Contents
-- [Installation](#installation)  
-    - [Install using gem command](#gem)    
-    - [Install using bundler](#bundler)  
-- [Setup](#setup)   
-    - [Cross browser configuration using testnow for your existing project](#cross)   
-    - [Command Line Tool -- testnow command](#cli)   
-- [Usage](#usage)   
-    - [Instantly create a fresh Cucumber-WebDriver framework](#cuke)    
-    - [Instantly create a fresh RSpec-WebDriver framework](#rspec)     
-    - [Instantly create a fresh Watir-Cucumber-WebDriver framework](#watir-cuke)    
-    - [Instantly create a fresh Watir-RSpec-WebDriver framework](#watir-rspec)      
-- [Variables](#variables)       
-    - [BROWSER](#browser)   
-    - [TEST_URL](#test-url)   
-- [Browsers](#browsers)    
-- [Contributing](#contributing)  
-- [Issues](#issues)     
-
-
-
-## Installation  
-There are multiple ways in which you can install and use testnow gem.
-You must have Ruby installed before you can install this gem.   
-
-### <a name="gem" /> 1. Install using gem command
-Just use following command from you Terminal.
-``` 
-gem install testnow 
-```
-   
-### <a name="bundler" /> 2. Install using bundler    
-You can include it in your Gemfile and run bundle install
-
-``` 
-gem 'testnow' 
-```   
-then run following   
-```   
-bundle install   
-```   
-  
-  
-## Setup   
-   
-### <a name="cross"></a> 1. Cross browser configuration using testnow for your existing project     
-When creating a Selenium-WebDriver automation suite, if one requires cross browser testing, the biggest headache is configuring all browsers mainly because configurations for every browser is done differently. This is where TestNow gem jumps in as an Asprin to cure your headache by taking care of  browser configurations for you.   
-
-Unlike some very famous Ruby-WebDriver tools which wraps up the WebDriver object and provides its own set of commands, TestNow gem returns you the ```driver``` object as is but initialized with any browser of your choice.
-
-In your existing automation suite, require and include the testnow gem in your config file 
-(i.e usually env.rb for cucumber or spec_helper for rspec depending on your framework)
-
-```
-require 'testnow'   
-
-include TestNow             # for basic webdriver framework   
-   
-include TestNow::Watir      # for watir webdriver framework   
-```
-
-now as everything is required, included and ready, just put the following command in the setup method. (Setup method is where WebDriver is initialized with a certain browser and a driver object is created. i.e hooks.rb file for cucumber)
-
-```
-@driver = TestNow.init
-```
-
-TestNow gem uses the environment variable __BROWSER__ to detect which browser to initialize. If no value is set for this variable then firefox will be initialized by default.
-
-### <a name="cli"></a> 2. Command Line Tool -- testnow command
-When you install testnow gem, it installs a command line tool which helps you to create automation frameworks with cross browser configuration in a jiffy.   
-This command line tool has multiple command and can be seen using help
-Following are the list of commands:   
-    
-![help, version, cucumber_now, rspec_now, watir_cucumber_now, watir_rspec_now] (/images/commands.png)
-
-
-  
-## Usage
-   
-### <a name="cuke"></a> 1. Instantly create a fresh Cucumber-WebDriver framework   
-
-```
-testnow cucumber_now
-```  
-This will run a series of commands and create a WebDriver-Ruby-Cucumber framework for you in a directory called __cucumber_now__. It will towards the end also ask you for gem dependency installation and it is highly recommended to say Yes. It will also create a sample scenario with a feature file and also a hooks and env file with all configurations. This scenario can be executed by simple command to see a demo of the execution.
-
-``` 
-cd cucumber_now                      # Navigate into the created directory   
-
-Command 1 : cucumber features        # Executes using cucumber gem executable
-or
-Command 2 : rake testnow        # Executes using cucumber rake task
-```   
-  
-Use any of the command to execute the sample scenario. A beautiful, screenshot embedded report will be created by this execution to in the reports directory. It will be in html format, please double click or open in a browser to view it.   
-
-
-### <a name="rspec"></a> 2. Instantly create a fresh RSpec-WebDriver framework   
-
-```
-testnow rspec_now
-```    
-   
-This will run a series of commands and create a WebDriver-Ruby-RSpec framework for you in a directory called __rspec_now__. It will towards the end also ask you for gem dependency installation and it is highly recommended to say Yes. It will also create a sample scenario with a spec and spec_helper file with all configuration. This scenario can be executed by simple command to see a live demo of the execution.
-
-``` 
-cd rspec_now       # Navigate into the created directory   
-
-rake testnow        # Executes using cucumber rake task
-```   
-  
-Use any of the command to execute the sample spec. A beautiful report will be created by this execution to in the reports directory. It will be in html format, please double click or open in a browser to view it. 
-  
-  
-### <a name="watir-cuke"></a> 3. Instantly create a fresh Watir-Cucumber-WebDriver framework
-
-```
-testnow watir_cucumber_now
-```  
-This will run a series of commands and create a WebDriver-Ruby-Cucumber framework for you in a directory called __watir_cucumber_now__. It will towards the end also ask you for gem dependency installation and it is highly recommended to say Yes. It will also create a sample scenario with a feature file and also a hooks and env file with all configurations. This scenario can be executed by simple command to see a demo of the execution.
-
-``` 
-cd watir_cucumber_now                # Navigate into the created directory   
-
-Command 1 : cucumber features        # Executes using cucumber gem executable
-or
-Command 2 : rake testnow        # Executes using cucumber rake task
-```   
-  
-Use any of the command to execute the sample scenario. A beautiful, screenshot embedded report will be created by this execution to in the reports directory. It will be in html format, please double click or open in a browser to view it.   
-  
-  
-### <a name="watir-rspec"></a> 4. Instantly create a fresh Watir-RSpec-WebDriver framework   
-
-```
-testnow rspec_now
-```    
-   
-This will run a series of commands and create a WebDriver-Ruby-RSpec framework for you in a directory called __watir_rspec_now__. It will towards the end also ask you for gem dependency installation and it is highly recommended to say Yes. It will also create a sample scenario with a spec and spec_helper file with all configuration. This scenario can be executed by simple command to see a live demo of the execution.
-
-``` 
-cd watir_rspec_now      # Navigate into the created directory   
-
-rake testnow            # Executes using cucumber rake task
-```   
-  
-Use any of the command to execute the sample spec. A beautiful report will be created by this execution to in the reports directory. It will be in html format, please double click or open in a browser to view it. 
-  
-  
-## Variables
-### <a name="browser"></a> 1. BROWSER
-Using testnow for existing project or creating a fresh framework from the testnow command line tool, there an environment variable which is consumed by the execution which is called __BROWSER__. One can pass the browser of its choice to this variable to execute tests in different browsers. The default value is set to firefox.
-
-For example, in above sample scenario.
-```
-rake testnow BROWSER=chrome
-or  
-rake testnow BROWSER=opera
-```
-
-[NOTE: This will work provided you have webdrivers placed in PATH varibale. i.e chromedriver or operadriver]
-   
-### <a name="test-url"></a> 2. TEST_URL
-This variable currently only works if you create a framework from testnow command line tool. This variable is called __TEST_URL__ and it gives you the power to pass the test url as a parameter. As we know that there can be multiple test environment and not necessarily we would need to run our tests on 1 environment. So to avaoid changing the code, testnow provides exposure of test url.
-
-For Example:
-```
-rake testnow BROWSER=chrome TEST_URL=https://github.com
-```
-
-## Browsers  
-As mentioned in the above section that there is a variable exposed called _BROWSER_ but what are the values to be passed and which OS-Browsers combinations are supported, well here is a index grid below:
-
-| OS  | Chrome  | Firefox (v47-)  | Firefox Gecko (v48+)  | IE 11/10   | Edge  | Opera  | PhantomJS   | Chrome Mobile[2]   |    
-|---|---|---|---|---|---|---|---|---|    
-| Linux     | Supported  | Supported  | Supported  | N/A         | N/A         | Supported[1]  | Coming Soon!  | Coming Soon!  |   
-| Mac       | Supported  | Supported  | Supported  | N/A         | N/A         | Supported[1]  | Coming Soon!  | Coming Soon!  |     
-| Windows   | Supported  | Supported  | Supported  | Supported   | Supported[3]| Coming Soon!  | Coming Soon!  | Coming Soon!  |    
-  
-Note:  
-[1] Currently it is expected that the Opera webdriver binary is present inside "/usr/local/bin/operadriver, soon this path will be made customizable and exposaed as a varibale.   
-[2] This is not another browser, it is the mobile emulation which Google Chrome proovides through its developer tools.   
-[3] Please download the required Microsoft WebDriver as per your windows 10 build number. Windows 10 build can be checked with the `winver` command.   
-
-## Contributing
-Ideas and suggestions are always always most welcome. Please fork this gem code and feel free to add any updates, suggestions etc and create a pull request.  
-
-## Issues
-If you face any problem related to syntax, usability, documentation then please raise an [issues](https://github.com/krupani/testnow/issues), testnow is committed to respond within 24hours...    
+# testnow
+
+An instant WebDriver-Ruby-Cucumber or WebDriver-Ruby-RSpec framework which has ability to do cross browser testing on any of the popular browsers, Firefox, Chrome, Opera, Internet Explorer, Safari, Android Browser. It uses the selenium-webdriver to driver the browsers already installed on your box.
+
+[NOTE] -- This gem does not provide any webdrivers or install any browsers, it is related to browser configuration and framework generation. For the tests to run, browsers should be installed and webdrivers should be present in the path variable.   
+
+
+## Table of Contents
+- [Installation](#installation)  
+    - [Install using gem command](#gem)    
+    - [Install using bundler](#bundler)  
+- [Setup](#setup)   
+    - [Cross browser configuration using testnow for your existing project](#cross)   
+    - [Command Line Tool -- testnow command](#cli)   
+- [Usage](#usage)   
+    - [Instantly create a fresh Cucumber-WebDriver framework](#cuke)    
+    - [Instantly create a fresh RSpec-WebDriver framework](#rspec)     
+    - [Instantly create a fresh Watir-Cucumber-WebDriver framework](#watir-cuke)    
+    - [Instantly create a fresh Watir-RSpec-WebDriver framework](#watir-rspec)      
+- [Variables](#variables)       
+    - [BROWSER](#browser)   
+    - [TEST_URL](#test-url)
+    - [DEVICE](#device)
+- [Browsers](#browsers)    
+- [Contributing](#contributing)  
+- [Issues](#issues)     
+
+
+
+## Installation  
+There are multiple ways in which you can install and use testnow gem.
+You must have Ruby installed before you can install this gem.   
+
+### <a name="gem" /> 1. Install using gem command
+Just use following command from you Terminal.
+``` 
+gem install testnow 
+```
+   
+### <a name="bundler" /> 2. Install using bundler    
+You can include it in your Gemfile and run bundle install
+
+``` 
+gem 'testnow' 
+```   
+then run following   
+```   
+bundle install   
+```   
+  
+  
+## Setup   
+   
+### <a name="cross"></a> 1. Cross browser configuration using testnow for your existing project     
+When creating a Selenium-WebDriver automation suite, if one requires cross browser testing, the biggest headache is configuring all browsers mainly because configurations for every browser is done differently. This is where TestNow gem jumps in as an Asprin to cure your headache by taking care of  browser configurations for you.   
+
+Unlike some very famous Ruby-WebDriver tools which wraps up the WebDriver object and provides its own set of commands, TestNow gem returns you the ```driver``` object as is but initialized with any browser of your choice.
+
+In your existing automation suite, require and include the testnow gem in your config file 
+(i.e usually env.rb for cucumber or spec_helper for rspec depending on your framework)
+
+```
+require 'testnow'   
+
+include TestNow             # for basic webdriver framework   
+   
+include TestNow::Watir      # for watir webdriver framework   
+```
+
+now as everything is required, included and ready, just put the following command in the setup method. (Setup method is where WebDriver is initialized with a certain browser and a driver object is created. i.e hooks.rb file for cucumber)
+
+```
+@driver = TestNow.init
+```
+
+TestNow gem uses the environment variable __BROWSER__ to detect which browser to initialize. If no value is set for this variable then firefox will be initialized by default.
+
+### <a name="cli"></a> 2. Command Line Tool -- testnow command
+When you install testnow gem, it installs a command line tool which helps you to create automation frameworks with cross browser configuration in a jiffy.   
+This command line tool has multiple command and can be seen using help
+Following are the list of commands:   
+    
+![help, version, cucumber_now, rspec_now, watir_cucumber_now, watir_rspec_now](https://github.com/krupani/testnow/blob/master/images/commands.png)
+
+
+  
+## Usage
+   
+### <a name="cuke"></a> 1. Instantly create a fresh Cucumber-WebDriver framework   
+
+```
+testnow cucumber_now
+```  
+This will run a series of commands and create a WebDriver-Ruby-Cucumber framework for you in a directory called __cucumber_now__. It will towards the end also ask you for gem dependency installation and it is highly recommended to say Yes. It will also create a sample scenario with a feature file and also a hooks and env file with all configurations. This scenario can be executed by simple command to see a demo of the execution.
+
+``` 
+cd cucumber_now                      # Navigate into the created directory   
+
+Command 1 : cucumber features        # Executes using cucumber gem executable
+or
+Command 2 : rake testnow        # Executes using cucumber rake task
+```   
+  
+Use any of the command to execute the sample scenario. A beautiful, screenshot embedded report will be created by this execution to in the reports directory. It will be in html format, please double click or open in a browser to view it.   
+
+
+### <a name="rspec"></a> 2. Instantly create a fresh RSpec-WebDriver framework   
+
+```
+testnow rspec_now
+```    
+   
+This will run a series of commands and create a WebDriver-Ruby-RSpec framework for you in a directory called __rspec_now__. It will towards the end also ask you for gem dependency installation and it is highly recommended to say Yes. It will also create a sample scenario with a spec and spec_helper file with all configuration. This scenario can be executed by simple command to see a live demo of the execution.
+
+``` 
+cd rspec_now       # Navigate into the created directory   
+
+rake testnow        # Executes using cucumber rake task
+```   
+  
+Use any of the command to execute the sample spec. A beautiful report will be created by this execution to in the reports directory. It will be in html format, please double click or open in a browser to view it. 
+  
+  
+### <a name="watir-cuke"></a> 3. Instantly create a fresh Watir-Cucumber-WebDriver framework
+
+```
+testnow watir_cucumber_now
+```  
+This will run a series of commands and create a WebDriver-Ruby-Cucumber framework for you in a directory called __watir_cucumber_now__. It will towards the end also ask you for gem dependency installation and it is highly recommended to say Yes. It will also create a sample scenario with a feature file and also a hooks and env file with all configurations. This scenario can be executed by simple command to see a demo of the execution.
+
+``` 
+cd watir_cucumber_now                # Navigate into the created directory   
+
+Command 1 : cucumber features        # Executes using cucumber gem executable
+or
+Command 2 : rake testnow        # Executes using cucumber rake task
+```   
+  
+Use any of the command to execute the sample scenario. A beautiful, screenshot embedded report will be created by this execution to in the reports directory. It will be in html format, please double click or open in a browser to view it.   
+  
+  
+### <a name="watir-rspec"></a> 4. Instantly create a fresh Watir-RSpec-WebDriver framework   
+
+```
+testnow rspec_now
+```    
+   
+This will run a series of commands and create a WebDriver-Ruby-RSpec framework for you in a directory called __watir_rspec_now__. It will towards the end also ask you for gem dependency installation and it is highly recommended to say Yes. It will also create a sample scenario with a spec and spec_helper file with all configuration. This scenario can be executed by simple command to see a live demo of the execution.
+
+``` 
+cd watir_rspec_now      # Navigate into the created directory   
+
+rake testnow            # Executes using cucumber rake task
+```   
+  
+Use any of the command to execute the sample spec. A beautiful report will be created by this execution to in the reports directory. It will be in html format, please double click or open in a browser to view it. 
+  
+  
+## Variables
+### <a name="browser"></a> 1. BROWSER
+Using testnow for existing project or creating a fresh framework from the testnow command line tool, there an environment variable which is consumed by the execution which is called __BROWSER__. One can pass the browser of its choice to this variable to execute tests in different browsers. The default value is set to firefox.
+
+For example, in above sample scenario.
+```
+rake testnow BROWSER=chrome
+or  
+rake testnow BROWSER=opera
+```
+
+[NOTE: This will work provided you have webdrivers placed in PATH varibale. i.e chromedriver or operadriver]
+   
+### <a name="test-url"></a> 2. TEST_URL
+This variable currently only works if you create a framework from testnow command line tool. This variable is called __TEST_URL__ and it gives you the power to pass the test url as a parameter. As we know that there can be multiple test environment and not necessarily we would need to run our tests on 1 environment. So to avaoid changing the code, testnow provides exposure of test url.   
+    
+For Example:
+```
+rake testnow BROWSER=chrome TEST_URL=https://github.com
+```   
+   
+### <a name="device"></a> 3. DEVICE
+This variable is only required when using Chrome Mobile emulation browser. This is a feature by Google Chrome provided for testing mobile websites how it will look on chrome browser on various devices. For eg: Google Chrome on Apple iPhone 6 Plus or Google Chrome on Samsung Galaxy Note 3. The list of devices can be found on [here](https://developers.google.com/web/tools/chrome-devtools/device-mode/). Now coming back to how to use this variable. We need to pass the DEVICE name when choosing BROWSER=mobilechrome.  
+  
+For example
+```   
+rake testnow BROWSER=mobile_chrome DEVICE="Apple iPhone 6"   
+or   
+rake testnow BROWSER=chrome_mobile DEVICE="Samsung Galaxy Note 3"  
+or  
+rake testnow BROWSER="Mobile Chrome" DEVICE=Google_Nexus_6
+```   
+ __Note: If certain devices are not found on your chrome then firstly update your chrome to latest version and then turn on the devices and device mode from developer tools options__
+
+
+
+## Browsers  
+As mentioned in the above section that there is a variable exposed called _BROWSER_ but what are the values to be passed and which OS-Browsers combinations are supported, well here is a index grid below:
+
+| OS  | Chrome  | Firefox (v47-)  | Firefox Gecko (v48+)  | IE 11/10   | Edge  | Opera  | PhantomJS   | Chrome Mobile[2]   |    
+|---|---|---|---|---|---|---|---|---|    
+| Linux     | Supported  | Supported  | Supported  | N/A         | N/A         | Supported[1]  | Coming Soon!  | Supported  |   
+| Mac       | Supported  | Supported  | Supported  | N/A         | N/A         | Supported[1]  | Coming Soon!  | Supported  |     
+| Windows   | Supported  | Supported  | Supported  | Supported   | Supported[3]| Coming Soon!  | Coming Soon!  | Supported  |    
+  
+Note:  
+[1] Currently it is expected that the Opera webdriver binary is present inside "/usr/local/bin/operadriver, soon this path will be made customizable and exposaed as a varibale.   
+[2] This is not another browser, it is the mobile emulation which Google Chrome proovides through its developer tools.   
+[3] Please download the required Microsoft WebDriver as per your windows 10 build number. Windows 10 build can be checked with the `winver` command.   
+
+## Contributing
+Ideas and suggestions are always always most welcome. Please fork this gem code and feel free to add any updates, suggestions etc and create a pull request.  
+
+## Issues
+If you face any problem related to syntax, usability, documentation then please raise an [issues](https://github.com/krupani/testnow/issues), testnow is committed to respond within 24hours...