deliver 0.0.1 → 0.1.0

data/Rakefile

@@ -1,2 +1,5 @@
 require "bundler/gem_tasks"
 
+Dir.glob('tasks/**/*.rake').each(&method(:import))
+
+task :default => :spec

data/bin/deliver

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+$:.push File.expand_path("../../lib", __FILE__)
+
+require 'deliver'
+require 'commander/import'
+
+HighLine.track_eof = false
+
+
+# Commander
+program :version, Deliver::VERSION
+program :description, 'CLI for \'Deliver\' - Automate uploading of app metadata, screenshots and app updates to Apple'
+program :help, 'Author', 'Felix Krause <krausefx@gmail.com>'
+program :help, 'Website', 'http://felixkrause.at'
+program :help, 'GitHub', 'https://github.com/krausefx/deliver'
+program :help_formatter, :compact
+
+global_option('--verbose') { $verbose = true }
+
+default_command :run
+
+require 'deliver/commands'
+
+def deliver_path
+  [enclosed_directory, Deliver::Deliverfile::Deliverfile::FILE_NAME].join('/')
+end
+
+# The directoy in which the Deliverfile and metadata should be created
+def enclosed_directory
+  "."
+end

data/deliver.gemspec

@@ -12,10 +12,10 @@ Gem::Specification.new do |spec|
   spec.description   = %q{Using Deliver you can easily integrate a real continuous delivery 
     solution for iOS applications. You can update the app metadata, upload screenshots 
     in all languages for different screensizes to iTunesConnect and even publish a new 
-    ipa file to iTunesConnect. You define you prefered deployment information once in a so called
+    ipa file to iTunesConnect. You define your prefered deployment information once in a so called
     Deliverfile and store it in git, to easily deploy from every machine, even your Continuos Integration server}
   spec.homepage      = ""
-  # spec.license       = ""
+  spec.license       = "MIT"
 
   spec.required_ruby_version = '>= 1.9.3'
 
@@ -30,17 +30,23 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'fastimage', '~> 1.6.3' # fetch the image sizes from the screenshots
   spec.add_dependency 'rubyzip', '~> 1.1.6' # needed for extracting the ipa file
   spec.add_dependency 'plist', '~> 3.1.0' # for reading the Info.plist of the ipa file
-  spec.add_dependency 'colored'
+  spec.add_dependency 'colored' # coloured terminal output
+  spec.add_dependency 'commander', '~> 4.2.0' # CLI parser
+  spec.add_dependency 'prawn' # generating PDF file for the applied changes
 
   # Frontend Scripting
   spec.add_dependency 'capybara', '~> 2.4.3' # for controlling iTC
   spec.add_dependency 'poltergeist', '~> 1.5.1' # headless Javascript browser for controlling iTC
 
   # Development only
-  spec.add_development_dependency "bundler"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec", "~> 3.1.0"
-  spec.add_development_dependency "pry"
-  spec.add_development_dependency "yard", "~> 0.8.7.4"
-  spec.add_development_dependency "webmock", "~> 1.19.0"
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 3.1.0'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'yard', '~> 0.8.7.4'
+  spec.add_development_dependency 'webmock', '~> 1.19.0'
+  spec.add_development_dependency 'codeclimate-test-reporter'
+
+
+  spec.post_install_message = "This gem requires phantomjs. Install it using 'brew update && brew install phantomjs'"
 end

data/lib/assets/DeliverfileDefault

@@ -0,0 +1,47 @@
+# For more information about each property, visit the GitHub documentation: https://github.com/krausefx/deliver
+# Everything next to a # is a comment and will be ignored
+
+
+
+########################################
+# App Metadata
+########################################
+
+# The app identifier is required
+app_identifier "[[APP_IDENTIFIER]]"
+
+
+# This folder has to include one folder for each language
+# More information about automatic screenshot upload: 
+screenshots_path "./deliver/screenshots/"
+
+
+# version '1.2' # you can pass this if you want to verify the version number with the ipa file
+
+config_json_folder './deliver'
+
+
+########################################
+# Building and Testing
+########################################
+
+# Dynamic generation of the ipa file
+# I'm using Shenzhen by Mattt, but you can use any build tool you want
+# Remove the whole block if you do not want to upload an ipa file
+ipa do
+    # Add any code you want, like incrementing the build 
+    # number or changing the app identifier
+
+    # system("ipa build") # build your project using Shenzhen
+    "./[[APP_NAME]].ipa" # Tell 'Deliver' where it can find the finished ipa file
+end
+
+# ipa "./latest.ipa" # this can be used, if you prefer manually building the ipa file
+
+# unit_tests do
+#   system("xctool test")
+# end
+
+success do
+  system("say 'Successfully deployed a new version.'")
+end

data/lib/assets/DeliverfileExample

@@ -0,0 +1,62 @@
+# This is the example Deliverfile
+# For more information about each property, visit the GitHub documentation: https://github.com/krausefx/deliver
+# 
+# You can remove those parts you don't need
+# 
+# A list of available language codes can be found here: https://github.com/krausefx/deliver#available-language-codes
+# 
+# Everything next to a # is a comment and will be ignored
+
+
+
+########################################
+# App Metadata
+########################################
+
+
+
+# The app identifier is required
+app_identifier "[Your App Identifier, e.g. at.felixkrause.app_name]"
+
+
+# This folder has to include one folder for each language
+# More information about automatic screenshot upload: 
+screenshots_path "./screenshots"
+
+
+# version '1.2' # you can pass this if you want to verify the version number with the ipa file
+# 
+# title({
+#   "en-US" => "Your App Name"
+# })
+# 
+# changelog({
+#   "en-US" => "iPhone 6 (Plus) Support" 
+# })
+
+
+
+########################################
+# Building and Testing
+########################################
+
+# Dynamic generation of the ipa file
+# I'm using Shenzhen by Mattt, but you can use any build tool you want
+# Remove the whole block if you do not want to upload an ipa file
+ipa do
+    # Add any code you want, like incrementing the build 
+    # number or changing the app identifier
+
+    # system("ipa build") # build your project using Shenzhen
+    "./[[APP_NAME]].ipa" # Tell 'Deliver' where it can find the finished ipa file
+end
+
+# ipa "./latest.ipa" # this can be used, if you prefer manually building the ipa file
+
+# unit_tests do
+#   system("xctool test")
+# end
+
+success do
+  system("say 'Successfully deployed a new version.'")
+end

data/lib/assets/ScreenshotsHelp

@@ -0,0 +1,4 @@
+Put all screenshots you want to use inside the folder of its language (e.g. en-US).
+The device type will automatically be recognized using the image resolution.
+
+The name of the screenshots itself does not matter

data/lib/deliver.rb

@@ -1,4 +1,23 @@
-require "deliver/version"
+require 'deliver/version'
+require 'deliver/helper'
+require 'deliver/app'
+require 'deliver/app_metadata'
+require 'deliver/metadata_item'
+require 'deliver/app_screenshot'
+require 'deliver/itunes_connect'
+require 'deliver/itunes_search_api'
+require 'deliver/itunes_transporter'
+require 'deliver/deliverfile/deliverfile'
+require 'deliver/deliverfile/deliverfile_creator'
+require 'deliver/deliverer'
+require 'deliver/ipa_uploader'
+require 'deliver/languages'
+require 'deliver/pdf_generator'
+require 'deliver/dependency_checker'
+require 'deliver/deliver_process'
+
+# Third Party code
+require 'colored'
 
 module Deliver
   # Your code goes here...

data/lib/deliver/app.rb

