itunes_store_transporter 0.0.1

data/spec/errors_spec.rb

@@ -0,0 +1,52 @@
+require "spec_helper"
+
+describe ITunes::Store::Transporter::TransporterMessage do
+  subject { ITunes::Store::Transporter::TransporterMessage.new("some message", 1) }
+  its(:code) { should == 1 }
+  its(:message) { should == "some message" }
+
+  describe "#to_s" do     
+    it "includes the code and message" do 
+      subject.to_s.should == "some message (1)"
+    end    
+  end
+
+  describe "error predicate methods" do 
+    method_codes = { 
+      :bad_data? => [3000, 3999], 
+      :invalid_data? => [4000, 4999],
+      :missing_data? => [5000, 5999],
+      :unsupported_feature? => [6000, 6999], 
+      :schema_error? => [8000, 8999], 
+      :asset_error? => [9000, 9999] 
+    }
+
+    method_codes.each do |method, codes|
+      [codes.first, codes.last].each do |code|
+
+        context "code #{code}" do        
+          subject { described_class.new("", code) }
+          its(method) { should be_true }        
+          its(:validation_error?) { should be_true }        
+
+          (method_codes.keys - [method]).each do |other|
+            its(other) { should be_false }
+          end
+        end
+      end
+    end
+  end
+end
+    
+describe ITunes::Store::Transporter::ExecutionError do 
+  subject { described_class.new(messages, 1) }
+  let(:messages) { 2.times.inject([]) { |err, i| err << ITunes::Store::Transporter::TransporterMessage.new("message #{i}", i) } }
+  its(:exitstatus) { should == 1 }
+  its(:errors) { should == messages }
+
+  describe "#to_s" do 
+    it "includes each messages and its code" do 
+      subject.to_s.should == "message 0 (0), message 1 (1)" 
+    end
+  end
+end

data/spec/output_parser_spec.rb

@@ -0,0 +1,71 @@
+require "spec_helper"
+
+describe ITunes::Store::Transporter::OutputParser do
+  describe "parsing errors" do     
+    # TODO: test various error message/code formats handled by the parser
+
+    context "without an error code" do 
+      before(:all) { @parser = described_class.new(fixture("errors_and_warnings.no_error_number")) }
+
+      subject { @parser }
+      its(:warnings) { should be_empty }
+      its(:errors) { should have(2).items }
+
+      describe "the first error" do 
+        subject { @parser.errors.first }
+        its(:code) { should be_nil }
+        its(:message) { should == "An error occurred while doing fun stuff" }
+      end
+
+      describe "the second error" do 
+        subject { @parser.errors.last }
+        its(:code) { should be_nil }
+        its(:message) { should == "An exception has occurred: network timeout" }
+      end
+    end
+
+    context "with an error code" do 
+      before(:all) { @parser = described_class.new(fixture("errors_and_warnings.with_error_number")) }
+      
+      subject { @parser }
+      its(:warnings) { should be_empty }
+      its(:errors) { should have(2).items }
+      
+
+      describe "the first error" do 
+        subject { @parser.errors.first }
+        its(:code) { should == 4000 }
+        its(:message) { should == "This is error 4000" }
+      end
+
+      describe "the second error" do 
+        subject { @parser.errors.last }
+        its(:code) { should == 5000 }
+        its(:message) { should == "This is error 5000" }
+      end
+    end
+
+    context "with duplicate messages" do 
+      before(:all) { @parser = described_class.new(fixture("errors_and_warnings.duplicate_errors")) }
+      
+      it "does not include duplicates" do 
+        errors = @parser.errors.map { |e| e.message }
+        errors.should == ["Error 1", "Error 2", "Error 3"]
+      end
+    end
+  end
+
+  describe "parsing warnings" do 
+    before(:all) { @parser = described_class.new(fixture("errors_and_warnings.single_warning")) }
+
+    subject { @parser }
+    its(:errors) { should be_empty }
+    its(:warnings) { should have(1).item }
+
+    describe "the warning" do 
+      subject { @parser.warnings.first }
+      its(:code) { should == 4010 }
+      its(:message) { should == "You've been warned!" }
+    end
+  end
+end

data/spec/shell_spec.rb

@@ -0,0 +1,52 @@
+require "spec_helper"
+require "rbconfig"
+
+describe ITunes::Store::Transporter::Shell do  
+  it "yields stdout and stderr as they become available" do 
+    ruby = File.join(RbConfig::CONFIG["bindir"], RbConfig::CONFIG["ruby_install_name"])
+    temp = Tempfile.new ""
+    # sleep else poll() (select) can favor the 1st FD in the read array, causing the
+    # test to fail on some platforms
+    temp.write(<<-CODE)
+      $stdout.puts "OUT 1"
+      $stdout.flush
+      sleep 1
+      $stderr.puts "ERR 1"
+      $stderr.flush
+      sleep 1
+      $stdout.puts "OUT 2"
+      $stdout.flush
+      sleep 1
+      $stderr.puts "ERR 2"
+    CODE
+
+    temp.flush
+
+    output = []
+    expect = [ [ :stdout, "OUT 1" ],
+               [ :stderr, "ERR 1" ],  
+               [ :stdout, "OUT 2" ], 
+               [ :stderr, "ERR 2" ] ]
+    
+    described_class.new(ruby).exec([temp.path]) do |line, stream|      
+      output << [ stream, line.chomp! ]
+    end
+
+    output.should == expect
+  end
+
+  context "when on Windows" do 
+    before(:all) { ENV["PROGRAMFILES"] = "C:\\" }
+    it "selects the Windows executable" do 
+      described_class.stub(:windows? => true)
+      described_class.new.path.should match /#{described_class::WINDOWS_EXE}\Z/
+    end
+  end
+
+  context "when on anything but Windows" do 
+    it "selects the right executable" do 
+      described_class.stub(:windows? => false)
+      described_class.new.path.should match /#{described_class::EXE_NAME}\Z/
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,75 @@
+require "rspec"
+require "yaml"
+require "tempfile"
+require "fileutils"
+require "itunes/store/transporter"
+
+module SpecHelper
+  def create_options(options = {})
+    { :username => "uzer", 
+      :password => "_Gcod3" }.merge(options)
+  end
+  
+  # TODO: options for package contents?
+  def create_package(options = {})
+    Dir.mktmpdir ["",".itmsp"]
+  end
+
+  def expect_shell_args(*expected)    
+    ITunes::Store::Transporter::Shell.any_instance.stub(:exec) { |*arg| arg.first.should include(*expected) } 
+  end
+
+  def fixture(path)
+    Fixture.for(path)
+  end
+
+  # Set up output streams and exit code
+  def mock_output(options = {})
+    outputs = []
+    exitcode = options[:exit] || 0
+    
+    # Load a fixture for the given stream
+    [:stderr, :stdout].each do |fd|
+      fixture = options[fd]
+      next unless fixture
+      lines = Array === fixture ? fixture : Fixture.for(fixture)
+      outputs << [ lines, fd ]
+    end
+    
+    ITunes::Store::Transporter::Shell.any_instance.stub(:exec) do |*options|
+      block = options.pop
+      outputs.each do |lines, fd|
+        lines.each { |line| block.call(line, fd) }
+      end
+      exitcode
+    end
+  end
+  
+  module Fixture
+    class << self
+      def for(path)      
+        type, name = path.split ".", 2
+        raise "Unknown fixture '#{path}'" unless fixtures[type].include?(name)
+        fixtures[type][name].split("\n")
+      end
+      
+      private
+      def fixtures
+        @fixtures ||= load_fixtures
+      end
+      
+      def load_fixtures
+        init = Hash.new { |h, k| h[k] = {} }
+        Dir[File.join(File.expand_path(File.dirname(__FILE__)), "fixtures", "*.yml")].inject(init) do |fixtures, path|
+          name = File.basename(path, ".yml")
+          fixtures[name] = YAML.load_file(path)
+          fixtures
+        end
+      end
+    end
+  end 
+end  
+
+RSpec.configure do |config| 
+  config.include(SpecHelper)
+end

data/spec/transporter_spec.rb

@@ -0,0 +1,106 @@
+require "spec_helper"
+require "itunes/store/transporter"
+
+shared_examples_for "a transporter method" do
+  it "uses the default options" do
+    defaults = create_options
+    config = {
+      :path => "/",
+      :print_stderr => true,
+      :print_stdout => true
+    }
+
+    s = stub(command)
+    s.should_receive(:run)
+
+    klass = ITunes::Store::Transporter::Command.const_get(command)
+    klass.should_receive(:new).with(config, defaults).and_return(s)
+
+    described_class.new(config.merge(defaults)).send(method, options)
+  end
+end
+
+shared_examples_for "a transporter method without a package argument" do 
+  it_behaves_like "a transporter method"
+
+  it "executes the underlying command" do
+    ITunes::Store::Transporter::Command.const_get(command).any_instance.should_receive(:run).with(options)
+    subject.send(method, options)
+  end
+end
+
+shared_examples_for "a transporter method with a package argument" do 
+  it_behaves_like "a transporter method"
+
+  it "executes the underlying command" do
+    ITunes::Store::Transporter::Command.const_get(command).any_instance.should_receive(:run).with(:package => "package.itmsp")
+    subject.send(method, "package.itmsp")
+  end
+end
+
+
+describe ITunes::Store::Transporter do
+  let(:options) { {} }
+
+  describe "#new" do
+    context "when the options are not a Hash or nil" do
+      it "raises an ArgumentError" do
+	lambda { described_class.new(123) }.should raise_exception(ArgumentError, /must be/)
+      end
+    end
+  end
+
+  describe "#lookup" do
+    let(:method) { :lookup }
+    let(:command) { "Lookup" }
+
+    it_behaves_like "a transporter method without a package argument"
+
+    it "executes the underlying command" do
+      ITunes::Store::Transporter::Command::Lookup.any_instance.should_receive(:run)
+      subject.lookup
+    end
+  end
+
+  describe "#providers" do
+    let(:method) { :providers }
+    let(:command) { "Providers" }
+
+    it_behaves_like "a transporter method without a package argument"
+  end
+
+  describe "#schema" do
+    let(:method) { :schema }
+    let(:command) { "Schema" }
+
+    it_behaves_like "a transporter method without a package argument"
+  end
+
+  describe "#status" do
+    let(:method) { :status }
+    let(:command) { "Status" }
+
+    it_behaves_like "a transporter method without a package argument"
+  end
+
+  describe "#upload" do
+    let(:method) { :upload }
+    let(:command) { "Upload" }
+
+    it_behaves_like "a transporter method with a package argument"
+  end
+
+  describe "#verify" do
+    let(:method) { :verify }
+    let(:command) { "Verify" }
+
+    it_behaves_like "a transporter method with a package argument"  
+  end
+
+  describe "#version" do
+    let(:method) { :version }
+    let(:command) { "Version" }
+
+    it_behaves_like "a transporter method without a package argument"  
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: itunes_store_transporter
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Skye Shaw
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-10 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: childprocess
+  requirement: &70193863731280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70193863731280
+- !ruby/object:Gem::Dependency
+  name: optout
+  requirement: &70193863730780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70193863730780
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70193863730320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: *70193863730320
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70193863729860 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :development
+  prerelease: false
+  version_requirements: *70193863729860
+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
+executables:
+- itms
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- lib/itunes/store/transporter/command/lookup.rb
+- lib/itunes/store/transporter/command/option.rb
+- lib/itunes/store/transporter/command/providers.rb
+- lib/itunes/store/transporter/command/schema.rb
+- lib/itunes/store/transporter/command/status.rb
+- lib/itunes/store/transporter/command/upload.rb
+- lib/itunes/store/transporter/command/verify.rb
+- lib/itunes/store/transporter/command/version.rb
+- lib/itunes/store/transporter/command.rb
+- lib/itunes/store/transporter/errors.rb
+- lib/itunes/store/transporter/output_parser.rb
+- lib/itunes/store/transporter/shell.rb
+- lib/itunes/store/transporter/version.rb
+- lib/itunes/store/transporter.rb
+- README.rdoc
+- spec/command_spec.rb
+- spec/errors_spec.rb
+- spec/output_parser_spec.rb
+- spec/shell_spec.rb
+- spec/spec_helper.rb
+- spec/transporter_spec.rb
+- bin/itms
+homepage: http://github.com/sshaw/itunes_store_transporter
+licenses:
+- MIT
+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
+signing_key: 
+specification_version: 3
+summary: Upload and manage your assets in the iTunes Store using the iTunes Store's
+  Transporter (iTMSTransporter).
+test_files:
+- spec/command_spec.rb
+- spec/errors_spec.rb
+- spec/output_parser_spec.rb
+- spec/shell_spec.rb
+- spec/spec_helper.rb
+- spec/transporter_spec.rb
+has_rdoc: