fastlane-plugin-bluepillarx 0.4.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 678cdf1452ce066f7a1732052c498f02f6795a1f
+  data.tar.gz: 11da0274758ee1197d2a0611142d9420081faa8e
+SHA512:
+  metadata.gz: 9a4a77b2eeaf192fae3e455b7be716b50d87b6e5809be72c38cfc4406bc8bcddb9a0ecfb7ae7cc656a95a32f511ecaa225adbd825c5be9d9a6877d45455e1d8b
+  data.tar.gz: a666b07702f94ea923b0ac172a2c0a3eceff2605336a503043b5a2d33c59d996093237adce92aafcbef47f61bcaa98837bfe3c123b5b39052cfe09c55bce2487

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Shashikant86 <shashikant.jagtap@icloud.com>
+
+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

@@ -0,0 +1,125 @@
+# bluepillarx plugin
+
+Based on the old bluepillar
+
+[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-bluepillarx)
+
+<a href="https://travis-ci.org/jterhorst/fastlane-plugin-bluepillarx/"><img src="https://img.shields.io/travis/jterhorst/fastlane-plugin-bluepillarx.svg" /></a>
+
+## Getting Started
+
+This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin to run XCUI Tests in parallel using Linkedin's Bluepill tool. To get started with `fastlane-plugin-bluepillarx`, add it to your project by running:
+
+
+
+```bash
+fastlane add_plugin bluepillarx
+```
+
+
+### Pre-requisite
+
+[Bluepill](https://github.com/linkedin/bluepill) homebrew package doesn't work well as it's lacking `bp` binary.
+We have to manually download `bluepill` and `bp` binaries from the Bluepill releases page on [Github](https://github.com/linkedin/bluepill/releases) and put in PATH. This plugin expect it inside `/usr/local/bin/` where all the other binaries live, so that we have `/usr/local/bin/bluepill` and `/usr/local/bin/bp` binaries in place.
+
+### Fastlane Setup
+
+We can setup Fastlane using some BluePill optins and Derived data.  
+
+ ##### BluePill Options
+
+ There are so many options available for the Bluepill but we just need few of them to get going and keep other options as default. This plugin provides basic 7 options as follows
+
+* `app` : PATH to your application. This is usually in the derived data `/Products/Debug-iphonesimulator/YOUR_APP.app`   
+
+* `runner_app_path` : PATH to UI Test runner app. This is usually in derived data `/Products/Debug-iphonesimulator\YOUR_UITEST_SCHEME-Runner.app` If you have a space in the Scheme name then you have to amend it with backslash in your path.
+
+* `scheme_path` : This is path to your scheme. This is usually in the `YOUR_PROJECT.xcodeproj/xcshareddata/xcschemes/YOUR_SCHEME.xcscheme`
+
+* `output_dir` : This is a directory where Bluepill will generate reports.
+
+* `num_sims` : Number of simulators to be launched.
+
+* `runtime` : The iOS version we want to run test against. Note we have to pass it as nested string like this `'"iOS 10.3"'`
+
+* `device`: The simulator to be used. We have to pass it as `'iPad Air'` or `'iPhone 6'`
+
+##### Generate Derived Data for Bluepill
+
+ It's good idea to generate derived data in the project itself using `build for testing` option.
+You can do that using Fastlane `scan` like this
+
+```
+scan(
+    scheme: YOUR_SCHEME,
+    build_for_testing: true,
+    derived_data_path: "./bluepill",
+    buildlog_path: "./bluepill/logs/"
+  )
+```
+This will generate derived data inside `bluepill` directory.
+
+##### Configure Fastfile
+Now that, all the Bluepill options are in place and we have generated derived data, we can configure lane in our `Fastfile` like this:
+
+```
+
+lane :test do
+    app: 'bluepill/Build/Products/Debug-iphonesimulator/Bluepillar.app',
+    runner_app_path: 'bluepill/Build/Products/Debug-iphonesimulator/BluepillarUITests-Runner.app',
+    scheme_path: 'Bluepillar.xcodeproj/xcshareddata/xcschemes/Bluepillar.xcscheme',
+    output_dir: 'bluepill_output/',
+    num_sims: '3',
+    runtime: '"iOS 10.3"',
+    device: 'iPad Air'
+end
+
+```
+Now that we can run test using fastlane like this :
+
+           $ fastlane test
+
+
+
+## About bluepillar
+
+Run XCUITests in Parallel using Bluepill. [Bluepill](https://github.com/linkedin/bluepill) is a tool from LinkedIn to run XCUI tests in the parallel.
+
+
+## Example
+
+There is sample example project available on Github [Bluepillar-Demo](https://github.com/Shashikant86/Bluepillar-Demo). Just clone it, replace the path to derived data and run
+
+
+             $ git clone git@github.com:Shashikant86/Bluepillar-Demo.git
+             $ bundle install
+             $ bundle exec fastlane test
+
+You can see sample report in the  `sample_bluepill_output` directory.
+
+
+
+## Run tests for this plugin
+
+To run both the tests, and code style validation, run
+
+```
+rake
+```
+
+To automatically fix many of the styling issues, use
+```
+rubocop -a
+```
+
+## Issues and Feedback
+
+For any other issues and feedback about this plugin, please submit it to this repository.
+
+## Troubleshooting
+
+If you have trouble using plugins, check out the [Plugins Troubleshooting](https://docs.fastlane.tools/plugins/plugins-troubleshooting/) guide.
+
+## Using _fastlane_ Plugins
+
+For more information about how the `fastlane` plugin system works, check out the [Plugins documentation](https://docs.fastlane.tools/plugins/create-plugin/).

data/lib/fastlane/plugin/bluepillarx.rb

@@ -0,0 +1,16 @@
+require 'fastlane/plugin/bluepillarx/version'
+
+module Fastlane
+  module Bluepillarx
+    # Return all .rb files inside the "actions" and "helper" directory
+    def self.all_classes
+      Dir[File.expand_path('**/{actions,helper}/*.rb', File.dirname(__FILE__))]
+    end
+  end
+end
+
+# By default we want to import all available actions and helpers
+# A plugin can contain any number of actions and plugins
+Fastlane::Bluepillarx.all_classes.each do |current|
+  require current
+end

data/lib/fastlane/plugin/bluepillarx/actions/bluepillarx_action.rb

@@ -0,0 +1,132 @@
+module Fastlane
+  module Actions
+    class BluepillarxAction < Action
+      BLUEPILL_PATH = '/usr/local/bin/bluepill'
+      BP_PATH = '/usr/local/bin/bp'
+      def self.run(params)
+        UI.message("Starting XCTests using the bluepillarx fastlane plugin!")
+        unless File.exist?(BLUEPILL_PATH)
+          UI.user_error!("You must download bluepill binary from Github and put it in /usr/local/bin/bluepill to carry on execution")
+        end
+
+        unless File.exist?(BP_PATH)
+          UI.user_error!("You must download bp binary from Github and put it in /usr/local/bin/bp to carry on execution")
+        end
+
+        bluepill_app_path = params[:app]
+        bluepill_runner_app_path = params[:runner_app_path]
+        bluepill_scheme_path = params[:scheme_path]
+        bluepill_num_sims = params[:num_sims]
+        bluepill_output_dir = params[:output_dir]
+        bluepill_runtime = params[:runtime]
+        bluepill_device = params[:device]
+        
+        bluepill_config_path = params[:config_path]
+
+
+        command = [
+          'bluepill' 
+        ]
+
+        command.concat ['-a', bluepill_app_path] if bluepill_app_path
+        command.concat ['-s', bluepill_scheme_path] if bluepill_scheme_path
+        command.concat ['-o', bluepill_output_dir] if bluepill_output_dir
+        command.concat ['-r', bluepill_runtime] if bluepill_runtime
+        command.concat ['-n', bluepill_num_sims] if bluepill_num_sims
+        if bluepill_device
+          processed_device = bluepill_device.gsub(/ /, '\ ')
+          command.concat ['-d', processed_device] if processed_device
+        end
+        command.concat ['-c', bluepill_config_path] if bluepill_config_path
+        command.concat ['-u', bluepill_runner_app_path] if bluepill_runner_app_path
+
+        Actions.sh(command.join(' '))
+      end
+
+      def self.description
+        "Run XCUITests in Parallel using Bluepill"
+      end
+
+      def self.authors
+        ["Shashikant86", "jterhorst"]
+      end
+
+      def self.return_value
+
+      end
+
+      def self.details
+        "This plugin will allow you to run XCUITests in Parallel using LinkedIn's Bluepil"
+      end
+
+      def self.available_options
+        [
+           FastlaneCore::ConfigItem.new(key: :app,
+                                       env_name: "BLUEPILLAR_APP_PATH",
+                                       description: "Path to the main app to be build for the bluepill in the Derived Data",
+                                       is_string: true,
+                                       optional: true),
+
+           FastlaneCore::ConfigItem.new(key: :runner_app_path,
+                                      env_name: "BLUEPILLAR_RUNNER_APP_PATH",
+                                      description: "Path to the test runner app in the Derived Data",
+                                      is_string: true,
+                                      optional: true),
+
+           FastlaneCore::ConfigItem.new(key: :scheme_path,
+                                     env_name: "BLUEPILLAR_XCTEST_SCHEME_PATH",
+                                     description: "Path to the scheme to be build for the bluepill in the .xcodeproj",
+                                     is_string: true,
+                                     optional: true),
+
+           FastlaneCore::ConfigItem.new(key: :output_dir,
+                                    env_name: "BLUEPILLAR_REPORT_PATH",
+                                    description: "Path to store simulator logs and test reports",
+                                    is_string: true,
+                                    optional: true),
+
+           FastlaneCore::ConfigItem.new(key: :num_sims,
+                                    env_name: "BLUEPILLAR_SUMULATORS",
+                                    description: "Number of sumulators to be launched",
+                                    is_string: true,
+                                    optional: true),
+
+           FastlaneCore::ConfigItem.new(key: :runtime,
+                                   env_name: "BLUEPILLAR_IOS_VERSION",
+                                   description: "The iOS version to be used for testing",
+                                   is_string: true,
+                                   optional: true),
+
+           FastlaneCore::ConfigItem.new(key: :device,
+                                   env_name: "BLUEPILLAR_IOS_DEVICE",
+                                   description: "The iOS device to be used for testing",
+                                   is_string: true,
+                                   optional: true),
+
+           FastlaneCore::ConfigItem.new(key: :config_path,
+                                   env_name: "BLUEPILLAR_CONFIG_PATH",
+                                   description: "Path for Bluepill config file",
+                                   is_string: true,
+                                   optional: true),
+        ]
+      end
+
+      def self.example_code
+           ['   bluepillarx(
+                    app: "bluepill/Build/Products/Debug-iphonesimulator/Bluepillar.app",
+                    runner_app_path: "bluepill/Build/Products/Debug-iphonesimulator/BluepillarUITests-Runner.app",
+                    scheme_path: "Bluepillar.xcodeproj/xcshareddata/xcschemes/Bluepillar.xcscheme",
+                    output_dir: "bluepill_output/",
+                    num_sims: "3",
+                    runtime: '"iOS 10.3"',
+                )
+          ']
+    end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+        true
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/bluepillarx/helper/bluepillarx_helper.rb

@@ -0,0 +1,12 @@
+module Fastlane
+  module Helper
+    class BluepillarxHelper
+      # class methods that you define here become available in your action
+      # as `Helper::BluepillarHelper.your_method`
+      #
+      def self.show_message
+        UI.message("Hello from the bluepillarx plugin helper!")
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/bluepillarx/version.rb

@@ -0,0 +1,5 @@
+module Fastlane
+  module Bluepillarx
+    VERSION = "0.4.3"
+  end
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-bluepillarx
+version: !ruby/object:Gem::Version
+  version: 0.4.3
+platform: ruby
+authors:
+- jterhorst
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-04-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fastlane
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.26.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.26.1
+description: 
+email: jterhorst@icloud.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/fastlane/plugin/bluepillarx.rb
+- lib/fastlane/plugin/bluepillarx/actions/bluepillarx_action.rb
+- lib/fastlane/plugin/bluepillarx/helper/bluepillarx_helper.rb
+- lib/fastlane/plugin/bluepillarx/version.rb
+homepage: https://github.com/jterhorst/fastlane-plugin-bluepillarx
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Fastlane Plugin to Run XCUITests in Parallel using Bluepill.
+test_files: []