andyw8-itunes-library 0.1.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Joshua Peek
+
+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,30 @@
+iTunes Library
+==============
+
+A Ruby library that makes it easy to dig around your iTunes Library metadata.
+
+Forked because: https://github.com/josh/itunes-library/issues/5
+
+Installation
+------------
+
+    gem install itunes-library
+
+Usage
+-----
+
+    require 'itunes/library'
+    library = ITunes::Library.load("~/Music/iTunes/iTunes Library.xml")
+
+    library.playlists.map(&:name) #=> ["90's Music", "Classical Music", "Recently Played", ...]
+
+    library.music.tracks.select { |t| t.artist == "Foo Fighters" }.inject(0) { |n, t| n + t.play_count } #=> 4261
+
+    library.podcasts.tracks.select { |t| t.unplayed? }
+
+License
+-------
+
+Copyright (c) 2011 Joshua Peek.
+
+Released under the MIT license. See `LICENSE` for details.

data/lib/itunes/library.rb

@@ -0,0 +1,69 @@
+require 'plist'
+require 'uri'
+
+require 'itunes/playlist'
+require 'itunes/track'
+
+module ITunes
+  class Library
+    def self.load(file)
+      new(Plist::parse_xml(file))
+    end
+
+    def initialize(properties)
+      @properties = properties || {}
+    end
+
+    def [](key)
+      @properties[key]
+    end
+
+    def playlists
+      @playlists ||= self['Playlists'].map { |p| Playlist.new(self, p) }
+    end
+
+    def find_playlist(name)
+      playlists.detect { |p| p.name == name }
+    end
+
+    def music
+      find_playlist 'Music'
+    end
+
+    def movies
+      find_playlist 'Movies'
+    end
+
+    def tv_shows
+      find_playlist 'TV Shows'
+    end
+
+    def podcasts
+      find_playlist 'Podcasts'
+    end
+
+    def books
+      find_playlist 'Books'
+    end
+
+    def track_ids
+      self['Tracks']
+    end
+
+    def fetch_track(id)
+      Track.new(self, track_ids[id.to_s])
+    end
+
+    def tracks
+      @tracks ||= self['Tracks'].values.map { |t| Track.new(self, t) }
+    end
+
+    def size
+      track_ids.size
+    end
+
+    def inspect
+      "#<#{self.class.name} size=#{size}>"
+    end
+  end
+end

data/lib/itunes/playlist.rb

@@ -0,0 +1,33 @@
+module ITunes
+  class Playlist
+    def initialize(library, properties)
+      @library    = library
+      @properties = properties
+    end
+
+    def [](key)
+      @properties[key]
+    end
+
+    def name
+      self['Name']
+    end
+
+    def item_ids
+      (self['Playlist Items'] || []).map { |t| t['Track ID'] }
+    end
+
+    def items
+      @items ||= item_ids.map { |id| @library.fetch_track(id) }
+    end
+    alias_method :tracks, :items
+
+    def size
+      item_ids.size
+    end
+
+    def inspect
+      "#<#{self.class.name} name=#{name.inspect} size=#{size}>"
+    end
+  end
+end

data/lib/itunes/track.rb

@@ -0,0 +1,143 @@
+module ITunes
+  class Track
+    def initialize(library, properties)
+      @library    = library
+      @properties = properties
+    end
+
+    def to_hash
+      @properties
+    end
+
+    def [](key)
+      @properties[key]
+    end
+
+    def id
+      self['Track ID']
+    end
+
+    def persistent_id
+      self['Persistent ID']
+    end
+
+    def name
+      self['Name']
+    end
+
+    def artist
+      self['Artist']
+    end
+
+    def album
+      self['Album']
+    end
+
+    def number
+      self['Track Number']
+    end
+    
+    def genre
+      self['Genre']
+    end
+
+    def year
+      self['Year']
+    end
+
+    def composer
+      self['Composer']
+    end
+
+    def season_number
+      self['Season']
+    end
+
+    def episode_number
+      self['Episode Order']
+    end
+
+    def date_added
+      self['Date Added']
+    end
+
+    def last_played_at
+      self['Play Date UTC']
+    end
+    
+    def play_count
+      self['Play Count'] || 0
+    end
+
+    def total_time
+      self['Total Time'] / 1000
+    end
+
+    def kind
+      self['Kind']
+    end
+
+    def bit_rate
+      self['Bit Rate']
+    end
+    
+    def sample_rate
+      self['Sample Rate']
+    end
+    
+    def artwork_count
+      self['Artwork Count']
+    end
+
+    def location
+      self['Location']
+    end
+
+    def location_path
+      uri_parser.unescape(location).gsub('file://localhost', '')
+    end
+
+    def audio?
+      !video?
+    end
+
+    def video?
+      self['Has Video'] || false
+    end
+
+    def movie?
+      self['Movie'] || false
+    end
+
+    def tv_show?
+      self['TV Show'] || false
+    end
+
+    def podcast?
+      self['Podcast'] || false
+    end
+
+    def audiobook?
+      kind =~ /Audible/ ? true : false
+    end
+
+    def unplayed?
+      self['Unplayed'] == true || play_count == 0
+    end
+
+    def played?
+      !unplayed?
+    end
+
+    def inspect
+      "#<#{self.class.name} name=#{name.inspect}>"
+    end
+
+    private
+
+    def uri_parser
+      # choose appropriate URI class for Ruby 1.9/1.8
+      @uri_parser ||= URI.const_defined?(:Parser) ? URI::Parser.new : URI
+    end
+  end
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: andyw8-itunes-library
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+  prerelease: 
+platform: ruby
+authors:
+- Joshua Peek
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: plist
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! '    A Ruby library that makes it easy to dig around your iTunes Library
+  metadata.
+
+'
+email:
+- josh@joshpeek.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/itunes/library.rb
+- lib/itunes/playlist.rb
+- lib/itunes/track.rb
+- LICENSE
+- README.md
+homepage: https://github.com/andyw8/itunes-library
+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'
+      segments:
+      - 0
+      hash: -3361530687575430051
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3361530687575430051
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Wrapper around iTunes Library.xml
+test_files: []