iTunesAmazon 0.0.1

data/History.txt

@@ -0,0 +1,5 @@
+=== 0.0.1 / 2008-12-19
+
+* First gem
+
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/i_tunes_amazon.rb
+lib/track.rb
+test/test_i_tunes_amazon.rb

data/README.txt

@@ -0,0 +1,66 @@
+= iTunesAmazon
+
+
+== DESCRIPTION:
+
+This is a handy little program that provides super useful stats about your
+iTunes library, including information about your music from Amazon.  The code
+was written for a Ruby class at UW extension.
+
+== FEATURES/PROBLEMS:
+
+Provides an API to show you the following stats about an iTunes library:
+Total playtime
+Artist count
+Album count
+Track count
+Genre count
+Most played album
+Most played artist
+Most played genre
+Random song
+Top rated Amazon album
+Total Amazon cost
+Top Amazon sales rank
+
+Many of these functions can be extended in interesting ways, for example you
+could use the random song generator to create playlists.
+
+== SYNOPSIS:
+
+  parser = ITunesParser.new("iTunes Music Library.xml")
+  top_track = parser.top_played_songs(1)[0]
+
+== REQUIREMENTS:
+
+You will need to install ruby-aaws
+Also, you will need an Amazon Web Services ID.  You can obtain one at: http://www.amazon.com/gp/aws/registration/registration-form.html
+
+== INSTALL:
+
+sudo gem install
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIX
+
+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/Rakefile

@@ -0,0 +1,13 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/track.rb'
+require './lib/i_tunes_amazon.rb'
+
+Hoe.new('iTunesAmazon', ITunesAmazon::VERSION) do |p|
+  p.rubyforge_name = 'uwruby'
+  p.developer('Tracie Hlavka', 'hlavka@gmail.com')
+end
+
+# vim: syntax=Ruby

data/lib/i_tunes_amazon.rb

@@ -0,0 +1,148 @@
+#!/usr/bin/env ruby -w
+
+
+
+require 'rubygems'
+require 'nokogiri'
+require 'amazon/aws'
+require 'amazon/aws/search'
+require './lib/track.rb'
+
+include Amazon::AWS
+include Amazon::AWS::Search
+
+KEY_ID = '1E3447REXBE9VATGH4R2'
+
+class ITunesAmazon
+  VERSION = '0.0.1'
+
+  attr_accessor :tracks, :albums, :total_time
+
+  def initialize(file)
+    @tracks = []
+    @albums = {}
+    parse(file)
+    get_amazon_stats
+  end
+
+  def parse(file)
+    xml = Nokogiri::XML.parse(File.read(file))
+    xml.xpath("//dict/dict/dict").each do |song|
+      track = Track.new
+      song.children.each do |attr|
+        case attr.text
+          when 'Artist' then track.artist = attr.next.text
+          when 'Album' then track.album = attr.next.text
+          when 'Name' then track.name = attr.next.text
+          when 'Genre' then track.genre = attr.next.text
+          when 'Size' then track.size = attr.next.text
+          when 'Total Time' then track.time = attr.next.text
+          when 'Play Count' then track.play_count = attr.next.text
+        end
+      end
+      @tracks << track
+      key = "#{track.artist},#{track.album}"
+      unless @albums.has_key?(key)
+        @albums[key] = Album.new(track.album, track.artist, track)
+      else
+        @albums[key].add_track(track)
+      end
+    end
+  end
+
+  def get_amazon_stats
+    @albums.each_value do |album|
+      album.get_amazon_info
+    end
+  end
+
+  def track_count
+    @tracks.size
+  end
+
+  def count_field name
+    @tracks.map {|track| track.send name}.uniq.size
+  end
+
+  def artist_count
+    count_field "artist"
+  end
+
+  def album_count
+    count_field "album"
+  end
+
+  def total_playtime
+    total_time = 0
+    @tracks.each do |track|
+      unless (track.time == nil && track.time.is_a?(Numeric)) then
+        total_time += track.time.to_i
+      end
+    end
+    total_time
+  end
+
+  def top_played_songs(n)
+    top_tracks = @tracks.sort {|a, b| b.play_count.to_i <=> a.play_count.to_i}
+    top_tracks[0..(n-1)]
+  end
+
+  def random_song(seed = nil)
+    unless seed == nil then srand(seed) end
+    @tracks[rand(@tracks.size)]
+  end
+
+  def genre_count
+    count_field "genre"
+  end
+
+  def most_played_album
+    most_played_field("album")
+  end
+
+  def most_played_artist
+    most_played_field("artist")
+  end
+
+  def most_played_genre
+    most_played_field("genre")
+  end
+
+  def most_played_field(name)
+    fields = {}
+    fields.default = 0
+    @tracks.each do |track|
+      fields[track.send(name)] += track.play_count.to_i
+    end
+    fields.sort {|a, b| b[1] <=> a[1]}[0][0]
+  end
+
+  def top_rated_amazon_albums(n)
+    top_albums = @albums.values.sort {|a, b| b.amazon_average_rating.to_f <=> a.amazon_average_rating.to_f}
+    top_albums[0..(n-1)]
+  end
+
+
+
+  def self.run(args)
+    parser = ITunesAmazon.new(args[0])
+
+    album = parser.top_rated_amazon_albums(1)[0]
+    p "Top rated Amazon album: #{album.album} by #{album.artist} rated #{album.amazon_average_rating.to_f}"
+
+    top_track = parser.top_played_songs(1)[0]
+    p "Top song: #{top_track.name} by #{top_track.artist}, played #{top_track.play_count} times"
+    p "Total playtime: #{parser.total_playtime/1000/60} minutes"
+    p "Artist Count: #{parser.artist_count}"
+    p "Album Count: #{parser.album_count}"
+    p "Track Count: #{parser.track_count}"
+    p "Genre Count: #{parser.genre_count}"
+    random_song = parser.random_song()
+    p "Random song: #{random_song.name} by #{random_song.artist}"
+    p "Most playd album: #{parser.most_played_album}"
+    p "Most played artist: #{parser.most_played_artist}"
+    p "Most played genre: #{parser.most_played_genre}"
+  end
+end
+
+ITunesAmazon.run(ARGV) if __FILE__ == $0

data/lib/track.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby -w
+
+class Track
+  attr_accessor :track_id, :name, :artist, :album, :genre, :size, :time, :play_count
+end
+
+class Album
+  attr_accessor :tracks, :album, :artist, :amazon_average_rating, :amazon_total_reviews, :amazon_price, :amazon_sales_rank
+
+  def initialize(album, artist, track)
+    @album = album
+    @artist = artist
+    @tracks = []
+    add_track(track)
+  end
+
+  def add_track(track)
+    @tracks << track
+  end
+
+  def get_amazon_info
+    request = Request.new(KEY_ID)
+    unless @artist == nil || @album == nil then
+      is = ItemSearch.new('Music', {'Artist' => @artist, 'Title' => @album, 'MerchantId' => 'Amazon'})
+      rg = ResponseGroup.new('Large')
+
+      begin
+        response = request.search(is, rg)
+        items = response.item_search_response.items.item
+        @amazon_average_rating = items[0].average_rating.to_s
+        @amazon_total_reviews = items[0].total_reviews.to_s
+        @amazon_price = items[0].item_attributes.list_price.amount.to_s
+        @amazon_sales_rank = items[0].sales_rank.to_s
+      rescue Amazon::AWS::Error::NoExactMatches
+        # do nothing?
+      end
+    end
+  end
+end

data/test/test_i_tunes_amazon.rb

@@ -0,0 +1,77 @@
+#!/usr/bin/env ruby -w
+
+
+$: << 'lib'
+
+require "test/unit"
+require 'i_tunes_amazon.rb'
+
+class ITunesParserTester < Test::Unit::TestCase
+  @@parse_this = ITunesAmazon.new("../test.itunes.xml")
+
+  def setup
+    @parser = @@parse_this
+  end
+
+  def test_track_count
+    actual = @parser.track_count
+    expected = 19
+    assert_equal expected, actual
+  end
+
+  def test_artist_count
+    actual = @parser.artist_count
+    expected = 2
+    assert_equal expected, actual
+  end
+
+  def test_album_count
+    actual = @parser.album_count
+    expected = 2
+    assert_equal expected, actual
+  end
+
+  def test_total_playtime
+    actual = @parser.total_playtime
+    expected = 4987057
+    assert_equal expected, actual
+  end
+
+  def test_top_song
+    actual = @parser.top_played_songs(1)[0].name
+    expected = "Kick In The Eye"
+    assert_equal expected, actual
+  end
+
+  def test_random_song
+    actual = @parser.random_song(0).name
+    expected = "Lagartija Nick"
+    assert_equal expected, actual
+  end
+
+  def test_genre_count
+    actual = @parser.genre_count
+    expected = 2
+    assert_equal expected, actual
+  end
+
+  def test_most_played_genre
+    actual = @parser.most_played_genre
+    expected = "Goth"
+    assert_equal expected, actual
+  end
+
+  def test_most_played_album
+    actual = @parser.most_played_album
+    expected = "1979-1983 Volume Two"
+    assert_equal expected, actual
+  end
+
+  def test_most_played_artist
+    actual = @parser.most_played_artist
+    expected = "Bauhaus"
+    assert_equal expected, actual
+  end
+
+
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: iTunesAmazon
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Tracie Hlavka
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-19 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.1
+    version: 
+description: This is a handy little program that provides super useful stats about your iTunes library, including information about your music from Amazon.  The code was written for a Ruby class at UW extension.
+email: 
+- hlavka@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/i_tunes_amazon.rb
+- lib/track.rb
+- test/test_i_tunes_amazon.rb
+has_rdoc: true
+homepage: 
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: uwruby
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: This is a handy little program that provides super useful stats about your iTunes library, including information about your music from Amazon
+test_files: 
+- test/test_i_tunes_amazon.rb