scan 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9ff87db75cf86a6467b0bc503b542e1f385e249e
-  data.tar.gz: 2d444cf47a4585bd15225b67edb8791c0860cc2f
+  metadata.gz: 9b7020eb2cd9811e364f4918945c656c55aa87f8
+  data.tar.gz: 40f0f4a684fe83652412765417da73d3c61510c2
 SHA512:
-  metadata.gz: 2cf1e347034fe102a751d3595c75b4093890ffa533831d222c6b064a535cee538f5e4404038ea09ba61a275dcc6e047a13a215a2f3e0bf829867b76817ee4a45
-  data.tar.gz: fcd6a576314c5907852be1a5c6d709cc83d50e9868f7eb37cc0d14e8b74f4140a41447adb49a951afebb7778a27145cf9499c588a2001e054130d173ede705d0
+  metadata.gz: cf86b5d405eb812df5543e6f97b9e39aa0abc130c6b5db0f25aaf6f530c7f89e30467044a1f9cfbbaaaaa89e4d58372b660b20091c860e47b2d9ec924f4195b0
+  data.tar.gz: 9c0a526c4cd24fc5a4093ac3216ed0e779284ebb319c637b94460e29c0f4727f85b1f18122dcc747af585c287ee1c694536fc9f64e02185cc4b39b5d1a26e66d

data/{LICENSE.txt → LICENSE}

@@ -9,13 +9,13 @@ 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 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.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,41 +1,203 @@
-# Scan
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/scan`. To experiment with that code, run `bin/console` for an interactive prompt.
+<h3 align="center">
+  <a href="https://github.com/KrauseFx/fastlane">
+    <img src="assets/fastlane.png" width="150" />
+    <br />
+    fastlane
+  </a>
+</h3>
+<p align="center">
+  <a href="https://github.com/KrauseFx/deliver">deliver</a> &bull; 
+  <a href="https://github.com/KrauseFx/snapshot">snapshot</a> &bull; 
+  <a href="https://github.com/KrauseFx/frameit">frameit</a> &bull; 
+  <a href="https://github.com/KrauseFx/PEM">PEM</a> &bull; 
+  <a href="https://github.com/KrauseFx/sigh">sigh</a> &bull; 
+  <a href="https://github.com/KrauseFx/produce">produce</a> &bull;
+  <a href="https://github.com/KrauseFx/cert">cert</a> &bull;
+  <a href="https://github.com/fastlane/spaceship">spaceship</a> &bull;
+  <a href="https://github.com/fastlane/pilot">pilot</a> &bull;
+  <a href="https://github.com/fastlane/boarding">boarding</a> &bull;
+  <a href="https://github.com/fastlane/gym">gym</a> &bull;
+  <b>scan</b>
+</p>
+-------
+
+<p align="center">
+  <img src="assets/scan.png" height="110">
+</p>
+
+scan
+============
+
+[![Twitter: @KauseFx](https://img.shields.io/badge/contact-@KrauseFx-blue.svg?style=flat)](https://twitter.com/KrauseFx)
+[![License](http://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/fastlane/scan/blob/master/LICENSE)
+[![Gem](https://img.shields.io/gem/v/scan.svg?style=flat)](http://rubygems.org/gems/scan)
+[![Build Status](https://img.shields.io/travis/fastlane/scan/master.svg?style=flat)](https://travis-ci.org/fastlane/scan)
+
+###### Building your app has never been easier
+
+Get in contact with the developer on Twitter: [@KrauseFx](https://twitter.com/KrauseFx)
+
+-------
+<p align="center">
+    <a href="#whats-scan">Features</a> &bull; 
+    <a href="#installation">Installation</a> &bull; 
+    <a href="#usage">Usage</a> &bull; 
+    <a href="#tips">Tips</a> &bull; 
+    <a href="#need-help">Need help?</a>
+</p>
+
+-------
+
+<h5 align="center"><code>scan</code> is part of <a href="https://fastlane.tools">fastlane</a>: connect all deployment tools into one streamlined workflow.</h5>
+
+# What's scan?
+
+`scan` makes it super easy to run tests of your iOS and Mac app. It does all the heavy lifting for you to run your tests... the easy way.
+
+### Before `scan`
+
+```sh
+xcodebuild \
+  -workspace MyApp.xcworkspace \
+  -scheme "MyApp" \
+  -sdk iphonesimulator \
+  -destination 'platform=iOS Simulator,name=iPhone 6,OS=8.1' \
+  test
+```
 
-TODO: Delete this and the text above, and describe your gem
+As the output will look like this
 
-## Installation
+```
+/Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/Objects-normal/arm64/main.o Example/main.m normal arm64 objective-c com.apple.compilers.llvm.clang.1_0.compiler
+    cd /Users/felixkrause/Developer/fastlane/gym/example/cocoapods
+    export LANG=en_US.US-ASCII
+    export PATH="/Applications/Xcode-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/usr/bin:/Applications/Xcode-beta.app/Contents/Developer/usr/bin:/Users/felixkrause/.rvm/gems/ruby-2.2.0/bin:/Users/felixkrause/.rvm/gems/ruby-2.2.0@global/bin:/Users/felixkrause/.rvm/rubies/ruby-2.2.0/bin:/Users/felixkrause/.rvm/bin:/usr/local/heroku/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+    /Applications/Xcode-beta.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang -x objective-c -arch arm64 -fmessage-length=126 -fdiagnostics-show-note-include-stack -fmacro-backtrace-limit=0 -fcolor-diagnostics -std=gnu99 -fobjc-arc -fmodules -gmodules -fmodules-cache-path=/Users/felixkrause/Library/Developer/Xcode/DerivedData/ModuleCache -fmodules-prune-interval=86400 -fmodules-prune-after=345600 -fbuild-session-file=/Users/felixkrause/Library/Developer/Xcode/DerivedData/ModuleCache/Session.modulevalidation -fmodules-validate-once-per-build-session -Wnon-modular-include-in-framework-module -Werror=non-modular-include-in-framework-module -Wno-trigraphs -fpascal-strings -Os -fno-common -Wno-missing-field-initializers -Wno-missing-prototypes -Werror=return-type -Wunreachable-code -Wno-implicit-atomic-properties -Werror=deprecated-objc-isa-usage -Werror=objc-root-class -Wno-arc-repeated-use-of-weak -Wduplicate-method-match -Wno-missing-braces -Wparentheses -Wswitch -Wunused-function -Wno-unused-label -Wno-unused-parameter -Wunused-variable -Wunused-value -Wempty-body -Wconditional-uninitialized -Wno-unknown-pragmas -Wno-shadow -Wno-four-char-constants -Wno-conversion -Wconstant-conversion -Wint-conversion -Wbool-conversion -Wenum-conversion -Wshorten-64-to-32 -Wpointer-sign -Wno-newline-eof -Wno-selector -Wno-strict-selector-match -Wundeclared-selector -Wno-deprecated-implementations -DCOCOAPODS=1 -DNS_BLOCK_ASSERTIONS=1 -DOBJC_OLD_DISPATCH_PROTOTYPES=0 -isysroot /Applications/Xcode-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS9.0.sdk -fstrict-aliasing -Wprotocol -Wdeprecated-declarations -miphoneos-version-min=9.0 -g -fvisibility=hidden -Wno-sign-conversion -fembed-bitcode -iquote /Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/ExampleProductName-generated-files.hmap -I/Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/ExampleProductName-own-target-headers.hmap -I/Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/ExampleProductName-all-target-headers.hmap -iquote /Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/ExampleProductName-project-headers.hmap -I/Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/BuildProductsPath/Release-iphoneos/include -I/Users/felixkrause/Developer/fastlane/gym/example/cocoapods/Pods/Headers/Public -I/Users/felixkrause/Developer/fastlane/gym/example/cocoapods/Pods/Headers/Public/HexColors -I/Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/DerivedSources/arm64 -I/Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/DerivedSources -F/Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/BuildProductsPath/Release-iphoneos -isystem /Users/felixkrause/Developer/fastlane/gym/example/cocoapods/Pods/Headers/Public -isystem /Users/felixkrause/Developer/fastlane/gym/example/cocoapods/Pods/Headers/Public/HexColors -MMD -MT dependencies -MF /Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/Objects-normal/arm64/main.d --serialize-diagnostics /Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/Objects-normal/arm64/main.dia -c /Users/felixkrause/Developer/fastlane/gym/example/cocoapods/Example/main.m -o /Users/felixkrause/Library/Developer/Xcode/DerivedData/Example-fhlmxikmujknefgidqwqvtbatohi/Build/Intermediates/ArchiveIntermediates/Example/IntermediateBuildFilesPath/Example.build/Release-iphoneos/Example.build/Objects-normal/arm64/main.o
+```
+you'll probably want to use something like [xcpretty](https://github.com/supermarin/xcpretty), which will look like this:
+
+```sh
+set -o pipefail &&
+  xcodebuild \
+    -workspace MyApp.xcworkspace \
+    -scheme "MyApp" \
+    -sdk iphonesimulator \
+    -destination 'platform=iOS Simulator,name=iPhone 6,OS=8.1' \
+    test \
+  | xcpretty \
+    -r "html" \
+    -o "tests.html"
+```
 
-Add this line to your application's Gemfile:
+### With `scan`
 
-```ruby
-gem 'scan'
 ```
+scan
+```
+
+### Why `scan`?
+
+`scan` uses the latest APIs and tools to make running tests plain simple and offer a great integration into your existing workflow, like [fastlane](https://fastlane.tools) or Jenkins.
+
+              |  scan Features
+--------------------------|------------------------------------------------------------
+:checkered_flag: | Beautiful inline build output while running the tests
+:mountain_cableway: | Sensible defaults: Automatically detect the project, its schemes and more
+:bar_chart: | Support for HTML, JSON and JUnit reports
+:mag: | Xcode duplicated your simulators again? `scan` will handle this for you
+:link:  | Works perfectly with [fastlane](https://fastlane.tools) and other tools
+:bullettrain_side: | Don't remember any complicated build commands, just `scan`
+:wrench:  | Easy and dynamic configuration using parameters and environment variables
+:loudspeaker: | Beautiful slack notifications of the test results
+:floppy_disk:   | Store common build settings in a `Scanfile` 
+:outbox_tray: | The raw `xcodebuild` outputs are stored in `~/Library/Logs/scan`
+:computer: | Supports both iOS and Mac applications
+:man:      | Automatically switches to the [travis formatter](https://github.com/kattrali/xcpretty-travis-formatter) when running on Travis
+:book:     | Helps you resolve common test errors like simulator not responding
+
+`scan` uses a plain `xcodebuild` command, therefore keeping 100% compatible with `xcodebuild`. To generate the nice output, `scan` uses [xcpretty](https://github.com/supermarin/xcpretty). You can alway access the raw output in `~/Library/Logs/scan`.
+
+![/assets/scanScreenshot.png](/assets/scanScreenshot.png)
+![/assets/slack.png](/assets/slack.png)
+![/assets/scanHTML.png](/assets/scanHTML.png)
+![/assets/scanHTMLFailing.png](/assets/scanHTMLFailing.png)
+
+# Installation
+
+    sudo gem install scan
+
+Make sure, you have the latest version of the Xcode command line tools installed:
+
+    xcode-select --install
 
-And then execute:
+# Usage
 
-    $ bundle
+    scan
 
-Or install it yourself as:
+That's all you need to run your tests. If you want more control, here are some available parameters:
 
-    $ gem install scan
+    scan --workspace "Example.xcworkspace" --scheme "AppName" --clean
 
-## Usage
+If you need to use a different xcode install, use xcode-select or define DEVELOPER_DIR:
 
-TODO: Write usage instructions here
+    DEVELOPER_DIR="/Applications/Xcode6.2.app" scan
 
-## Development
+For a list of all available parameters use
+
+    scan --help
+
+To access the raw `xcodebuild` output open `~/Library/Logs/scan`
+
+# Scanfile
+
+Since you might want to manually trigger the tests but don't want to specify all the parameters every time, you can store your defaults in a so called `Scanfile`.
+
+Run `scan init` to create a new configuration file. Example:
+
+```ruby
+scheme "Example"
+
+clean true
+
+output_types "html"
+```
+
+# Automating the whole process
+
+`scan` works great together with [fastlane](https://fastlane.tools), which connects all deployment tools into one streamlined workflow. 
+
+Using `fastlane` you can define a configuration like
+
+```ruby
+lane :test do
+  scan(scheme: "Example")
+end
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake false` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+For more information visit the [fastlane GitHub page](https://github.com/KrauseFx/fastlane).
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
-## Contributing
+# Tips
+## [`fastlane`](https://fastlane.tools) Toolchain
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/scan. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+- [`fastlane`](https://fastlane.tools): Connect all deployment tools into one streamlined workflow
+- [`deliver`](https://github.com/KrauseFx/deliver): Upload screenshots, metadata and your app to the App Store
+- [`snapshot`](https://github.com/KrauseFx/snapshot): Automate taking localized screenshots of your iOS app on every device
+- [`frameit`](https://github.com/KrauseFx/frameit): Quickly put your screenshots into the right device frames
+- [`PEM`](https://github.com/KrauseFx/pem): Automatically generate and renew your push notification profiles
+- [`produce`](https://github.com/KrauseFx/produce): Create new iOS apps on iTunes Connect and Dev Portal using the command line
+- [`cert`](https://github.com/KrauseFx/cert): Automatically create and maintain iOS code signing certificates
+- [`spaceship`](https://github.com/fastlane/spaceship): Ruby library to access the Apple Dev Center and iTunes Connect
+- [`pilot`](https://github.com/fastlane/pilot): The best way to manage your TestFlight testers and builds from your terminal
+- [`boarding`](https://github.com/fastlane/boarding): The easiest way to invite your TestFlight beta testers 
+- [`gym`](https://github.com/fastlane/gym): Building your iOS apps has never been easier
 
+##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
 
-## License
+# Need help?
+Please submit an issue on GitHub and provide information about your setup
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+# License
+This project is licensed under the terms of the MIT license. See the LICENSE file.
 
+> This project and all fastlane tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.

data/bin/scan

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.push File.expand_path("../../lib", __FILE__)
+
+require "scan"
+require "scan/commands_generator"
+Scan::CommandsGenerator.start

data/lib/assets/ScanfileTemplate

@@ -0,0 +1,13 @@
+# For more information about this configuation visit
+# https://github.com/fastlane/scan#scanfile
+
+# In general, you can use the options available
+# scan --help
+
+# Remove the # in front of the line to enable the option
+
+# scheme "Example"
+
+# skip_html_open true
+
+# clean true

data/lib/scan.rb

@@ -1,5 +1,35 @@
-require "scan/version"
+require 'json'
+require 'scan/version'
+require 'scan/manager'
+require 'scan/options'
+require 'scan/runner'
+require 'scan/detect_values'
+require 'scan/report_collector'
+require 'scan/test_command_generator'
+require 'scan/test_result_parser'
+require 'scan/error_handler'
+require 'scan/slack_poster'
+
+require 'fastlane_core'
 
 module Scan
-  # Your code goes here...
+  class << self
+    attr_accessor :config
+
+    attr_accessor :project
+
+    attr_accessor :cache
+
+    def config=(value)
+      @config = value
+      DetectValues.set_additional_default_values
+      @cache = {}
+    end
+
+    def scanfile_name
+      "Scanfile"
+    end
+  end
+
+  Helper = FastlaneCore::Helper # you gotta love Ruby: Helper.* should use the Helper class contained in FastlaneCore
 end

data/lib/scan/commands_generator.rb

@@ -0,0 +1,63 @@
+require "commander"
+require "fastlane_core"
+
+HighLine.track_eof = false
+
+module Scan
+  class CommandsGenerator
+    include Commander::Methods
+
+    FastlaneCore::CommanderGenerator.new.generate(Scan::Options.available_options)
+
+    def self.start
+      FastlaneCore::UpdateChecker.start_looking_for_update("scan")
+      new.run
+    ensure
+      FastlaneCore::UpdateChecker.show_update_status("scan", Scan::VERSION)
+    end
+
+    def convert_options(options)
+      o = options.__hash__.dup
+      o.delete(:verbose)
+      o
+    end
+
+    def run
+      program :version, Scan::VERSION
+      program :description, Scan::DESCRIPTION
+      program :help, "Author", "Felix Krause <scan@krausefx.com>"
+      program :help, "Website", "https://fastlane.tools"
+      program :help, "GitHub", "https://github.com/fastlane/scan"
+      program :help_formatter, :compact
+
+      global_option("--verbose") { $verbose = true }
+
+      command :tests do |c|
+        c.syntax = "scan"
+        c.description = Scan::DESCRIPTION
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Scan::Options.available_options,
+                                                      convert_options(options))
+          Scan::Manager.new.work(config)
+        end
+      end
+
+      command :init do |c|
+        c.syntax = "scan init"
+        c.description = "Creates a new Scanfile for you"
+        c.action do |_args, options|
+          containing = (Helper.fastlane_enabled? ? 'fastlane' : '.')
+          path = File.join(containing, Scan.scanfile_name)
+          raise "Scanfile already exists".yellow if File.exist?(path)
+          template = File.read("#{Helper.gem_path('scan')}/lib/assets/ScanfileTemplate")
+          File.write(path, template)
+          Helper.log.info "Successfully created '#{path}'. Open the file using a code editor.".green
+        end
+      end
+
+      default_command :tests
+
+      run!
+    end
+  end
+end

data/lib/scan/detect_values.rb

@@ -0,0 +1,59 @@
+module Scan
+  # This class detects all kinds of default values
+  class DetectValues
+    # This is needed as these are more complex default values
+    # Returns the finished config object
+    def self.set_additional_default_values
+      config = Scan.config
+
+      FastlaneCore::Project.detect_projects(config)
+      Scan.project = FastlaneCore::Project.new(config)
+
+      # Go into the project's folder
+      Dir.chdir(File.expand_path("..", Scan.project.path)) do
+        config.load_configuration_file(Scan.scanfile_name)
+      end
+
+      Scan.project.select_scheme
+
+      default_device if Scan.project.ios?
+      detect_destination
+
+      return config
+    end
+
+    def self.default_device
+      config = Scan.config
+
+      if config[:device] # make sure it actually exists
+        return if FastlaneCore::Simulator.all.find { |d| d.name == config[:device].strip }
+        Helper.log.error "Couldn't find simulator '#{config[:device]}' - falling back to default simulator".red
+      end
+
+      # An iPhone 5s is reasonable small and useful for tests
+      found = FastlaneCore::Simulator.all.find { |d| d.name == "iPhone 5s" }
+      found ||= FastlaneCore::Simulator.all.first # anything is better than nothing
+
+      config[:device] = found
+      raise "No simulators found".red unless config[:device]
+    end
+
+    # Is it an iOS device or a Mac?
+    def self.detect_destination
+      if Scan.config[:destination]
+        Helper.log.info "It's not recommended to set the `destination` value directly".yellow
+        Helper.log.info "Instead use the other options available in `scan --help`".yellow
+        Helper.log.info "Using your value '#{Scan.config[:destination]}' for now".yellow
+        Helper.log.info "because I trust you know what you're doing...".yellow
+        return
+      end
+
+      # building up the destination now
+      if Scan.project.ios?
+        Scan.config[:destination] = "platform=iOS Simulator,id=#{Scan.config[:device].udid}"
+      else
+        Scan.config[:destination] = "platform=OS X"
+      end
+    end
+  end
+end

data/lib/scan/error_handler.rb

@@ -0,0 +1,43 @@
+module Scan
+  # This classes methods are called when something goes wrong in the building process
+  class ErrorHandler
+    class << self
+      # @param [String] The output of the errored build
+      # This method should raise an exception in any case, as the return code indicated a failed build
+      def handle_build_error(output)
+        # The order of the handling below is import
+        case output
+        when /US\-ASCII/
+          print "Your shell environment is not correctly configured"
+          print "Instead of UTF-8 your shell uses US-ASCII"
+          print "Please add the following to your '~/.bashrc':"
+          print ""
+          print "       export LANG=en_US.UTF-8"
+          print "       export LANGUAGE=en_US.UTF-8"
+          print "       export LC_ALL=en_US.UTF-8"
+          print ""
+          print "You'll have to restart your shell session after updating the file."
+          print "If you are using zshell or another shell, make sure to edit the correct bash file."
+          print "For more information visit this stackoverflow answer:"
+          print "https://stackoverflow.com/a/17031697/445598"
+        when /Testing failed/
+          raise "Error building the application - see the log above".red
+        when /Executed/
+          # this is *really* important:
+          # we don't want to raise an exception here
+          # as we handle this in runner.rb at a later point
+          # after parsing the actual test results
+          return
+        end
+        raise "Error building/testing the application - see the log above".red
+      end
+
+      private
+
+      # Just to make things easier
+      def print(text)
+        Helper.log.error text.red
+      end
+    end
+  end
+end