apple_music_library 0.5.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28f3fe7d3df7d724f7e7290f9eb6c33e2dae08d22e60ed07dfeb87c9bda9c283
-  data.tar.gz: 302301b2f8dd1826f71d18474fa15dfa804babf481b46ab4db99694364e0342f
+  metadata.gz: 5c00fde335b53ca8bacdd13bdbce297b0bea1a7f5f4453f4c42bbe9c867b6c02
+  data.tar.gz: cec158953268525e8142c5a51960d0b79584e646c4e16def0fb2e71cd66b2b7e
 SHA512:
-  metadata.gz: 5bcb31d7d2326fe4d6f614a6a29a6c69b4e47e349a235b47234afc97f10618630eb4ae995bfc2c402fe2629d080e6834067cc2b6606ba22132c1662af9d19c1e
-  data.tar.gz: d1785f58aab9a2a75d1c77ce165f37307141af7dc25833d12f669dbc0c201a9633384187c9d71b36e3a5e7a8c1f7a8696d8e14197b826f5538d5b49e3310cd82
+  metadata.gz: debab2473712160521d5bc793b65e3febd984620f53d060e3864285bcb906119b074d645c678fcb4e865ea23ae90b6005eff4ccc89c26a3cfb0d91b556f26199
+  data.tar.gz: 47e7b6381f4d94afda90441cdd975fed9ba6afc6ff09de115e0cd0a1144b0bd9b3582cec0f5f736d394308d6537b5f3e31bba407cde5496b7ace6b5cc59ee6b6

data/CHANGELOG.md

@@ -3,6 +3,18 @@
 ## [Unreleased]
 - Ability to print out playlist folder hierarchy
 
+## 0.8.0 - 2022-03-13
+### Added
+- Ability to sort artists by track count and album count
+
+## 0.7.0 - 2022-03-12
+### Added
+- Average star ratings for track collectsion (albums, playlists, genres)
+
+## 0.6.0 - 2022-03-11
+### Added
+- Ability to list top artists by play count
+
 ## 0.5.0 - 2022-03-11
 ### Added
 - Basic functionality for track ratings via the #rating, #star_rating, and #loved

data/Gemfile.lock

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

data/README.md

@@ -2,6 +2,10 @@
 
 The `apple_music_library` gem offeres a ruby interface to the information stored in an iTunes / Apple Muisic `Library.xml` file, as can be generated with the app's menu option `File > Library > Export Library...`
 
