itunes_store_transporter 0.0.2 → 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 03bfd32d4a15484365dbcb15dbd92ef31f26245b
+  data.tar.gz: 664a9e8ec021008970be52d5b25589e88f492726
+SHA512:
+  metadata.gz: 53aacb46d02bc9303bd96521cbb0d0600fe6b065bb32cdf70d638c3d3f71466a9a2cc8dd0e9ddeb4b8a84dc0c14e3b7d14022775e33acf2fdaebb64992d1838c
+  data.tar.gz: 47a88fa62dd96a654f9086f35d41b9e8972eed344abae81db17878451e84bf4d0f6e18ae6076d149efeeb6765f6852b0f5569e2c2121f7fc04880beb582baa58

data/Changes

@@ -1,3 +1,10 @@
+v0.1.0    2013-04-23
+--------------------
+* `itms lookup` now saves metadata in an .itmsp directory as metadata.xml
+
+Enhancements:
+* `itms` added --assets option to lookup command
+
 v0.0.2    2012-09-23
 --------------------
 Enhancements:

data/README.rdoc

@@ -35,7 +35,7 @@ supports the following operations:
 * Upload packages
 * Validate packages
 * Retrieve status information
-* Lookup package metadata
+* Lookup package metadata and video assets
 * List providers
 * Retrieve iTunes metadata schemas
 
@@ -73,6 +73,30 @@ This can be fixed by modifying +iTMSTransporter.CMD+ (note that the following do
 * +COMMAND+ - The command (<code>iTunes::Store::Transporter</code> method) to run
 * +OPTIONS+ - These are quivalent to the given +COMMAND+'s options except they must be given in long option format. For example <code>:apple_id => "X123"</code> would be <code>--apple-id=X123</code>. Boolean options can be negated with the <code>--no-</code> prefix.
 
+==== Lookup command
+
+The lookup command differs slightly from the gem by allowing you to download low-quality copies of the assets associated with the looked up metadata.
+These assets are created by Apple (at the time of this writing, Apple only allows you to download full and preview assets, there is nothing
+in +itms+ that would prevent you from downloading other types of assets if/when they're supported).
+
+For example, to lookup the metadata for package +X123+ and download low-quality copies of all the assets:
+
+  itms lookup --vendor-id=X123 --assets
+
+To download a particular asset type just provide its name:
+  
+  itms lookup --vendor-id=X123 --assets=preview
+
+If there are multiple territories this will download the preview assets for each of them. To only download assets in a given territory or territories use:
+
+  itms lookup --vendor-id=X123 --assets=preview:US
+  itms lookup --vendor-id=X123 --assets=preview:US:BR
+
+If necessary multiple asset types can be seperated by a comma:
+
+  itms lookup --vendor-id=X123 --assets=full,preview
+  itms lookup --vendor-id=X123 --assets=full,preview:MX
+
 ==== Config file
 
 Default options and email notifications can be placed in a YAML file at <code>$HOME/.itms</code>. To skip loading the config file use the <code>--no-config</code> option.
@@ -120,14 +144,14 @@ As you can see, command options are turned into template variables.
 
 === More Info
 
-* Docs: http://ruby-doc.org/gems/docs/i/itunes_store_transporter-0.0.2/README_rdoc.html
+* Docs: http://ruby-doc.org/gems/docs/i/itunes_store_transporter-0.1.0/README_rdoc.html
 * Bugs: http://github.com/sshaw/itunes_store_transporter/issues
 * Source Code: http://github.com/sshaw/itunes_store_transporter
 * Web Based GUI: http://github.com/sshaw/itunes_store_transporter_web
 
 === Author
 
-Skye Shaw [sshaw AT lucas.cis.temple.edu]
+Skye Shaw [sshaw AT gmail.com]
 
 === License
 

data/bin/itms

@@ -1,8 +1,11 @@
 #!/usr/bin/env ruby
 
 require "erb"
+require "uri"
 require "yaml"
 require "net/smtp"
+require "net/http"
+require "rexml/document"
 require "itunes/store/transporter"
 
 # Command line interface to the ITunes::Store::Transporter library.
@@ -44,11 +47,84 @@ module Command
   end
 
   class Lookup < Base
+    def initialize(options)
+      super
+      @assets  = options.delete(:assets)
+      @assets  = @assets.split(",").map { |x| x.split(":").grep(/\w/) } if String === @assets
+      @package = "#{options[:apple_id] || options[:vendor_id]}.itmsp"
+      Dir.mkdir(@package)
+    end
+
     def execute(args = [])
-      filename = "#{@options[:apple_id] || @options[:vendor_id]}.xml"
       metadata = @itms.lookup
-      File.open(filename, "w") { |f| f.write(metadata) }
-      puts "Metadata saved to #{filename}"
+      File.open("#@package/metadata.xml", "w") { |f| f.write(metadata) }
+      puts "Metadata saved in #@package"
+      retrieve_assets(metadata) if @assets
+    end
+
+    def retrieve_assets(metadata)
+      doc = REXML::Document.new(metadata)
+      assets = build_asset_list(doc)
+
+      if assets.none?
+        puts "No assets found"
+      else
+        assets.each do |asset|
+          puts "Downloading #{asset[:type]} asset #{asset[:filename]}"
+          uri = URI.parse(asset[:url])
+
+          Net::HTTP.start(uri.host, uri.port) do |http|
+            File.open("#@package/#{asset[:filename]}", "w") do |io|
+              http.request_get(uri.path) do |res|
+                raise res.message unless Net::HTTPSuccess === res
+                res.read_body do |data|
+                  io.write data
+                end
+              end
+            end
+          end
+        end
+      end
+    rescue => e
+      raise "Asset retrieval failed: #{e}"
+    end
+
+    def build_asset_list(doc)
+      asset_info = lambda do |xpath|
+        doc.get_elements(xpath).map do |e|
+          file = {}
+          file[:url] = e.get_text("//*[ @key = 'proxy-encode-url' ]").to_s
+          type = e.attribute("type")
+          file[:type] = type.value if type
+          file[:filename] = e.get_text(".//data_file[ @role = 'source' ]/file_name").to_s
+          file[:territories] = e.get_elements(".//territory").map { |t| t.get_text.to_s }
+          file
+        end
+      end
+
+      files = []
+      if @assets == true
+        files = asset_info["//asset[ .//*[ @key = 'proxy-encode-url' ]]"]
+      else
+        @assets.each do |asset|
+          type, regions = asset.shift, asset
+          regions.clear if type == "full" # There's only one full asset per package
+
+          xpath = "//asset[ @type = '#{type}'"
+          if regions.any?
+            xpath << " and (%s)" % regions.map { |code| ".//territory = '#{code}'" }.join(" or ")
+          end
+          xpath << "and .//*[ @key = 'proxy-encode-url' ]]"
+
+          info = asset_info[xpath]
+          unknown = regions - info.map { |file| file[:territories] }.flatten
+          raise "No #{type} asset for #{unknown.join ", "}" if unknown.any?
+
+          files.concat info
+        end
+      end
+
+      files
     end
   end
 
@@ -57,7 +133,6 @@ module Command
       filename = "#{@options[:version]}-#{@options[:type]}.rng"
       schema = @itms.schema
       File.open(filename, "w") { |f| f.write(schema) }
-      puts "Schema saved to #{filename}"
     end
   end
 
@@ -70,7 +145,7 @@ module Command
       super
     end
 
-    def execute(args = [])      
+    def execute(args = [])
       info = @itms.status
       info.each do |k, v|
         next if k == :status
@@ -131,7 +206,7 @@ class Email
 
   def initialize(config = {})
     unless config["to"]
-      raise "No email recipeints provided, you must specify at least one"
+      raise "No email recipients provided, you must specify at least one"
     end
 
     @config = config
@@ -264,7 +339,7 @@ rescue ITunes::Store::Transporter::ExecutionError => e
   options[:error] = e
   send_email(email_options["failure"], options)
   exit 1
-rescue ITunes::Store::Transporter::TransporterError => e
+rescue => e
   $stderr.puts e
   exit 2
 end

data/lib/itunes/store/transporter/version.rb

@@ -1,7 +1,7 @@
 module ITunes
   module Store
     class Transporter
-      VERSION = "0.0.2"
+      VERSION = "0.1.0"
     end
   end
 end

metadata

@@ -1,53 +1,60 @@
 --- !ruby/object:Gem::Specification
 name: itunes_store_transporter
 version: !ruby/object:Gem::Version
-  version: 0.0.2
-  prerelease: 
+  version: 0.1.0
 platform: ruby
 authors:
 - Skye Shaw
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-23 00:00:00.000000000Z
+date: 2013-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: childprocess
-  requirement: &70153694946460 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.3.2
   type: :runtime
   prerelease: false
-  version_requirements: *70153694946460
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.2
 - !ruby/object:Gem::Dependency
   name: optout
-  requirement: &70153694945700 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.0.2
   type: :runtime
   prerelease: false
-  version_requirements: *70153694945700
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.2
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70153694938340 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.9.2
   type: :development
   prerelease: false
-  version_requirements: *70153694938340
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70153694937480 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -57,11 +64,18 @@ dependencies:
         version: '3'
   type: :development
   prerelease: false
-  version_requirements: *70153694937480
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.9'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '3'
 description: ! "    iTunes::Store::Transporter is a wrapper around Apple's iTMSTransporter
   program. It allows you to upload packages to the \n    Apple Store, validate them,
   retrieve status information, lookup metadata, and more!\n"
-email: sshaw@lucas.cis.temple.edu
+email: skye.shaw@gmail.com
 executables:
 - itms
 extensions: []
@@ -100,27 +114,26 @@ files:
 homepage: http://github.com/sshaw/itunes_store_transporter
 licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Upload and manage your assets in the iTunes Store using the iTunes Store's
   Transporter (iTMSTransporter).
 test_files: