parallel_appium 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0dd9bf8c3fad781b6c92dac1b50418460552e227
-  data.tar.gz: ff75fc96b8a649452ef4eb0e750d395f00bac941
+  metadata.gz: fcfc289c2b24a3fb4ee3e8be46e9b9c9a4479754
+  data.tar.gz: 7af36ebcd29622f33fd4dddeccc4b60a40bd1d2c
 SHA512:
-  metadata.gz: d733a1478338bf3b88ef7d6e1791f6992becce51397a7658a4f65299511b8d7d65b16da180312d3905e8164093cd3812e0be20bf2a348a7665031bb8d58de26c
-  data.tar.gz: 95c786e84905a10948994273ddf1f8f510fdd40488c8e9f8f012fb1733022484bc6a150ea779908f4a6d8ff33891afcee1e41a1f1b57aeed0a9a3af65aae2baa
+  metadata.gz: 6e6f21359696283cfe95dee022803464eb6e61e0348282ef2545fef2c0a5c31af229f9ad3e76d75dae69c21395cc7a62bb8855a40c79a8ca1e4785386d1379ff
+  data.tar.gz: f06af407504f7304577c1eed08bcf4d536867bad468ed4ef4c05f3c9b57f2b670543c06d902ce102f5984e844eae31ed7981239a8368838b65e92ebba89f58df

data/.gitignore

@@ -454,4 +454,6 @@ hsd-report
 
 tmp/
 
