pilot 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a669f4e5d2466f5d2bf0a596fb69a002f90058e2
-  data.tar.gz: ae38d3e57214c987e094f3c38219e81351b6d550
+  metadata.gz: 3a252d1f974787effe53dd857fabc664f5266bd9
+  data.tar.gz: 7c878a216f10538ce757c88f4cb66bcf047316ca
 SHA512:
-  metadata.gz: 88d326c652d0eae87aefc9df359eb2b1ba5b6c748fbee35bda9981fb3a008dea8d8d7190199b81bc4a70513839f71801cf29ad8b4a354b27f8ca8199a0254b99
-  data.tar.gz: 69ac8e4342b4c87b420b3cc32542af9e07bc20c4cc17e22eff755d24e8bb6da7ab4e555763a36ce8e97713aaa7dae5b26e315b68008115e748be1c1db0322b52
+  metadata.gz: c41ab0d075f516c1764755ea9c5f986e815884a53f91622c5f0790c50508d3b0f3bc6af7e326f57d44560778d05cd1d92451e1f20bc18670e6c3172142639def
+  data.tar.gz: 8f46022dac75b6c64e5082f2447214d17eda3df4bb2496c375ccae279af49624e658112c5d9a6d45b9add0c50530d0e913eb6d99709acacf3fd79b3a3d4c8444

data/README.md

@@ -13,43 +13,246 @@
   <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/KrauseFx/codes">codes</a>
+  <a href="https://github.com/KrauseFx/codes">codes</a> &bull;
+  <a href="https://github.com/fastlane/spaceship">spaceship</a> &bull;
+  <b>pilot</b> &bull;
+  <a href="https://github.com/fastlane/boarding">boarding</a>
 </p>
 -------
 
 <p align="center">
-  <img src="assets/deliver.png">
+  <img src="assets/PilotTextTransparentSmall.png" width="500">
 </p>
 
-TestFlight CLI
+Pilot
 ============
