fastlane 1.111.0 → 2.0.1

data/spaceship/lib/spaceship/portal/spaceship.rb

@@ -0,0 +1,112 @@
+module Spaceship
+  module Portal
+    class << self
+      # This client stores the default client when using the lazy syntax
+      # Spaceship.app instead of using the spaceship launcher
+      attr_accessor :client
+
+      # Authenticates with Apple's web services. This method has to be called once
+      # to generate a valid session. The session will automatically be used from then
+      # on.
+      #
+      # This method will automatically use the username from the Appfile (if available)
+      # and fetch the password from the Keychain (if available)
+      #
+      # @param user (String) (optional): The username (usually the email address)
+      # @param password (String) (optional): The password
+      #
+      # @raise InvalidUserCredentialsError: raised if authentication failed
+      #
+      # @return (Spaceship::Client) The client the login method was called for
+      def login(user = nil, password = nil)
+        @client = PortalClient.login(user, password)
+      end
+
+      # Open up the team selection for the user (if necessary).
+      #
+      # If the user is in multiple teams, a team selection is shown.
+      # The user can then select a team by entering the number
+      #
+      # Additionally, the team ID is shown next to each team name
+      # so that the user can use the environment variable `FASTLANE_TEAM_ID`
+      # for future user.
+      #
+      # @return (String) The ID of the select team. You also get the value if
+      #   the user is only in one team.
+      def select_team
+        @client.select_team
+      end
+
+      # Helper methods for managing multiple instances of spaceship
+
+      # @return (Class) Access the apps for the spaceship
+      def app
+        Spaceship::App.set_client(@client)
+      end
+
+      # @return (Class) Access the app groups for the spaceship
+      def app_group
+        Spaceship::AppGroup.set_client(@client)
+      end
+
+      # @return (Class) Access app services for the spaceship
+      def app_service
+        Spaceship::AppService
+      end
+
+      # @return (Class) Access the devices for the spaceship
+      def device
+        Spaceship::Device.set_client(@client)
+      end
+
+      # @return (Class) Access the certificates for the spaceship
+      def certificate
+        Spaceship::Certificate.set_client(@client)
+      end
+
+      # @return (Class) Access the provisioning profiles for the spaceship
+      def provisioning_profile
+        Spaceship::ProvisioningProfile.set_client(@client)
+      end
+    end
+  end
+
+  # Legacy code to support `Spaceship.app` without `Portal`
+  class << self
+    def login(user = nil, password = nil)
+      Spaceship::Portal.login(user, password)
+    end
+
+    def select_team
+      Spaceship::Portal.select_team
+    end
+
+    def app
+      Spaceship::Portal.app
+    end
+
+    def app_group
+      Spaceship::Portal.app_group
+    end
+
+    def app_service
+      Spaceship::Portal.app_service
+    end
+
+    def device
+      Spaceship::Portal.device
+    end
+
+    def certificate
+      Spaceship::Portal.certificate
+    end
+
+    def provisioning_profile
+      Spaceship::Portal.provisioning_profile
+    end
+
+    def client
+      Spaceship::Portal.client
+    end
+  end
+end

data/spaceship/lib/spaceship/portal/ui/select_team.rb

@@ -0,0 +1,83 @@
+module Spaceship
+  class Client
+    class UserInterface
+      # Shows the UI to select a team
+      # @example teams value:
+      #  [{"status"=>"active",
+      #   "teamId"=>"5A997XAAAA",
+      #   "type"=>"Company/Organization",
+      #   "extendedTeamAttributes"=>{},
+      #   "teamAgent"=>{
+      #       "personId"=>15534241111,
+      #       "firstName"=>"Felix",
+      #       "lastName"=>"Krause",
+      #       "email"=>"spaceship@krausefx.com",
+      #       "developerStatus"=>"active",
+      #       "teamMemberId"=>"5Y354CXAAA"},
+      #   "memberships"=>
+      #    [{"membershipId"=>"HJ5WHYC5CE",
+      #      "membershipProductId"=>"ds1",
+      #      "status"=>"active",
+      #      "inDeviceResetWindow"=>false,
+      #      "inRenewalWindow"=>false,
+      #      "dateStart"=>"11/20/14 07:59",
+      #      "dateExpire"=>"11/20/15 07:59",
+      #      "platform"=>"ios",
+      #      "availableDeviceSlots"=>100,
+      #      "name"=>"iOS Developer Program"}],
+      #   "currentTeamMember"=>
+      #    {"personId"=>nil, "firstName"=>nil, "lastName"=>nil, "email"=>nil, "developerStatus"=>nil, "privileges"=>{}, "roles"=>["TEAM_ADMIN"], "teamMemberId"=>"HQR8N4GAAA"},
+      #   "name"=>"Company GmbH"},
+      #     {...}
+      #   ]
+
+      def select_team
+        teams = client.teams
+
+        if teams.count == 0
+          puts "No teams available on the Developer Portal"
+          puts "You must accept an invitation to a team for it to be available"
+          puts "To learn more about teams and how to use them visit https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/ManagingYourTeam/ManagingYourTeam.html"
+          raise "Your account is in no teams"
+        end
+
+        team_id = (ENV['FASTLANE_TEAM_ID'] || '').strip
+        team_name = (ENV['FASTLANE_TEAM_NAME'] || '').strip
+
+        if team_id.length > 0
+          # User provided a value, let's see if it's valid
+          teams.each_with_index do |team, i|
+            # There are 2 different values - one from the login page one from the Dev Team Page
+            return team['teamId'] if team['teamId'].strip == team_id
+            return team['teamId'] if team['currentTeamMember']['teamMemberId'].to_s.strip == team_id
+          end
+          puts "Couldn't find team with ID '#{team_id}'"
+        end
+
+        if team_name.length > 0
+          # User provided a value, let's see if it's valid
+          teams.each_with_index do |team, i|
+            return team['teamId'] if team['name'].strip == team_name
+          end
+          puts "Couldn't find team with Name '#{team_name}'"
+        end
+
+        return teams[0]['teamId'] if teams.count == 1 # user is just in one team
+
+        # User Selection
+        loop do
+          # Multiple teams, user has to select
+          puts "Multiple teams found on the Developer Portal, please enter the number of the team you want to use: "
+          teams.each_with_index do |team, i|
+            puts "#{i + 1}) #{team['teamId']} \"#{team['name']}\" (#{team['type']})"
+          end
+
+          selected = ($stdin.gets || '').strip.to_i - 1
+          team_to_use = teams[selected] if selected >= 0
+
+          return team_to_use['teamId'] if team_to_use
+        end
+      end
+    end
+  end
+end

data/spaceship/lib/spaceship/spaceauth_runner.rb

@@ -0,0 +1,50 @@
+require "colored"
+require "credentials_manager"
+require 'yaml'
+
+module Spaceship
+  class SpaceauthRunner
+    def initialize(username: nil)
+      @username = username
+      @username ||= CredentialsManager::AppfileConfig.try_fetch_value(:apple_id)
+      @username ||= ask("Username: ")
+    end
+
+    def run
+      begin
+        puts "Logging into to iTunes Connect (#{@username})..."
+        Spaceship::Tunes.login(@username)
+        puts "Successfully logged in to iTunes Connect".green
+        puts ""
+      rescue
+        puts "Could not login to iTunes Connect...".red
+      end
+
+      itc_cookie_content = Spaceship::Tunes.client.store_cookie
+
+      # The only value we actually need is the "DES5c148586daa451e55afb017aa62418f91" cookie
+      # We're not sure if the key changes
+      #
+      # Example:
+      # name: DES5c148586daa451e55afb017aa62418f91
+      # value: HSARMTKNSRVTWFlaF/ek8asaa9lymMA0dN8JQ6pY7B3F5kdqTxJvMT19EVEFX8EQudB/uNwBHOHzaa30KYTU/eCP/UF7vGTgxs6PAnlVWKscWssOVHfP2IKWUPaa4Dn+I6ilA7eAFQsiaaVT
+      cookies = YAML.load(itc_cookie_content)
+
+      # We remove all the un-needed cookies
+      cookies.delete_if do |current|
+        ['aa', 'X-SESS', 'site', 'acn01', 'myacinfo', 'itctx', 'wosid', 'woinst', 'NSC_17ofu-jud-jud-mc'].include?(current.name)
+      end
+
+      yaml = cookies.to_yaml.gsub("\n", "\\n")
+
+      puts "---"
+      puts ""
+      puts "Pass the following via the FASTLANE_SESSION environment variable:"
+      puts yaml.cyan.underline
+      puts ""
+      puts ""
+      puts "Example:"
+      puts "export FASTLANE_SESSION='#{yaml}'".cyan.underline
+    end
+  end
+end

data/spaceship/lib/spaceship/tunes/app_details.rb

@@ -0,0 +1,139 @@
+module Spaceship
+  module Tunes
+    class AppDetails < TunesBase
+      attr_accessor :application
+
+      ####
+      # Localized values
+      ####
+
+      # @return (Array) Raw access the all available languages. You shouldn't use it probbaly
+      attr_accessor :languages
+
+      # @return (Hash) A hash representing the app name in all languages
+      attr_reader :name
+
+      # @return (Hash) A hash representing the privacy URL in all languages
+      attr_reader :privacy_url
+
+      # @return (Hash) Some bla bla about privacy
+      attr_reader :apple_tv_privacy_policy
+
+      # Categories (e.g. MZGenre.Business)
+      attr_accessor :primary_category
+
+      attr_accessor :primary_first_sub_category
+
+      attr_accessor :primary_second_sub_category
+
+      attr_accessor :secondary_category
+
+      attr_accessor :secondary_first_sub_category
+
+      attr_accessor :secondary_second_sub_category
+
+      attr_accessor :primary_locale_code
+
+      attr_accessor :available_primary_locale_codes
+
+      attr_mapping(
+        'localizedMetadata.value' => :languages,
+        'primaryCategory.value' => :primary_category,
+        'primaryFirstSubCategory.value' => :primary_first_sub_category,
+        'primarySecondSubCategory.value' => :primary_second_sub_category,
+        'secondaryCategory.value' => :secondary_category,
+        'secondaryFirstSubCategory.value' => :secondary_first_sub_category,
+        'secondarySecondSubCategory.value' => :secondary_second_sub_category,
+        'primaryLocaleCode.value' => :primary_locale_code,
+        'availablePrimaryLocaleCodes' => :available_primary_locale_codes
+      )
+
+      class << self
+        # Create a new object based on a hash.
+        # This is used to create a new object based on the server response.
+        def factory(attrs)
+          obj = self.new(attrs)
+          obj.unfold_languages
+
+          return obj
+        end
+      end
+
+      # Prefill name, privacy url
+      def unfold_languages
+        {
+          name: :name,
+          privacyPolicyUrl: :privacy_url,
+          privacyPolicy: :apple_tv_privacy_policy
+        }.each do |json, attribute|
+          instance_variable_set("@#{attribute}".to_sym, LanguageItem.new(json, languages))
+        end
+      end
+
+      # Push all changes that were made back to iTunes Connect
+      def save!
+        client.update_app_details!(application.apple_id, raw_data)
+      rescue Spaceship::TunesClient::ITunesConnectError => ex
+        if ex.to_s == "operation_failed"
+          # That's alright, we get this error message if nothing has changed
+        else
+          raise ex
+        end
+      end
+
+      # Custom Setters
+      #
+      def primary_category=(value)
+        value = prefix_apps(value)
+        value = prefix_mzgenre(value)
+        super(value)
+      end
+
+      def primary_first_sub_category=(value)
+        value = prefix_apps(value)
+        value = prefix_mzgenre(value)
+        super(value)
+      end
+
+      def primary_second_sub_category=(value)
+        value = prefix_apps(value)
+        value = prefix_mzgenre(value)
+        super(value)
+      end
+
+      def secondary_category=(value)
+        value = prefix_apps(value)
+        value = prefix_mzgenre(value)
+        super(value)
+      end
+
+      def secondary_first_sub_category=(value)
+        value = prefix_apps(value)
+        value = prefix_mzgenre(value)
+        super(value)
+      end
+
+      def secondary_second_sub_category=(value)
+        value = prefix_apps(value)
+        value = prefix_mzgenre(value)
+        super(value)
+      end
+
+      #####################################################
+      # @!group General
+      #####################################################
+      def setup; end
+
+      private
+
+      def prefix_mzgenre(value)
+        value.include?("MZGenre") ? value : "MZGenre.#{value}"
+      end
+
+      def prefix_apps(value)
+        return value unless value.include? "Stickers"
+        value.include?("Apps") ? value : "Apps.#{value}"
+      end
+    end
+  end
+end

data/spaceship/lib/spaceship/tunes/app_image.rb

@@ -0,0 +1,55 @@
+module Spaceship
+  module Tunes
+    # Represents an image hosted on iTunes Connect. Used for icons, screenshots, etc
+    class AppImage < TunesBase
+      HOST_URL = "https://is1-ssl.mzstatic.com/image/thumb"
+
+      attr_accessor :asset_token
+
+      attr_accessor :sort_order
+
+      attr_accessor :original_file_name
+
+      attr_accessor :url
+
+      attr_accessor :is_imessage
+
+      attr_mapping(
+        'assetToken' => :asset_token,
+        'sortOrder' => :sort_order,
+        'url' => :url,
+        'originalFileName' => :original_file_name
+      )
+
+      class << self
+        def factory(attrs)
+          self.new(attrs)
+        end
+      end
+
+      def reset!(attrs = {})
+        update_raw_data!(
+          {
+            asset_token: nil,
+            original_file_name: nil,
+            sort_order: nil,
+            url: nil
+          }.merge(attrs)
+        )
+      end
+
+      def setup
+        # Since September 2015 we don't get the url any more, so we have to manually build it
+        self.url = "#{HOST_URL}/#{self.asset_token}/0x0ss.jpg"
+      end
+
+      private
+
+      def update_raw_data!(hash)
+        hash.each do |k, v|
+          self.send("#{k}=", v)
+        end
+      end
+    end
+  end
+end

data/spaceship/lib/spaceship/tunes/app_ratings.rb

@@ -0,0 +1,107 @@
+module Spaceship
+  module Tunes
+    # Represents app ratings from iTunesConnect
+    class AppRatings < TunesBase
+      # @return (Spaceship::Tunes::Application) A reference to the application
+      #   this version is for
+      attr_accessor :application
+
+      # @return (Spaceship::Tunes::AppRatingSummary) A summary of the overall ratings for the application
+      attr_accessor :rating_summary
+
+      # @return (Hash) mapping country codes to a (Spaceship::Tunes::AppRatingSummary) summary of ratings for that country
+      attr_reader :store_fronts
+
+      # @return (Hash) of iTunesConnect version id's to readable version numbers
+      attr_reader :versions
+
+      attr_mapping({
+        'versions' => :versions
+      })
+
+      class << self
+        # Create a new object based on a hash.
+        # This is used to create a new object based on the server response.
+        def factory(attrs)
+          obj = self.new(attrs)
+
+          obj.unfold_rating_summary(attrs['ratings'])
+          obj.unfold_store_fronts(attrs['storeFronts'])
+
+          return obj
+        end
+      end
+
+      def unfold_rating_summary(attrs)
+        unfolded_rating_summary = AppRatingSummary.new(attrs)
+        instance_variable_set(:@rating_summary, unfolded_rating_summary)
+      end
+
+      def unfold_store_fronts(attrs)
+        unfolded_store_fronts = {}
+
+        attrs.each do |info|
+          unfolded_store_fronts[info['countryCode']] = AppRatingSummary.new(info['ratings'])
+        end
+
+        instance_variable_set(:@store_fronts, unfolded_store_fronts)
+      end
+
+      # @return (Array) of raw hashes representing user reviews for the given store front (and optional versionId)
+      def reviews(store_front, versionId = '')
+        client.get_reviews(application.apple_id, application.platform, store_front, versionId)
+      end
+    end
+
+    class AppRatingSummary < TunesBase
+      # @return (Integer) total number of reviews recevied
+      attr_reader :review_count
+
+      # @return (Integer) total number of ratings recevied
+      attr_reader :rating_count
+
+      # @return (Integer) total number of one star ratings recevied
+      attr_reader :one_star_rating_count
+
+      # @return (Integer) total number of two star ratings recevied
+      attr_reader :two_star_rating_count
+
+      # @return (Integer) total number of three star ratings recevied
+      attr_reader :three_star_rating_count
+
+      # @return (Integer) total number of four star ratings recevied
+      attr_reader :four_star_rating_count
+
+      # @return (Integer) total number of five star ratings recevied
+      attr_reader :five_star_rating_count
+
+      attr_mapping({
+        'reviewCount' => :review_count,
+        'ratingCount' => :rating_count,
+        'ratingOneCount' => :one_star_rating_count,
+        'ratingTwoCount' => :two_star_rating_count,
+        'ratingThreeCount' => :three_star_rating_count,
+        'ratingFourCount' => :four_star_rating_count,
+        'ratingFiveCount' => :five_star_rating_count
+      })
+
+      class << self
+        # Create a new object based on a hash.
+        # This is used to create a new object based on the server response.
+        def factory(attrs)
+          obj = self.new(attrs)
+          return obj
+        end
+      end
+
+      # @return (Float) the average rating for this summary (rounded to 2 decimal places)
+      def average_rating
+        ((self.one_star_rating_count +
+          (self.two_star_rating_count * 2) +
+          (self.three_star_rating_count * 3) +
+          (self.four_star_rating_count * 4) +
+          (self.five_star_rating_count * 5)) / self.rating_count.to_f).round(2)
+      end
+    end
+  end
+end