@@ -0,0 +1,146 @@
+module Deliver
+  class App
+    attr_accessor :apple_id, :app_identifier, :metadata
+
+
+    # Defines the different states of the app
+    # 
+    # As specified by Apple: https://developer.apple.com/library/ios/documentation/LanguagesUtilities/Conceptual/iTunesConnect_Guide/Chapters/ChangingAppStatus.html
+    module AppStatus
+      PREPARE_FOR_SUBMISSION = "Prepare for Submission"
+      WAITING_FOR_REVIEW = "Waiting For Review"
+      IN_REVIEW = "In Review"
+      UPLOAD_RECEIVED = "Upload Received"
+      PENDING_DEVELOPER_RELEASE = "Pending Developer Release"
+      PROCESSING_FOR_APP_STORE = "Processing for App Store"
+      READY_FOR_SALE = "Ready for Sale"
+      REJECTED = "Rejected"
+
+
+      # Unused app states
+      # PENDING_APPLE_RELASE="Pending Apple Release"
+      # PENDING_CONTRACT = "Pending Contract"
+      # WAITING_FOR_EXPORT_COMPLIANCE = "Waiting For Export Compliance"
+      # METADATA_REJECTED = "Metadata Rejected"
+      # REMOVED_FROM_SALE = "Removed From Sale"
+      # DEVELOPER_REJECTED = "Developer Rejected" # equals PREPARE_FOR_SUBMISSION
+      # DEVELOPER_REMOVED_FROM_SALE = "Developer Removed From Sale"
+      # INVALID_BINARY = "Invalid Binary"
+    end
+
+    # @param apple_id The Apple ID of the app you want to modify or update. This ID has usually 9 digits
+    # @param app_identifier If you don't pass this, it will automatically be fetched from the Apple API
+    #   which means it takes longer. If you **can** pass the app_identifier (e.g. com.facebook.Facebook) do it
+    def initialize(apple_id: nil, app_identifier: nil)
+      self.apple_id = (apple_id || '').to_s.gsub('id', '').to_i
+      self.app_identifier = app_identifier
+      
+      if apple_id and not app_identifier
+        # Fetch the app identifier based on the given Apple ID
+        self.app_identifier = Deliver::ItunesSearchApi.fetch_bundle_identifier(apple_id)
+      elsif app_identifier and not apple_id
+        # Fetch the Apple ID based on the given app identifier
+        begin
+          self.apple_id = Deliver::ItunesSearchApi.fetch_by_identifier(app_identifier)['trackId']
+        rescue
+          Helper.log.fatal "Could not find Apple ID based on the app identifier '#{app_identifier}'. Maybe the app is not in the AppStore yet?"
+          raise "Please pass a valid Apple ID using 'apple_id'".red
+        end
+      end
+    end
+
+    def to_s
+      "#{apple_id} - #{app_identifier}"
+    end
+
+    #####################################################
+    # @!group Interacting with iTunesConnect
+    #####################################################
+
+    # The iTC handler which is used to interact with the iTunesConnect backend
+    def itc
+      @itc ||= Deliver::ItunesConnect.new
+    end
+
+    # This method fetches the current app status from iTunesConnect.
+    # This method may take some time to execute, since it uses frontend scripting under the hood.
+    # @return the current App Status defined at {Deliver::App::AppStatus}, like "Waiting For Review"
+    def get_app_status
+      itc.get_app_status(self)
+    end
+
+    # This method fetches the app version of the latest published version
+    # This method may take some time to execute, since it uses frontend scripting under the hood.
+    # @return the currently active app version, which in production
+    def get_live_version
+      itc.get_live_version(self)
+    end
+
+
+    #####################################################
+    # @!group Updating the App Metadata
+    #####################################################
+
+    # Use this method to change the default download location for the metadata packages
+    def set_metadata_directory(dir)
+      raise "Can not change metadata directory after accessing metadata of an app" if @metadata
+      @metadata_dir = dir
+    end
+
+    # @return the path to the directy in which the itmsp files will be downloaded
+    def get_metadata_directory
+      return @metadata_dir if @metadata_dir 
+      return "./spec/fixtures/packages/" if Helper.is_test?
+      return "./"
+    end
+
+    # Access to update the metadata of this app
+    # 
+    # The first time accessing this, will take some time, since it's downloading
+    # the latest version from iTC.
+    # 
+    # Don't forget to call {#upload_metadata!} once you are finished
+    # @return [Deliver::AppMetadata] the latest metadata of this app
+    def metadata
+      @metadata ||= Deliver::AppMetadata.new(self, get_metadata_directory)
+    end
+
+    # Was the app metadata already downloaded?
+    def metadata_downloaded?
+      @metadata != nil
+    end
+
+
+    # # Uploads a new app icon to iTunesConnect. This uses a headless browser
+    # # which makes this command quite slow.
+    # # @param (path) a path to the new app icon. The image must have the resolution of 1024x1024
+    # def update_app_icon!(path)
+    #   itc.update_app_icon!(self, path)
+    # end
+
+    #####################################################
+    # @!group Destructive/Constructive methods
+    #####################################################
+
+    # This method creates a new version of your app using the
+    # iTunesConnect frontend. This will happen directly after calling
+    # this method. 
+    # @param version_number (String) the version number as string for 
+    # the new version that should be created
+    def create_new_version!(version_number)
+      itc.create_new_version!(self, version_number)
+    end
+
+    # This method has to be called, after modifying the values of .metadata.
+    # It will take care of uploading all changes to Apple.
+    # This method might take a few minutes to run
+    # @return [bool] true on success
+    # @raise [Deliver::TransporterTransferError]
+    # @raise [Deliver::TransporterInputError]
+    def upload_metadata!
+      raise "You first have to modify the metadata using app.metadata.setDescription" unless @metadata
+      
+      self.metadata.upload!
+    end
+  end
+end

data/lib/deliver/app_metadata.rb

@@ -0,0 +1,487 @@
+require 'nokogiri'
+
+module Deliver
+  class AppMetadataError < StandardError 
+  end
+  class AppMetadataParameterError < StandardError 
+  end
+
+  class AppMetadata
+    ITUNES_NAMESPACE = "http://apple.com/itunes/importer"
+    METADATA_FILE_NAME = "metadata.xml"
+    MAXIMUM_NUMBER_OF_SCREENSHOTS = 5
+
+    # @return Data contains all information for this app, including the unmodified one
+    attr_accessor :information
+    # data = {
+    #   'en-US' => {
+    #     title: {
+    #       value: "Something",
+    #       modified: false
+    #     },
+    #     version_whats_new: {
+    #       value: "Some text",
+    #       modified: true
+    #     }
+    #     screenshots: {
+    #       '45' => [
+    #         Screenshot1
+    #       ]
+    #     }
+    #   }
+    # }
+
+    private_constant :METADATA_FILE_NAME, :MAXIMUM_NUMBER_OF_SCREENSHOTS
+
+    INVALID_LANGUAGE_ERROR = "The specified language could not be found. Make sure it is available in Deliver::Languages::ALL_LANGUAGES"
+
+    # You don't have to manually create an AppMetadata object. It will
+    # be created when you access the app's metadata ({Deliver::App#metadata})
+    # @param app [Deliver::App] The app this metadata is from/for
+    # @param dir [String] The app this metadata is from/for
+    # @param redownload_package [bool] When true
+    #  the current package will be downloaded from iTC before you can 
+    #  modify any values. This should only be false for unit tests
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct app object
+    def initialize(app, dir, redownload_package = true)
+      raise AppMetadataParameterError.new("No valid Deliver::App given") unless app.kind_of?Deliver::App
+
+      @metadata_dir = dir
+      @app = app
+
+      if self.class == AppMetadata
+        if redownload_package
+          # Delete the one that may exists already
+          unless Helper.is_test?
+            `rm -fr #{dir}/*.itmsp`
+          end
+
+          # we want to update the metadata, so first we have to download the existing one
+          transporter.download(app, dir)
+
+          # Parse the downloaded package
+          parse_package(dir)
+        else
+          # use_data contains the data to be used. This is the case for unit tests
+          parse_package(dir)
+        end
+      end
+    end
+
+    def information
+      @information ||= {}
+    end
+
+    # Verifies the if the version of iTunesConnect matches the one you pass as parameter
+    def verify_version(version_number)
+      xml_version = self.fetch_value("//x:version").first['string']
+      raise "Version mismatch: on iTunesConnect the latest version is '#{xml_version}', you specified '#{version_number}'" if xml_version != version_number
+      true
+    end
+
+    # Adds a new locale (language) to the given app
+    # @param language (Deliver::Languages::ALL_LANGUAGES) the language you want to
+    #  this app
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct hash with correct language codes.
+    # @return (Bool) Is true, if the language was created. False, when the language alreade existed
+    def add_new_locale(language)
+      unless Deliver::Languages::ALL_LANGUAGES.include?language
+        raise "Language '#{language}' is invalid. It must be in #{Deliver::Languages::ALL_LANGUAGES}."
+      end
+
+      if information[language] != nil
+        Helper.log.info("Locale '#{language}' already exists. Can not create it again.")
+        return false
+      end
+      
+
+      locales = fetch_value("//x:locales").first
+      
+      new_locale = @data.create_element('locale')
+      new_locale['name'] = language
+      locales << new_locale
+
+      # Title is the only thing which is required by iTC
+      default_title = information.values.first[:title][:value]
+
+      title = @data.create_element('title')
+      title.content = default_title
+      new_locale << title
+
+      Helper.log.info("Successfully created the new locale '#{language}'. The default title '#{default_title}' was set, since it's required by iTunesConnect.")
+      Helper.log.info("You can update the title using 'app.metadata.update_title'")
+      
+      information[language] ||= {}
+      information[language][:title] = { value: default_title, modified: true}
+
+      true
+    end
+
+
+    #####################################################
+    # @!group Updating metadata information
+    #####################################################
+
+    # Updates the app title
+    # @param (Hash) hash The hash should contain the correct language codes ({Deliver::Languages})
+    #  as keys.
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct hash with correct language codes.
+    def update_title(hash)
+      update_metadata_key(:title, hash)
+    end
+
+    # Updates the app description which is shown in the AppStore
+    # @param (Hash) hash The hash should contain the correct language codes ({Deliver::Languages})
+    #  as keys.
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct hash with correct language codes.
+    def update_description(hash)
+      update_metadata_key(:description, hash)
+    end
+
+    # Updates the app changelog of the latest version
+    # @param (Hash) hash The hash should contain the correct language codes ({Deliver::Languages})
+    #  as keys.
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct hash with correct language codes.
+    def update_changelog(hash)
+      update_metadata_key(:version_whats_new, hash)
+    end
+
+    # Updates the Marketing URL
+    # @param (Hash) hash The hash should contain the correct language codes ({Deliver::Languages})
+    #  as keys.
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct hash with correct language codes.
+    def update_marketing_url(hash)
+      update_metadata_key(:software_url, hash)
+    end
+
+    # Updates the Support URL
+    # @param (Hash) hash The hash should contain the correct language codes ({Deliver::Languages})
+    #  as keys.
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct hash with correct language codes.
+    def update_support_url(hash)
+      update_metadata_key(:support_url, hash)
+    end
+
+    # Updates the Privacy URL
+    # @param (Hash) hash The hash should contain the correct language codes ({Deliver::Languages})
+    #  as keys.
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct hash with correct language codes.
+    def update_privacy_url(hash)
+      update_metadata_key(:privacy_url, hash)
+    end
+
+    # Updates the app keywords
+    # @param (Hash) hash The hash should contain the correct language codes ({Deliver::Languages})
+    #  as keys. The value should be an array of keywords (each keyword is a string)
+    # @raise (AppMetadataParameterError) Is thrown when don't pass a correct hash with correct language codes.
+    def update_keywords(hash)
+      update_localized_value('keywords', hash) do |field, keywords, language|
+        raise AppMetadataParameterError.new("Parameter needs to be a hash (each language) with an array of keywords in it (given: #{hash})") unless keywords.kind_of?Array
+
+        if keywords.sort != information[language][:keywords][:value].sort
+          field.children.remove # remove old keywords
+
+          node_set = Nokogiri::XML::NodeSet.new(@data)
+          keywords.each do |word|
+            keyword = Nokogiri::XML::Node.new('keyword', @data)
+            keyword.content = word
+            node_set << keyword
+          end
+
+          field.children = node_set
+
+          information[language][:keywords] = { value: keywords, modified: true }
+        end
+      end
+    end
+
+    #####################################################
+    # @!group Screenshot related
+    #####################################################
+
+    # Removes all currently enabled screenshots for the given language.
+    # @param (String) language The language, which has to be in this list: {Deliver::Languages}.
+    def clear_all_screenshots(language)
+      raise AppMetadataParameterError.new(INVALID_LANGUAGE_ERROR) unless Languages::ALL_LANGUAGES.include?language
+
+      update_localized_value('software_screenshots', {language => {}}) do |field, useless, language|
+        field.children.remove # remove all the screenshots
+      end
+      information[language][:screenshots] = []
+      true
+    end
+
+    # Appends another screenshot to the already existing ones
+    # @param (String) language The language, which has to be in this list: {Deliver::Languages}.
+    # @param (Deliver::AppScreenshot) app_screenshot The screenshot you want to add to the app metadata.
+    # @raise (AppMetadataParameterError) When there are already 5 screenshots (MAXIMUM_NUMBER_OF_SCREENSHOTS).
+
+    def add_screenshot(language, app_screenshot)
+      raise AppMetadataParameterError.new(INVALID_LANGUAGE_ERROR) unless Languages::ALL_LANGUAGES.include?language
+      
+      create_locale_if_not_exists(language)
+
+      # Fetch the 'software_screenshots' node (array) for the specific locale
+      locales = self.fetch_value("//x:locale[@name='#{language}']")
+
+      screenshots = self.fetch_value("//x:locale[@name='#{language}']/x:software_screenshots").first
+      
+      if not screenshots or screenshots.children.count == 0
+        screenshots.remove if screenshots
+
+        # First screenshot ever
+        screenshots = Nokogiri::XML::Node.new('software_screenshots', @data)
+        locales.first << screenshots
+
+        node_set = Nokogiri::XML::NodeSet.new(@data)
+        node_set << app_screenshot.create_xml_node(@data, 1)
+        screenshots.children = node_set
+      else
+        # There is already at least one screenshot
+        next_index = 1
+        screenshots.children.each do |screen|
+          if screen['display_target'] == app_screenshot.screen_size
+            next_index += 1
+          end
+        end
+
+        if next_index > MAXIMUM_NUMBER_OF_SCREENSHOTS
+          raise AppMetadataParameterError.new("Only #{MAXIMUM_NUMBER_OF_SCREENSHOTS} screenshots are allowed per language per device type (#{app_screenshot.screen_size})")
+        end
+
+        # Ready for storing the screenshot into the metadata.xml now
+        screenshots.children.after(app_screenshot.create_xml_node(@data, next_index))
+      end
+
+      information[language][:screenshots] << app_screenshot
+
+      app_screenshot.store_file_inside_package(@package_path)
+    end
+
+    # This method will clear all screenshots and set the new ones you pass
+    # @param new_screenshots
+    #   +code+
+    #    {
+    #     'de-DE' => [
+    #       AppScreenshot.new('path/screenshot1.png', Deliver::ScreenSize::IOS_35),
+    #       AppScreenshot.new('path/screenshot2.png', Deliver::ScreenSize::IOS_40),
+    #       AppScreenshot.new('path/screenshot3.png', Deliver::ScreenSize::IOS_IPAD)
+    #     ]
+    #    }
+    # This method uses {#clear_all_screenshots} and {#add_screenshot} under the hood.
+    # @return [bool] true if everything was successful
+    # @raise [AppMetadataParameterError] error is raised when parameters are invalid
+    def set_all_screenshots(new_screenshots)
+      error_text = "Please pass a hash, containing an array of AppScreenshot objects"
+      raise AppMetadataParameterError.new(error_text) unless new_screenshots.kind_of?Hash
+
+      new_screenshots.each do |key, value|
+        if key.kind_of?String and value.kind_of?Array and value.count > 0 and value.first.kind_of?AppScreenshot
+          
+          self.clear_all_screenshots(key)
+
+          value.each do |screen|
+            add_screenshot(key, screen)
+          end
+        else
+          raise AppMetadataParameterError.new(error_text)
+        end
+      end
+      true
+    end
+
+    # Automatically add all screenshots contained in the given directory to the app.
+    # 
+    # This method will automatically detect which device type each screenshot is.
+    # 
+    # This will also clear all existing screenshots before setting the new ones.
+    # @param (Hash) hash A hash containing a different path for each locale ({Deliver::Languages::ALL_LANGUAGES})
+    def set_screenshots_for_each_language(hash)
+      raise AppMetadataParameterError.new("Parameter needs to be an hash, containg strings with the new description") unless hash.kind_of?Hash
+
+      hash.each do |language, current_path|
+        resulting_path = "#{current_path}/*.png"
+
+        raise AppMetadataParameterError.new(INVALID_LANGUAGE_ERROR) unless Languages::ALL_LANGUAGES.include?language
+
+        if Dir[resulting_path].count == 0
+          Helper.log.error("No screenshots found at the given path '#{resulting_path}'") 
+        else
+          self.clear_all_screenshots(language)
+          
+          Dir[resulting_path].sort.each do |path|
+            add_screenshot(language, Deliver::AppScreenshot.new(path))
+          end
+        end
+      end
+
+      true
+    end
+
+    # This method will run through all the available locales, check if there is 
+    # a folder for this language (e.g. 'en-US') and use all screenshots in there
+    # @param (String) path A path to the folder, which contains a folder for each locale
+    def set_all_screenshots_from_path(path)
+      raise AppMetadataParameterError.new("Parameter needs to be a path (string)") unless path.kind_of?String
+
+      found = false
+      Deliver::Languages::ALL_LANGUAGES.each do |language|
+        full_path = path + "/#{language}"
+        if File.directory?(full_path)
+          found = true
+          set_screenshots_for_each_language({
+            language => full_path
+          })
+        end
+      end
+      return found
+    end
+
+
+    #####################################################
+    # @!group Manually fetching elements from the metadata.xml
+    #####################################################
+
+    # Directly fetch XML nodes from the metadata.xml.
+    # @example Fetch all keywords
+    #  fetch_value("//x:keyword")
+    # @example Fetch a specific locale
+    #  fetch_value("//x:locale[@name='de-DE']")
+    # @example Fetch the node that contains all screenshots for a specific language
+    #  fetch_value("//x:locale[@name='de-DE']/x:software_screenshots")
+    # @return the requests XML nodes or node set
+    def fetch_value(xpath)
+      @data.xpath(xpath, "x" => ITUNES_NAMESPACE)
+    end
+
+
+    #####################################################
+    # @!group Uploading the updated metadata
+    #####################################################
+
+    # Actually uploads the updated metadata to Apple.
+    # This method might take a while.
+    # @raise (TransporterTransferError) When something goes wrong when uploading
+    #  the metadata/app
+    def upload!
+      unless Helper.is_test?
+        # First: Write the current XML state to disk
+        File.write("#{@package_path}/#{METADATA_FILE_NAME}", @data.to_xml)
+      end
+
+      transporter.upload(@app, @metadata_dir)
+    end
+
+    private
+      def update_metadata_key(key, hash)
+        update_localized_value(key, hash) do |field, new_val, language|
+          raise AppMetadataParameterError.new("Parameter needs to be an hash, containg strings.") unless new_val.kind_of?String
+          if field.content != new_val
+            field.content = new_val
+            information[language][key] = { value: new_val, modified: true }
+          end
+        end
+      end
+
+      # @return (Deliver::ItunesTransporter) The iTunesTranspoter which is
+      #  used to upload/download the app metadata.
+      def transporter
+        @transporter ||= ItunesTransporter.new
+      end
+
+      def update_localized_value(xpath_name, new_value)
+        raise AppMetadataParameterError.new("Please pass a hash of languages to this method") unless new_value.kind_of?Hash
+        raise AppMetadataParameterError.new("Please pass a block, which updates the resulting node") unless block_given?
+
+        xpath_name = xpath_name.to_s
+
+        # Run through all the locales given by the 'user'
+        new_value.each do |language, value|
+          create_locale_if_not_exists(language)
+
+          locale = fetch_value("//x:locale[@name='#{language}']").first
+
+          raise AppMetadataParameterError.new("#{INVALID_LANGUAGE_ERROR} (#{language})") unless Languages::ALL_LANGUAGES.include?language
+          
+
+          field = locale.search(xpath_name).first
+
+          if not field
+            # This entry does not exist yet, so we have to create it
+            field = Nokogiri::XML::Node.new(xpath_name, @data)
+            locale << field
+          end
+
+          yield(field, value, language)
+          Helper.log.info "Updated #{xpath_name} for locale #{language}"
+        end
+      end
+
+      def create_locale_if_not_exists(locale)
+        add_new_locale(locale) unless information[locale]
+      end
+
+      # Parses the metadata using nokogiri
+      def parse_package(path)
+        unless path.include?".itmsp"
+          path += "/#{@app.apple_id}.itmsp/"
+        end
+        @package_path = path
+
+        @data ||= Nokogiri::XML(File.read("#{path}/#{METADATA_FILE_NAME}"))
+        verify_package
+        clean_package
+        fill_in_data
+      end
+
+      # Checks if there is a non live version available
+      # (a new version, or a new app)
+      def verify_package
+        versions = fetch_value("//x:version")
+
+        raise AppMetadataError.new("metadata_token is missing. This package seems to be broken") if fetch_value("//x:metadata_token").count != 1
+      end
+
+      # Cleans up the package of stuff we do not want to modify/upload
+      def clean_package
+
+        # Remove the live version (if it exists)
+        versions = fetch_value("//x:version")
+        while versions.count > 1
+          versions.last.remove
+          versions = fetch_value("//x:version")
+        end
+        Helper.log.info "Modifying version '#{versions.first['string']}' of app #{@app.app_identifier}"
+
+        # Remove all GameCenter related code
+        fetch_value("//x:game_center").remove
+
+        fetch_value("//x:software_screenshots").remove
+      end
+
+      # This will fill in all information we got (from the downloaded metadata.xml file) into self.information
+      def fill_in_data
+        locales = fetch_value("//x:locale")
+        locales.each do |locale|
+          language = locale['name']
+          information[language] ||= {}
+
+          all_keys = [:title, :description, :version_whats_new, :software_url, :support_url, :privacy_url]
+
+          all_keys.each do |key|
+            information[language][key] = {
+              value: (locale.search(key.to_s).first.content rescue ''),
+              modified: false
+            }
+          end
+          
+          information[language][:keywords] = { value: [], modified: false}
+          locale.search('keyword').each do |current|
+            information[language][:keywords][:value] << current.content
+          end
+
+          information[language][:screenshots] = []
+        end
+      end
+  end
+end