-.vscode/
+.vscode/
+
+*.sh

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    parallel_appium (0.2.0)
+    parallel_appium (0.2.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,26 +1,85 @@
 # parallel_appium
 
-Distributed mobile testing in Appium
+Single and Distributed Parallel mobile testing in Appium and RSpec fro Android and iOS
+
+## Quick check
+
+If you'd like to check if you're good to go for this project simply execute
+
+```rake parallel_appium:validate_android``` for Android
+
+```rake parallel_appium:validate_ios``` for iOS
+
+
+The messages will indicate if there's any component necessary for the platform that's still not set up as yet.
+
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-```ruby
+```
 gem 'parallel_appium'
 ```
 
 And then execute:
 
-    $ bundle
+    $ bundle install
 
 Or install it yourself as:
 
     $ gem install parallel_appium
 
-## Usage
+## Getting started and ssage
+
+To get started with this gem there's 3 lines of code you'll need to know to include within your project.
+These lines handle the following.
+
+### Starting the servers
+
+The library at the moment doesn't offer the ability to connect to existing appium processes and instead 
+starts appium servers and the selenium grid server as needed. The following line of code is what you'll need to include
+for the library to handle this,
+
+```ParallelAppium::ParallelAppium.new.start platform: platform, file_path: file_path```
+
+where platform is either android, ios or all and file_path is the absolute path to the folder or spec file 
+to be executed. 
+
+### Initializing the appium instance(s)
+
+As expected each appium instance will need to be loaded with capabilities defining all kinds of important things 
+about how the tests executing on that instance will work, hence this will need to be done before the tests begin
+it's best to put this in some form of 'before all' block that will execute it prior to all the tests executing.
+
+The following line of code is an example of what you'll need to use
+
+```ParallelAppium::ParallelAppium.new.initialize_appium platform: ENV['platform']```
+
+The initialize_appium function can take two parameters
+
+1. platform - If provided it will look for a appium-{platform}.txt file in the root of the project and load capabilities
+from that location.
+2. caps - The capabilities as a map to be loaded. 
+
+### Setting UDID for the test
+
+When distributing tests across multiple devices the library spreads the specs across multiple threads and depends on the
+UDID environment variable to know which device it's working with for the specific test file, as such this will need to 
+be setup in each test file, simply include the following line of code at the top of the test file after any dependencies 
+and the library will set this up as needed,
+
+```ParallelAppium::Server.new.set_udid_environment_variable```
+
+This is all you need to get started with this library. There's a number of environment variables set by the library
+for the purpose of writing easier cross platform tests. These are described in more detail below.
+
+### Environment variables
+
+
+### Tags
+
 
-TODO: Write usage instructions here
 
 ## Development
 

data/Rakefile

@@ -5,24 +5,38 @@ RSpec::Core::RakeTask.new(:spec)
 
 task default: :spec
 
-
-# TODO: Move into functions
-desc 'Validate Android'
-task :validate_android do
-  %x(emulator 2>&1)
-  if $? == 0
-    puts "emulator command configured properly"
-  else
-    puts "emulator command not configured properly"
+# TODO: Move checks into gem
+namespace :parallel_appium do
+  desc 'Validate Android'
+  task :validate_android do
+    %x(which emulator 2>&1)
+    puts '==========================================='
+    can_do_android = true
+    can_do_android = can_do_android && ($? == 0)
+    if can_do_android
+      puts "emulator command configured properly"
+    else
+      puts "emulator command not configured properly"
+      exit
+    end
+    puts '==========================================='
+    puts 'Android good to go'
   end
-end
 
-desc 'Validate iOS'
-task :validate_ios do
-  %x(instruments 2>&1)
-  if $? == 0
-    puts "instruments command configured properly"
-  else
-    puts "instruments command not configured properly"
+  desc 'Validate iOS'
+  task :validate_ios do
+    %x(which instruments 2>&1)
+    puts '==========================================='
+    can_do_ios = true
+    can_do_ios = can_do_ios && ($? == 0)
+    if can_do_ios
+      puts "instruments command configured properly"
+    else
+      puts "instruments command not configured properly"
+      exit
+    end
+
+    puts '==========================================='
+    puts 'iOS good to go'
   end
 end

data/build.sh

@@ -1 +1,2 @@
+#!/usr/bin/env bash
 gem build parallel_appium.gemspec

data/lib/parallel_appium/ios.rb

@@ -9,11 +9,11 @@ module ParallelAppium
 
     # Filter simulator data
     def simulator_information
-      re = /\([0-9]+\.[0-9]\) \[[0-9A-Z-]+\]/m
+      re = /\([0-9]+\.[0-9](\.[0-9])?\) \[[0-9A-Z-]+\]/m
 
       # Filter out simulator info for iPhone platform version and udid
       @simulators.select { |simulator_data| simulator_data.include?('iPhone') && !simulator_data.include?('Apple Watch') }
-                 .map { |simulator_data| simulator_data.scan(re)[0].tr('()[]', '').split }[0, ENV['THREADS'].to_i]
+                 .map { |simulator_data| simulator_data.match(re).to_s.tr('()[]', '').split }[0, ENV['THREADS'].to_i]
     end
 
     # Devices after cleanup and supplemental data included
@@ -28,3 +28,4 @@ module ParallelAppium
     end
   end
 end
+

data/lib/parallel_appium/version.rb

@@ -1,3 +1,3 @@
 module ParallelAppium
-  VERSION = '0.2.1'.freeze
+  VERSION = '0.2.2'.freeze
 end

data/lib/parallel_appium.rb

@@ -93,9 +93,9 @@ module ParallelAppium
     # @param [boolean] parallel
     def execute_specs(platform, threads, spec_path, parallel = false)
       command = if parallel
-                  "platform=#{platform} parallel_rspec -n #{threads} #{spec_path}  > output/#{platform}.log"
+                  "platform=#{platform} parallel_rspec -n #{threads} #{spec_path}  --out output/#{platform}.log"
                 else
-                  "platform=#{platform} rspec #{spec_path} --tag #{platform} > output/#{platform}.log"
+                  "platform=#{platform} rspec #{spec_path} --tag #{platform} --out output/#{platform}.log"
                 end
 
       puts "Executing #{command}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: parallel_appium
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Javon Davis
@@ -36,7 +36,7 @@ cert_chain:
   pjBkMT4ow4ZhVgBKPDT2jh74b8g2rIDSbkJIj0lf35WXqJqZzseabGPpTbtzJEap
   HIrd7mPILLe3
   -----END CERTIFICATE-----
-date: 2018-07-07 00:00:00.000000000 Z
+date: 2018-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appium_lib
@@ -159,7 +159,6 @@ files:
 - LICENSE
 - README.md
 - Rakefile
-- apps/.gitignore
 - bin/console
 - bin/setup
 - build.sh

data/apps/.gitignore

@@ -1,3 +0,0 @@
-# Created by .ignore support plugin (hsz.mobi)
-*.apk
-*.app