+[![Maintainability](https://api.codeclimate.com/v1/badges/86a57ad0904e4358dd02/maintainability)](https://codeclimate.com/github/pugetive/apple_music_library/maintainability)
+
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -44,9 +48,24 @@ end
 artist = library.artist('XTC')
 puts artist.tracks.count
 
-# Get favorite tracks by this artists
+# Get favorite tracks by this artist
 favorite_tracks = artist.tracks.select{|t| t.loved? || t.star_rating > 3}
 
+# List out the most played artists
+library.artists(:most_played).each do |artist|
+  puts "#{artist.play_count} :: #{artist.name}"
+end
+
+# List out artists with the most tracks
+library.artists(:most_tracks).each do |artist|
+  puts "#{artist.track_count} :: #{artist.name}"
+end
+
+# List out artists with the most albums
+library.artists(:most_albums).each do |artist|
+  puts "#{artist.album_count} :: #{artist.name}"
+end
+
 # Display track counts per genre
 library.genres.each do |genre|
   puts "#{genre.tracks.count} #{genre.name}"

data/apple_music_library.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |spec|
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/pugetive/apple_music_library"
-  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+  spec.metadata["changelog_uri"] = "https://github.com/pugetive/apple_music_library/blob/main/CHANGELOG.md"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.

data/lib/apple_music_library/album.rb

@@ -1,16 +1,14 @@
+require_relative 'track_collection'
+
 module AppleMusicLibrary
-  class Album
+  class Album < TrackCollection
     attr_reader :artist
 
-
-    attr_reader :artist, :album_name, :tracks
-
     @@albums = {}
 
-    def initialize(artist, album_name)
+    def initialize(album_name, artist)
       @artist = artist
-      @album_name = album_name
-      @tracks = []
+      super
     end
 
     def self.all
@@ -22,20 +20,27 @@ module AppleMusicLibrary
       if @@albums[key]
         return @@albums[key]
       end
-      @@albums[key] = self.new(artist, album_name)
+      @@albums[key] = self.new(album_name, artist)
     end
 
     def id
       "#{artist.name}-#{album_name}"
     end
 
-    def add_track(track)
-      @tracks << track
+    def name
+      @album_name
     end
 
     def year
       @year ||= @tracks.sort_by(&:year).last.year
     end
 
+    def dump
+      puts "#{artist.name} - #{name}"
+      tracks.each do |track|
+        puts "\t#{track.name}"
+      end
+    end
+
   end
 end

data/lib/apple_music_library/artist.rb

@@ -15,6 +15,18 @@ module AppleMusicLibrary
       @@artists.values
     end
 
+    def self.most_played(limit = 20)
+      self.sorted_set(:play_count, limit)
+    end
+
+    def self.most_tracks(limit = 20)
+      self.sorted_set(:track_count, limit)
+    end
+
+    def self.most_albums(limit = 20)
+      self.sorted_set(:album_count, limit)
+    end
+
     def self.find_or_create(name)
       if @@artists[name]
         return @@artists[name]
@@ -45,9 +57,30 @@ module AppleMusicLibrary
       @albums.sort_by(&:year)
     end
 
+    def album_count
+      @albums.size
+    end
+
     def tracks
       @tracks
     end
 
+    def track_count
+      @tracks.size
+    end
+
+    def play_count
+      tracks.map(&:play_count).sum
+    end
+
+    protected
+
+    def self.sorted_set(sort_by_method, limit)
+      if limit.nil?
+        self.all.sort_by{|a| a.send(sort_by_method)}.reverse
+      else
+        self.all.sort_by{|a| a.send(sort_by_method)}.reverse.take(limit)
+      end
+    end
   end
 end

data/lib/apple_music_library/genre.rb

@@ -1,35 +1,6 @@
 module AppleMusicLibrary
-  class Genre
+  class Genre < TrackCollection
 
-    attr_reader :name, :tracks
-
-    @@genres = {}
-
-    def initialize(name)
-      @name = name
-      @tracks = []
-    end
-
-    def self.all
-      @@genres.values
-    end
-    
-    def self.find_or_create(name)
-      if @@genres[name]
-        return @@genres[name]
-      end
-      @@genres[name] = self.new(name)
-    end
-
-    def self.find_by_name(name)
-      @@genres[name]
-    end
-
-    def add_track(track)
-      unless tracks.include?(track)
-        @tracks << track
-      end
-    end
 
   end
 end

data/lib/apple_music_library/library.rb

@@ -44,8 +44,8 @@ module AppleMusicLibrary
       @albums ||= Album.all
     end
 
-    def artists
-      @artists ||= Artist.all
+    def artists(filter = nil, limit = nil)
+      filter.present? ? Artist.send(filter, limit) : Artist.all
     end
 
     def artist(artist_name)
@@ -92,6 +92,10 @@ module AppleMusicLibrary
       tracks.any?
     end
 
+    def rated_tracks
+      tracks.select{|t| t.rated?}
+    end
+
     private
 
     def extract_plist_info

data/lib/apple_music_library/playlist.rb

@@ -1,9 +1,10 @@
 require 'facets'
+require_relative 'track_collection'
 
 module AppleMusicLibrary
-  class Playlist
+  class Playlist < TrackCollection
 
-    attr_reader :info, :tracks
+    attr_reader :info
 
     @@playlists = {}
 
@@ -25,7 +26,7 @@ module AppleMusicLibrary
         return PlaylistFolder.new(info)
       end
 
-      @tracks = []
+      super
 
       load_tracks
 

data/lib/apple_music_library/track.rb

@@ -38,6 +38,9 @@ module AppleMusicLibrary
       @info = info
       @artist = Artist.find_or_create(artist_name)
       @album = Album.find_or_create(@artist, album_name)
+      # if name.match(/Humble.*demo/)
+      #   puts "Adding track #{name} to album #{album_name}"
+      # end
       @genre = Genre.find_or_create(genre_name)
 
       @artist.add_track(self)
@@ -80,6 +83,10 @@ module AppleMusicLibrary
       rating / 20
     end
 
+    def rated?
+      rating > 0 and rating <= 100
+    end
+
     def loved?
       loved
     end

data/lib/apple_music_library/track_collection.rb

@@ -0,0 +1,52 @@
+module AppleMusicLibrary
+  class TrackCollection
+
+    attr_reader :name, :tracks
+
+    @@track_collections = {}
+
+    def initialize(name, *args)
+      @tracks = []
+      @name = name
+    end
+
+    def self.all
+      @@track_collections[token].values
+    end
+
+    def self.find_by_name(lookup_name)
+      @@track_collections[token][lookup_name]
+    end
+
+    def self.find_or_create(lookup_name)
+      unless @@track_collections[token]
+        @@track_collections[token] = {}
+      end
+      @@track_collections[token][lookup_name] = self.new(lookup_name)
+    end
+
+    def add_track(track)
+      @tracks << track
+    end
+
+    def star_rating
+      return nil if rated_tracks.empty?      
+      rated_tracks.map(&:star_rating).sum / rated_tracks.size
+    end
+
+    protected
+
+    def rated_tracks
+      @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.5.0"
+  VERSION = "0.8.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: apple_music_library
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Todd Gehman
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-03-11 00:00:00.000000000 Z
+date: 2022-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -131,6 +131,7 @@ files:
 - lib/apple_music_library/playlist.rb
 - lib/apple_music_library/playlist_folder.rb
 - lib/apple_music_library/track.rb
+- lib/apple_music_library/track_collection.rb
 - lib/apple_music_library/utils.rb
 - lib/apple_music_library/version.rb
 - sig/apple_music_library.rbs
@@ -140,6 +141,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/pugetive/apple_music_library
   source_code_uri: https://github.com/pugetive/apple_music_library
+  changelog_uri: https://github.com/pugetive/apple_music_library/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths: