new version for 1.0.7

Author: ravelinx22

README.md

@@ -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

bin/kraken-mobile

@@ -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

bin/kraken_mobile_helpers.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 @@ def save_mobile_device_settings_for_user_with_id(
     @settings[user_id] = {
       id: device_id,
       model: device.model,
+      type: K::ANDROID_DEVICE,
       config: {
         apk_path: apk
       }
@@ -96,6 +99,7 @@ def save_web_device_settings_for_user_with_id(user_id:)
     @settings[user_id] = {
       id: device.id,
       model: device.model,
+      type: K::WEB_DEVICE,
       config: {}
     }
   end

bin/kraken_mobile_setup.rb

@@ -0,0 +1,77 @@
+# Kraken web steps
+
+In this section we will list all available web steps in Kraken web.
+
+## Navigation
+
+Navigate to a specific website.
+
+```ruby
+Then /^I navigate to page "([^\"]*)"$/
+```
+
+## Clicking
+
+Click on a view with id.
+
+```ruby
+Then /^I click on element having id "(.*?)"$/
+```
+
+## Entering text
+
+Enter text in a specific input with id.
+
+```ruby
+Then /^I enter "([^\"]*)" into input field having id "([^\"]*)"$/
+```
+
+Enter text on a input with CSS selector.
+
+```ruby
+Then /^I enter "([^\"]*)" into input field having css selector "([^\"]*)"$/
+```
+
+## Waiting
+
+Wait for a specific amount of time.
+
+```ruby
+Then /^I wait for (\d+) seconds$/
+```
+
+## Assertion
+
+Assert that in current web page a text is present and visible.
+
+```ruby
+Then /^I should see text "(.*?)"$/
+```
+
+## Kraken Signaling
+
+Send a signal to another device containing a specific content.
+
+```ruby
+Then /^I send a signal to user (\d+) containing "([^\"]*)"$/
+```
+
+Wait for a signal coming from another device and containing specific content.
+
+```ruby
+Then /^I wait for a signal containing "([^\"]*)"$/
+```
+
+Wait for a signal coming from another device, containing specific content and for maximum amount of time.
+
+```ruby
+Then /^I wait for a signal containing "([^\"]*)" for (\d+) seconds$/
+```
+
+## Kraken Monkey
+
+Start Kraken monkey and run a specific amount of random events on the GUI.
+
+```ruby
+Then /^I start a monkey with (\d+) events$/
+```

docs/WEB_STEPS.md

@@ -31,7 +31,7 @@ Gem::Specification.new do |s|
   s.add_dependency( 'tty-prompt', '0.18.1')
   s.add_development_dependency 'byebug', '~> 11.1'
   s.add_dependency( 'capybara', '3.31.0')
-  s.add_dependency( 'selenium-webdriver', '3.142.7')
+  s.add_dependency( 'selenium-webdriver', '3.14.0')
   s.add_dependency( 'faker', '2.10.0')
 
   s.require_paths = ['lib']

kraken-mobile.gemspec

@@ -1,3 +1,5 @@
+require 'fileutils'
+
 # Abstract class
 class DeviceProcess
   attr_accessor :id
@@ -43,12 +45,40 @@ def register_process_to_directory
     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 @@ def self.processes_in_state(state)
 
     devices_ready || []
   end
+
+  def terminal_command_separator
+    return ' & ' if running_on_windows?
+
+    ';'
+  end
 end

lib/kraken-mobile/device_process.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 @@ def dictionary_json
     absolute_dictionary_path = File.expand_path(K::DICTIONARY_PATH)
     file = open(absolute_dictionary_path)
     content = file.read
+    file.close
     JSON.parse(content)
   end
 

lib/kraken-mobile/helpers/kraken_faker.rb

@@ -26,6 +26,7 @@ def generate_general_report
       # 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 @@ def generate_device_report device
       @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 @@ def report_by_devices devices
         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

lib/kraken-mobile/helpers/reporter.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 @@ def before_execute
   end
 
   def after_execute
+    unregister_process_from_directory
     device.delete_inbox
   end
 
@@ -42,15 +43,32 @@ def apk_path
   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 @@ def config_json
     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