+[![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/pilot/blob/master/LICENSE)
+[![Gem](https://img.shields.io/gem/v/pilot.svg?style=flat)](http://rubygems.org/gems/pilot)
 
-This gem allows you to manage all important features of Apple TestFlight using a CLI.
 
-This includes
+###### The best way to manage your TestFlight testers and builds from your terminal
+
+This tool allows you to manage all important features of Apple TestFlight using your terminal.
 
 - Upload new builds and distribute them to all testers
-- Set build information like changelog for new builds
-- Add new testers to your team
+- List all available builds
+- Add and remove beta testers
+- Get information about testers, like the registered devices
+- Export and import all your testers
+
+Get in contact with the developer on Twitter: [@KrauseFx](https://twitter.com/KrauseFx)
+
+`pilot` uses [spaceship.airforce](https://spaceship.airforce) to interact with iTunes Connect :rocket:
+
+-------
+<p align="center">
+    <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>pilot</code> is part of <a href="https://fastlane.tools">fastlane</a>: connect all deployment tools into one streamlined workflow.</h5>
+
+# Installation
+
+    sudo gem install pilot
+
+# Usage
+
+For all commands you can specify the Apple ID to use using `-u felix@krausefx.com`. If you execute `pilot` in a project already using [fastlane](https://fastlane.tools) the username and app identifier will automatically be determined.
+
+## Uploading builds
 
 To upload a new build, just run 
 
 ```
-pizzacutter
+pilot upload
 ```
 
 This will automatically look for an `ipa` in your current directory and tries to fetch the login credentials from your [fastlane setup](https://fastlane.tools).
 
-You'll be asked for any missing information. Additionally, you can pass all kinds of parameters to `pizzacutter`:
+You'll be asked for any missing information. Additionally, you can pass all kinds of parameters to `pilot`:
 
 ```
-pizzacutter -u "felix@krausefx.com"
-   --changelog "This build is better"
+pilot upload -u felix@krausefx.com
 ```
 
-`pizzacutter` does all kinds of magic for you:
+Additionally you can skip the submission of the binary, which means, the `ipa` file will only be uploaded and not distributet to testers:
+
+```
+pilot upload --skip_submission
+```
+
+`pilot` does all kinds of magic for you:
 
 - Automatically detects the bundle identifier from your `ipa` file
 - Automatically fetch the AppID of your app based on the bundle identifier
 
-This gem uses [spaceship](https://spaceship.airforce) to submit the build metadata and iTunes Transporter to upload the binary.
+`pilot` uses [spaceship.airforce](https://spaceship.airforce) to submit the build metadata and the iTunes Transporter to upload the binary :rocket:
+
+## List builds
+
+To list all builds for specific application use
+
+```
+pilot list
+```
+
+The result lists all active builds and processing builds:
+
+```
++-----------+---------+----------+----------+----------+
+|                   Great App Builds                   |
++-----------+---------+----------+----------+----------+
+| Version # | Build # | Testing  | Installs | Sessions |
++-----------+---------+----------+----------+----------+
+| 0.9.13    | 1       | Expired  | 1        | 0        |
+| 0.9.13    | 2       | Expired  | 0        | 0        |
+| 0.9.20    | 3       | Expired  | 0        | 0        |
+| 0.9.20    | 4       | Internal | 5        | 3        |
++-----------+---------+----------+----------+----------+
+```
+
+## Managing beta testers
+
+### List of Testers
+
+This command will list all your testers, both internal and external.
+
+```
+pilot list
+```
+
+The output will look like this:
+
+```
++--------+--------+--------------------------+-----------+
+|                    Internal Testers                    |
++--------+--------+--------------------------+-----------+
+| First  | Last   | Email                    | # Devices |
++--------+--------+--------------------------+-----------+
+| Felix  | Krause | felix@krausefx.com       | 2         |
++--------+--------+--------------------------+-----------+
+
++-----------+---------+----------------------------+-----------+
+|                       External Testers                       |
++-----------+---------+----------------------------+-----------+
+| First     | Last    | Email                      | # Devices |
++-----------+---------+----------------------------+-----------+
+| Max       | Manfred | email@email.com            | 0         |
+| Detlef    | Müller  | detlef@krausefx.com        | 1         |
++-----------+---------+----------------------------+-----------+
+```
+
+### Add a new tester
+
+To add a new tester to both your iTunes Connect account and to your app (if given), use the `pilot add` command. This will create a new tester (if necesssary) or add an existing tester to the app to test.
+
+```
+pilot add email@invite.com
+```
+
+Additionally you can specify the app identifier (if necessary): 
+
+```
+pilot add -e email@email.com -a com.krausefx.app
+```
+
+### Find a tester
+
+To find a specific tester use
+
+```
+pilot find felix@krausefx.com
+```
+
+The resulting output will look like this:
+
+```
++---------------------+---------------------+
+|            felix@krausefx.com             |
++---------------------+---------------------+
+| First name          | Felix               |
+| Last name           | Krause              |
+| Email               | felix@krausefx.com  |
+| Latest Version      | 0.9.14 (23          |
+| Latest Install Date | 03/28/15 19:00      |
+| 2 Devices           | • iPhone 6, iOS 8.3 |
+|                     | • iPhone 5, iOS 7.0 |
++---------------------+---------------------+
+```
+
+### Remove a tester
+
+This command will only remove external beta testers.
+
+```
+pilot remove felix@krausefx.com
+```
+
+### Export testers
+
+To export all external testers to a CSV file. Useful if you need to import tester info to another system or a new account.
+
+```
+pilot export
+```
+
+### Import testers
+
+Add external testers from a CSV file. Sample CSV file available [here](https://itunesconnect.apple.com/itc/docs/tester_import.csv).
+
+```
+pilot import
+```
+
+You can also specify the directory using
+
+```
+pilot export -c ~/Desktop/testers.csv
+pilot import -c ~/Desktop/testers.csv
+ ```
+
+# 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 using a single command
+- [`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 
+
+##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
+
+## How is my password stored?
+
+`pilot` uses the [CredentialsManager](https://github.com/fastlane/CredentialsManager) from `fastlane`.
+
+# Need help?
+- If there is a technical problem with `pilot`, submit an issue.
+- I'm available for contract work - drop me an email: pilot@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.
+
+# Contributing
+
+1. Create an issue to start a discussion about your idea
+2. Fork it (https://github.com/fastlane/pilot/fork)
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request
+

data/bin/pilot

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

data/lib/assets/XMLTemplate.xml.erb

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<package xmlns="http://apple.com/itunes/importer" version="software4.7">
+  <software_assets apple_id="<%= @data[:apple_id] %>">
+    <asset type="bundle">
+      <data_file>
+        <size><%= @data[:file_size] %></size>
+        <file_name><%= @data[:ipa_path] %></file_name>
+        <checksum type="md5"><%= @data[:md5] %></checksum>
+      </data_file>
+    </asset>
+  </software_assets>
+</package>

data/lib/pilot.rb

@@ -1,7 +1,15 @@
-require 'json'
-require 'pilot/version'
+require "json"
+require "pilot/version"
+require "pilot/manager"
+require "pilot/build_manager"
+require "pilot/tester_manager"
+require "pilot/tester_importer"
+require "pilot/tester_exporter"
+require "pilot/package_builder"
 
-require 'fastlane_core'
+require "fastlane_core"
+require "spaceship"
+require "terminal-table"
 
 module Pilot
   Helper = FastlaneCore::Helper # you gotta love Ruby: Helper.* should use the Helper class contained in FastlaneCore

data/lib/pilot/build_manager.rb

@@ -0,0 +1,87 @@
+module Pilot
+  class BuildManager < Manager
+    def upload(options)
+      start(options)
+
+      Helper.log.info "Ready to upload new build to TestFlight (App: #{config[:apple_id]})...".green
+
+      package_path = PackageBuilder.new.generate(apple_id: config[:apple_id], 
+                                                 ipa_path: config[:ipa],
+                                             package_path: "/tmp") # TODO: Config
+
+      result = FastlaneCore::ItunesTransporter.new.upload(config[:apple_id], package_path)
+      if result
+        Helper.log.info "Successfully uploaded the new binary to iTunes Connect"
+
+        unless config[:skip_submission]
+          upload_date = wait_for_processing_build
+          distribute_build(upload_date)
+
+          Helper.log.info "Successfully distribute build to beta testers 🚀"
+        end
+      else
+        raise "Error uploading ipa file, more information see above".red
+      end
+    end
+
+    def list(options)
+      start(options)
+      if config[:apple_id].to_s.length == 0 and config[:app_identifier].to_s.length == 0
+        config[:app_identifier] = ask("App Identifier: ")
+      end
+
+      rows = app.all_processing_builds.collect { |build| describe_build(build) }
+      rows = rows + app.builds.collect { |build| describe_build(build) }
+
+      puts Terminal::Table.new(
+        title: "#{app.name} Builds".green,
+        headings: ["Version #", "Build #", "Testing", "Installs", "Sessions"],
+        rows: rows
+      )
+    end
+
+    private
+      def describe_build(build)
+        row = [build.train_version, 
+               build.build_version,
+               build.testing_status,
+               build.install_count,
+               build.session_count]
+
+        return row
+      end
+
+      # This method will takes care of checking for the processing builds every few seconds
+      # @return [Integer] The upload date
+      def wait_for_processing_build
+        # the upload date of the new buid
+        # we use it to identify the build
+        upload_date = nil
+        loop do
+          Helper.log.info "Waiting for iTunes Connect to process the new build"
+          sleep 5
+          builds = app.all_processing_builds
+          break if builds.count == 0
+          upload_date = builds.last.upload_date
+        end
+
+        if upload_date
+          Helper.log.info "Build successfully processed by iTunes Connect".green
+          return upload_date
+        else
+          raise "Error: Seems like iTunes Connect didn't properly pre-process the binary".red
+        end
+      end
+
+      def distribute_build(upload_date)
+        Helper.log.info "Distributing new build to testers"
+        
+        current_build = app.builds.find do |build|
+          build.upload_date == upload_date
+        end
+
+        # First, enable TestFlight beta testing for this train
+        current_build.build_train.update_testing_status!(true)
+      end
+  end
+end

data/lib/pilot/commands_generator.rb

@@ -0,0 +1,123 @@
+require "commander"
+require "pilot/options"
+require "fastlane_core"
+
+HighLine.track_eof = false
+
+module Pilot
+  class CommandsGenerator
+    include Commander::Methods
+
+    FastlaneCore::CommanderGenerator.new.generate(Pilot::Options.available_options)
+
+    def self.start
+      FastlaneCore::UpdateChecker.start_looking_for_update("pilot")
+      new.run
+    ensure
+      FastlaneCore::UpdateChecker.show_update_status("pilot", Pilot::VERSION)
+    end
+
+    def convert_options(options)
+      o = options.__hash__.dup
+      o.delete(:verbose)
+      o
+    end
+
+    def handle_email(config, _args)
+      config[:email] ||= _args.first
+      config[:email] ||= ask("Email address of the tester: ".yellow)
+    end
+
+    def run
+      program :version, Pilot::VERSION
+      program :description, Pilot::DESCRIPTION
+      program :help, "Author", "Felix Krause <pilot@krausefx.com>"
+      program :help, "Website", "https://fastlane.tools"
+      program :help, "GitHub", "https://github.com/fastlane/pilot"
+      program :help_formatter, :compact
+
+      global_option("--verbose") { $verbose = true }
+
+      always_trace!
+
+      command :upload do |c|
+        c.syntax = "pilot upload"
+        c.description = "Uploads a new binary to Apple TestFlight"
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Pilot::Options.available_options, convert_options(options))
+          Pilot::BuildManager.new.upload(config)
+        end
+      end
+
+      command :builds do |c|
+        c.syntax = "pilot builds"
+        c.description = "Lists all builds for given application"
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Pilot::Options.available_options, convert_options(options))
+          Pilot::BuildManager.new.list(config)
+        end
+      end
+
+      command :add do |c|
+        c.syntax = "pilot add"
+        c.description = "Adds a new external tester to a specific app (if given). This will also add an existing tester to an app."
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Pilot::Options.available_options, convert_options(options))
+          handle_email(config, _args)
+          Pilot::TesterManager.new.add_tester(config)
+        end
+      end
+
+      command :list do |c|
+        c.syntax = "pilot list"
+        c.description = "Lists all registered testers, both internal and external"
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Pilot::Options.available_options, convert_options(options))
+          Pilot::TesterManager.new.list_testers(config)
+        end
+      end
+
+      command :find do |c|
+        c.syntax = "pilot find"
+        c.description = "Find a tester (internal or external) by their email address"
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Pilot::Options.available_options, convert_options(options))
+          handle_email(config, _args)
+          Pilot::TesterManager.new.find_tester(config)
+        end
+      end
+
+      command :remove do |c|
+        c.syntax = "pilot remove"
+        c.description = "Remove an external tester by their email address"
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Pilot::Options.available_options, convert_options(options))
+          handle_email(config, _args)
+          Pilot::TesterManager.new.remove_tester(config)
+        end
+      end
+
+      command :export do |c|
+        c.syntax = "pilot export"
+        c.description = "Exports all external testers to a CSV file"
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Pilot::Options.available_options, convert_options(options))
+          Pilot::TesterExporter.new.export_testers(config)
+        end
+      end
+
+      command :import do |c|
+        c.syntax = "pilot import"
+        c.description = "Create external testers from a CSV file"
+        c.action do |_args, options|
+          config = FastlaneCore::Configuration.create(Pilot::Options.available_options, convert_options(options))
+          Pilot::TesterImporter.new.import_testers(config)
+        end
+      end
+
+      default_command :help
+
+      run!
+    end
+  end
+end

data/lib/pilot/manager.rb

@@ -0,0 +1,61 @@
+require "fastlane_core"
+
+module Pilot
+  class Manager
+    def start(options)
+      return if @config # to not login multiple times
+      @config = options
+      login
+    end
+
+    def login
+      user = config[:username]
+      user ||= ENV["DELIVER_USERNAME"]
+      user ||= CredentialsManager::AppfileConfig.try_fetch_value(:apple_id)
+      CredentialsManager::PasswordManager.shared_manager(user) if user
+
+      Helper.log.info "Login to iTunes Connect"
+      Spaceship::Tunes.login(user, CredentialsManager::PasswordManager.shared_manager(user).password)
+      Helper.log.info "Login successful"
+    end
+
+    # The app object we're currently using
+    def app
+      @apple_id ||= fetch_app_id
+
+      unless (@app ||= Spaceship::Application.find(@apple_id))
+        raise "Could not find app with #{(config[:apple_id] || config[:app_identifier])}"
+      end
+      return @app
+    end
+
+    # Access the current configuration 
+    def config
+      @config
+    end
+
+    # Config Related
+    ################
+
+    def fetch_app_id
+      return @apple_id if @apple_id
+      config[:app_identifier] = fetch_app_identifier
+
+      if config[:app_identifier]
+        @app ||= Spaceship::Application.find(config[:app_identifier])
+        app_id ||= @app.apple_id
+      end
+
+      app_id ||= ask("Could not automatically find the app ID, please enter it here (e.g. 956814360): ")
+
+      return app_id
+    end
+
+    def fetch_app_identifier
+      result = config[:app_identifier]
+      result ||= FastlaneCore::IpaFileAnalyser.fetch_app_identifier(config[:ipa])
+      result ||= ask("Please enter the app's bundle identifier: ")
+      return result
+    end
+  end
+end

data/lib/pilot/options.rb

@@ -0,0 +1,88 @@
+require "fastlane_core"
+require "credentials_manager"
+
+module Pilot
+  class Options
+    def self.available_options
+      @@options ||= [
+        FastlaneCore::ConfigItem.new(key: :username,
+                                     short_option: "-u",
+                                     env_name: "PILOT_USERNAME",
+                                     description: "Your Apple ID Username",
+                                     default_value: ENV["DELIVER_USER"] || CredentialsManager::AppfileConfig.try_fetch_value(:apple_id),
+                                     verify_block: proc do |value|
+                                       CredentialsManager::PasswordManager.shared_manager(value)
+                                     end),
+
+        FastlaneCore::ConfigItem.new(key: :ipa,
+                                     short_option: "-i",
+                                     env_name: "PILOT_IPA",
+                                     description: "Path to the ipa file to upload",
+                                     default_value: Dir["*.ipa"].first,
+                                     verify_block: proc do |value|
+                                       fail "Could not find ipa file at path '#{value}'" unless File.exist? value
+                                       fail "'#{value}' doesn't seem to be an ipa file" unless value.end_with? ".ipa"
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :skip_submission,
+                                     short_option: "-s",
+                                     env_name: "PILOT_SKIP_SUBMISSION",
+                                     description: "Skip the distributing action of pilot and only upload the ipa file",
+                                     default_value: false),
+        FastlaneCore::ConfigItem.new(key: :app_identifier,
+                                     short_option: "-a",
+                                     env_name: "PILOT_APP_IDENTIFIER",
+                                     description: "The bundle identifier of the app to upload or manage testers (optional)",
+                                     optional: true,
+                                     default_value: ENV["TESTFLIGHT_APP_IDENTITIFER"] || CredentialsManager::AppfileConfig.try_fetch_value(:app_identifier),
+                                     verify_block: proc do |_value|
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :apple_id,
+                                     short_option: "-p",
+                                     env_name: "PILOT_APPLE_ID",
+                                     description: "The unique App ID provided by iTunes Connect",
+                                     optional: true,
+                                     default_value: ENV["TESTFLIGHT_APPLE_ID"],
+                                     verify_block: proc do |_value|
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :first_name,
+                                     short_option: "-f",
+                                     env_name: "PILOT_TESTER_FIRST_NAME",
+                                     description: "The tester's first name",
+                                     optional: true,
+                                     verify_block: proc do |_value|
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :last_name,
+                                     short_option: "-l",
+                                     env_name: "PILOT_TESTER_LAST_NAME",
+                                     description: "The tester's last name",
+                                     optional: true,
+                                     verify_block: proc do |_value|
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :email,
+                                     short_option: "-e",
+                                     env_name: "PILOT_TESTER_EMAIL",
+                                     description: "The tester's email",
+                                     optional: true,
+                                     verify_block: proc do |_value|
+                                        raise "Please pass a valid email address" unless _value.include?"@"
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :group_name,
+                                     short_option: "-g",
+                                     env_name: "PILOT_TESTER_GROUP",
+                                     description: "Group to add the tester to",
+                                     optional: true,
+                                     verify_block: proc do |_value|
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :testers_file_path,
+                                     short_option: "-c",
+                                     env_name: "PILOT_TESTERS_FILE",
+                                     description: "Path to a CSV file of testers",
+                                     default_value: "./testers.csv",
+                                     optional: true,
+                                     verify_block: proc do |_value|
+                                     end)
+
+      ]
+    end
+  end
+end

data/lib/pilot/package_builder.rb

@@ -0,0 +1,42 @@
+require "digest/md5"
+
+module Pilot
+  class PackageBuilder
+    METADATA_FILE_NAME = "metadata.xml"
+
+    attr_accessor :package_path
+
+    def generate(apple_id: nil, ipa_path: nil, package_path: nil)
+      self.package_path = File.join(package_path, "#{apple_id}.itmsp")
+      FileUtils.rm_rf self.package_path rescue nil
+      FileUtils.mkdir_p self.package_path
+
+      lib_path = Helper.gem_path("pilot")
+
+      ipa_path = copy_ipa(ipa_path)
+      @data = {
+        apple_id: apple_id,
+        file_size: File.size(ipa_path),
+        ipa_path: File.basename(ipa_path), # this is only the base name as the ipa is inside the package
+        md5: Digest::MD5.hexdigest(File.read(ipa_path))
+      }
+
+      xml_path = File.join(lib_path, "lib/assets/XMLTemplate.xml.erb")
+      xml = ERB.new(File.read(xml_path)).result(binding) # http://www.rrn.dk/rubys-erb-templating-system  
+      
+      File.write(File.join(self.package_path, METADATA_FILE_NAME), xml)
+      Helper.log.info "Wrote XML data to '#{self.package_path}'".green if $verbose
+
+      return package_path
+    end
+
+    private
+      def copy_ipa(ipa_path)
+        ipa_file_name = Digest::MD5.hexdigest(ipa_path)
+        resulting_path = File.join(self.package_path, "#{ipa_file_name}.ipa")
+        FileUtils.cp(ipa_path, resulting_path)
+
+        return resulting_path
+      end
+  end
+end

data/lib/pilot/tester_exporter.rb

@@ -0,0 +1,38 @@
+require "fastlane_core"
+
+module Pilot
+  class TesterExporter < Manager
+    def export_testers(options)
+
+      raise "Export file path is required".red unless options[:testers_file_path]
+
+      start(options)
+      require 'csv'
+
+      testers = Spaceship::Tunes::Tester::External.all
+
+      file = config[:testers_file_path]
+
+      CSV.open(file, "w") do |csv|
+
+        csv << ['First', 'Last', 'Email', 'Devices', 'Groups', 'Installed Version', 'Install Date']
+
+        testers.each do |tester|
+
+          groups = tester.raw_data.get("groups")
+
+          group_names = ""
+          if groups && groups.length > 0
+            names = groups.map { |group| group["name"]["value"] }
+            group_names = names.join(';')
+          end
+
+          csv << [tester.first_name, tester.last_name, tester.email, tester.devices.count, group_names]
+        end
+
+        Helper.log.info "Successfully exported CSV to #{file}".green
+      end
+
+    end
+  end
+end

data/lib/pilot/tester_importer.rb

@@ -0,0 +1,47 @@
+require "fastlane_core"
+
+module Pilot
+  class TesterImporter < Manager
+    def import_testers(options)
+      raise "Import file path is required".red unless options[:testers_file_path]
+
+      start(options)
+
+      require 'csv'
+
+      file = config[:testers_file_path]
+      tester_manager = Pilot::TesterManager.new
+      imported_tester_count = 0
+
+      is_first = true
+      CSV.foreach(file, "r") do |row|
+        if is_first
+          is_first = false
+          next
+        end
+
+        first_name, last_name, email = row        
+
+        unless email
+          Helper.log.error "No email found in row: #{row}".red
+          next
+        end
+
+        # Add this the existing config hash to pass it to the TesterManager
+        config[:first_name] = first_name
+        config[:last_name] = last_name
+        config[:email] = email
+
+        begin
+          tester_manager.add_tester(config)
+          imported_tester_count += 1
+        rescue => ex
+          # do nothing, move on to the next row
+        end
+
+      end
+
+      Helper.log.info "Successfully imported #{imported_tester_count} testers from #{file}".green
+    end
+  end
+end

data/lib/pilot/tester_manager.rb

@@ -0,0 +1,137 @@
+require "fastlane_core"
+
+module Pilot
+  class TesterManager < Manager
+    def add_tester(options)
+      start(options)
+
+      begin
+        tester = Spaceship::Tunes::Tester::Internal.find(config[:email])
+        tester ||= Spaceship::Tunes::Tester::External.find(config[:email])
+
+        if tester
+          Helper.log.info "Existing tester #{tester.email}".green
+        else
+          tester = Spaceship::Tunes::Tester::External.create!(email: config[:email],
+                                                              first_name: config[:first_name],
+                                                              last_name: config[:last_name],
+                                                              group: config[:group_name])
+          Helper.log.info "Successfully invited tester: #{tester.email}".green
+        end
+        
+        app_filter = (config[:apple_id] || config[:app_identifier])
+        if app_filter
+          begin
+            app = Spaceship::Application.find(app_filter)
+            raise "Couldn't find app with '#{app_filter}'" unless app
+            tester.add_to_app!(app.apple_id)
+            Helper.log.info "Successfully added tester to app #{app_filter}".green
+          rescue => ex
+            Helper.log.error "Could not add #{tester.email} to app: #{ex}".red
+            raise ex
+          end
+        end
+      rescue => ex
+        Helper.log.error "Could not create tester #{config[:email]}".red
+        raise ex
+      end
+    end
+
+    def find_tester(options)
+      start(options)
+
+      tester = Spaceship::Tunes::Tester::Internal.find(config[:email])
+      tester ||= Spaceship::Tunes::Tester::External.find(config[:email])
+
+      raise "Tester #{config[:email]} not found".red unless tester
+      
+      describe_tester(tester)
+      return tester
+    end
+
+    def remove_tester(options)
+      start(options)
+      
+      tester = Spaceship::Tunes::Tester::External.find(config[:email])
+      tester ||= Spaceship::Tunes::Tester::Internal.find(config[:email])
+
+      if tester
+        tester.delete!
+        Helper.log.info "Successully removed tester #{tester.email}".green
+      else
+        Helper.log.error "Tester not found: #{config[:email]}".red
+      end
+    end
+
+    def list_testers(options)
+      start(options)
+      require 'terminal-table'
+
+      list(Spaceship::Tunes::Tester::Internal.all, "Internal Testers")
+      puts "" # new line
+      list(Spaceship::Tunes::Tester::External.all, "External Testers")
+    end
+
+    private
+
+      def list(all_testers, title)
+        rows = []
+        all_testers.each do |tester|
+          rows << [tester.first_name, tester.last_name, tester.email, tester.devices.count]
+        end
+
+        puts Terminal::Table.new(
+          title: title.green,
+          headings: ["First", "Last", "Email", "Devices"],
+          rows: rows
+        )
+      end
+
+      # Print out all the details of a specific tester
+      def describe_tester(tester)
+        return unless tester
+
+        rows = []
+
+        rows << ["First name", tester.first_name]
+        rows << ["Last name", tester.last_name]
+        rows << ["Email", tester.email]
+
+        groups = tester.raw_data.get("groups")
+
+        if groups && groups.length > 0
+          group_names = groups.map { |group| group["name"]["value"] }
+          rows << ["Groups", group_names.join(', ')]
+        end
+
+        if tester.latest_install_date
+          latest_installed_version = tester.latest_installed_version_number
+          latest_installed_short_version = tester.latest_installed_build_number
+          pretty_date = Time.at((tester.latest_install_date / 1000)).strftime("%m/%d/%y %H:%M")
+
+          rows << ["Latest Version", "#{latest_installed_version} (#{latest_installed_short_version})"]
+          rows << ["Latest Install Date", pretty_date]
+        end
+
+        if tester.devices.length == 0
+          rows << ["Devices", "No devices"]
+        else
+          rows << ["#{tester.devices.count} Devices", ""]
+          tester.devices.each do |device|
+            current = "\u2022 #{device['model']}, iOS #{device['osVersion']}"
+
+            if rows.last[1].length == 0
+              rows.last[1] = current
+            else
+              rows << ["", current]
+            end
+          end
+        end
+
+        puts Terminal::Table.new(
+          title: tester.email.green,
+          rows: rows
+        )
+      end
+  end
+end

data/lib/pilot/version.rb

@@ -1,3 +1,4 @@
 module Pilot
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
+  DESCRIPTION = "The best way to manage your TestFlight testers and builds from your terminal"
 end

metadata

@@ -1,142 +1,170 @@
 --- !ruby/object:Gem::Specification
 name: pilot
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Felix Krause
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-14 00:00:00.000000000 Z
+date: 2015-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fastlane_core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.7.2
+        version: 0.9.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.7.2
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: spaceship
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: credentials_manager
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.3.0
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.5
 - !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: 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: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.1.0
 - !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: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.8.7.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.8.7.4
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.19.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.19.0
 - !ruby/object:Gem::Dependency
   name: coveralls
   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'
-description: The unofficial TestFlight CLI to upload builds and manage testers
+description: The best way to manage your TestFlight testers and builds from your terminal
 email:
 - pilot@krausefx.com
 executables:
@@ -147,7 +175,16 @@ files:
 - LICENSE
 - README.md
 - bin/pilot
+- lib/assets/XMLTemplate.xml.erb
 - lib/pilot.rb
+- lib/pilot/build_manager.rb
+- lib/pilot/commands_generator.rb
+- lib/pilot/manager.rb
+- lib/pilot/options.rb
+- lib/pilot/package_builder.rb
+- lib/pilot/tester_exporter.rb
+- lib/pilot/tester_importer.rb
+- lib/pilot/tester_manager.rb
 - lib/pilot/version.rb
 homepage: https://fastlane.tools
 licenses:
@@ -159,19 +196,19 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.7
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
-summary: The unofficial TestFlight CLI to upload builds and manage testers
+summary: The best way to manage your TestFlight testers and builds from your terminal
 test_files: []
 has_rdoc: