app-store-emigrant 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+# For the actual gemspec see app-store-emigrant.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,23 @@
+
+Licensed under the MIT license
+
+Copyright (c) 2012 Tim Kurvers <tim@moonsphere.net>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,5 @@
+
+App Store Emigrant
+==================
+
+Once this gem is even remotely stable, this README will be updated.

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['specs/*.rb']
+  t.verbose    = true
+  t.libs      << 'specs'
+end

data/app-store-emigrant.gemspec

@@ -0,0 +1,29 @@
+# encoding: utf-8
+
+$:.push File.expand_path('../lib', __FILE__)
+
+require 'app-store-emigrant/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'app-store-emigrant'
+  s.version     = AppStore::Emigrant::VERSION
+  s.authors     = ['Tim Kurvers']
+  s.email       = ['tim@moonsphere.net']
+  s.homepage    = 'http://moonsphere.net'
+  s.summary     = 'App Store Emigrant will manually attempt to verify whether any of your local mobile applications are out of date'
+  s.description = 'Moved countries and now iTunes refuses to notify you properly with updates? Rest assured, using App Store Emigrant you know exactly which apps are outdated'
+  
+  s.rubyforge_project = 'app-store-emigrant'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+  
+  s.add_dependency 'rubyzip',        '~> 0.9.5'
+  s.add_dependency 'rainbow',        '~> 1.1.3'
+  s.add_dependency 'CFPropertyList', '~> 2.0.17'
+  
+  s.add_development_dependency 'rake'
+
+end

data/bin/ase

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'app-store-emigrant'
+
+AppStore::Emigrant::CLI.new ARGV

data/lib/app-store-emigrant/app.rb

@@ -0,0 +1,121 @@
+require 'cfpropertylist'
+require 'json'
+require 'net/http'
+require 'pathname'
+require 'zip/zip'
+require 'zip/zipfilesystem'
+
+module AppStore; end
+
+module AppStore::Emigrant
+  
+  # Represents a single iTunes mobile application
+  class App
+    
+    # List of valid extensions for an application
+    VALID_EXTENSIONS = [
+      '.ipa'
+    ]
+    
+    # Regular expression to match a version number in filenames
+    FILENAME_VERSION_REGEX = Regexp.new('(?<version>[0-9.]+)(?:' + VALID_EXTENSIONS.join('|') + ')')
+    
+    attr_reader :path
+    
+    # Initializes application from given path
+    def initialize path
+      @path = Pathname.new path
+      @path = @path.expand_path unless @path.absolute?
+      
+      # Ensure application exists
+      unless @path.file?
+        raise DoesNotExist, "Given path is not a valid application: #{@path}"
+      end
+      
+      # Ensure application has valid extension
+      unless VALID_EXTENSIONS.include? @path.extname
+        raise Invalid, "Given application does not have a valid extension: #{@path}"
+      end
+      
+      @metadata = nil
+      @clouddata = nil
+    end
+    
+    # Filename of this application (including extension)
+    def filename
+      unless @filename
+        @filename = @path.basename().to_s
+      end
+      
+      @filename
+    end
+    
+    # Name of this application (from its metadata)
+    def name
+      metadata['itemName']
+    end
+    
+    # Version of this application
+    def version
+      unless @version
+        
+        # Extract version information (if available)
+        @version = metadata['bundleShortVersionString'] || metadata['bundleVersion']
+        
+        # Otherwise, use the filename
+        unless @version
+          @version = filename[FILENAME_VERSION_REGEX, :version]
+        end
+        
+      end
+      
+      @version
+    end
+    
+    # Lazily loads local metadata for this application from its iTunesMetadata.plist
+    def metadata
+      unless @metadata
+        begin
+          Zip::ZipFile.open(@path) do |zip|
+            data = zip.file.read('iTunesMetadata.plist')
+            plist = CFPropertyList::List.new(data: data)
+            @metadata = CFPropertyList.native_types(plist.value)
+          end
+        rescue Zip::ZipError => e
+          raise Invalid, e.message
+        end
+      end
+      
+      @metadata
+    end
+    
+    # Lazily queries Apple's iTunes Store API for latest cloud data
+    # Note: Clouddata may be nil if the application was removed from the store
+    def clouddata
+      unless @clouddata
+        response = Net::HTTP.get('itunes.apple.com', '/lookup?id=' + metadata['itemId'].to_s)
+        @clouddata = JSON.parse(response)['results'].first
+      end
+      
+      @clouddata
+    end
+    
+    # Version available in the cloud
+    def cloudversion
+      clouddata && clouddata['version']
+    end
+    
+    # Whether this application is outdated
+    def outdated?
+      return cloudversion && version != cloudversion
+    end
+  
+    # Raised when an application does not exist
+    class DoesNotExist < StandardError; end
+  
+    # Raised when an application is invalid (e.g non-valid extension)
+    class Invalid < StandardError; end
+    
+  end
+  
+end

data/lib/app-store-emigrant/cli.rb

@@ -0,0 +1,36 @@
+require 'rainbow'
+
+module AppStore; end
+
+module AppStore::Emigrant
+  
+  # Represents the command line interface
+  class CLI
+    
+    # Initializes CLI instance with given arguments
+    def initialize args
+      
+      # Extract the path (if any)
+      path, = args
+      
+      # Use the default library on this system when no path is specified
+      library = path ? Library.new(path) : Library.default
+      
+      # Loop through all applications
+      library.apps.each do |app|
+        
+        # And print their name, version and whether it's outdated
+        print app.name + ' @ ' + "v#{app.version}".foreground(app.outdated? ? :red : :green)
+        if app.outdated?
+          print " (v#{app.cloudversion} available in the cloud)" 
+        end
+        puts
+        
+        sleep(1)
+      end
+      
+    end
+    
+  end
+  
+end

data/lib/app-store-emigrant/library.rb

@@ -0,0 +1,89 @@
+require 'pathname'
+
+module AppStore; end
+
+module AppStore::Emigrant
+  
+  # Represents a single iTunes mobile applications library
+  class Library
+    
+    attr_reader :path
+    
+    # Initializes library from given path
+    def initialize path
+      @path = Pathname.new path
+      @path = @path.expand_path unless @path.absolute?
+      
+      # Ensure library is a valid directory
+      unless @path.directory?
+        raise DoesNotExist, "Given path is not a valid library directory: #{@path}"
+      end
+      
+      @apps = nil
+    end
+    
+    # Retrieves a list of applications
+    def apps
+      unless @apps
+        load!
+      end
+      
+      @apps
+    end
+    
+    # Forcefully loads applications from disk
+    def load!
+      @apps = []
+      @path.each_child do |item|
+        if item.file?
+          begin
+            @apps << App.new(item)
+          rescue App::Invalid; end
+        end
+      end
+      self
+    end
+    
+    # Searches for applications containing given snippet in filename
+    def find snippet
+      apps.select do |app|
+        app.filename.include? snippet
+      end
+    end
+    
+    # Returns the default library (if any) for this system
+    # See Apple's support document (http://support.apple.com/kb/ht1391) as to where libraries can be found
+    def self.default
+      
+      # Use the homedir provided through the environment
+      homedir = ENV['HOME']
+      
+      # List all locations
+      locations = [
+        
+        # Mac OSX and Windows Vista
+        "#{homedir}/Music/iTunes/iTunes Media/Mobile Applications/",
+        
+        # Windows 7
+        "#{homedir}/My Music/iTunes/iTunes Media/Mobile Applications/",
+        
+        # Windows XP
+        "#{homedir}/My Documents/My Music/iTunes/iTunes Media/Mobile Applications/"
+      ]
+      
+      # Raise exception if no default library could be found
+      path = Dir.glob(locations).first
+      unless path
+        raise DoesNotExist, 'Could not locate default iTunes library'
+      end
+      
+      # Return an instance of this default library
+      Library.new path
+    end
+    
+    # Raised when a library does not exist
+    class DoesNotExist < StandardError; end
+    
+  end
+  
+end

data/lib/app-store-emigrant/version.rb

@@ -0,0 +1,8 @@
+
+module AppStore; end
+
+module AppStore::Emigrant
+  
+  VERSION = '0.0.1'
+
+end

data/lib/app-store-emigrant.rb

@@ -0,0 +1,11 @@
+
+module AppStore; end
+
+module AppStore::Emigrant
+  
+  autoload :App,      'app-store-emigrant/app'
+  autoload :CLI,      'app-store-emigrant/cli'
+  autoload :Library,  'app-store-emigrant/library'
+  autoload :VERSION,  'app-store-emigrant/version'    
+  
+end

data/specs/app.rb

@@ -0,0 +1,51 @@
+require 'app-store-emigrant'
+require 'helpers'
+require 'minitest/spec'
+require 'minitest/autorun'
+
+include AppStore::Emigrant
+
+describe App do
+  
+  LIBRARY = ROOT + '/fixtures/dummy-library'
+  
+  before do
+    @dummy = App.new(LIBRARY + '/Dummy.ipa')
+    @outdated = App.new(LIBRARY + '/Outdated.ipa')
+  end
+  
+  it 'must be a valid file on disk' do
+    lambda do
+      App.new(LIBRARY + '/Non-Existent.ipa')
+    end.must_raise App::DoesNotExist
+  end
+  
+  it 'must have a valid extension' do
+    lambda do
+      App.new(LIBRARY + '/Non-Existent.ipa')
+    end.must_raise App::DoesNotExist
+  end
+  
+  it 'can determine its own filename' do
+    @dummy.filename.must_equal 'Dummy.ipa'
+  end
+  
+  it 'can handle invalid structures' do
+    lambda do
+      @dummy.version
+    end.must_raise App::Invalid
+  end
+  
+  it 'can query local metadata' do
+    @outdated.version.must_equal '0.9'
+  end
+  
+  it 'can query clouddata' do
+    @outdated.cloudversion.must_equal '1.1.0'
+  end
+  
+  it 'can determine whether it is outdated' do
+    @outdated.outdated?.must_equal true
+  end
+  
+end

data/specs/fixtures/dummy-library/iTunesMetadata.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>bundleVersion</key>
+	<string>0.9</string>
+	<key>itemId</key>
+	<integer>344186162</integer>
+</dict>
+</plist>

data/specs/helpers.rb

@@ -0,0 +1,3 @@
+
+# Helper constant holding path to tests-folder
+ROOT = File.dirname __FILE__

data/specs/library.rb

@@ -0,0 +1,32 @@
+require 'app-store-emigrant'
+require 'helpers'
+require 'minitest/spec'
+require 'minitest/autorun'
+
+include AppStore::Emigrant
+
+describe Library do
+  
+  before do
+    @library = Library.new(ROOT + '/fixtures/dummy-library')
+  end
+  
+  it 'must be located in a valid directory' do
+    @library.must_be_instance_of Library
+    
+    lambda do
+      Library.new(ROOT + '/non-existent-library')
+    end.must_raise Library::DoesNotExist
+  end
+  
+  it 'will gracefully and lazily load applications' do
+    @library.instance_variable_get('@apps').must_be_nil
+    @library.apps.must_be_instance_of Array
+    @library.apps.length.must_equal 2
+  end
+  
+  it 'can find applications' do
+    @library.find('Dummy').length.must_equal 1
+  end
+  
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: app-store-emigrant
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Tim Kurvers
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: &70227983767300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+  type: :runtime
+  prerelease: false
+  version_requirements: *70227983767300
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: &70227984172040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *70227984172040
+- !ruby/object:Gem::Dependency
+  name: CFPropertyList
+  requirement: &70227984171580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.17
+  type: :runtime
+  prerelease: false
+  version_requirements: *70227984171580
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70227984171200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70227984171200
+description: Moved countries and now iTunes refuses to notify you properly with updates?
+  Rest assured, using App Store Emigrant you know exactly which apps are outdated
+email:
+- tim@moonsphere.net
+executables:
+- ase
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- app-store-emigrant.gemspec
+- bin/ase
+- lib/app-store-emigrant.rb
+- lib/app-store-emigrant/app.rb
+- lib/app-store-emigrant/cli.rb
+- lib/app-store-emigrant/library.rb
+- lib/app-store-emigrant/version.rb
+- specs/app.rb
+- specs/fixtures/dummy-library/Dummy.ipa
+- specs/fixtures/dummy-library/Invalid.extension
+- specs/fixtures/dummy-library/Outdated.ipa
+- specs/fixtures/dummy-library/iTunesMetadata.plist
+- specs/helpers.rb
+- specs/library.rb
+homepage: http://moonsphere.net
+licenses: []
+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: app-store-emigrant
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: App Store Emigrant will manually attempt to verify whether any of your local
+  mobile applications are out of date
+test_files: []