itunes_store_transporter 0.1.2beta → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4108c78a24a87a971a948d57ce6c38562f83ed17
-  data.tar.gz: 15792381aef3440f4f08bba1856e9ce3cb13b70a
+  metadata.gz: f7127018124d73b10742187cbd8ca283b2d70fe6
+  data.tar.gz: 9967d8bab13f0c965e383522491227cf7bfac5e6
 SHA512:
-  metadata.gz: 20f44051c7fc697f58a42fbe26caddcb4db41ecd0e3799b9474d5f433ce3fa87e747ff14bdef78406dff395036949a415cb98fef1b6a12090dd91af47840e203
-  data.tar.gz: 9b0d9bab5f02325c3e7669e7a2dcdb75ef76eceb9ac0a64c5d2c42989e96ad49ed0bc02f23249011e574fd9aa1c79dead73452512ff269d7b35aa6cfe3a0b506
+  metadata.gz: edef7e176540218a6b572e27c8f1a23dba40f51e2fbc7cc637f00db563033293fd38ad957957d386e08acdce8c14960078493fc85e4c89a7522e811d9a4972a3
+  data.tar.gz: caac988d22b3d8dc46ba05d7692c86eeb97790bda4f546a7f0562eeaec897f6746341e0e6e3cbb56fff046331e6da26256045cb0ff072edd4f927f5d2a1678e3

data/Changes

@@ -1,7 +1,16 @@
+v0.1.2    2015-03-07
+--------------------
+Changes:
+* Only parse errors from the main iTMSTransporter thread
+
+Enhancements:
+* Look for the iTMSTransporter at known locations on OS X
+* Add the :streams (-numStreams) option to upload
+
 v0.1.1    2013-08-14
 --------------------
-Changes: 
-* Added post_install_message letting Windows users know they need to modify iTMSTransporter.CMD 
+Changes:
+* Added post_install_message letting Windows users know they need to modify iTMSTransporter.CMD
 * Transporter is now a module, new() returns an instance of ITMSTransporter
 
 Bug fixes:
@@ -22,7 +31,7 @@ Enhancements:
 * `itms` added --no-config option
 * `itms` allow boolean options to be set to false via --no-XXXX, e.g., --no-print-stderr
 
-Bug Fixes: 
+Bug Fixes:
 * `itms status` passed the wrong arguments to the underlying method
 * `itms` failed when the config file was empty
 * Verify command :verify_assets => true would disable asset verification

data/README.rdoc

@@ -74,10 +74,20 @@ This can be fixed by modifying +iTMSTransporter.CMD+ (note that the following do
 
 === Using itms
 
-<code>itms COMMAND [OPTIONS]</code>
+<code>itms COMMAND [OPTIONS] [PACKAGE]</code>
 
-* +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.
+* +COMMAND+ - The command to run, which can be any one of {the <code>iTunes::Store::Transporter</code> methods}[http://ruby-doc.org/gems/docs/i/itunes_store_transporter-0.1.1/ITunes/Store/Transporter/ITMSTransporter.html]
+* +OPTIONS+ - These are quivalent to the given +COMMAND+'s options except they must be given in a strict 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. For more info see {each command's options}[http://ruby-doc.org/gems/docs/i/itunes_store_transporter-0.1.1/ITunes/Store/Transporter/ITMSTransporter.html].
+* +PACKAGE+ - The package or directory to operate on, if required by the command
+
+<b>Note that options with a value must contain the equals character</b> (<code>"="</code>).
+The format is <code>--option=value</code> and not <code>--option value</code>.
+
+==== Examples
+
+    itms upload --username=sshaw --password=w3cAllYoU --transport=aspera a_package.itmsp
+    itms version
+    itms status --no-print-stderr --vendor-id=X123123 --username=sshaw --password=sekr3t_ --shortname=ss
 
 ==== Username, Password, Short Name
 
@@ -95,7 +105,7 @@ For example, to lookup the metadata for package +X123+ and download low-quality
   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:

data/lib/itunes/store/transporter/command/status.rb

@@ -4,18 +4,18 @@ module ITunes
   module Store
     module Transporter
       module Command            # :nodoc:
-        
+
         ##
         # Retrieve the status of a previously uploaded package
         #
         class Status < Mode
           def initialize(*config)
-            super 
+            super
             options.on *VENDOR_ID
           end
 
-          protected 
-          def handle_success(stdout_lines, stderr_lines, options) 
+          protected
+          def handle_success(stdout_lines, stderr_lines, options)
             status = {}
             while line = stdout_lines.shift
               next unless line =~ /\S+/
@@ -33,7 +33,7 @@ module ITunes
               end
             end
             status
-          end             
+          end
 
           def parse_line(line)
             key, value = line.split(/:\s+/, 2).map(&:strip)
@@ -41,7 +41,7 @@ module ITunes
             key.downcase!
             [key.to_sym, value]
           end
-        end                   
+        end
       end
     end
   end

data/lib/itunes/store/transporter/command/upload.rb

@@ -17,7 +17,8 @@ module ITunes
             options.on *SUCCESS
             options.on *FAILURE
             options.on :delete, "-delete", Optout::Boolean
-            options.on :rate, "-k", Integer  # Required if TRANSPORT is Aspera or Signiant 
+            options.on :rate, "-k", Integer  # Required if TRANSPORT is Aspera or Signiant
+            options.on :streams, "-numStreams", Integer  # Only valid if TRANSPORT is Signiant
             options.on :log_history, "-loghistory", Optout::Dir.exists
           end
         end

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

@@ -1,46 +1,46 @@
 module ITunes
-  module Store      
+  module Store
     module Transporter
       ##
       # Upload and manage your assets in the iTunes Store using the iTunes Store's Transporter (+iTMSTransporter+).
       class ITMSTransporter
-        
+
         ##
-        # === Arguments 
+        # === Arguments
         #
         # [options (Hash)] Transporter options
         #
         # === Options
-        #  
+        #
         # Options given here will be used as defaults for all subsequent method calls. Thus you can set method specific options here but, if you call a method that does not accept one of these options, an OptionError will be raised.
-        # 
-        # See specific methods for a list of options. 
+        #
+        # See specific methods for a list of options.
         #
         # [:username (String)] Your username
         # [:password (String)] Your password
         # [:shortname (String)] Your shortname. Optional, not every iTunes account has one
         # [:path (String)] The path to the +iTMSTransporter+. Optional.
-        # [:print_stdout (Boolean)] Print +iTMSTransporter+'s stdout to your stdout. Defaults to +false+. 
-        # [:print_stderr (Boolean)] Print +iTMSTransporter+'s stderr to your stderr. Defaults to +false+. 
+        # [:print_stdout (Boolean)] Print +iTMSTransporter+'s stdout to your stdout. Defaults to +false+.
+        # [:print_stderr (Boolean)] Print +iTMSTransporter+'s stderr to your stderr. Defaults to +false+.
         #
 
         def initialize(options = nil)
           @defaults = create_options(options)
-          @config = { 
+          @config = {
             :path         => @defaults.delete(:path),
-            :print_stdout => @defaults.delete(:print_stdout), 
-            :print_stderr => @defaults.delete(:print_stderr), 
-          }        
+            :print_stdout => @defaults.delete(:print_stdout),
+            :print_stderr => @defaults.delete(:print_stderr),
+          }
         end
-        
+
         ##
         # :method: lookup
-        # :call-seq: 
+        # :call-seq:
         #   lookup(options = {})
-        #            
-        # Retrieve the metadata for a previously delivered package. 
         #
-        # === Arguments 
+        # Retrieve the metadata for a previously delivered package.
+        #
+        # === Arguments
         #
         # [options (Hash)] Transporter options
         #
@@ -55,15 +55,15 @@ module ITunes
         # === Returns
         #
         # [String] The metadata
-        
+
         ##
         # :method: providers
-        # :call-seq: 
+        # :call-seq:
         #   providers(options = {})
         #
         # List of Providers for whom your account is authorzed to deliver for.
         #
-        # === Arguments 
+        # === Arguments
         #
         # [options (Hash)] Transporter options
         #
@@ -74,15 +74,15 @@ module ITunes
         # === Returns
         #
         # [Array] Each element is a +Hash+ with two keys: +:shortname+ and +:longname+ representing the given provider's long and short names
-        
+
         ##
         # :method: schema
-        # :call-seq: 
+        # :call-seq:
         #   schema(options = {})
         #
         # Download a RelaxNG schema file for a particular metadata specification.
-        #    
-        # === Arguments 
+        #
+        # === Arguments
         #
         # [options (Hash)] Transporter options
         #
@@ -93,24 +93,24 @@ module ITunes
         #
         # === Errors
         #
-        # TransporterError, OptionError, ExecutionError      
+        # TransporterError, OptionError, ExecutionError
         #
         # === Returns
         #
         # [String] The schema
-        
+
         ##
         # :method: status
-        # :call-seq: 
+        # :call-seq:
         #   status(options = {})
         #
         # Retrieve the status of a previously uploaded package.
-        #      
-        # === Arguments 
+        #
+        # === Arguments
         #
         # [options (Hash)] Transporter options
         #
-        # === Options 
+        # === Options
         #
         # [:vendor_id (String)] ID of the package you want status info on
         #
@@ -121,44 +121,45 @@ module ITunes
         # === Returns
         #
         # [Hash] Descibes various facets of the package's status.
-        
+
         ##
         # :method: upload
-        # :call-seq: 
+        # :call-seq:
         #   upload(package, options = {})
         #
         # Upload a package to the iTunes Store.
         #
         # === Arguments
-        # 
+        #
         # [package (String)] The path to the package directory to upload. Package names must end in +.itmsp+.
         # [options (Hash)] Transporter options
-        #      
+        #
         # === Options
         #
         # [:transport (String)] The method/protocol used to upload your package. Optional. Can be one of: <code>"Aspera"</code>, <code>"Signiant"</code>, or <code>"DEV"</code>. By default +iTMSTransporter+ automatically selects the transport.
-        # [:rate (Integer)] Target bitrate in Kbps. Optional, only used with +Aspera+ and +Signiant+ 
+        # [:rate (Integer)] Target bitrate in Kbps. Optional, only used with +Aspera+ and +Signiant+
         # [:success (String)] A directory to move the package to if the upload succeeds
         # [:failure (String)] A directory to move the package to if the upload fails
         # [:delete (Boolean)] Delete the package if the upload succeeds. Defaults to +false+.
         # [:log_history (String)] Write an +iTMSTransporter+ log to this directory. Off by default.
+        # [:streams (Integer)] Number of data streams to use. Optional, only used with +Signiant+
         #
         # === Errors
         #
         # TransporterError, OptionError, ExecutionError
         #
         # === Returns
-        # 
+        #
         # +true+ if the upload was successful.
-        
+
         ##
-        # :method: verify      
-        # :call-seq: 
+        # :method: verify
+        # :call-seq:
         #   verify(package, options = {})
-        #      
-        # Validate the contents of a package's metadata and assets.      
         #
-        # If verification fails an ExecutionError containing the errors will be raised. 
+        # Validate the contents of a package's metadata and assets.
+        #
+        # If verification fails an ExecutionError containing the errors will be raised.
         # Each error message is an instance of TransporterMessage.
         #
         # === Arguments
@@ -175,12 +176,12 @@ module ITunes
         # TransporterError, OptionError, ExecutionError
         #
         # === Returns
-        # 
+        #
         # +true+ if the package was verified.
-        
+
         ##
         # :method: version
-        # :call-seq: 
+        # :call-seq:
         #   version
         #
         # Return the underlying +iTMSTransporter+ version.
@@ -188,31 +189,30 @@ module ITunes
         # === Returns
         #
         # [String] The version number
-        
+
         %w|upload verify|.each do |command|
-          define_method(command) do |package, *options| 
+          define_method(command) do |package, *options|
             cmd_options = create_options(options.first)
             cmd_options[:package] = package
             run_command(command, cmd_options)
           end
         end
-        
+
         %w|lookup providers schema status version|.each do |command|
           define_method(command) { |*options| run_command(command, options.shift) }
-        end          
-        
-        private 
-        def run_command(name, options) 
+        end
+
+        private
+        def run_command(name, options)
           Command.const_get(name.capitalize).new(@config, @defaults).run(create_options(options))
         end
-        
+
         def create_options(options)
           options ||= {}
           raise ArgumentError, "options must be a Hash" unless Hash === options
           options.dup
         end
-      end      
+      end
     end
   end
 end
-

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

@@ -1,7 +1,7 @@
 module ITunes
   module Store
     module Transporter
-      VERSION = "0.1.2beta"
+      VERSION = "0.1.2"
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: itunes_store_transporter
 version: !ruby/object:Gem::Version
-  version: 0.1.2beta
+  version: 0.1.2
 platform: ruby
 authors:
 - Skye Shaw
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-02 00:00:00.000000000 Z
+date: 2015-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: childprocess
@@ -131,12 +131,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: Upload and manage your assets in the iTunes Store using the iTunes Store's