fastlane 1.111.0 → 2.0.1

data/pilot/lib/pilot/tester_manager.rb

@@ -0,0 +1,212 @@
+require "fastlane_core"
+require "pilot/tester_util"
+require 'terminal-table'
+
+module Pilot
+  class TesterManager < Manager
+    def add_tester(options)
+      start(options)
+
+      if config[:groups]
+        groups = Spaceship::Tunes::Tester::External.groups
+        selected_groups = []
+        config[:groups].each do |group|
+          group_id = groups.find { |k, v| v == group || k == group }
+          raise "Group '#{group}' not found for #{config[:email]}" unless group_id
+          selected_groups.push(group_id[0])
+        end
+        config[:groups] = selected_groups
+      end
+
+      begin
+        tester = Spaceship::Tunes::Tester::Internal.find(config[:email])
+        tester ||= Spaceship::Tunes::Tester::External.find(config[:email])
+
+        if tester
+          UI.success("Existing tester #{tester.email}")
+        else
+          tester = Spaceship::Tunes::Tester::External.create!(email: config[:email],
+                                                              first_name: config[:first_name],
+                                                              last_name: config[:last_name],
+                                                              groups: config[:groups])
+          UI.success("Successfully invited tester: #{tester.email}")
+        end
+
+        app_filter = (config[:apple_id] || config[:app_identifier])
+        if app_filter
+          begin
+            app = Spaceship::Application.find(app_filter)
+            UI.user_error!("Couldn't find app with '#{app_filter}'") unless app
+            tester.add_to_app!(app.apple_id)
+            UI.success("Successfully added tester to app #{app_filter}")
+          rescue => ex
+            UI.error("Could not add #{tester.email} to app: #{ex}")
+            raise ex
+          end
+        end
+      rescue => ex
+        UI.error("Could not create tester #{config[:email]}")
+        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])
+
+      UI.user_error!("Tester #{config[:email]} not found") 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
+        app_filter = (config[:apple_id] || config[:app_identifier])
+        if app_filter
+          begin
+            app = Spaceship::Application.find(app_filter)
+            UI.user_error!("Couldn't find app with '#{app_filter}'") unless app
+            tester.remove_from_app!(app.apple_id)
+            UI.success("Successfully removed tester #{tester.email} from app #{app_filter}")
+          rescue => ex
+            UI.error("Could not remove #{tester.email} from app: #{ex}")
+            raise ex
+          end
+        else
+          tester.delete!
+          UI.success("Successfully removed tester #{tester.email}")
+        end
+      else
+        UI.error("Tester not found: #{config[:email]}")
+      end
+    end
+
+    def list_testers(options)
+      start(options)
+
+      app_filter = (config[:apple_id] || config[:app_identifier])
+      if app_filter
+        list_testers_by_app(app_filter)
+      else
+        list_testers_global
+      end
+    end
+
+    # private
+
+    def list_testers_by_app(app_filter)
+      app = Spaceship::Application.find(app_filter)
+      UI.user_error!("Couldn't find app with '#{app_filter}'") unless app
+
+      int_testers = Spaceship::Tunes::Tester::Internal.all_by_app(app.apple_id)
+      ext_testers = Spaceship::Tunes::Tester::External.all_by_app(app.apple_id)
+
+      list_by_app(int_testers, "Internal Testers")
+      puts ""
+      list_by_app(ext_testers, "External Testers")
+    end
+
+    def list_testers_global
+      begin
+        int_testers = Spaceship::Tunes::Tester::Internal.all
+        ext_testers = Spaceship::Tunes::Tester::External.all
+      rescue => ex
+        if ex.to_s.include?("Forbidden")
+          UI.user_error!("You don't have the permission to list the testers of your whole team. Please provide an app identifier to list all testers of a specific application.")
+        else
+          raise ex
+        end
+      end
+
+      list_global(int_testers, "Internal Testers")
+      puts ""
+      list_global(ext_testers, "External Testers")
+    end
+
+    def list_global(all_testers, title)
+      headers = ["First", "Last", "Email", "Groups", "Devices", "Latest Version", "Latest Install Date"]
+      list(all_testers, title, headers) do |tester|
+        [
+          tester.first_name,
+          tester.last_name,
+          tester.email,
+          tester.groups_list,
+          tester.devices.count,
+          tester.full_version,
+          tester.pretty_install_date
+        ]
+      end
+    end
+
+    def list_by_app(all_testers, title)
+      headers = ["First", "Last", "Email", "Groups"]
+      list(all_testers, title, headers) do |tester|
+        [
+          tester.first_name,
+          tester.last_name,
+          tester.email,
+          tester.groups_list
+          # Testers returned by the query made in the context of an app do not contain
+          # the devices, version, or install date information
+        ]
+      end
+    end
+
+    # Requires a block that accepts a tester and returns an array of tester column values
+    def list(all_testers, title, headings)
+      puts Terminal::Table.new(
+        title: title.green,
+        headings: headings,
+        rows: all_testers.map { |tester| yield tester }
+      )
+    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]
+
+      if tester.groups.length > 0
+        rows << ["Groups", tester.groups_list]
+      end
+
+      if tester.latest_install_date
+        rows << ["Latest Version", tester.full_version]
+        rows << ["Latest Install Date", tester.pretty_install_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/pilot/lib/pilot/tester_util.rb

@@ -0,0 +1,23 @@
+require "spaceship/base"
+require "spaceship/tunes/tunes_base"
+require "spaceship/tunes/tester"
+
+module Spaceship
+  module Tunes
+    # monkey patched
+    # move this to spaceship
+    class Tester < TunesBase
+      def full_version
+        return nil unless latest_install_date
+        latest_installed_version = latest_installed_version_number
+        latest_installed_short_version = latest_installed_build_number
+        "#{latest_installed_version} (#{latest_installed_short_version})"
+      end
+
+      def pretty_install_date
+        return nil unless latest_install_date
+        Time.at((latest_install_date / 1000)).strftime("%m/%d/%y %H:%M")
+      end
+    end
+  end
+end

data/produce/README.md

@@ -0,0 +1,232 @@
+<h3 align="center">
+  <a href="https://github.com/fastlane/fastlane/tree/master/fastlane">
+    <img src="../fastlane/assets/fastlane.png" width="150" />
+    <br />
+    fastlane
+  </a>
+</h3>
+<p align="center">
+  <a href="https://github.com/fastlane/fastlane/tree/master/deliver">deliver</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/snapshot">snapshot</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/frameit">frameit</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/pem">pem</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/sigh">sigh</a> &bull;
+  <b>produce</b> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/cert">cert</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/spaceship">spaceship</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/pilot">pilot</a> &bull;
+  <a href="https://github.com/fastlane/boarding">boarding</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/gym">gym</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/scan">scan</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/match">match</a>
+</p>
+-------
+
+<p align="center">
+  <img src="assets/produce.png" height="110">
+</p>
+
+produce
+============
+
+[![Twitter: @FastlaneTools](https://img.shields.io/badge/contact-@FastlaneTools-blue.svg?style=flat)](https://twitter.com/FastlaneTools)
+[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/fastlane/fastlane/blob/master/produce/LICENSE)
+[![Gem](https://img.shields.io/gem/v/produce.svg?style=flat)](http://rubygems.org/gems/produce)
+
+###### Create new iOS apps on iTunes Connect and Dev Portal using your command line
+
+`produce` creates new iOS apps on both the Apple Developer Portal and iTunes Connect with the minimum required information.
+
+Get in contact with the developers on Twitter: [@FastlaneTools](https://twitter.com/FastlaneTools)
+
+-------
+<p align="center">
+    <a href="#features">Features</a> &bull;
+    <a href="#installation">Installation</a> &bull;
+    <a href="#usage">Usage</a> &bull;
+    <a href="#how-does-it-work">How does it work?</a> &bull;
+    <a href="#tips">Tips</a> &bull;
+    <a href="#need-help">Need help?</a>
+</p>
+
+-------
+
+<h5 align="center"><code>produce</code> is part of <a href="https://fastlane.tools">fastlane</a>: The easiest way to automate beta deployments and releases for your iOS and Android apps.</h5>
+
+# Features
+
+- **Create** new apps on both iTunes Connect and the Apple Developer Portal
+- **Modify** Application Services on the Apple Developer Portal
+- **Create** App Groups on the Apple Developer Portal
+- **Associate** apps with App Groups on the Apple Developer Portal
+- Support for **multiple Apple accounts**, storing your credentials securely in the Keychain
+
+##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
+
+# Installation
+
+    sudo gem install fastlane
+
+# Usage
+
+## Creating a new application
+
+    fastlane produce
+
+To get a list of all available parameters:
+
+    fastlane produce --help
+
+```
+  Commands:
+    associate_group  Associate with a group, which is create if needed or simply located otherwise
+    create           Creates a new app on iTunes Connect and the Apple Developer Portal
+    disable_services Disable specific Application Services for a specific app on the Apple Developer Portal
+    enable_services  Enable specific Application Services for a specific app on the Apple Developer Portal
+    group            Ensure that a specific App Group exists
+    help             Display global or [command] help documentation
+
+  Global Options:
+    -u, --username STRING Your Apple ID Username (PRODUCE_USERNAME)
+    -a, --app_identifier STRING App Identifier (Bundle ID, e.g. com.krausefx.app) (PRODUCE_APP_IDENTIFIER)
+    -e, --bundle_identifier_suffix STRING App Identifier Suffix (Ignored if App Identifier does not ends with .*) (PRODUCE_APP_IDENTIFIER_SUFFIX)
+    -q, --app_name STRING App Name (PRODUCE_APP_NAME)
+    -z, --app_version STRING Initial version number (e.g. '1.0') (PRODUCE_VERSION)
+    -y, --sku STRING     SKU Number (e.g. '1234') (PRODUCE_SKU)
+    -m, --language STRING Primary Language (e.g. 'English', 'German') (PRODUCE_LANGUAGE)
+    -c, --company_name STRING The name of your company. Only required if it's the first app you create (PRODUCE_COMPANY_NAME)
+    -i, --skip_itc       Skip the creation of the app on iTunes Connect (PRODUCE_SKIP_ITC)
+    -d, --skip_devcenter  Skip the creation of the app on the Apple Developer Portal (PRODUCE_SKIP_DEVCENTER)
+    -b, --team_id STRING The ID of your team if you're in multiple teams (PRODUCE_TEAM_ID)
+    -l, --team_name STRING The name of your team if you're in multiple teams (PRODUCE_TEAM_NAME)
+    -h, --help           Display help documentation
+    -v, --version        Display version information
+```
+
+## Enabling / Disabling Application Services
+
+If you want to enable Application Services for an App ID (HomeKit and HealthKit in this example):
+
+    fastlane produce enable_services --homekit --healthkit
+
+If you want to disable Application Services for an App ID (iCloud in this case):
+
+    fastlane produce disable_services --icloud
+
+If you want to create a new App Group:
+
+    fastlane produce group -g group.krausefx -n "Example App Group"
+
+If you want to associate an app with an App Group:
+
+    fastlane produce associate_group -a com.krausefx.app group.krausefx
+
+# Parameters
+
+Get a list of all available options using
+
+    fastlane produce enable_services --help
+
+```
+    --app-group          Enable App Groups
+    --apple-pay          Enable Apple Pay
+    --associated-domains Enable Associated Domains
+    --data-protection STRING Enable Data Protection, suitable values are "complete", "unlessopen" and "untilfirstauth"
+    --game-center        Enable Game Center
+    --healthkit          Enable HealthKit
+    --homekit            Enable HomeKit
+    --wireless-conf      Enable Wireless Accessory Configuration
+    --icloud STRING      Enable iCloud, suitable values are "legacy" and "cloudkit"
+    --in-app-purchase    Enable In-App Purchase
+    --inter-app-audio    Enable Inter-App-Audio
+    --passbook           Enable Passbook
+    --push-notification  Enable Push notification (only enables the service, does not configure certificates)
+    --sirikit            Enable SiriKit
+    --vpn-conf           Enable VPN Configuration
+```
+
+    fastlane produce disable_services --help
+
+```
+    --app-group          Disable App Groups
+    --apple-pay          Disable Apple Pay
+    --associated-domains Disable Associated Domains
+    --data-protection    Disable Data Protection
+    --game-center        Disable Game Center
+    --healthkit          Disable HealthKit
+    --homekit            Disable HomeKit
+    --wireless-conf      Disable Wireless Accessory Configuration
+    --icloud             Disable iCloud
+    --in-app-purchase    Disable In-App Purchase
+    --inter-app-audio    Disable Inter-App-Audio
+    --passbook           Disable Passbook
+    --push-notification  Disable Push notifications
+    --sirikit            Disable SiriKit
+    --vpn-conf           Disable VPN Configuration
+```
+
+## Environment Variables
+
+All available values can also be passed using environment variables, run `fastlane produce --help` to get a list of all available parameters.
+
+## [`fastlane`](https://github.com/fastlane/fastlane/tree/master/fastlane) Integration
+
+Your `Fastfile` should look like this
+```ruby
+lane :release do
+  produce(
+    username: 'felix@krausefx.com',
+    app_identifier: 'com.krausefx.app',
+    app_name: 'MyApp',
+    language: 'English',
+    app_version: '1.0',
+    sku: '123',
+    team_name: 'SunApps GmbH' # only necessary when in multiple teams
+  )
+
+  deliver
+end
+```
+
+To use the newly generated app in `deliver`, you need to add this line to your `Deliverfile`:
+
+```ruby
+apple_id ENV['PRODUCE_APPLE_ID']
+```
+
+This will tell `deliver`, which `App ID` to use, since the app is not yet available in the App Store.
+
+You'll still have to fill out the remaining information (like screenshots, app description and pricing). You can use [deliver](https://github.com/fastlane/fastlane/tree/master/deliver) to upload your app metadata using a CLI
+
+## How is my password stored?
+`produce` uses the [password manager](https://github.com/fastlane/fastlane/tree/master/credentials_manager) from `fastlane`. Take a look the [CredentialsManager README](https://github.com/fastlane/fastlane/tree/master/credentials_manager) for more information.
+
+# Tips
+## [`fastlane`](https://fastlane.tools) Toolchain
+
+- [`fastlane`](https://fastlane.tools): The easiest way to automate beta deployments and releases for your iOS and Android apps
+- [`deliver`](https://github.com/fastlane/fastlane/tree/master/deliver): Upload screenshots, metadata and your app to the App Store
+- [`snapshot`](https://github.com/fastlane/fastlane/tree/master/snapshot): Automate taking localized screenshots of your iOS app on every device
+- [`frameit`](https://github.com/fastlane/fastlane/tree/master/frameit): Quickly put your screenshots into the right device frames
+- [`pem`](https://github.com/fastlane/fastlane/tree/master/pem): Automatically generate and renew your push notification profiles
+- [`sigh`](https://github.com/fastlane/fastlane/tree/master/sigh): Because you would rather spend your time building stuff than fighting provisioning
+- [`cert`](https://github.com/fastlane/fastlane/tree/master/cert): Automatically create and maintain iOS code signing certificates
+- [`spaceship`](https://github.com/fastlane/fastlane/tree/master/spaceship): Ruby library to access the Apple Dev Center and iTunes Connect
+- [`pilot`](https://github.com/fastlane/fastlane/tree/master/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/fastlane/tree/master/gym): Building your iOS apps has never been easier
+- [`scan`](https://github.com/fastlane/fastlane/tree/master/scan): The easiest way to run tests of your iOS and Mac app
+- [`match`](https://github.com/fastlane/fastlane/tree/master/match): Easily sync your certificates and profiles across your team using git
+
+##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
+
+# Need help?
+Please submit an issue on GitHub and provide information about your setup
+
+# Code of Conduct
+Help us keep `produce` open and inclusive. Please read and follow our [Code of Conduct](https://github.com/fastlane/fastlane/blob/master/CODE_OF_CONDUCT.md).
+
+# 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.