gym 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 16d37d8d48ab649fc02d99958515229f50444a33
-  data.tar.gz: c7ac3402ef0e98ccbaf7e1656a97fc4b89340a0c
+  metadata.gz: 574af8b98bbf18a7cd50ea0df99abf0a56614635
+  data.tar.gz: d0479a56afa1949ef434976da023a69fb6a56e5b
 SHA512:
-  metadata.gz: 2250554abb1d9f2ff99738c8a95a7ca8f7c79f0587116f8119e70ff96cdfb801ce62ed0c229e44aff446d6d07210d6c5ce1e3e36e1ad4b3c988cf3ed341eca13
-  data.tar.gz: 1f60d9e7173d84c3eca50a3d66ee37c84e181cde2315c5136f2d90d822f8c6d60ddbabe29be122a2901d3f6a044c99e799a36d2ad893b76c44549841c30c5d7f
+  metadata.gz: 7b14141ac66187610e817a34f1940a68d4ecf531942b625d267b8d6618afd6ea43320c53bba7399919018a15f51f6301afd6e03ed51aa43284d16612ccedb489
+  data.tar.gz: 6b0046422e07785ae133f0b7ea9edeb43ce524d01f769c8aeb1629a258e48ff37321a29336905ce08e5f397a2cb9ad5b8590fe74aca730bc3596eeddd2fe47a7

data/README.md

@@ -1 +1,198 @@
-#### Still super secret
+<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/fastlane/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/KrauseFx/codes">codes</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;
+  <b>gym</b>
+</p>
+-------
+
+<p align="center">
+    <img src="assets/gym.png">
+</p>
+
+gym
+============
+
+[![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/gym/blob/master/LICENSE)
+[![Gem](https://img.shields.io/gem/v/gym.svg?style=flat)](http://rubygems.org/gems/gym)
+[![Build Status](https://img.shields.io/travis/fastlane/gym/master.svg?style=flat)](https://travis-ci.org/fastlane/gym)
+
+###### 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-gym">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>gym</code> is part of <a href="https://fastlane.tools">fastlane</a>: connect all deployment tools into one streamlined workflow.</h5>
+
+# What's gym?
+
+`gym` builds and packages iOS apps for you. It takes care of all the heavy lifting and makes it super easy to generate a signed `ipa` file :muscle:
+
+`gym` is a replacement for [shenzhen](https://github.com/nomad/shenzhen).
+
+### Before `gym`
+
+```
+xcodebuild clean archive -archivePath build/MyApp \
+                         -scheme MyApp
+xcodebuild -exportArchive \
+           -exportFormat ipa \
+           -archivePath "build/MyApp.xcarchive" \
+           -exportPath "build/MyApp.ipa" \
+           -exportProvisioningProfile "ProvisioningProfileName" 
+```
+
+### With `gym`
+
+```
+gym
+```
+
+### Why `gym`?
+
+`gym` uses the latest APIs to build and sign your application which results in much faster build times.
+
+              |  Gym Features
+--------------------------|------------------------------------------------------------
+:rocket:            | `gym` builds 30% faster than other build tools like [shenzhen](https://github.com/nomad/shenzhen)
+:checkered_flag: | Beautiful inline build output
+:book:     | helps you resolve common build errors like code signing issues
+:mountain_cableway: | Sensible defaults: Automatically detect the project, its schemes and more
+:link:  | Works perfectly with [fastlane](https://fastlane.tools) and other tools
+:package: | Automatically generates an `ipa` and a compressed `dSYM` file
+:bullettrain_side: | Don't remember any complicated build commands, just `gym`
+:wrench:  | Easy and dynamic configuration using parameters and environment variables
+:floppy_disk:   | Store common build settings in a `Gymfile` 
+:computer: | All archives are stored and accessible in the Xcode Organisier
+
+![/assets/gymScreenshot.png](/assets/gymScreenshot.png)
+
+-----
+
+![/assets/gym.gif](/assets/gym.gif)
+
+# Installation
+
+This tool is still work in progress. You can already try it by cloning the repo and running
+
+    sudo gem install gym
+
+Make sure, you have the latest version of the Xcode command line tools installed:
+
+    xcode-select --install
+
+# Usage
+
+    gym
+
+That's all you need to build your application. If you want more control, here are some available parameters:
+
+    gym --workspace "Example.xcworkspace" --scheme "AppName" --clean
+
+For a list of all available parameters use
+
+    gym --help
+
+# Gymfile
+
+Since you might want to manually trigger a new build but don't want to specify all the parameters every time, you can store your defaults in a so called `Gymfile`.
+
+Run `gym init` to create a new configuration file. Example:
+
+```ruby
+scheme "Example"
+
+sdk "9.0"
+
+output_directory "./build"    # store the ipa in this folder
+output_name "MyApp"           # the name of the ipa file
+```
+
+# How does it work?
+
+`gym` uses the latest APIs to build and sign your application. The 2 main components are 
+
+- `xcodebuild` 
+- [xcpretty](https://github.com/supermarin/xcpretty)
+
+When you run `gym` without the `--silent` mode it will print out every command it executes.
+
+To build the archive `gym` uses the following command:
+
+```
+set -o pipefail && \
+xcodebuild -scheme 'Example' \
+-project './Example.xcodeproj' \
+-configuration 'Release' \
+-destination 'generic/platform=iOS' \
+-archivePath '/Users/felixkrause/Library/Developer/Xcode/Archives/2015-08-11/ExampleProductName 2015-08-11 18.15.30.xcarchive' \
+archive | xcpretty
+```
+
+
+After building the archive it is being checked by `gym`. If it's valid, it gets packaged up and signed into an `ipa` file
+
+```
+xcodebuild -exportArchive -archivePath \
+'/Users/felixkrause/Library/Developer/Xcode/Archives/2015-08-11/ExampleProductName 2015-08-11 18.15.30.xcarchive' \
+exportFormat ipa \
+-exportPath '/Users/felixkrause/Library/Developer/Xcode/Archives/2015-08-11/ExampleProductName.ipa' \
+-exportProvisioningProfile 'Profile Name'
+```
+
+Afterwards the `ipa` file is moved to the output folder. The `dSYM` file is compressed and moved to the output folder as well.
+
+# Tips
+## [`fastlane`](https://fastlane.tools) Toolchain
+
+- [`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
+- [`codes`](https://github.com/KrauseFx/codes): Create promo codes for iOS Apps using the command line
+- [`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 
+
+##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
+
+## Use the 'Provisioning Quicklook plugin'
+Download and install the [Provisioning Plugin](https://github.com/chockenberry/Provisioning).
+
+# Need help?
+- If there is a technical problem with `gym`, submit an issue.
+- I'm available for contract work - drop me an email: gym@krausefx.com
+
+# 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/gym

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

data/lib/assets/GymfileTemplate

@@ -0,0 +1,14 @@
+# For more information about this configuation visit
+# https://github.com/fastlane/gym#gymfile
+
+# In general, you can use the options available
+# gym --help
+
+# Remove the # in front of the line to enable this 
+# particular option
+
+# scheme "Example"
+
+# sdk "9.0"
+
+output_directory "./"

data/lib/gym.rb

@@ -0,0 +1,32 @@
+require 'json'
+require 'gym/version'
+require 'gym/manager'
+require 'gym/project'
+require 'gym/build_command_generator'
+require 'gym/package_command_generator'
+require 'gym/runner'
+require 'gym/error_handler'
+require 'gym/options'
+require 'gym/detect_values'
+
+require 'fastlane_core'
+require 'terminal-table'
+
+module Gym
+  class << self
+    attr_accessor :config
+
+    attr_accessor :project
+
+    def config=(value)
+      @config = value
+      DetectValues.set_additional_default_values
+    end
+
+    def gymfile_name
+      "Gymfile"
+    end
+  end
+
+  Helper = FastlaneCore::Helper # you gotta love Ruby: Helper.* should use the Helper class contained in FastlaneCore
+end

data/lib/gym/build_command_generator.rb

@@ -0,0 +1,86 @@
+module Gym
+  # Responsible for building the fully working xcodebuild command
+  class BuildCommandGenerator
+    class << self
+      def generate
+        parts = prefix
+        parts << "xcodebuild"
+        parts += options
+        parts += actions
+        parts += suffix
+        parts += pipe
+
+        parts
+      end
+
+      def prefix
+        ["set -o pipefail &&"]
+      end
+
+      # Path to the project or workspace as parameter
+      # This will also include the scheme (if given)
+      # @return [Array] The array with all the components to join
+      def project_path_array
+        config = Gym.config
+        proj = []
+        proj << "-workspace '#{config[:workspace]}'" if config[:workspace]
+        proj << "-scheme '#{config[:scheme]}'" if config[:scheme]
+        proj << "-project '#{config[:project]}'" if config[:project]
+
+        return proj if proj.count > 0
+        raise "No project/workspace found"
+      end
+
+      def options
+        config = Gym.config
+
+        options = []
+        options += project_path_array
+        options << "-configuration '#{config[:configuration]}'" # We need `Release` to export the DSYM file as well
+        options << "-sdk '#{config[:sdk]}'" if config[:sdk]
+        options << "-destination '#{config[:destination]}'" if config[:destination]
+        options << "-archivePath '#{archive_path}'"
+        options << "-xcargs '#{config[:xcargs]}'" if config[:xcargs]
+
+        options
+      end
+
+      def actions
+        config = Gym.config
+
+        actions = []
+        actions << :clean if config[:clean]
+        actions << :archive
+
+        actions
+      end
+
+      def suffix
+        []
+      end
+
+      def pipe
+        ["| xcpretty"]
+      end
+
+      # The path to set the Derived Data to
+      def build_path
+        unless @build_path
+          day = Time.now.strftime("%F") # e.g. 2015-08-07
+
+          @build_path = File.expand_path("~/Library/Developer/Xcode/Archives/#{day}/")
+          FileUtils.mkdir_p @build_path
+        end
+        @build_path
+      end
+
+      def archive_path
+        unless @archive_path
+          file_name = [Gym.config[:output_name], Time.now.strftime("%F %H.%M.%S")] # e.g. 2015-08-07 14.49.12
+          @archive_path = File.join(build_path, file_name.join(" ") + ".xcarchive")
+        end
+        return @archive_path
+      end
+    end
+  end
+end

data/lib/gym/commands_generator.rb

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

data/lib/gym/detect_values.rb

@@ -0,0 +1,132 @@
+module Gym
+  # 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 = Gym.config
+
+      detect_projects
+
+      if config[:workspace].to_s.length > 0 and config[:project].to_s.length > 0
+        raise "You can only pass either a workspace or a project path, not both".red
+      end
+
+      if config[:workspace].to_s.length == 0 and config[:project].to_s.length == 0
+        raise "No project/workspace found in the current directory.".red
+      end
+
+      Gym.project = Project.new(config)
+      detect_provisioning_profile
+
+      # Go into the project's folder
+      Dir.chdir(File.expand_path("..", Gym.project.path)) do
+        config.load_configuration_file(Gym.gymfile_name)
+      end
+
+      detect_scheme
+
+      config[:output_name] ||= Gym.project.app_name
+
+      return config
+    end
+
+    # Helper Methods
+
+    def self.detect_provisioning_profile
+      unless Gym.config[:provisioning_profile_path]
+        Dir.chdir(File.expand_path("..", Gym.project.path)) do
+          profiles = Dir["*.mobileprovision"]
+          if profiles.count == 1
+            profile = File.expand_path(profiles.last)
+          elsif profiles.count > 1
+            puts "Found more than one provisioning profile in the project directory:"
+            profile = choose(*(profiles))
+          end
+
+          Gym.config[:provisioning_profile_path] = profile
+        end
+      end
+
+      if Gym.config[:provisioning_profile_path]
+        FastlaneCore::ProvisioningProfile.install(Gym.config[:provisioning_profile_path])
+        data = FastlaneCore::ProvisioningProfile.parse(Gym.config[:provisioning_profile_path])
+
+        if data['Name']
+          Helper.log.info "Using provisioning profile with name '#{data['Name']}'...".green if $verbose
+          Gym.config[:provisioning_profile_name] = data['Name']
+        end
+      end
+    end
+
+    def self.detect_projects
+      if Gym.config[:workspace].to_s.length == 0
+        workspace = Dir["./*.xcworkspace"]
+        if workspace.count > 1
+          puts "Select Workspace: "
+          Gym.config[:workspace] = choose(*(workspace))
+        else
+          Gym.config[:workspace] = workspace.first # this will result in nil if no files were found
+        end
+      end
+
+      if Gym.config[:workspace].to_s.length == 0 and Gym.config[:project].to_s.length == 0
+        project = Dir["./*.xcodeproj"]
+        if project.count > 1
+          puts "Select Project: "
+          Gym.config[:project] = choose(*(project))
+        else
+          Gym.config[:project] = project.first # this will result in nil if no files were found
+        end
+      end
+    end
+
+    def self.choose_project
+      loop do
+        path = ask("Couldn't automatically detect the project file, please provide a path: ".yellow).strip
+        if File.directory? path
+          if path.end_with? ".xcworkspace"
+            config[:workspace] = path
+            break
+          elsif path.end_with? ".xcodeproj"
+            config[:project] = path
+            break
+          else
+            Helper.log.error "Path must end with either .xcworkspace or .xcodeproj"
+          end
+        else
+          Helper.log.error "Couldn't find project at path '#{File.expand_path(path)}'".red
+        end
+      end
+    end
+
+    def self.detect_scheme
+      config = Gym.config
+      if config[:scheme].to_s.length > 0
+        # Verify the scheme is available
+        unless Gym.project.schemes.include?(config[:scheme].to_s)
+          Helper.log.error "Couldn't find specified scheme '#{config[:scheme]}'.".red
+          config[:scheme] = nil
+        end
+      end
+
+      if config[:scheme].to_s.length == 0
+        proj_schemes = Gym.project.schemes
+        if proj_schemes.count == 1
+          config[:scheme] = proj_schemes.last
+        elsif proj_schemes.count > 1
+          if Helper.is_ci?
+            Helper.log.error "Multiple schemes found but you haven't specified one.".red
+            Helper.log.error "Since this is a CI, please pass one using the `scheme` option".red
+            raise "Multiple schemes found".red
+          else
+            puts "Select Scheme: "
+            config[:scheme] = choose(*(proj_schemes))
+          end
+        else
+          raise "Couldn't find any schemes in this project".red
+        end
+      end
+    end
+  end
+end

data/lib/gym/error_handler.rb

@@ -0,0 +1,95 @@
+module Gym
+  # This classes methods are called when something goes wrong in the building process
+  class ErrorHandler
+    class << self
+      # @param [Array] The output of the errored build (line by line)
+      # 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 /Your build settings specify a provisioning profile with the UUID/
+          print "Invalid code signing settings"
+          print "Your project defines a provisioning profile which doesn't exist on your local machine"
+          print "You can use sigh (https://github.com/KrauseFx/sigh) to download and install the provisioning profile"
+          print "Follow this guide: https://github.com/KrauseFx/fastlane/blob/master/docs/CodeSigning.md"
+        when /Provisioning profile does not match bundle identifier/
+          print "Invalid code signing settings"
+          print "Your project defines a provisioning profile that doesn't match the bundle identifier of your app"
+          print "Make sure you use the correct provisioning profile for this app"
+          print "Take a look at the ouptput above for more information"
+          print "You can follow this guide: https://github.com/KrauseFx/fastlane/blob/master/docs/CodeSigning.md"
+        when /provisioning profiles matching the bundle identifier “(.*)”/
+          print "You don't have the provisioning profile for '#{$1}' installed on the local machine"
+          print "Make sure you have the profile on this computer and it's properly installed"
+          print "You can use sigh (https://github.com/KrauseFx/sigh) to download and install the provisioning profile"
+          print "Follow this guide: https://github.com/KrauseFx/fastlane/blob/master/docs/CodeSigning.md"
+        when /code signing is required/
+          print "Your project settings define invalid code signing settings"
+          print "To generate an ipa file you need to enable code signing for your project"
+          print "Additionally make sure you have a code signing identity set"
+          print "Follow this guide: https://github.com/KrauseFx/fastlane/blob/master/docs/CodeSigning.md"
+        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 "http://stackoverflow.com/a/17031697/445598"
+        end
+        raise "Error building the application - see the log above".red
+      end
+
+      # @param [Array] The output of the errored build (line by line)
+      # This method should raise an exception in any case, as the return code indicated a failed build
+      def handle_package_error(output)
+        case output
+        when /single\-bundle/
+          print "Your project does not contain a single–bundle application or contains multiple products"
+          print "Please read the documentation provided by Apple: https://developer.apple.com/library/ios/technotes/tn2215/_index.html"
+        when /no signing identity matches '(.*)'/
+          print "Could not find code signing identity '#{$1}'"
+          print "Make sure the name of the code signing identity is correct"
+          print "and it matches a locally installed code signing identity"
+          print "You can pass the name of the code signing identity using the"
+          print "`codesigning_identity` option"
+        when /no provisioning profile matches '(.*)'/
+          print "Could not find provisioning profile with the name '#{$1}'"
+          print "Make sure the name of the provisioning profile is correct"
+          print "and it matches a locally installed profile"
+          print "You can pass the name of the provisioning profile using the"
+          print "`--provisioning_profile_name` option"
+        when /mismatch between specified provisioning profile and signing identity/
+          print "Mismatch between provisioning profile and code signing identity"
+          print "This means, the specified provisioning profile was not created using"
+          print "the specified certificate."
+          print "Run cert and sigh before gym to make sure to have all signing resources ready"
+        # insert more specific code signing errors here
+        when /Codesign check fails/
+          print "A general code signing error occurred. Make sure you passed a valid"
+          print "provisioning profile and code signing identity."
+        end
+        raise "Error packaging up the application".red
+      end
+
+      def handle_empty_archive
+        print "The generated archive is invalid, this can have various reasons:"
+        print "Usually it's caused by the `Skip Install` option in Xcode, set it to `NO`"
+        print "For more information visit https://developer.apple.com/library/ios/technotes/tn2215/_index.html"
+        raise "Archive invalid"
+      end
+
+      private
+
+      # Just to make things easier
+      def print(text)
+        Helper.log.error text.red
+      end
+    end
+  end
+end

data/lib/gym/manager.rb

@@ -0,0 +1,28 @@
+module Gym
+  class Manager
+    def work(options)
+      Gym.config = options
+
+      print_summary
+
+      return Runner.new.run
+    end
+
+    private
+
+    def print_summary
+      config = Gym.config
+      rows = []
+      rows << ["Project", config[:project]] if config[:project]
+      rows << ["Workspace", config[:workspace]] if config[:workspace]
+      rows << ["Scheme", config[:scheme]] if config[:scheme]
+
+      puts ""
+      puts Terminal::Table.new(
+        title: "Building Application".green,
+        rows: rows
+      )
+      puts ""
+    end
+  end
+end

data/lib/gym/options.rb

@@ -0,0 +1,111 @@
+require "fastlane_core"
+require "credentials_manager"
+
+module Gym
+  class Options
+    def self.available_options
+      return @options if @options
+
+      @options = plain_options
+    end
+
+    # rubocop:disable Metrics/MethodLength
+    def self.plain_options
+      [
+        FastlaneCore::ConfigItem.new(key: :workspace,
+                                     short_option: "-w",
+                                     env_name: "GYM_WORKSPACE",
+                                     optional: true,
+                                     description: "Path the workspace file",
+                                     verify_block: proc do |value|
+                                       raise "Workspace file not found at path '#{File.expand_path(value)}'".red unless File.exist?(value.to_s)
+                                       raise "Workspace file invalid".red unless File.directory?(value.to_s)
+                                       raise "Workspace file is not a workspace, must end with .xcworkspace".red unless value.include?(".xcworkspace")
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :project,
+                                     short_option: "-p",
+                                     optional: true,
+                                     env_name: "GYM_PROJECT",
+                                     description: "Path the project file",
+                                     verify_block: proc do |value|
+                                       raise "Project file not found at path '#{File.expand_path(value)}'".red unless File.exist?(value.to_s)
+                                       raise "Project file invalid".red unless File.directory?(value.to_s)
+                                       raise "Project file is not a project file, must end with .xcodeproj".red unless value.include?(".xcodeproj")
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :provisioning_profile_path,
+                                     short_option: "-e",
+                                     env_name: "GYM_PROVISIONING_PROFILE_PATH",
+                                     description: "The path to the provisioning profile (found automatically when located in current folder)",
+                                     optional: true,
+                                     verify_block: proc do |value|
+                                       raise "Provisioning profile not found at path '#{File.expand_path(value)}'".red unless File.exist?(value)
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :scheme,
+                                     short_option: "-s",
+                                     optional: true,
+                                     env_name: "GYM_SCHEME",
+                                     description: "The project's scheme. Make sure it's marked as `Shared`"),
+        FastlaneCore::ConfigItem.new(key: :clean,
+                                     short_option: "-c",
+                                     env_name: "GYM_CLEAN",
+                                     description: "Should the project be cleaned before building it?",
+                                     is_string: false,
+                                     default_value: false),
+        FastlaneCore::ConfigItem.new(key: :output_directory,
+                                     short_option: "-o",
+                                     env_name: "GYM_OUTPUT_DIRECTORY",
+                                     description: "The directory in which the ipa file should be stored in",
+                                     default_value: ".",
+                                     verify_block: proc do |value|
+                                       raise "Directory not found at path '#{File.expand_path(value)}'".red unless File.directory?(value)
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :output_name,
+                                     short_option: "-n",
+                                     env_name: "GYM_OUTPUT_NAME",
+                                     description: "The name of the resulting ipa file",
+                                     optional: true,
+                                     verify_block: proc do |value|
+                                       value.gsub!(".ipa", "")
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :sdk,
+                                     short_option: "-k",
+                                     env_name: "GYM_SDK",
+                                     description: "The SDK that should be used for building the application",
+                                     optional: true),
+        FastlaneCore::ConfigItem.new(key: :configuration,
+                                     short_option: "-q",
+                                     env_name: "GYM_CONFIGURATION",
+                                     description: "The configuration to use when building the app. Defaults to 'Release'",
+                                     default_value: "Release"),
+        FastlaneCore::ConfigItem.new(key: :silent,
+                                     short_option: "-t",
+                                     env_name: "GYM_SILENT",
+                                     description: "Hide all information that's not necessary while building",
+                                     default_value: false,
+                                     is_string: false),
+        FastlaneCore::ConfigItem.new(key: :provisioning_profile_name,
+                                     short_option: "-l",
+                                     env_name: "GYM_PROVISIONING_PROFILE_NAME",
+                                     description: "The name of the provisioning profile to use. It has to match the name exactly",
+                                     optional: true),
+        FastlaneCore::ConfigItem.new(key: :codesigning_identity,
+                                     short_option: "-i",
+                                     env_name: "GYM_CODE_SIGNING_IDENTITY",
+                                     description: "The name of the code signing identity to use. It has to match the name exactly. You usually don't need this! e.g. 'iPhone Distribution: SunApps GmbH'",
+                                     optional: true),
+        FastlaneCore::ConfigItem.new(key: :destination,
+                                     short_option: "-d",
+                                     env_name: "GYM_DESTINATION",
+                                     description: "Use a custom destination for building the app",
+                                     default_value: "generic/platform=iOS"),
+        FastlaneCore::ConfigItem.new(key: :xcargs,
+                                     short_option: "-x",
+                                     env_name: "GYM_XCARGS",
+                                     description: "Pass additional arguments to xcodebuild when building the app. Be sure to quote multiple args",
+                                     optional: true)
+
+      ]
+    end
+    # rubocop:enable Metrics/MethodLength
+  end
+end

data/lib/gym/package_command_generator.rb

@@ -0,0 +1,50 @@
+module Gym
+  # Responsible for building the fully working xcodebuild command
+  class PackageCommandGenerator
+    class << self
+      def generate
+        parts = ["/usr/bin/xcrun -sdk iphoneos PackageApplication -v"]
+        parts += options
+        parts += pipe
+
+        parts
+      end
+
+      def options
+        options = []
+
+        options << "'#{appfile_path}'"
+        options << "-o '#{ipa_path}'"
+        options << "exportFormat ipa"
+
+        if Gym.config[:provisioning_profile_name]
+          options << "--embed '#{Gym.config[:provisioning_profile_name]}'"
+        end
+
+        if Gym.config[:codesigning_identity]
+          options << "--sign '#{Gym.config[:codesigning_identity]}'"
+        end
+
+        options
+      end
+
+      def pipe
+        [""]
+      end
+
+      def appfile_path
+        Dir.glob("#{BuildCommandGenerator.archive_path}/Products/Applications/*.app").first
+      end
+
+      # We export it to the temporary folder and move it over to the actual output once it's finished and valid
+      def ipa_path
+        File.join(BuildCommandGenerator.build_path, "#{Gym.config[:output_name]}.ipa")
+      end
+
+      # The path the the dsym file for this app. Might be nil
+      def dsym_path
+        Dir[BuildCommandGenerator.archive_path + "/**/*.dsym"].last
+      end
+    end
+  end
+end

data/lib/gym/project.rb

@@ -0,0 +1,93 @@
+module Gym
+  # Represents the Xcode project/workspace
+  class Project
+    # Path to the project/workspace
+    attr_accessor :path
+
+    attr_accessor :is_workspace
+
+    def initialize(options)
+      self.path = File.expand_path(options[:workspace] || options[:project])
+      self.is_workspace = (options[:workspace].to_s.length > 0)
+
+      if !path or !File.directory? path
+        raise "Could not find project at path '#{path}'".red
+      end
+    end
+
+    # Get all available schemes in an array
+    def schemes
+      results = []
+      output = raw_info.split("Schemes:").last.split(":").first
+      output.split("\n").each do |current|
+        current = current.strip
+
+        next if current.length == 0
+        results << current
+      end
+
+      results
+    end
+
+    def app_name
+      # WRAPPER_NAME: Example.app
+      # WRAPPER_SUFFIX: .app
+      build_settings("WRAPPER_NAME").gsub(build_settings("WRAPPER_SUFFIX"), "")
+    end
+
+    #####################################################
+    # @!group Raw Access
+    #####################################################
+
+    # Get the build settings for our project
+    # this is used to properly get the DerivedData folder
+    # @param [String] The key of which we want the value for (e.g. "PRODUCT_NAME")
+    def build_settings(key)
+      unless @build_settings
+        # We also need to pass the workspace and scheme to this command
+        command = "xcrun xcodebuild -showBuildSettings #{BuildCommandGenerator.project_path_array.join(' ')}"
+        Helper.log.info command.yellow unless Gym.config[:silent]
+        @build_settings = `#{command}`
+      end
+
+      begin
+        result = @build_settings.split("\n").find { |c| c.include? key }
+        result.split(" = ").last
+      rescue => ex
+        Helper.log.error caller.join("\n\t")
+        Helper.log.error "Could not fetch #{key} from project file: #{ex}"
+      end
+    end
+
+    def raw_info
+      # e.g.
+      # Information about project "Example":
+      #     Targets:
+      #         Example
+      #         ExampleUITests
+      #
+      #     Build Configurations:
+      #         Debug
+      #         Release
+      #
+      #     If no build configuration is specified and -scheme is not passed then "Release" is used.
+      #
+      #     Schemes:
+      #         Example
+      #         ExampleUITests
+
+      return @raw if @raw
+
+      # We DO NOT want to pass the workspace, as this would also show
+      # all the CocoaPods schemes which we don't want here
+      containing_path = File.expand_path("..", path)
+      command = "xcrun xcodebuild -list"
+      Helper.log.info command.yellow unless Gym.config[:silent]
+
+      Dir.chdir(containing_path) do
+        @raw = `#{command}`
+      end
+      @raw
+    end
+  end
+end

data/lib/gym/runner.rb

@@ -0,0 +1,166 @@
+require 'pty'
+require 'open3'
+
+module Gym
+  class Runner
+    # @return (String) The path to the resulting ipa
+    def run
+      clear_old_files
+      build_app
+      verify_archive
+      package_app
+      move_results
+    end
+
+    private
+
+    #####################################################
+    # @!group Printing out things
+    #####################################################
+
+    # @param [Array] An array containing all the parts of the command
+    def print_command(command, title)
+      rows = command.map do |c|
+        current = c.to_s.dup
+        next unless current.length > 0
+
+        if current.include? "-" and current.to_s.split(" '").count == 2
+          # That's a default parameter, like `-project 'Name'`
+          # We use " '" to not split by spaces within the value (e.g. path)
+          current.split(" '")
+        else
+          current.gsub!("| ", "") # as the | will somehow break the terminal table
+          [current, ""]
+        end
+      end
+
+      puts Terminal::Table.new(
+        title: title.green,
+        headings: ["Option", "Value"],
+        rows: rows.delete_if { |c| c.to_s.empty? }
+      )
+    end
+
+    #####################################################
+    # @!group The individual steps
+    #####################################################
+
+    def clear_old_files
+      if File.exist? PackageCommandGenerator.ipa_path
+        File.delete(PackageCommandGenerator.ipa_path)
+      end
+    end
+
+    # Builds the app and prepares the archive
+    def build_app
+      command = BuildCommandGenerator.generate
+      print_command(command, "Generated Build Command") if $verbose
+      execute_command(command: command, print_all: true, error: proc do |output|
+        ErrorHandler.handle_build_error(output)
+      end)
+
+      Helper.log.info("Successfully stored the archive. You can find it in the Xcode Organizer.".green)
+      Helper.log.info("Stored the archive in: ".green + BuildCommandGenerator.archive_path) if $verbose
+    end
+
+    # Makes sure the archive is there and valid
+    def verify_archive
+      if Dir[BuildCommandGenerator.archive_path + "/*"].count == 0
+        ErrorHandler.handle_empty_archive
+      end
+    end
+
+    def package_app
+      command = PackageCommandGenerator.generate
+      print_command(command, "Generated Package Command") if $verbose
+
+      execute_command(command: command, print_all: false, error: proc do |output|
+        ErrorHandler.handle_package_error(output)
+      end)
+    end
+
+    # Moves over the binary and dsym file to the output directory
+    # @return (String) The path to the resulting ipa file
+    def move_results
+      require 'fileutils'
+
+      FileUtils.mv(PackageCommandGenerator.ipa_path, Gym.config[:output_directory], force: true)
+
+      if PackageCommandGenerator.dsym_path
+        # Compress and move the dsym file
+        containing_directory = File.expand_path("..", PackageCommandGenerator.dsym_path)
+        file_name = File.basename(PackageCommandGenerator.dsym_path)
+
+        output_path = File.expand_path(File.join(Gym.config[:output_directory], Gym.config[:output_name] + ".app.dSYM.zip"))
+        command = "cd '#{containing_directory}' && zip -r '#{output_path}' '#{file_name}'"
+        Helper.log.info command.yellow unless Gym.config[:silent]
+        command_result = `#{command}`
+        Helper.log.info command_result if $verbose
+
+        puts "" # new line
+
+        Helper.log.info "Successfully exported and compressed dSYM file: ".green
+        Helper.log.info File.join(Gym.config[:output_directory], File.basename(PackageCommandGenerator.dsym_path))
+      end
+
+      ipa_path = File.join(Gym.config[:output_directory], File.basename(PackageCommandGenerator.ipa_path))
+
+      Helper.log.info "Successfully exported and signed ipa file:".green
+      Helper.log.info ipa_path
+      ipa_path
+    end
+
+    #####################################################
+    # @!group Actually executing the commands
+    #####################################################
+
+    # @param command [String] The command to be executed
+    # @param print_all [Boolean] Do we want to print out the command output while building?
+    #   If set to false, nothing will be printed
+    # @param error [Block] A block that's called if an error occurs
+    # @return [String] All the output as string
+    def execute_command(command: nil, print_all: false, error: nil)
+      print_all = true if $verbose
+
+      output = []
+      command = command.join(" ")
+      Helper.log.info command.yellow.strip unless Gym.config[:silent]
+
+      puts "\n-----".cyan if print_all
+
+      last_length = 0
+      begin
+        PTY.spawn(command) do |stdin, stdout, pid|
+          stdin.each do |l|
+            line = l.strip # strip so that \n gets removed
+            output << line
+
+            next unless print_all
+
+            current_length = line.length
+            spaces = [last_length - current_length, 0].max
+            print((line + " " * spaces + "\r").cyan)
+            last_length = current_length
+          end
+          Process.wait(pid)
+          puts "-----\n".cyan if print_all
+        end
+      rescue => ex
+        # This could happen when the environment is wrong:
+        # > invalid byte sequence in US-ASCII (ArgumentError)
+        output << ex.to_s
+        o = output.join("\n")
+        puts o
+        error.call(o)
+      end
+
+      # Exit status for build command, should be 0 if build succeeded
+      # Disabled Rubocop, since $CHILD_STATUS just is not the same
+      if $?.exitstatus != 0 # rubocop:disable Style/SpecialGlobalVars
+        o = output.join("\n")
+        puts o # the user has the right to see the raw output
+        error.call(o)
+      end
+    end
+  end
+end

data/lib/gym/version.rb

@@ -0,0 +1,4 @@
+module Gym
+  VERSION = "0.1.0"
+  DESCRIPTION = "Building your iOS apps has never been easier"
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gym
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Felix Krause
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-01 00:00:00.000000000 Z
+date: 2015-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fastlane_core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.13.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.13.0
 - !ruby/object:Gem::Dependency
   name: xcpretty
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: fastlane
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.15.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.15.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -164,15 +178,29 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Building your iOS app, made easy
+description: Building your iOS apps has never been easier
 email:
 - gym@krausefx.com
-executables: []
+executables:
+- gym
 extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- bin/gym
+- lib/assets/GymfileTemplate
+- lib/gym.rb
+- lib/gym/build_command_generator.rb
+- lib/gym/commands_generator.rb
+- lib/gym/detect_values.rb
+- lib/gym/error_handler.rb
+- lib/gym/manager.rb
+- lib/gym/options.rb
+- lib/gym/package_command_generator.rb
+- lib/gym/project.rb
+- lib/gym/runner.rb
+- lib/gym/version.rb
 homepage: https://fastlane.tools
 licenses:
 - MIT
@@ -196,6 +224,6 @@ rubyforge_project:
 rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
-summary: Building your iOS app, made easy
+summary: Building your iOS apps has never been easier
 test_files: []
 has_rdoc: