spaceship 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5874fb36abe1aa100b7c5b793a291699ca11568d
-  data.tar.gz: 43449a997428f3e6bddc8eda4e67f94e50781354
+  metadata.gz: 904794a304cacd104b57a5dfdc757a9daaa73154
+  data.tar.gz: c73073f31e7b3d3b7385fc1e864cf9944ef55583
 SHA512:
-  metadata.gz: 7aec5cec146a3ee90077d67a2c0efba4c3ae03a6d9000f0aa36bbf7a763cc02f33f821257d782d83751ec1150050690b21aa98d2d235ee002e177ec1873b97b8
-  data.tar.gz: 7f54d76361cc18e52b826fdd40f1542c5623823b83dddb7321d140b5d63d59caf3c5aa119ddc90b81e12f413ef09036dfa901b97882d217376fd0a8a401b6688
+  metadata.gz: da46f269738c9ed37cf56fa1c4c5ae8ba491eb9c3eedef6c59415d492b0defb7819df981091666cadd328d84aea67bccb8c6a21d7104e17a1c2395aa000ad6fb
+  data.tar.gz: a8e15b850a1fca1cdbb565a988b51bf9fbb503ed9d6fc911bd4f09032f234971d1cc4513b82b3ee2d845bd5d68f1e3e3a310dad05d6e8b0f8f3dd8169b9f7661

data/lib/spaceship/tunes/application.rb

@@ -162,6 +162,8 @@ module Spaceship
         Tunes::BuildTrain.all(self, self.apple_id)
       end
 
+      # @return [Array] A list of all pre-processing builds
+      #   These are all build that have no information except the upload date
       def pre_processing_builds
         data = client.build_trains(apple_id) # we need to fetch all trains here to get the builds
         
@@ -171,6 +173,33 @@ module Spaceship
         end
       end
 
+      # @return [Array] This will return an array of *all* processing builds
+      #   this include pre-processing or standard processing
+      def all_processing_builds
+        builds = self.pre_processing_builds
+      
+        self.build_trains.each do |version_number, train|
+          train.processing_builds.each do |build|
+            builds << build
+          end
+        end
+
+        return builds
+      end
+
+      # Get all builds that are already processed for all build trains
+      # You can either use the return value (array) or pass a block
+      def builds
+        all_builds = []
+        self.build_trains.each do |version_number, train|
+          train.builds.each do |build|
+            yield(build) if block_given?
+            all_builds << build unless block_given?
+          end
+        end
+        all_builds
+      end
+
       #####################################################
       # @!group Submit for Review
       #####################################################
@@ -184,6 +213,18 @@ module Spaceship
         Spaceship::AppSubmission.create(self, self.apple_id, version)
       end
 
+      # Cancels all ongoing TestFlight beta submission for this application
+      def cancel_all_testflight_submissions!
+        self.builds do |build|
+          begin
+            build.cancel_beta_review!
+          rescue => ex
+            # We really don't care about any errors here
+          end
+        end
+        true
+      end
+
       #####################################################
       # @!group General
       #####################################################

data/lib/spaceship/tunes/build.rb

@@ -7,7 +7,7 @@ module Spaceship
       # @!group General metadata
       #####################################################
       
-      # @return (Spaceship::Tunes::Application) A reference to the build train this build is contained in
+      # @return (Spaceship::Tunes::BuildTrain) A reference to the build train this build is contained in
       attr_accessor :build_train
 
       # @return (Integer) The ID generated by iTunes Connect
@@ -16,7 +16,7 @@ module Spaceship
       # @return (Boolean)
       attr_accessor :valid
 
-      # @return (String) The build version (not the version number)
+      # @return (String) The build version (not the version number), but also is named `build number`
       attr_accessor :build_version
 
       # @return (String) The version number (e.g. 1.3)
@@ -28,7 +28,7 @@ module Spaceship
       # @return (String) URL to the app icon of this build (150x150px)
       attr_accessor :icon_url
 
-      # @return (String)
+      # @return (String) The name of the app this build is for
       attr_accessor :app_name
 
       # @return (String) The platform of this build (e.g. 'ios')
@@ -104,6 +104,65 @@ module Spaceship
 
         @external_testing_enabled = (self.external_expiry_date || 0) > 0
       end
+
+      # This will submit this build for TestFlight beta review
+      # @param metadata [Hash] A hash containing the following information (keys must be symbols):
+      #  {
+      #    # Required Metadata:
+      #     changelog: "Changelog",
+      #     description: "Your Description",
+      #     feedback_email: "Email Address for Feedback",
+      #     marketing_url: "https://marketing.com",
+      #     first_name: "Felix",
+      #     last_name: "Krause",
+      #     review_email: "Contact email address for Apple",
+      #     phone_number: "0128383383",
+      #
+      #   # Optional Metadata:
+      #     privacy_policy_url: nil,
+      #     review_notes: nil,
+      #     review_user_name: nil,
+      #     review_password: nil,
+      #     encryption: false
+      #  }
+      def submit_for_beta_review!(metadata)
+        # First, enable beta testing for this train (per iTC requirement)
+        self.build_train.update_testing_status!(true)
+        
+        parameters = {
+          app_id: self.build_train.application.apple_id, 
+          train: self.build_train.version_string,
+          build_number: self.build_version,
+
+          # Required Metadata:
+          changelog: "No changelog provided",
+          description: "No app description provided",
+          feedback_email: "contact@company.com",
+          marketing_url: "http://marketing.com",
+          first_name: "Felix",
+          last_name: "Krause",
+          review_email: "contact@company.com",
+          phone_number: "0123456789",
+
+          # Optional Metadata:
+          privacy_policy_url: nil,
+          review_notes: nil,
+          review_user_name: nil,
+          review_password: nil,
+          encryption: false
+        }.merge(metadata)
+
+        client.submit_testflight_build_for_review!(parameters)
+
+        return parameters
+      end
+
+      # This will cancel the review process for this TestFlight build
+      def cancel_beta_review!
+        client.remove_testflight_build_from_review!(app_id: self.build_train.application.apple_id, 
+                                                     train: self.build_train.version_string,
+                                              build_number: self.build_version)
+      end
     end
   end
 end

data/lib/spaceship/tunes/tester.rb

@@ -32,12 +32,31 @@ module Spaceship
       #    }]
       attr_accessor :devices
 
+
+      # Information about the most recent beta install
+      # @return [Integer] The ID of the most recently installed app
+      attr_accessor :latest_install_app_id
+
+      # @return [Integer] Date of the last install of this tester
+      #   Number of seconds since 1970
+      attr_accessor :latest_install_date
+
+      # @return [Integer] The build number of the last installed build
+      attr_accessor :latest_installed_build_number
+
+      # @return [Integer] The version number of the last installed build
+      attr_accessor :latest_installed_version_number
+
       attr_mapping(
         'testerId' => :tester_id,
         'emailAddress.value' => :email,
         'firstName.value' => :first_name,
         'lastName.value' => :last_name,
-        'devices' => :devices
+        'devices' => :devices,
+        'latestInstalledAppAdamId' => :latest_install_app_id,
+        'latestInstalledDate' => :latest_install_date,
+        'latestInstalledVersion' => :latest_installed_version_number,
+        'latestInstalledShortVersion' => :latest_installed_build_number,
       )
 
       class << self

data/lib/spaceship/tunes/tunes_client.rb

@@ -1,6 +1,10 @@
 module Spaceship
   class TunesClient < Spaceship::Client
 
+    # ITunesConnectError is only thrown when iTunes Connect raises an exception
+    class ITunesConnectError < StandardError
+    end
+
     #####################################################
     # @!group Init and Login
     #####################################################
@@ -65,9 +69,11 @@ module Spaceship
       end
     end
 
-    def handle_itc_response(data)
-      return unless data
-      return unless data.kind_of?Hash
+    def handle_itc_response(raw)
+      return unless raw
+      return unless raw.kind_of?Hash
+
+      data = raw['data'] || raw # sometimes it's with data, sometimes it isn't
  
       if data.fetch('sectionErrorKeys', []).count == 0 and
         data.fetch('sectionInfoKeys', []).count == 0 and 
@@ -100,10 +106,13 @@ module Spaceship
       errors = errors + data.fetch('sectionErrorKeys') if data['sectionErrorKeys']
 
       # Sometimes there is a different kind of error in the JSON response
-      different_error = data.fetch('messages', {}).fetch('error', nil)
+      # e.g. {"warn"=>nil, "error"=>["operation_failed"], "info"=>nil}
+      different_error = raw.fetch('messages', {}).fetch('error', nil)
       errors << different_error if different_error
 
-      raise errors.join(' ') if errors.count > 0 # they are separated by `.` by default
+      if errors.count > 0 # they are separated by `.` by default
+        raise ITunesConnectError.new(errors.join(' '))
+      end
 
       puts data['sectionInfoKeys'] if data['sectionInfoKeys']
       puts data['sectionWarningKeys'] if data['sectionWarningKeys']
@@ -194,7 +203,7 @@ module Spaceship
         req.headers['Content-Type'] = 'application/json'
       end
       
-      handle_itc_response(r.body['data'])
+      handle_itc_response(r.body)
     end
 
     #####################################################
@@ -217,7 +226,88 @@ module Spaceship
         req.headers['Content-Type'] = 'application/json'
       end
 
-      handle_itc_response(r.body['data'])
+      handle_itc_response(r.body)
+    end
+
+    def remove_testflight_build_from_review!(app_id: nil, train: nil, build_number: nil)
+      r = request(:post) do |req|
+        req.url "ra/apps/#{app_id}/trains/#{train}/builds/#{build_number}/reject"
+        req.body = {}.to_json
+        req.headers['Content-Type'] = 'application/json'
+      end
+      handle_itc_response(r.body)
+    end
+
+    def submit_testflight_build_for_review!(# Required:
+                                            app_id: nil, 
+                                            train: nil, 
+                                            build_number: nil, 
+                                            cancel_other_submissions: false,
+
+                                            # Required Metadata:
+                                            changelog: nil,
+                                            description: nil,
+                                            feedback_email: nil,
+                                            marketing_url: nil,
+                                            first_name: nil,
+                                            last_name: nil,
+                                            review_email: nil,
+                                            phone_number: nil,
+
+                                            # Optional Metadata:
+                                            privacy_policy_url: nil,
+                                            review_notes: nil,
+                                            review_user_name: nil,
+                                            review_password: nil,
+                                            encryption: false)
+
+      start_url = "ra/apps/#{app_id}/trains/#{train}/builds/#{build_number}/submit/start"
+      r = request(:get) do |req|
+        req.url start_url
+        req.headers['Content-Type'] = 'application/json'
+      end
+      handle_itc_response(r.body)
+
+      build_info = r.body['data']
+      # Now fill in the values provided by the user
+      
+      # First the localised values:
+      build_info['testInfo']['details'].each do |current|
+        current['whatsNew']['value'] = changelog
+        current['description']['value'] = description
+        current['feedbackEmail']['value'] = feedback_email
+        current['marketingUrl']['value'] = marketing_url
+        current['privacyPolicyUrl']['value'] = privacy_policy_url
+        current["pageLanguageValue"] = current['language'] # could iTunes Connect be any more buggy? This is required for some reason
+      end
+      build_info['testInfo']['reviewFirstName']['value'] = first_name
+      build_info['testInfo']['reviewLastName']['value'] = last_name
+      build_info['testInfo']['reviewPhone']['value'] = phone_number
+      build_info['testInfo']['reviewEmail']['value'] = review_email
+      build_info['testInfo']['reviewUserName']['value'] = review_user_name
+      build_info['testInfo']['reviewPassword']['value'] = review_password
+
+      r = request(:post) do |req| # same URL, but a POST request
+        req.url start_url
+        req.body = build_info.to_json
+        req.headers['Content-Type'] = 'application/json'
+      end
+      handle_itc_response(r.body)
+
+      encryption_info = r.body['data']
+      if encryption_info['exportComplianceRequired']
+        # only sometimes this is required
+
+        encryption_info['usesEncryption']['value'] = encryption
+
+        r = request(:post) do |req|
+          req.url "ra/apps/#{app_id}/trains/#{train}/builds/#{build_number}/submit/complete"
+          req.body = encryption_info.to_json
+          req.headers['Content-Type'] = 'application/json'
+        end
+
+        handle_itc_response(r.body)
+      end
     end
     
     #####################################################
@@ -233,7 +323,7 @@ module Spaceship
         req.headers['Content-Type'] = 'application/json'
       end
       
-      handle_itc_response(r.body['data'])
+      handle_itc_response(r.body)
       parse_response(r, 'data')
     end
 
@@ -310,7 +400,8 @@ module Spaceship
           },
           testing: {
             value: false
-          }, 
+          },
+          userName: tester.email,
           testerId: tester.tester_id
         }
       ]

data/lib/spaceship/version.rb

@@ -1,3 +1,3 @@
 module Spaceship
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spaceship
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Stefan Natchev
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-18 00:00:00.000000000 Z
+date: 2015-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: credentials_manager