kraken-mobile 1.0.5 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a62f2fa104aef33dbd29eeb781a1af75ebeac4306038023d6fc1abd51235a5c
-  data.tar.gz: 9d3b50a9fa14ccb8e411ff760733be78f91b856e0f99805b24f67c837b0e03c4
+  metadata.gz: 1b00ad0b9cbfa1874a61ff9285fddf9616901c2e99db685b9fcfa05099bba3d6
+  data.tar.gz: 9370f8c54723f070282457dfca37a51bd4e4522fcc94ba14bb38f401b2db7fb2
 SHA512:
-  metadata.gz: 0ef9c9887cdd96ea1fd702c93c1ca7ebaf98a889328927f8834e76a0f47a6f36a40d6d46617e765db1b7f51f1a38792db8d2796d6dd4a1157539236dbe7e38f9
-  data.tar.gz: 0a91cd009596a0adc065b72eafaff018e65797ad79bcdcadf03ba41bc530e871a7de736b00c4572d1cd0f776386e3be1b00a245c44773122d4dfc5a795c8e020
+  metadata.gz: 7f9f6c735b8cfc759b6f9b8dec02bf833b4abe3fe8f450647af3303e4e9c7e3d9634e49b524b9931d6f6ecba31b00e64453b6b1d0b0a9a97ce3057433225d567
+  data.tar.gz: cf4c0fc443b23308a2c226e9523c39a178144cae805a5751ef0256a31840002f15521361e930ff02d4144e0e5345b0b6139b2dbf1added31ec1bf61eb25d8731

data/README.md

@@ -1,10 +1,8 @@
 <p align="center">
     <img src="./reporter/assets/images/kraken.png" alt="kraken logo" width="140" height="193">
+<h1 align="center">Kraken</h1>
 
-
-<h1 align="center">Kraken Mobile</h1>
-
-Kraken is an open source automated android E2E testing tool that supports and validates scenarios that involve the inter-communication between two or more users. It works in a Black Box manner meaning that it is not required to have access to the source code of the application but instead it can be run with the APK (Android package file format). Kraken uses signaling for coordinating the communication between the devices using a file based protocol.
+Kraken is an open source automated android and web E2E testing tool that supports and validates scenarios that involve the inter-communication between two or more users. It works in a Black Box manner meaning that it is not required to have access to the source code of the application but instead it can be run with the APK (Android package file format) and web page URL. Kraken uses signaling for coordinating the communication between the devices using a file based protocol.
 
 **Kraken is partially supported by a Google Latin America Research Award (LARA) 2018**
 
@@ -13,26 +11,36 @@ Kraken is an open source automated android E2E testing tool that supports and va
 
 # Publications
 
-- _"Kraken-Mobile: Cross-Device Interaction-based Testing of Android Apps"_, [William Ravelo-Méndez](https://ravelinx22.github.io/), [Camilo Escobar-Velásquez](https://caev03.github.io), and  [Mario Linares-Vásquez](https://profesores.virtual.uniandes.edu.co/mlinaresv/en/inicio-en/), _Proceedings of the 35th IEEE International Conference  on Software Maintenance and Evolution ([ICSME'19](https://icsme2019.github.io/))_, Tool Demo Track, Cleveland, OH, USA, September 30th - October 4th, 2019, to appear 4 pages (52% Acceptance Rate) [[pdf](https://thesoftwaredesignlab.github.io/KrakenMobile/assets/pdfs/icsme19.pdf)][[bibtex](https://thesoftwaredesignlab.github.io/KrakenMobile/assets/pdfs/icsme19.bib)]
+- *“Kraken-Mobile: Cross-Device Interaction-based Testing of Android Apps”*, [William Ravelo-Méndez](https://ravelinx22.github.io/), [Camilo Escobar-Velásquez](https://caev03.github.io/), and [Mario Linares-Vásquez](https://profesores.virtual.uniandes.edu.co/mlinaresv/en/inicio-en/), *Proceedings of the 35th IEEE International Conference on Software Maintenance and Evolution ([ICSME’19](https://icsme2019.github.io/))*, Tool Demo Track, Cleveland, OH, USA, September 30th - October 4th, 2019, to appear 4 pages (52% Acceptance Rate) [[pdf](https://thesoftwaredesignlab.github.io/KrakenMobile/assets/pdfs/icsme19.pdf)][[bibtex](https://thesoftwaredesignlab.github.io/KrakenMobile/assets/pdfs/icsme19.bib)]
 
 # Technologies
 
-Kraken uses [calabash-android](https://github.com/calabash/calabash-android) for running automated E2E tests in each device or emulator and [cucumber](https://github.com/cucumber/cucumber-ruby) for running your feature files written with Gherkin sintax.
-
+Kraken uses [calabash-android](https://github.com/calabash/calabash-android) and [selenium-webdriver](https://github.com/SeleniumHQ/selenium) for running automated E2E tests in each device or emulator and [cucumber](https://github.com/cucumber/cucumber-ruby) for running your feature files written with Gherkin sintax.
 
-# Installation
+# 🔨 Installation
 
 ### Prerequisites
 
-Kraken requires Ruby 2.20 or higher but we recommend using ~2.3 version. We use calabash-android as runner, you can check their prerequisites at this [link](https://github.com/calabash/calabash-android/blob/master/documentation/installation.md). Installing and managing a Gem is done through the gem command. To install Kraken's gem run the following command.
+Kraken requires Ruby 2.20 or higher but we recommend using ~2.3 version. We use calabash-android for mobile testing, you can check their prerequisites at this [link](https://github.com/calabash/calabash-android/blob/master/documentation/installation.md). For web testing we use selenium-webdriver, you can check their prerequisites as well at this [link](https://www.selenium.dev/selenium/docs/api/rb/).
+
+- Ruby at least version 2.3.1
+- Java JDK
+- Android SDK
+- Chromedriver (Version ~83 recommended) or Geckodriver (Only if you use Kraken web)
+
+You need to have configured ANDROID_HOME, ANDROID_HOME/platform_tools and JAVA_HOME in your environment variables.
 
-```shell
+Installing and managing Kraken Gem is done through the gem command. To install Kraken’s gem run the following command.
+
+```
 $ gem install kraken-mobile
 ```
 
+NOTE: If you are having trouble running Kraken in your Windows operating system refer to the this [guide](https://github.com/TheSoftwareDesignLab/KrakenMobile/blob/master/docs/WINDOWS_GUIDE.md) specifying steps to solve this issues.
+
 # Signaling
 
-Signaling is a protocol used for the communication of two or more devices running in parallel. It is based in the idea that each emulator or real device has a communication channel where he can receive signals sent from other devices which contain information or actions that are supposed to be executed. This type of protocol is commonly used in automated mobile E2E testing tools that validate scenarios involving the inter-communication and collaboration of two or more applications.
+Signaling is a protocol used for the communication of two or more devices running in parallel. It is based in the idea that each browser, emulator or real device has a communication channel where he can receive signals sent from other devices which contain information or actions that are supposed to be executed. This type of protocol is commonly used in automated mobile E2E testing tools that validate scenarios involving the inter-communication and collaboration of two or more applications.
 
 # Writing your first test
 
@@ -47,19 +55,24 @@ features
 | |_app_life_cycle_hooks.rb
 | |_env.rb
 |_step_definitions
-| |_kraken_steps.rb
+| |_mobile_steps.rb
+|_web
+| |_step_definitions
+| | |_web_steps.rb
+| |_support
+| | |_app_life_cycle_hooks.rb
 |_my_first.feature
 ```
 
 ### Write a test
 
-The features goes in the features foler and should have the ".feature" extension. You can start out by looking at `features/my_first.feature`. You should also check calabash [predefined steps](https://github.com/calabash/calabash-android/blob/master/ruby-gem/lib/calabash-android/canned_steps.md).
+The features goes in the features foler and should have the “.feature” extension. You can start out by looking at `features/my_first.feature`. You should also check calabash [predefined steps](https://github.com/calabash/calabash-android/blob/master/ruby-gem/lib/calabash-android/canned_steps.md).
 
 ### Syntax
 
 In Kraken each feature is a test and each scenario within a feature is a test case that is run in a device. Each device is identified as an user and numbered from 1 to N. Ex: @user1, @user2, @user3. To check what is the number of a given device you should run `kraken-mobile devices`.
 
-```shell
+```
 List of devices attached
 user1 - emulator-5554 - Android_SDK_built_for_x86
 user2 - emulator-5556 - Android_SDK_built_for_x86
@@ -67,9 +80,9 @@ user2 - emulator-5556 - Android_SDK_built_for_x86
 
 After identifying what number each device has, you can write your test case giving each scenario the tag of a given device like so:
 
-```Gherkin
+```
 Feature: Example feature
-  
+
   @user1
   Scenario: As a first user I say hi to a second  user
   Given I wait
@@ -88,9 +101,11 @@ Kraken offers two main steps to help synchronizing your devices.
 ### Signaling steps
 
 To wait for a signal coming from another device for 10 seconds that is Kraken default timeout use the following step.
+
 ```
 Then /^I wait for a signal containing "([^\"]*)"$/
 ```
+
 To wait for a signal coming from another device for an specified number of seconds use the following step
 
 ```
@@ -105,34 +120,120 @@ Then /^I send a signal to user (\d+) containing "([^\"]*)"$/
 
 ### Signaling functions
 
-Kraken internal implementation of the signaling steps use the following functions.
+Each device has an internal Kraken implementation of the signaling steps using the following functions.
 
-```ruby
-readSignal(channel, content, timeout)
+```
+read_signal(content, time_out)
 ```
 
-Waits for a signal with the specified content in the channel passed by parameter. This functions waits for the specified number of seconds in the timeout parameter before throwing an exception.
-
- **Note: The channel parameter has to be the number of a device such as @user1, @user2, @userN**
+Waits for a signal with the specified content. This functions waits for the specified number of seconds in the timeout parameter before throwing an exception if specified.
 
-```ruby
-writeSignal(channel, content)
+```
+write_signal(signal)
 ```
 
-Writes content to a channel passed by parameter.
+Writes signal content to a device inbox.
 
-**Note: The channel parameter has to be the number of a device such as @user1, @user2, @userN**
+# 📱Kraken Mobile
 
-# Running your tests
+## Running your tests
 
 To run your test:
 
-```shell
+```
 $ kraken-mobile run <apk>
 ```
 
 Kraken with the help of Calabash-Android will install an instrumentation along with your app and will start your tests in all devices connected (Check Kraken Settings section in order to learn how to specify in what devices your tests should be run).
 
+## 🦍 Mobile Monkey execution
+
+Kraken offers the possibility of generating random GUI events by using Android ADB monkey as well as its own implementation based in the idea of sending and reading random signals.
+
+### Android’s ADB Monkey
+
+To execute ADB monkey Kraken offers the following command specifying the number of events to be executed:
+
+```
+Then I start a monkey with (\d+) events
+```
+
+### Kraken’s own monkey
+
+Kraken extended the ADB monkey behavior by executing GUI events only in buttons and clickable views or inputs by offering the following command:
+
+```
+Then I start kraken monkey with (\d+) events
+```
+
+## XML snapshot
+
+Kraken makes it possible to save the XML presented by the current view in a specific device, this is convenient to identify view ids, asserting the correct XML is presented after an action has being completed or running static analyzing tools.
+
+### Saving the snapshot
+
+To save the snapshot of the current view, Kraken offers the following step specifying where the file is going to be saved:
+
+```
+Then I save device snapshot in file with path "([^\"]*)"
+```
+
+# 🌎 Kraken Web
+
+Kraken is extended to run also in web browsers and orchestrate the communication with other browsers running different websites or mobile applications that are being executed on physical devices or emulators. With the help of ChromeDriver/Geckodriver, selenium-webdriver and Cucumber we run test scenarios using Gherkin syntax as well as Kraken predefined signaling steps described before.
+
+## Specifying a web user in a test
+
+To specify that user is going to be run in a web browser instead of a mobile device you need to tag the scenario with @web. If a scenario is not tagged with @web Kraken will assume that is a mobile user and will attempt to run all steps in a mobile manner.
+
+```bash
+Feature: Example feature
+
+  @user1 @web
+  Scenario: As a first user I say hi to a second  user
+	Given I navigate to page "https://www.gmail.com/"
+    Then I send a signal to user 2 containing "hi"
+
+  @user2 @web
+  Scenario: As a second user I wait for user 1  to say hi
+    Given I wait for a signal containing "hi"
+	Then I navigate to page "https://www.gmail.com/"
+```
+
+This scenario will open two web browsers and execute the signaling between them.
+
+## Web steps
+
+To see a list of all web steps available in Kraken, visit the following [link.](https://github.com/TheSoftwareDesignLab/KrakenMobile/blob/master/docs/WEB_STEPS.md)
+
+## Executing web only scenarios
+
+To run a test that only contains web users and as a result does not require an APK file, run the following command:
+
+```
+$ kraken-mobile run
+```
+
+Kraken with the help of selenium-webdriver will start all required browsers and run your test scenario.
+
+## Specifying in what browser Kraken will run
+
+Kraken uses ChromeDriver and Chrome as default web browser but provides support for Firefox and Geckodriver. To specify that your test is going to be run in Firefox, specify the environment variable BROWSER when running your tests as follows:
+
+```bash
+$ BROWSER=firefox kraken-mobile run
+```
+
+**Note: Make sure that you have Geckodriver and Firefox installed previously.**
+
+## 🦍 Web Monkey execution
+
+Kraken has implemented it's own monkey behavior by executing random GUI events in buttons, clickable views and inputs by offering the following command:
+
+```
+Then I start kraken monkey with (\d+) events
+```
+
 # Kraken Settings
 
 Kraken uses kraken_mobile_settings.json to specify in what devices the tests should be run.
@@ -141,16 +242,20 @@ Kraken uses kraken_mobile_settings.json to specify in what devices the tests sho
 
 The following command will show you the available connected devices or emulators and let you choose which ones you want to use.
 
-```shell
+```
 $ kraken-mobile setup
 ```
 
 ### Run tests with settings file
 
-``` shell
+```
 $ kraken-mobile run <apk> --configuration=<kraken_mobile_settings_path>
 ```
 
+# 🗯 Extended Kraken functionalities
+
+In the following sections we provide specification for shared functionality between Kraken mobile and web as well as some examples of Kraken in action.
+
 # Properties file
 
 Kraken uses properties files to store sensitive data such as passwords or api keys that should be used in your test cases.
@@ -159,22 +264,22 @@ Kraken uses properties files to store sensitive data such as passwords or api ke
 
 The properties files should be a manually created JSON file with the following structure.
 
-```json
+```
 {
-  "@user1": {
-    "PASSWORD": "test"
-  },
-  "@user2": {
-    "PASSWORD": "test2"
-  }
+    "@user1": {
+        "PASSWORD": "test"
+    },
+    "@user2": {
+        "PASSWORD": "test2"
+    }
 }
 ```
-    
+
 ### Use properties file in your test
 
 You can use the specified properties using the following sintax.
 
-```Gherkin
+```
 @user1
 Scenario: As a user
     Given I wait
@@ -191,17 +296,17 @@ kraken-mobile run <apk> --properties=<kraken_mobile_properties_path>
 
 Kraken offers a Fake string generator thanks to the Ruby gem [Faker](https://github.com/faker-ruby/faker), the list of supported faker types are listed as follows:
 
-* Name
-* Number
-* Email
-* String
-* String Date
+- Name
+- Number
+- Email
+- String
+- String Date
 
 ### Use a faker in a test
 
-Kraken keeps a record of every Fake string generated, thats why each string will have an id associated. To generate a Faker string you need to follow the structure "$FAKERNAME_ID".
+Kraken keeps a record of every Fake string generated, thats why each string will have an id associated. To generate a Faker string you need to follow the structure “$FAKERNAME_ID”.
 
-```Gherkin
+```
 @user1
 Scenario: As a user
     Given I wait
@@ -212,7 +317,7 @@ Scenario: As a user
 
 As mentioned before, Kraken keeps record of every string generated with an id given to each string, this gives you the possibility of reusing this string later in your scenario. To reuse a string you can you need to append a $ character to the fake string as follows:
 
-```Gherkin
+```
 @user1
 Scenario: As a user
     Given I wait
@@ -223,15 +328,16 @@ Scenario: As a user
 
 # Examples
 
-| Application  | Video | Feature File | Properties file | Settings File | Report Link |
-|:-------------|:-------------|:------------------|:-------|:-------|:-------|
-| Infinite Words | [video](https://www.youtube.com/watch?v=4lX7mO80w-4&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=3&t=0s)|[.feature](../gh-pages/examples/infinite-words/infinite_words.feature) | ---  | ---  | [report](../gh-pages/examples/infinite-words/report/index.html) |
-| QuizUp | [video](https://www.youtube.com/watch?v=2mhZVTK0r6k&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=4&t=1s) | [.feature](../gh-pages/examples/quizup/quizup.feature) | --- |  --- | [report](../gh-pages/examples/quizup/report/index.html)  |
-| Spotify/Shazam | [video](https://www.youtube.com/watch?v=7AKsfY1KFX0&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=5&t=0s) | [.feature](../gh-pages/examples/shazam/shazam.feature) | [.json](../gh-pages/examples/shazam/kraken_properties.json) |  [.json](../gh-pages/examples/shazam/kraken_mobile_settings.json) | [report](../gh-pages/examples/shazam/report/index.html)  |
-| Spunky | [video](https://www.youtube.com/watch?v=WOhRWkdFaVk&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=6&t=25s) | [.feature](../gh-pages/examples/spunky/spunky.feature) | --- |  --- | [report](../gh-pages/examples/spunky/report/index.html)  |
-| Picap | [video](https://www.youtube.com/watch?v=RozQrmH_Z5k&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=7&t=3s) | [.feature](../gh-pages/examples/picap/picap.feature) | [.json](../gh-pages/examples/picap/kraken_properties.json) |  --- | [report](../gh-pages/examples/picap/report/index.html)  |
-| AskFM | [video](https://www.youtube.com/watch?v=d9Gbdx8kFX8&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=8&t=0s) | [.feature](../gh-pages/examples/askfm/askfm.feature) | --- |  --- | [report](../gh-pages/examples/askfm/report/index.html)  |
-| Stick Men Fight | [video](https://www.youtube.com/watch?v=36OJKNj0nSo&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=9&t=4s) | [.feature](../gh-pages/examples/stick/stick.feature) | --- |  --- | [report](../gh-pages/examples/stick/report/index.html)  |
-| Tic Tac Toe | [video](https://www.youtube.com/watch?v=F9pDJDYsL_w&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=10&t=2s) | [.feature](../gh-pages/examples/tictactoe/tictactoe.feature) | --- |  --- | [report](../gh-pages/examples/tictactoe/report/index.html)  |
-| Tumblr | [video](https://www.youtube.com/watch?v=eqFej2uJz4k&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=11&t=3s) | [.feature](../gh-pages/examples/tumblr/tumblr.feature) | [.json](../gh-pages/examples/tumblr/kraken_properties.json) |  --- | [report](../gh-pages/examples/tumblr/report/index.html)  |
-| F3 | [video](https://www.youtube.com/watch?v=vESh6Jyp-so&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=12&t=0s) | [.feature](../gh-pages/examples/f3/f3.feature) | [.json](../gh-pages/examples/f3/kraken_properties.json) |  --- | [report](../gh-pages/examples/f3/report/index.html)  |
+
+| Application  | Video | Feature File | Steps Definition | Properties file | Settings File | Report Link |
+|:-------------|:-------------|:-------------|:------------------|:-------|:-------|:-------|
+| Infinite Words | [video](https://www.youtube.com/watch?v=4lX7mO80w-4&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=3&t=0s)|[.feature](/examples/infinite-words/infinite_words.feature)|--- | ---  | ---  | [report](/examples/infinite-words/report/index.html) |
+| QuizUp | [video](https://www.youtube.com/watch?v=2mhZVTK0r6k&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=4&t=1s) | [.feature](/examples/quizup/quizup.feature)|[stepsDef](../gh-pages/examples/quizup/step_definitions/kraken_steps.rb) | --- |  --- | [report](/examples/quizup/report/index.html)  |
+| Spotify/Shazam | [video](https://www.youtube.com/watch?v=7AKsfY1KFX0&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=5&t=0s) | [.feature](/examples/shazam/shazam.feature)|[stepsDef](../gh-pages/examples/shazam/step_definitions/kraken_steps.rb) | [.json](/examples/shazam/kraken_properties.json) |  [.json](/examples/shazam/kraken_mobile_settings.json) | [report](/examples/shazam/report/index.html)  |
+| Spunky | [video](https://www.youtube.com/watch?v=WOhRWkdFaVk&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=6&t=25s) | [.feature](/examples/spunky/spunky.feature)|[stepsDef](../gh-pages/examples/spunky/step_definitions/kraken_steps.rb) | --- |  --- | [report](/examples/spunky/report/index.html)  |
+| Picap | [video](https://www.youtube.com/watch?v=RozQrmH_Z5k&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=7&t=3s) | [.feature](/examples/picap/picap.feature)|[stepsDef](../gh-pages/examples/picap/step_definitions/kraken_steps.rb) | [.json](/examples/picap/kraken_properties.json) |  --- | [report](/examples/picap/report/index.html)  |
+| AskFM | [video](https://www.youtube.com/watch?v=d9Gbdx8kFX8&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=8&t=0s) | [.feature](/examples/askfm/askfm.feature)|[stepsDef](../gh-pages/examples/askfm/step_definitions/kraken_steps.rb) | --- |  --- | [report](/examples/askfm/report/index.html)  |
+| Stick Men Fight | [video](https://www.youtube.com/watch?v=36OJKNj0nSo&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=9&t=4s) | [.feature](/examples/stick/stick.feature)|--- | --- |  --- | [report](/examples/stick/report/index.html)  |
+| Tic Tac Toe | [video](https://www.youtube.com/watch?v=F9pDJDYsL_w&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=10&t=2s) | [.feature](/examples/tictactoe/tictactoe.feature)|[stepsDef](../gh-pages/examples/tictactoe/step_definitions/kraken_steps.rb) | --- |  --- | [report](/examples/tictactoe/report/index.html)  |
+| Tumblr | [video](https://www.youtube.com/watch?v=eqFej2uJz4k&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=11&t=3s) | [.feature](/examples/tumblr/tumblr.feature)|[stepsDef](../gh-pages/examples/tumblr/step_definitions/kraken_steps.rb) | [.json](/examples/tumblr/kraken_properties.json) |  --- | [report](/examples/tumblr/report/index.html)  |
+| F3 | [video](https://www.youtube.com/watch?v=vESh6Jyp-so&list=PLF5U8kfVgRcJ3RCHt7cWmwlqN93brbVW-&index=12&t=0s) | [.feature](/examples/f3/f3.feature)|[stepsDef](../gh-pages/examples/f3/step_definitions/kraken_steps.rb) | [.json](/examples/f3/kraken_properties.json) |  --- | [report](/examples/f3/report/index.html)  |

data/bin/kraken-mobile

@@ -62,13 +62,22 @@ else
   when 'setup'
     KrakenSetup.new.run
   when 'gen'
+    ensure_java_installed
+    ensure_android_sdk_installed
+
     scaffold_folder_structure
   when 'resign'
+    ensure_java_installed
+    ensure_android_sdk_installed
+
     require 'calabash-android/helpers'
     puts 'Resigning APK with Calabash-Android'
     ensure_apk_is_specified
     resign_apk(user_entered_apk_path)
   when 'run'
+    ensure_java_installed
+    ensure_android_sdk_installed
+
     require File.join(File.dirname(__FILE__), 'kraken_mobile_calabash_android')
     configuration = read_configuration
     user_entered_properties_path = read_user_entered_properties_path

data/bin/kraken_mobile_helpers.rb

@@ -89,3 +89,19 @@ def ensure_properties_is_valid(properties)
   puts 'The path of the properties file is not valid.'
   exit 1
 end
+
+def ensure_android_sdk_installed
+  return unless ENV['ANDROID_HOME'].nil?
+
+  puts 'To use Kraken you need to have installed Android SDK first. '\
+        'Make sure you have the environment variable ANDROID_HOME configured'
+  exit 1
+end
+
+def ensure_java_installed
+  return unless ENV['ANDROID_HOME'].nil?
+
+  puts 'To use Kraken you need to have installed Java first.'\
+        'Make sure you have the environment variable JAVA_HOME configured'
+  exit 1
+end

data/bin/kraken_mobile_setup.rb

@@ -1,9 +1,11 @@
 require 'io/console'
 require 'tty-prompt'
+$LOAD_PATH << File.expand_path('../lib', __dir__)
+require 'kraken-mobile/utils/k.rb'
 
 class KrakenSetup
   WEB_IDENTIFIER = 'Web'.freeze
-  IS_WEB_AVAILABLE_FOR_SELECTION = false
+  IS_WEB_AVAILABLE_FOR_SELECTION = true
 
   attr_accessor :prompt
   attr_accessor :devices_connected_id
@@ -85,6 +87,7 @@ class KrakenSetup
     @settings[user_id] = {
       id: device_id,
       model: device.model,
+      type: K::ANDROID_DEVICE,
       config: {
         apk_path: apk
       }
@@ -96,6 +99,7 @@ class KrakenSetup
     @settings[user_id] = {
       id: device.id,
       model: device.model,
+      type: K::WEB_DEVICE,
       config: {}
     }
   end

data/lib/kraken-mobile/device_process.rb

@@ -1,3 +1,5 @@
+require 'fileutils'
+
 # Abstract class
 class DeviceProcess
   attr_accessor :id
@@ -43,12 +45,40 @@ class DeviceProcess
     end
   end
 
+  def unregister_process_from_directory
+    File.open(K::DIRECTORY_PATH, 'r') do |f|
+      File.open("#{K::DIRECTORY_PATH}.tmp", 'w') do |f2|
+        f.each_line do |line|
+          f2.write(line) unless line.start_with?(
+            "#{id}#{K::SEPARATOR}#{device}"
+          )
+        end
+      end
+    end
+    FileUtils.mv("#{K::DIRECTORY_PATH}.tmp", K::DIRECTORY_PATH)
+  end
+
   def notify_ready_to_start
     File.open(K::DIRECTORY_PATH, 'a') do |file|
       file.puts("#{id}#{K::SEPARATOR}#{device}")
     end
   end
 
+  def running_on_windows?
+    RbConfig::CONFIG['host_os'] =~ /cygwin|mswin|mingw|bccwin|wince|emx/
+  end
+
+  def exporting_command_for_environment_variables(variables = {})
+    commands = variables.map do |key, value|
+      if running_on_windows?
+        "(SET \"#{key}=#{value}\")"
+      else
+        "#{key}=#{value};export #{key}"
+      end
+    end
+    commands.join(terminal_command_separator)
+  end
+
   def self.directory
     return [] unless File.exist?(K::DIRECTORY_PATH)
 
@@ -91,4 +121,10 @@ class DeviceProcess
 
     devices_ready || []
   end
+
+  def terminal_command_separator
+    return ' & ' if running_on_windows?
+
+    ';'
+  end
 end

data/lib/kraken-mobile/helpers/kraken_faker.rb

@@ -1,5 +1,5 @@
 require 'faker'
-require 'kraken-mobile/utils/k'
+require 'kraken-mobile/utils/k.rb'
 require 'json'
 
 class KrakenFaker
@@ -56,6 +56,7 @@ class KrakenFaker
     absolute_dictionary_path = File.expand_path(K::DICTIONARY_PATH)
     file = open(absolute_dictionary_path)
     content = file.read
+    file.close
     JSON.parse(content)
   end
 

data/lib/kraken-mobile/helpers/reporter.rb

@@ -26,6 +26,7 @@ module KrakenMobile
       # Variables
       report_file = open("#{KrakenMobile::Constants::REPORT_PATH}/#{@execution_id}/#{KrakenMobile::Constants::REPORT_DEVICES_FILE_NAME}.json")
       content = report_file.read
+      report_file.close
       @devices = JSON.parse(content)
       devices_report = report_by_devices(@devices)
       @features_report = fetures_from_report_by_devices devices_report
@@ -45,6 +46,7 @@ module KrakenMobile
       @apk_path = device.config["apk_path"] ? device.config["apk_path"] : @options[:apk_path]
       report_file = open("#{KrakenMobile::Constants::REPORT_PATH}/#{@execution_id}/#{device.id}/#{KrakenMobile::Constants::REPORT_FILE_NAME}.json")
       content = report_file.read
+      report_file.close
       @features = JSON.parse(content)
       @total_scenarios = total_scenarios @features
       @device = device
@@ -70,6 +72,7 @@ module KrakenMobile
         next if !File.exists?("#{KrakenMobile::Constants::REPORT_PATH}/#{@execution_id}/#{device['id']}/#{KrakenMobile::Constants::REPORT_FILE_NAME}.json")
         report_file = open("#{KrakenMobile::Constants::REPORT_PATH}/#{@execution_id}/#{device['id']}/#{KrakenMobile::Constants::REPORT_FILE_NAME}.json")
         content = report_file.read
+        report_file.close
         devices_report[device['user']] = JSON.parse(content)
         devices_report[device['user']].each do |d| d["device_model"] = device["model"] if !d["device_model"] end
         devices_report[device['user']].each do |d| d["device_id"] = device["id"] if !d["device_id"] end

data/lib/kraken-mobile/mobile/mobile_process.rb

@@ -1,5 +1,5 @@
 require 'kraken-mobile/device_process.rb'
-require 'kraken-mobile/utils/k'
+require 'kraken-mobile/utils/k.rb'
 
 class MobileProcess < DeviceProcess
   #-------------------------------
@@ -11,6 +11,7 @@ class MobileProcess < DeviceProcess
   end
 
   def after_execute
+    unregister_process_from_directory
     device.delete_inbox
   end
 
@@ -42,15 +43,32 @@ class MobileProcess < DeviceProcess
   private
 
   def execution_command
+    "|#{environment_variables_command}#{terminal_command_separator}"\
+    "#{running_process_command}"
+  end
+
+  def running_process_command
     feature_path = test_scenario.feature_file.file_path
     raise 'ERROR: Invalid feature file path' if feature_path.nil?
 
     process_apk_path = apk_path
     raise 'ERROR: Invalid APK file path' if process_apk_path.nil?
 
-    "|ADB_DEVICE_ARG=#{device.id} calabash-android run #{process_apk_path} "\
-    "#{feature_path} --tags @user#{id} --format pretty --format json -o "\
-    "#{K::REPORT_PATH}/#{@test_scenario.execution_id}/#{device.id}/#{K::FILE_REPORT_NAME}" # TODO, folder to save all things
+    "calabash-android run #{process_apk_path} \
+    #{feature_path} --tags @user#{id} \
+    --require features/support/env.rb \
+    --require features/support/app_installation_hooks.rb \
+    --require features/support/app_life_cycle_hooks.rb \
+    --require features/step_definitions/mobile_steps.rb \
+    --format pretty --format json -o \
+    #{K::REPORT_PATH}/#{@test_scenario.execution_id}/#{device.id}/#{K::FILE_REPORT_NAME}"
+  end
+
+  def environment_variables_command
+    variables = {
+      ADB_DEVICE_ARG: device.id
+    }
+    exporting_command_for_environment_variables(variables)
   end
 
   #-------------------------------
@@ -61,6 +79,7 @@ class MobileProcess < DeviceProcess
     config_absolute_path = File.expand_path(ENV[K::CONFIG_PATH])
     file = open(config_absolute_path)
     content = file.read
+    file.close
     JSON.parse(content)[@id.to_s] || {}
   end
 

data/lib/kraken-mobile/models/feature_file.rb

@@ -22,24 +22,49 @@ class FeatureFile
   #-------------------------------
   # Helpers
   #-------------------------------
-  def number_of_required_mobile_devices
+  def user_tags
     all_tags = @scenarios.map(&:tags).flatten.uniq
-    mobile_tagged_count = all_tags.select { |tag| tag == '@mobile' }.count
-    empty_tagged_scenarios = @scenarios.select do |scenario|
-      !scenario.tags.include?('@mobile') &&
-        !scenario.tags.include?('@web')
+    all_tags.select { |tag| tag.start_with?('@user') }
+  end
+
+  def system_tags
+    @scenarios.map do |scenario|
+      tags = scenario.tags
+      system_tag = tags.select do |tag|
+        tag.start_with?('@web') || tag.start_with?('@mobile')
+      end.first
+      system_tag || '@mobile'
     end
-    mobile_tagged_count + empty_tagged_scenarios.count
+  end
+
+  def number_of_required_mobile_devices
+    system_tags.select { |tag| tag == '@mobile' }.count
   end
 
   def number_of_required_web_devices
-    all_tags = @scenarios.map(&:tags).flatten.uniq
-    all_tags.select { |tag| tag == '@web' }.count
+    system_tags.select { |tag| tag == '@web' }.count
   end
 
   def number_of_required_devices
-    all_tags = @scenarios.map(&:tags).flatten.uniq
-    all_tags.select { |tag| tag.start_with?('@user') }.count
+    user_tags.count
+  end
+
+  def required_devices
+    users = user_tags
+    systems = system_tags
+
+    users.map do |user|
+      {
+        user_id: user.delete_prefix('@user'),
+        system_type: systems.shift || '@mobile'
+      }
+    end
+  end
+
+  def sorted_required_devices
+    required_devices.sort_by do |device|
+      device[:user_id].to_i
+    end
   end
 
   def tags_for_user_id(user_id)
@@ -95,7 +120,9 @@ class FeatureFile
 
   def read_content
     parser = Gherkin::Parser.new
-    file_content = File.open(file_path).read
+    file = File.open(file_path)
+    file_content = file.read
+    file.close
     gherkin_document = parser.parse(file_content)
     pickles = Gherkin::Pickles::Compiler.new.compile(gherkin_document)
     pickles.each do |scenario|

data/lib/kraken-mobile/models/web_device.rb

@@ -5,7 +5,8 @@ class WebDevice < Device
   # Signaling
   #-------------------------------
   def create_inbox
-    File.open(inbox_file_path, 'w')
+    file = File.open(inbox_file_path, 'w')
+    file.close
   end
 
   def delete_inbox
@@ -80,7 +81,9 @@ class WebDevice < Device
   end
 
   def inbox_last_signal
-    lines = File.open(inbox_file_path).to_a
+    file = File.open(inbox_file_path)
+    lines = file.to_a
+    file.close
     lines.last&.strip
   end
 end

data/lib/kraken-mobile/monkeys/web/web_monkey.rb

@@ -0,0 +1,63 @@
+require 'selenium-webdriver'
+require 'faker'
+
+class WebMonkey
+  attr_accessor :driver
+  attr_accessor :wait
+  DEFAULT_WAIT_TIMEOUT = 0.5
+
+  def initialize(driver:)
+    self.driver = driver
+    self.wait = Selenium::WebDriver::Wait.new(timeout: DEFAULT_WAIT_TIMEOUT)
+  end
+
+  # Helpers
+  def execute_kraken_monkey(number_of_events)
+    number_of_events.times do |_i|
+      execute_random_action
+    end
+  end
+
+  def execute_random_action
+    arr = [
+      method(:random_click), method(:insert_random_text)
+    ]
+    arr.sample.call
+  rescue StandardError => _e
+    nil
+  end
+
+  def random_click
+    element = @wait.until { driver.find_elements(:xpath, '//*').sample }
+    highlight_element(element)
+    element.click
+    remove_element_highlight(element)
+  end
+
+  def insert_random_text
+    element = @wait.until { driver.find_elements(:xpath, '//input').sample }
+    highlight_element(element)
+    element.click
+    text = [Faker::Lorem.word, Faker::Lorem.sentence].sample
+    element.send_keys(text)
+    remove_element_highlight(element)
+  end
+
+  private
+
+  def highlight_element(element)
+    @driver.execute_script(
+      "arguments[0].setAttribute('style', arguments[1]);",
+      element,
+      'color: red; border: 2px solid red'
+    )
+  end
+
+  def remove_element_highlight(element)
+    @driver.execute_script(
+      "arguments[0].setAttribute('style', arguments[1]);",
+      element,
+      ''
+    )
+  end
+end

data/lib/kraken-mobile/runners/calabash/android/steps/communication_steps.rb

@@ -9,6 +9,7 @@ ParameterType(
       s.slice!(">")
       file = open(ENV["PROPERTIES_PATH"])
       content = file.read
+      file.close
       properties = JSON.parse(content)
       raise "Property <#{s}> not found for #{channel}" if !properties[channel] || !properties[channel][s]
       return properties[channel][s]

data/lib/kraken-mobile/steps/general_steps.rb

@@ -64,6 +64,7 @@ def all_user_properties_as_json
 
   file = open(properties_absolute_path)
   content = file.read
+  file.close
   JSON.parse(content)
 end
 

data/lib/kraken-mobile/steps/mobile/kraken_steps.rb

@@ -1,5 +1,5 @@
 require 'calabash-android/calabash_steps'
-require 'kraken-mobile/utils/K'
+require 'kraken-mobile/utils/k.rb'
 require 'kraken-mobile/models/android_device'
 require 'kraken-mobile/steps/general_steps'
 

data/lib/kraken-mobile/steps/web/kraken_steps.rb

@@ -1,30 +1,35 @@
+require 'kraken-mobile/monkeys/web/web_monkey'
+require 'kraken-mobile/steps/general_steps'
+require 'kraken-mobile/utils/k.rb'
 require 'selenium-webdriver'
 require 'uri'
 
-driver = Selenium::WebDriver.for :chrome
+Before do
+  @driver = Selenium::WebDriver.for((ENV['BROWSER'] || 'chrome').to_sym)
+end
 
 Given(/^I navigate to page "([^\"]*)"$/) do |web_url|
   raise 'ERROR: Invalid URL' if web_url.nil?
   raise 'ERROR: Invalid URL' unless web_url =~ URI::DEFAULT_PARSER.make_regexp
 
-  driver.navigate.to web_url
+  @driver.navigate.to web_url
   sleep 2
 end
 
 Then(/^I enter "([^\"]*)" into input field having id "([^\"]*)"$/) do |text, id|
-  driver.find_element(:id, id).send_keys(text)
+  @driver.find_element(:id, id).send_keys(text)
   sleep 2
 end
 
 Then(
   /^I enter "([^\"]*)" into input field having css selector "([^\"]*)"$/
 ) do |text, selector|
-  driver.find_element(:css, selector).send_keys(text)
+  @driver.find_element(:css, selector).send_keys(text)
   sleep 2
 end
 
 Then(/^I click on element having id "(.*?)"$/) do |id|
-  driver.find_element(:id, id).click
+  @driver.find_element(:id, id).click
   sleep 2
 end
 
@@ -35,7 +40,7 @@ Then(/^I wait for (\d+) seconds$/) do |seconds|
 end
 
 Then(/^I should see text "(.*?)"$/) do |text|
-  driver.page_source.include?(text)
+  @driver.page_source.include?(text)
 end
 
 # Kraken Steps
@@ -73,9 +78,14 @@ Then(
   device.read_signal(signal, seconds)
 end
 
-private
+Then(/^I start a monkey with (\d+) events$/) do |number_of_events|
+  monkey = WebMonkey.new(driver: @driver)
+  monkey.execute_kraken_monkey(number_of_events)
+end
 
-def current_process_id
-  tag_process_id = @scenario_tags.grep(/@user/).first
-  tag_process_id.delete_prefix('@user')
+# Hooks
+AfterStep do |_scenario|
+  path = "#{ENV[K::SCREENSHOT_PATH]}/#{SecureRandom.hex(12)}.png"
+  @driver.save_screenshot(path)
+  embed(path, 'image/png', File.basename(path))
 end

data/lib/kraken-mobile/test_scenario.rb

@@ -5,7 +5,7 @@ require 'kraken-mobile/models/web_device'
 require 'kraken-mobile/web/web_process'
 require 'kraken-mobile/utils/reporter'
 require 'kraken-mobile/mobile/adb'
-require 'kraken-mobile/utils/k'
+require 'kraken-mobile/utils/k.rb'
 require 'parallel'
 
 class TestScenario
@@ -27,6 +27,9 @@ class TestScenario
     @kraken_app = kraken_app
     @execution_id = Digest::SHA256.hexdigest(Time.now.to_f.to_s)
     @reporter = Reporter.new(test_scenario: self)
+
+    ensure_apk_specified_if_necessary
+    setup_scenario_environment_variables
   end
 
   #-------------------------------
@@ -70,11 +73,12 @@ class TestScenario
     Parallel.map_with_index(
       @devices, in_threads: @devices.count
     ) do |device, index|
-      user_id = index + 1
-      start_process_for_user_id_in_device(
-        user_id,
-        device
-      )
+      unless device.nil?
+        user_id = index + 1
+        start_process_for_user_id_in_device(
+          user_id, device
+        )
+      end
     end
   end
 
@@ -135,7 +139,11 @@ class TestScenario
   def sample_devices
     return predefined_devices if requires_predefined_devices?
 
-    (sample_mobile_devices + sample_web_devices).flatten
+    mobile = sample_mobile_devices
+    web = sample_web_devices
+    @feature_file.sorted_required_devices.map do |device|
+      device[:system_type] == '@web' ? web.shift : mobile.shift
+    end
   end
 
   def sample_mobile_devices
@@ -181,13 +189,39 @@ class TestScenario
     config_absolute_path = File.expand_path(ENV[K::CONFIG_PATH])
     file = open(config_absolute_path)
     content = file.read
+    file.close
     devices_json = JSON.parse(content).values
-
     devices_json.map do |device_json|
-      AndroidDevice.new(
-        id: device_json['id'],
-        model: device_json['model']
-      )
+      if device_json['type'] == K::ANDROID_DEVICE
+        AndroidDevice.new(
+          id: device_json['id'], model: device_json['model']
+        )
+      elsif device_json['type'] == K::WEB_DEVICE
+        WebDevice.new(
+          id: device_json['id'], model: device_json['model']
+        )
+      else
+        raise 'ERROR: Platform not supported'
+      end
     end
   end
+
+  def apk_required?
+    sample_mobile_devices.any? && ENV[K::CONFIG_PATH].nil?
+  end
+
+  def ensure_apk_specified_if_necessary
+    return unless apk_required?
+    return unless @kraken_app&.apk_path.nil?
+
+    raise 'ERROR: Invalid APK file path'
+  end
+
+  def setup_scenario_environment_variables
+    return if @kraken_app.nil? || @reporter.nil?
+
+    @kraken_app.save_value_in_environment_variable_with_name(
+      name: K::SCREENSHOT_PATH, value: @reporter.screenshot_path
+    )
+  end
 end

data/lib/kraken-mobile/utils/k.rb

@@ -18,6 +18,7 @@ module K
   REPORT_PATH = './reports' unless defined? REPORT_PATH
   FILE_REPORT_NAME = 'report.json' unless defined? FILE_REPORT_NAME
   D3_DATA_FILE_NAME = 'data.json' unless defined? D3_DATA_FILE_NAME
+  SCREENSHOT_PATH = 'SCREENSHOT_PATH' unless defined? SCREENSHOT_PATH
 
   unless defined? DEVICES_REPORT_FILE_NAME
     DEVICES_REPORT_FILE_NAME = 'devices.json'

data/lib/kraken-mobile/utils/reporter.rb

@@ -1,4 +1,4 @@
-require 'kraken-mobile/utils/k'
+require 'kraken-mobile/utils/k.rb'
 require 'json'
 
 class Reporter
@@ -48,6 +48,7 @@ class Reporter
       "#{K::REPORT_PATH}/#{test_execution_id}/#{K::DEVICES_REPORT_FILE_NAME}"
     )
     content = report_file.read
+    report_file.close
     devices_report = report_by_devices
     @features_report = fetures_from_report_by_devices(devices_report)
     data_hash = feature_by_nodes_and_links @features_report
@@ -71,6 +72,16 @@ class Reporter
   end
 
   def generate_device_report(device, id)
+    if device.is_a? AndroidDevice
+      generate_mobile_report(device, id)
+    elsif device.is_a? WebDevice
+      generate_web_report(device, id)
+    else
+      raise 'ERROR: Platform not supported'
+    end
+  end
+
+  def generate_mobile_report(device, id)
     process = MobileProcess.new(
       id: id,
       device: device,
@@ -79,6 +90,36 @@ class Reporter
     @apk_path = process.apk_path
     report_file = open("#{K::REPORT_PATH}/#{test_execution_id}/#{device.id}/#{K::FILE_REPORT_NAME}")
     content = report_file.read
+    report_file.close
+    @features = JSON.parse(content)
+    @total_scenarios = total_scenarios @features
+    @device = device
+    @total_failed_scenarios_percentage = total_failed_scenarios_percentage @features
+    @total_passed_scenarios_percentage = total_passed_scenarios_percentage @features
+    @total_passed_features_percentage = total_passed_features_percentage @features
+    @total_failed_features_percentage = total_failed_features_percentage @features
+    erb_file = File.join(File.expand_path('../../../../reporter', __FILE__), "feature_report.html.erb")
+    html_file = File.join(File.expand_path("#{K::REPORT_PATH}/#{test_execution_id}/#{device.id}/"), File.basename(erb_file, '.erb')) #=>"page.html"
+    # Variables
+    template = File.read(erb_file)
+    result = ERB.new(template).result(binding)
+    # write result to file
+    File.open(html_file, 'w+') do |f|
+      f.write result
+    end
+    generate_features_report @features, device
+  end
+
+  def generate_web_report(device, id)
+    process = WebProcess.new(
+      id: id,
+      device: device,
+      test_scenario: @test_scenario
+    )
+    @apk_path = nil
+    report_file = open("#{K::REPORT_PATH}/#{test_execution_id}/#{device.id}/#{K::FILE_REPORT_NAME}")
+    content = report_file.read
+    report_file.close
     @features = JSON.parse(content)
     @total_scenarios = total_scenarios @features
     @device = device
@@ -110,6 +151,7 @@ class Reporter
   def create_report_execution_report_folder
     Dir.mkdir(K::REPORT_PATH) unless File.exist?(K::REPORT_PATH)
     Dir.mkdir("#{K::REPORT_PATH}/#{test_execution_id}")
+    Dir.mkdir(screenshot_path)
     FileUtils.cp_r(
       File.expand_path(K::REPORT_ASSETS_PATH, __FILE__),
       "#{K::REPORT_PATH}/#{test_execution_id}/"
@@ -134,6 +176,10 @@ class Reporter
     end
   end
 
+  def screenshot_path
+    "#{K::REPORT_PATH}/#{test_execution_id}/screenshots/"
+  end
+
   private
 
   def generate_features_report features, device
@@ -170,6 +216,7 @@ class Reporter
         "#{K::REPORT_PATH}/#{test_execution_id}/#{device[:id]}/#{K::FILE_REPORT_NAME}"
       )
       content = report_file.read
+      report_file.close
       devices_report[device[:user]] = JSON.parse(content)
       devices_report[device[:user]].each do |d| d['device_model'] = device[:model] if !d['device_model'] end
       devices_report[device[:user]].each do |d| d['device_id'] = device[:id] if !d['device_id'] end
@@ -316,7 +363,7 @@ class Reporter
   def devices
     raise 'ERROR: Invalid test scenario' if @test_scenario.nil?
 
-    @test_scenario.devices
+    @test_scenario.devices.compact
   end
 
   def devices_json

data/lib/kraken-mobile/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module KrakenMobile
-  VERSION = '1.0.5'
+  VERSION = '1.0.8'
 end

data/lib/kraken-mobile/web/web_process.rb

@@ -10,6 +10,7 @@ class WebProcess < DeviceProcess
   end
 
   def after_execute
+    unregister_process_from_directory
     device.delete_inbox
   end
 
@@ -31,9 +32,10 @@ class WebProcess < DeviceProcess
     feature_path = test_scenario.feature_file.file_path
     raise 'ERROR: Invalid feature file path' if feature_path.nil?
 
-    # TODO, only execute one file
-    "|cucumber --tags @user#{id}\
+    "|cucumber #{feature_path} --tags @user#{id} \
     --require features/web/step_definitions/web_steps.rb \
-    --require features/web/support/app_life_cycle_hooks.rb"
+    --require features/web/support/app_life_cycle_hooks.rb \
+    --format pretty --format json -o \
+    #{K::REPORT_PATH}/#{@test_scenario.execution_id}/#{device.id}/#{K::FILE_REPORT_NAME}"
   end
 end

data/lib/kraken_mobile.rb

@@ -27,17 +27,37 @@ class KrakenApp
     build_scenarios_queue
   end
 
-  def start
+  #-------------------------------
+  # Observers
+  #-------------------------------
+  def on_test_scenario_finished
     execute_next_scenario
   end
 
   #-------------------------------
-  # Observers
+  # Helpers
   #-------------------------------
-  def on_test_scenario_finished
+
+  def start
     execute_next_scenario
   end
 
+  def save_path_in_environment_variable_with_name(name:, path:)
+    return if path.nil?
+
+    absolute_path = File.expand_path(path)
+    save_value_in_environment_variable_with_name(
+      name: name,
+      value: absolute_path
+    )
+  end
+
+  def save_value_in_environment_variable_with_name(name:, value:)
+    return if name.nil? || value.nil?
+
+    ENV[name] = value
+  end
+
   private
 
   def build_scenarios_queue
@@ -58,20 +78,4 @@ class KrakenApp
     scenario.run
     scenario
   end
-
-  def save_path_in_environment_variable_with_name(name:, path:)
-    return if path.nil?
-
-    absolute_path = File.expand_path(path)
-    save_value_in_environmant_variable_with_name(
-      name: name,
-      value: absolute_path
-    )
-  end
-
-  def save_value_in_environmant_variable_with_name(name:, value:)
-    return if name.nil? || value.nil?
-
-    ENV[name] = value
-  end
 end

data/reporter/feature_report.html.erb

@@ -175,7 +175,11 @@
                 <%= device.model %> - <%= device.id %>
               </td>
               <td>
-                <i class="fa fa-android fa-lg"><span>android</span></i>
+                <% if device.type == K::ANDROID_DEVICE %>
+                  <i class="fa fa-android fa-lg"><span>android</span></i>
+                <% else %>
+                  <i class="fa fa-globe fa-lg"><span>web</span></i>
+                <% end %>
               </td>
               <td>
                 <%= @apk_path %>

data/reporter/index.html.erb

@@ -599,12 +599,18 @@
         <div class="ui-card col-md-3">
           <div class="container device-container">
             <div class="row device-os-icon">
-              <i class="fa fa-android fa-lg"></i>
+              <% if device[:type] == K::ANDROID_DEVICE %>
+                <i class="fa fa-android fa-lg"></i>
+              <% else %>
+                <i class="fa fa-globe fa-lg"></i>
+              <% end %>
             </div>
             <div class="row device-title"><%= device[:model] %></div>
             <div class="row device-info">ID - <%= device[:id] %></div>
-            <div class="row device-info">SDK Version - <%= device[:sdk] %></div>
-            <div class="row device-info">Screen Size - <%= "#{device[:screen_height]}x#{device[:screen_width]}" %></div>
+            <% if device[:type] == K::ANDROID_DEVICE %>
+              <div class="row device-info">SDK Version - <%= device[:sdk] %></div>
+              <div class="row device-info">Screen Size - <%= "#{device[:screen_height]}x#{device[:screen_width]}" %></div>
+            <% end %>
             <div class="row device-info result-btn">
               <a href='<%= "./#{device[:id]}/feature_report.html" %>'>See Results</a>
             </div>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kraken-mobile
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.8
 platform: ruby
 authors:
 - William Ravelo M
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-03-20 00:00:00.000000000 Z
+date: 2021-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cucumber
@@ -100,14 +100,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.142.7
+        version: 3.14.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.142.7
+        version: 3.14.0
 - !ruby/object:Gem::Dependency
   name: faker
   requirement: !ruby/object:Gem::Requirement
@@ -166,6 +166,7 @@ files:
 - lib/kraken-mobile/models/web_device.rb
 - lib/kraken-mobile/monkeys/mobile/android_monkey.rb
 - lib/kraken-mobile/monkeys/mobile/kraken_android_monkey.rb
+- lib/kraken-mobile/monkeys/web/web_monkey.rb
 - lib/kraken-mobile/protocols/file_protocol.rb
 - lib/kraken-mobile/runners/calabash/android/android_runner.rb
 - lib/kraken-mobile/runners/calabash/android/apk_signer.rb
@@ -227,7 +228,7 @@ homepage: https://github.com/TheSoftwareDesignLab/KrakenMobile
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -242,8 +243,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.0.8
+signing_key:
 specification_version: 4
 summary: Automated E2E mobile testing involving intercommunication scenarios.
 test_files: []