apple_music_library 0.9.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d57d33d85a24895e93ca386313d43fe9dd28c6a48bec21fbb4348ec3b168a177
-  data.tar.gz: d3d0b25dbd54fa23f03cea03b46729224d9b1054da276060a62cac40ab0016e3
+  metadata.gz: bd3e0f399519af81aa6cbcfe2b93ac6e1b46aed6c3bae8a3e7ececb38da228fa
+  data.tar.gz: 513c9a28c7ee88d54f4eac8775b8b521ea5809cd58f9e5dca88218c3cdddb69b
 SHA512:
-  metadata.gz: 319fb967951a32d12f0d871c32d40b56a2c4d674bbb8966de6bf6b592da5b5ed0af41f9443caf2b7b222345ded89264af85bdf75694856a8ed7e37162ab706f1
-  data.tar.gz: 148f0638affc3d19f1c96619e732280966574885fce0c66acc69e083d0cd569200e2a8535f75f96e8ef06b75fdee07b6f0ca82befd0ab8a4bcf914b86af2fff5
+  metadata.gz: cae55ca54cc8b379482da24e8d11f67c4b53c3d7735ac2e14d85930e3be5e4cc5fbef6e4b369799fd97d28941545093af5d39078a18010625d0550effa9cfbec
+  data.tar.gz: c8cd1e2cd3800896d2f76e7fd0576199f03f962fe5db1957758be9208f790a3222a9cfd2632de49e56bb8898ea7a184d5eba88a5c262234598e82aad1de33df7

data/CHANGELOG.md

@@ -3,6 +3,20 @@
 ## [Unreleased]
 - Ability to print out playlist folder hierarchy
 
+## 0.12.0 - 2022-03-26
+### Added
+- Added handling for smart versus regular playlists
+
+## 0.11.0 - 2022-03-19
+### Added
+- Added Decade model to retrieve track and album info per decade
+
+## 0.10.0 - 2022-03-16
+### Fixed
+- Fixed incorrect handling of tracks when added to track collections
+### Added
+- Added Year model to retrieve tracks and track counts per year of release
+
 ## 0.9.0 - 2022-03-15
 ### Added
 - Ability to get genres associated with an artist

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    apple_music_library (0.9.0)
+    apple_music_library (0.12.0)
       facets (~> 3.1)
       plist (~> 3.6)
 

data/README.md

@@ -32,12 +32,28 @@ library = AppleMusicLibrary.new('path/to/Library.xml')
 # Count albums
 puts library.albums.count
 
-# Show playlist inside playlist folder
+# Show playlists contained in a playlist folder
 playlist_folder = library.playlist_folder('Folder for Testing')
 playlist_folder.playlists.each do |playlist|
   puts playlist.name
 end
 
+# List all playlists
+library.playlists.each do |playlist|
+  puts playlist.name
+end
+
+# List only 'smart' playlists
+library.playlists(:smart).each do |playlist|
+  puts playlist.name
+end
+
+# List all regular (not 'smart') playlists
+library.playlists(:regular).each do |playlist|
+  puts playlist.name
+end
+
+
 # Show tracks in a specific playlist
 playlist = library.playlist('XTC Favorites')
 playlist.tracks.each do |track|
@@ -76,6 +92,26 @@ library.genres.each do |genre|
   puts "#{genre.track_count} #{genre.name}"
 end
 
+# Display track counts per year
+library.years.each do |year|
+  puts "#{year.track_count} #{year.name}"
+end
+
+# Display track counts per decade
+library.decades.each do |decade|
+  puts "#{decade.track_count} #{decade.name}"
+end
+
+# Print a report on all decades in the library
+#   e.g.
+# 1970-1979 - 336 tracks on 10 albums
+# 1980-1989 - 816 tracks on 16 albums
+# 1990-1999 - 300 tracks on 8 albums
+# 2000-2009 - 110 tracks on 5 albums
+library.decades_report
+
+
+
 ```
 All stored attributes are available via snake_cased methods on `Track` and `Playlist`. However, note that `#artist`, `#album`, and `#genre` are special cases, returning Ruby objects rather than their associated string values. Methods to return the string versions of these track attributes are provided as `track.artist_name`, `track.album_name`, and `track.genre_name`.
 

data/lib/apple_music_library/album.rb

@@ -42,5 +42,9 @@ module AppleMusicLibrary
       end
     end
 
+    def self.token
+      :album
+    end
+
   end
 end

data/lib/apple_music_library/decade.rb

@@ -0,0 +1,25 @@
+require_relative 'track_collection'
+
+module AppleMusicLibrary
+  class Decade < TrackCollection
+
+    def self.report
+      self.all.sort_by{|d| d.name}.each do |decade|
+        puts "#{decade.name} - #{decade.track_count} tracks on #{decade.album_count} albums"
+      end
+    end
+
+    def self.find_or_create_for(year_name)
+      decade_start_year = year_name.to_i - (year_name.to_i % 10)
+      decade_stop_year = decade_start_year + 9
+      decade_name = "#{decade_start_year}-#{decade_stop_year}"
+
+      self.find_or_create(decade_name)
+    end
+
+    def self.token
+      :decade
+    end
+
+  end
+end

data/lib/apple_music_library/genre.rb

@@ -1,6 +1,9 @@
 module AppleMusicLibrary
   class Genre < TrackCollection
 
+    def self.token
+      :genre
+    end
 
   end
 end

data/lib/apple_music_library/library.rb

@@ -1,10 +1,4 @@
-require_relative 'album'
-require_relative 'artist'
-require_relative 'genre'
-require_relative 'playlist'
-require_relative 'playlist_folder'
-require_relative 'track'
-require_relative "utils"
+Dir[File.join(__dir__, '.', '*.rb')].each { |file| require file }
 require 'plist'
 
 module AppleMusicLibrary
@@ -60,8 +54,9 @@ module AppleMusicLibrary
       Genre.find_by_name(genre_name)
     end
 
-    def playlists
-      @playlists ||= Playlist.all
+    def playlists(filter = nil)
+      return Playlist.all unless filter
+      Playlist.send(filter)
     end
 
     def playlist(playlist_name)
@@ -84,6 +79,18 @@ module AppleMusicLibrary
       Track.find(track_id)
     end
 
+    def years
+      @years ||= Year.all
+    end
+
+    def decades
+      @decades ||= Decade.all
+    end
+
+    def decades_report
+      Decade.report
+    end
+
     def valid?
       has_tracks?
     end

data/lib/apple_music_library/playlist.rb

@@ -37,6 +37,14 @@ module AppleMusicLibrary
       @@playlists.values
     end
 
+    def self.smart
+      @@playlists.values.select{|p| p.smart?}
+    end
+
+    def self.regular
+      @@playlists.values.select{|p| !p.smart?}
+    end
+
     def self.find_by_name(playlist_name)
       results = @@playlists.values.select{|p| p.name == playlist_name}
       if results.size == 1
@@ -59,6 +67,14 @@ module AppleMusicLibrary
       folder.present?
     end
 
+    def smart?
+      smart_info.present?
+    end
+
+    def token
+      :playlist
+    end
+
     private
 
     def load_tracks

data/lib/apple_music_library/track.rb

@@ -43,6 +43,14 @@ module AppleMusicLibrary
       # end
       @genre = Genre.find_or_create(genre_name)
 
+      if year_name.present?
+        @year = Year.find_or_create(year_name)
+        @year.add_track(self)
+
+        @decade = Decade.find_or_create_for(year_name)
+        @decade.add_track(self)
+      end
+
       @artist.add_track(self)
       @artist.add_album(@album)
       @album.add_track(self)
@@ -79,6 +87,10 @@ module AppleMusicLibrary
       @info['Genre']
     end
 
+    def year_name
+      @info['Year']
+    end
+
     def star_rating
       rating / 20
     end

data/lib/apple_music_library/track_collection.rb

@@ -7,7 +7,7 @@ module AppleMusicLibrary
 
     def initialize(name, *args)
       @tracks = []
-      @name = name
+      @name = name.present? ? name : 'Unknown'
     end
 
     def self.all
@@ -19,13 +19,23 @@ module AppleMusicLibrary
     end
 
     def self.find_or_create(lookup_name)
+      if lookup_name.blank?
+        lookup_name = 'Unknown'
+      end
+      # puts "Finding or creating #{token}: #{lookup_name}"
       unless @@track_collections[token]
         @@track_collections[token] = {}
       end
+      if @@track_collections[token][lookup_name]
+        # puts "FOUND"
+        return @@track_collections[token][lookup_name]
+      end
+      # puts "CREATING"
       @@track_collections[token][lookup_name] = self.new(lookup_name)
     end
 
     def add_track(track)
+      # puts "Adding #{track.name} to #{self.class.token} #{name}"
       @tracks << track
     end
 
@@ -33,6 +43,10 @@ module AppleMusicLibrary
       @track_count ||= tracks.count
     end
 
+    def album_count
+      @ablum_count ||= tracks.map(&:album).uniq.count
+    end
+
     def star_rating
       return nil if rated_tracks.empty?      
       rated_tracks.map(&:star_rating).sum / rated_tracks.size
@@ -44,13 +58,6 @@ module AppleMusicLibrary
       @rated_tracks ||= tracks.select{|t| t.rated?}
     end
 
-    def self.token
-      self.class.name
-    end
-
-    def token
-      self.class.token
-    end
 
   end
 end

data/lib/apple_music_library/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AppleMusicLibrary
-  VERSION = "0.9.0"
+  VERSION = "0.12.0"
 end

data/lib/apple_music_library/year.rb

@@ -0,0 +1,20 @@
+require_relative 'track_collection'
+
+module AppleMusicLibrary
+  class Year < TrackCollection
+
+    def self.dump
+      self.all.sort_by{|y| y.name}.each do |year|
+        puts "#{year.name} - #{year.track_count} tracks"
+        # year.tracks.each do |track|
+        #   puts "\t#{track.name}"
+        # end
+      end
+    end
+
+    def self.token
+      :year
+    end
+
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: apple_music_library
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Todd Gehman
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-03-15 00:00:00.000000000 Z
+date: 2022-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -126,6 +126,7 @@ files:
 - lib/apple_music_library.rb
 - lib/apple_music_library/album.rb
 - lib/apple_music_library/artist.rb
+- lib/apple_music_library/decade.rb
 - lib/apple_music_library/genre.rb
 - lib/apple_music_library/library.rb
 - lib/apple_music_library/playlist.rb
@@ -134,6 +135,7 @@ files:
 - lib/apple_music_library/track_collection.rb
 - lib/apple_music_library/utils.rb
 - lib/apple_music_library/version.rb
+- lib/apple_music_library/year.rb
 - sig/apple_music_library.rbs
 homepage: https://github.com/pugetive/apple_music_library
 licenses:
@@ -157,7 +159,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.9
+rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
 summary: Provides a Ruby interface to the information stored in an Apple Music (formerly