stratify-itunes 0.1.0

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.bundle
+pkg/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm use ruby-1.9.2-p180@stratify

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in stratify-itunes.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,92 @@
+PATH
+  remote: .
+  specs:
+    stratify-itunes (0.1.0)
+      itunes-library (~> 0.1.1)
+      railties (~> 3.1.0.rc1)
+      stratify-base (~> 0.1.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionpack (3.1.0.rc1)
+      activemodel (= 3.1.0.rc1)
+      activesupport (= 3.1.0.rc1)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      i18n (~> 0.6.0beta1)
+      rack (~> 1.3.0.beta2)
+      rack-cache (~> 1.0.1)
+      rack-mount (~> 0.8.1)
+      rack-test (~> 0.6.0)
+      sprockets (~> 2.0.0.beta.5)
+      tzinfo (~> 0.3.27)
+    activemodel (3.1.0.rc1)
+      activesupport (= 3.1.0.rc1)
+      bcrypt-ruby (~> 2.1.4)
+      builder (~> 3.0.0)
+      i18n (~> 0.6.0beta1)
+    activesupport (3.1.0.rc1)
+      multi_json (~> 1.0)
+    bcrypt-ruby (2.1.4)
+    bson (1.3.1)
+    bson_ext (1.3.1)
+    builder (3.0.0)
+    database_cleaner (0.6.7)
+    diff-lcs (1.1.2)
+    erubis (2.7.0)
+    hike (1.0.0)
+    i18n (0.6.0)
+    itunes-library (0.1.1)
+      plist
+    mongo (1.3.1)
+      bson (>= 1.3.1)
+    mongoid (2.0.2)
+      activemodel (~> 3.0)
+      mongo (~> 1.3)
+      tzinfo (~> 0.3.22)
+    multi_json (1.0.3)
+    plist (3.1.0)
+    rack (1.3.0)
+    rack-cache (1.0.2)
+      rack (>= 0.4)
+    rack-mount (0.8.1)
+      rack (>= 1.0.0)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.0)
+      rack (>= 1.0)
+    railties (3.1.0.rc1)
+      actionpack (= 3.1.0.rc1)
+      activesupport (= 3.1.0.rc1)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      thor (~> 0.14.6)
+    rake (0.9.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.3)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    sprockets (2.0.0.beta.10)
+      hike (~> 1.0)
+      rack (~> 1.0)
+      tilt (!= 1.3.0, ~> 1.1)
+    stratify-base (0.1.0)
+      bson_ext (~> 1.3.1)
+      mongoid (~> 2.0.2)
+      tilt (~> 1.3.2)
+    thor (0.14.6)
+    tilt (1.3.2)
+    tzinfo (0.3.27)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  database_cleaner (~> 0.6.7)
+  rspec (~> 2.6.0)
+  stratify-itunes!

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Jason Rudolph (http://jasonrudolph.com)
+
+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,21 @@
+# stratify-itunes
+
+## Dependencies
+
+Stratify is developed and tested with the following dependencies.
+
+* Ruby 1.9.2 (See `.rvmrc` for the specific version.)
+* MongoDB 1.8
+
+## Development
+
+To get set up for development on stratify-itunes, clone the repo, and ...
+
+    cd stratify/stratify-itunes
+    gem install bundler
+    bundle
+    rake
+
+## License
+
+Copyright 2011 Jason Rudolph ([jasonrudolph.com](http://jasonrudolph.com)). Released under the MIT license. See the LICENSE file for further details.

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec

data/lib/stratify-itunes/activity.rb

@@ -0,0 +1,37 @@
+require 'stratify-itunes/presenter'
+
+module Stratify
+  module ITunes
+    class Activity < Stratify::Activity
+      field :persistent_id, :type => Integer
+      field :album
+      field :artist
+      field :composer
+      field :genre
+      field :movie, :type => Boolean
+      field :name
+      field :podcast, :type => Boolean
+      field :track_number, :type => Integer
+      field :episode_number, :type => Integer
+      field :tv_show, :type => Boolean
+      field :season_number, :type => Integer
+      field :year, :type => Integer
+
+      natural_key :persistent_id, :created_at
+
+      validates_presence_of :persistent_id
+
+      # For TV shows, iTunes stores the show name in the Artist field
+      alias_attribute :show, :artist
+
+      template %q[
+        <p class="summary"><%= summary %></p>
+        <p class="details"><%= details %></p>
+      ]
+
+      def presenter
+        Stratify::ITunes::Presenter.new(self)
+      end
+    end
+  end
+end

data/lib/stratify-itunes/collector.rb

@@ -0,0 +1,33 @@
+require 'stratify-itunes/query'
+
+module Stratify
+  module ITunes
+    class Collector < Stratify::Collector
+      source "iTunes"
+
+      configuration_fields :library_path => {:type => :string, :label => "Location of 'iTunes Music Library.xml' file"}
+
+      configuration_instructions %q[
+        <p>An iTunes collector pulls in your latest iTunes activity from an "iTunes Music Library.xml" file.  On OS X, this file typically resides at <code>~/Music/iTunes/iTunes Music Library.xml</code>. To create an iTunes collector, provide the location of your iTunes XML file.</p>
+
+        <p>To pull in activity from a local iTunes library, just provide the file path, and you're all set.  For example:</p>
+
+        <p><code>/Users/johndoe/Music/iTunes/iTunes Music Library.xml</code></p>
+
+        <p>You can also pull in activity from an iTunes XML file at a remote location.  To do so, just provide a URL that points to the file.  A few examples:</p>
+
+        <p><code>http://dl.dropbox.com/u/1234567/iTunes%20Music%20Library.xml</code></p>
+
+        <p><code>ftp://username:password@LivingRoomMacMini.local/Music/iTunes/iTunes%20Music%20Library.xml</code></p>
+      ]
+
+      def activities
+        query.activities
+      end
+
+      def query
+        Stratify::ITunes::Query.new(library_path)
+      end
+    end
+  end
+end

data/lib/stratify-itunes/engine.rb

@@ -0,0 +1,9 @@
+require 'rails'
+
+module Stratify
+  module ITunes
+    class Engine < Rails::Engine
+      engine_name :stratify_itunes
+    end
+  end
+end

data/lib/stratify-itunes/presenter.rb

@@ -0,0 +1,51 @@
+module Stratify
+  module ITunes
+    class Presenter
+      def initialize(activity)
+        @activity = activity
+      end
+
+      def name
+        @activity.name.blank? ? 'Untitled' : @activity.name
+      end
+
+      def summary
+        return name if movie?
+        join_fields_with_separator name, artist
+      end
+
+      def details
+        if tv_show?
+          join_fields_with_separator season_number, episode_number, year
+        else
+          join_fields_with_separator album, year, genre
+        end
+      end
+  
+      def season_number
+        return unless @activity.season_number
+        "Season #{@activity.season_number}"
+      end
+
+      def episode_number
+        number = @activity.episode_number || @activity.track_number
+        return unless number
+        "Episode #{number}"
+      end
+  
+      def method_missing(*args)
+        @activity.send(*args)
+      end
+  
+      private
+
+      def separator
+        "\u2022"
+      end
+  
+      def join_fields_with_separator(*fields)
+        fields.reject(&:blank?).join(" #{separator} ")
+      end
+    end
+  end
+end

data/lib/stratify-itunes/query.rb

@@ -0,0 +1,56 @@
+require 'itunes/library'
+
+module Stratify
+  module ITunes
+    class Query
+      attr_reader :library_path, :limit
+
+      def initialize(library_path, limit = 50)
+        @library_path = library_path
+        @limit = limit
+      end
+
+      def activities
+        recently_played_tracks.map {|track| build_activity_from_raw_data(track)}
+      end
+
+      private
+
+      def library_xml
+        open(@library_path).read    
+      end
+
+      def build_activity_from_raw_data(track)
+        Stratify::ITunes::Activity.new({
+          :album => track.album,
+          :artist => track.artist,
+          :composer => track.composer,
+          :created_at => track.last_played_at.to_time,
+          :episode_number => track.episode_number,
+          :genre => track.genre,
+          :movie => track.movie?,
+          :name => track.name,
+          :persistent_id => track.persistent_id,
+          :podcast => track.podcast?,
+          :season_number => track.season_number,
+          :track_number => track.number, 
+          :tv_show => track.tv_show?,
+          :year => track.year,
+        })
+      end
+
+      def tracks
+        ::ITunes::Library.load(library_xml).tracks
+      end
+
+      def played_tracks
+        tracks.select { |t| t.played? }
+      end
+
+      def recently_played_tracks
+        sorted_tracks = played_tracks.sort_by(&:last_played_at)
+        sorted_tracks.last(limit)
+      end
+    end
+  end  
+end

data/lib/stratify-itunes/version.rb

@@ -0,0 +1,5 @@
+module Stratify
+  module ITunes
+    VERSION = "0.1.0"
+  end
+end

data/lib/stratify-itunes.rb

@@ -0,0 +1,6 @@
+require 'stratify-base'
+
+require 'stratify-itunes/activity'
+require 'stratify-itunes/collector'
+require 'stratify-itunes/engine'
+require 'stratify-itunes/version'