album_credits 0.0.2

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/README.md

@@ -0,0 +1,57 @@
+Album Credits
+=============
+### Just because we listen to music digitally doesn't mean we shouldn't be able to access the album's liner notes.
+
+Very much a work in progress but it's fairly functional.
+
+Installation:
+-------------
+    gem install album_credits
+
+
+Usage:
+------
+    $ album_credits "tool" "lateralus"
+      ===================================================
+      Lateralus 2001-05-11
+      13 songs
+      http://s.dsimg.com/image/R-1581120-1229978166.jpeg
+      The packaging is the same as the EU version.
+
+      Packaged in a translucent black slipcase over a unique stained jewel case.  The jewel case design is off centre from the typical US release.
+
+      This pressing contains a typo on track 9 on both the Obi and the actual packaging.  The correct spelling is the same as the album title: "Lateralus."
+
+      Recorded at:
+      Cello Studios, Hollywood, CA
+      The Hook, North Hollywood, CA
+      Big Empty Space, North Hollywood, CA
+      The Lodge, North Hollywood, CA
+
+      Mixed at Larrabee Sound North, North Hollywood, CA.
+      Mastered by Gateway Mastering Studios, Portland, ME.
+
+      Engineers:
+
+      David Bottrill
+      AKA: Bottrill, D. Bottril, D.B., Dave Botirill, Dave Bottril, Dave Bottrill, David Botirill, David Botrill, David Bottril, Frameman
+      721 releases in discography
+      Abdelli (2 total)
+        * New Moon [1995 Real World Records, Virgin]
+      Afro Celt Sound System (4 total)
+        * Volume 1: Sound Magic [1996 Real World Records]
+        * Volume 2: Release [1999 Real World Records, Virgin]
+      Baaba Maal (4 total)
+        * Firin' In Fouta [1994 Mango, Mango]
+      Blackbud (4 total)
+        * From The Sky [2006 Independiente]
+        * Forever [2006 Independiente]
+
+        ...
+
+
+TODO:
+-----
+* Cleanup code.  Was a hack turned gem...still needs lots of refactoring, comments and tests.
+* Better identifying if a search result is *actually the album* being queried for.
+* Add sources other than Discogs.com.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/album_credits.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "album_credits/version"
+
+Gem::Specification.new do |s|
+  s.name        = "album_credits"
+  s.version     = AlbumCredits::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["bassnode"]
+  s.email       = ["bassnode@gmail.com"]
+  s.homepage    = "https://github.com/bassnode/album_credits"
+  s.summary     = %q{Provides album engineering credits}
+  s.description = %q{Searches databases for a given artist + album combination and returns recording engineering information.}
+
+  s.rubyforge_project = "album_credits"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "ruby-debug"
+  s.add_dependency "bassnode-discogs"
+end

data/bin/album_credits

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+# TEMP
+require 'rubygems'
+require 'bundler'
+require 'ruby-debug'
+require 'album_credits'
+
+artist = ARGV[0]
+album  = ARGV[1]
+year   = ARGV[2]
+ac = AlbumCredits::Finder.new
+
+releases = ac.find_releases(artist, album, year)
+raise "No releases" if releases.empty?
+puts "Found #{releases.size} releases"
+
+sorted_releases = releases.inject([]) do |rel_array, release|
+  unless (engineers = ac.engineers_for_release(release)).nil?
+    rel_array << [release, engineers]
+  end
+  rel_array
+end.sort_by{|arr| arr.last.size}.reverse
+
+raise "No engineering data though :/" if sorted_releases.empty?
+
+best_guess = sorted_releases.shift
+ac.display_release(best_guess.first, best_guess.last, :color => :green, :show_discography => true)
+
+sorted_releases.each do |release, engineers|
+  ac.display_release(release, engineers)
+end

data/engineering_data.rb

@@ -0,0 +1,142 @@
+require 'rubygems'
+#require 'ap'
+require 'discogs'
+require 'cgi'
+require 'ruby-debug'
+COLORS = {
+  :clear => "\e[0m",
+  :bold => "\e[1m",
+  :black => "\e[30m",
+  :white => "\e[37m",
+  :red   => "\e[31m",
+  :green => "\e[32m",
+  :yellow => "\e[33m",
+  :blue => "\e[34m"
+}
+
+def color_puts(text, color=:white, bold=false)
+  embolden = bold ? COLORS[:bold] : ''
+  puts "#{embolden}#{COLORS[color]}#{text}#{COLORS[:clear]}"
+end
+
+def parse_discogs_id(search_result)
+  search_result.uri.split('/').last
+end
+
+def discogs
+  return @discogs if @discogs
+  @discogs = Discogs::Wrapper.new("bff9085fc7")
+end
+
+def find_releases(artist, album, year=nil)
+  releases = []
+  [nil, 'CD', 'HDCD', 'vinyl'].each do |format|
+    format = " AND format:#{format}" if format
+    query = CGI.escape("#{album} AND artist:#{artist}#{format}")
+    possibilities = discogs.search(query, 'releases')
+    if possibilities.searchresults.size > 0
+      possibilities.searchresults.each do |found_album|
+        # puts "trying #{found_album.inspect}"
+        release = discogs.get_release(parse_discogs_id(found_album))
+        # Make sure the album is actually what we think it is and that it
+        # is in an Accepted state (as per Discogs).
+        if release.title =~ /#{album}/i && release.status == 'Accepted'
+          releases << release
+        end
+      end
+    else
+      # puts "no results for #{query}"
+    end
+  end
+
+  # Could put this later but still trying to figure out if we want to narrow
+  # by year if it removes all potential results.
+  releases.reject!{ |r| r.released.to_s.split('-').first.to_s != year } if year
+
+  # Only return unique releases
+  seen = {}
+  uniq_releases = releases.inject([]) do |uniq, rel|
+    unless seen.has_key?(rel.id)
+      seen[rel.id] = 1
+      uniq << rel
+    end
+    uniq
+  end
+
+  # Only return with nil release date filter unless it filters out everything.
+  pristine_releases = uniq_releases.reject{|release| release.released.nil?}
+  pristine_releases.size < uniq_releases.size ? pristine_releases : uniq_releases
+end
+
+def engineers_for_release(release)
+  if release.extraartists && !(engineers = release.extraartists.select{|a| a.role =~ /mix|master|engineer/i}).empty?
+    return engineers
+  end
+end
+
+def discography_for_artist(artist)
+  debugger
+  discogs.get_artist(CGI.escape(artist)) rescue []
+end
+
+def image_uri_for_release(release)
+  return if release.images.nil?
+  img = release.images.detect{|i| i.type == 'primary'}
+  img = release.images.detect{|i| i.type == 'secondary'} if img.nil?
+  img.uri if img
+end
+
+def display_release(release, engineers, options={})
+  color = options.delete(:color) || :white
+  show_discography = options[:show_discography] == true
+
+  color_puts "="*40, color
+  color_puts "#{release.title} #{release.released} ID: #{release.id}", color
+  color_puts "#{release.tracklist.size} songs", color
+  color_puts image_uri_for_release(release), color
+  color_puts release.notes, color
+  color_puts "Engineers:", color
+  engineers.each do |engineer|
+    color_puts "#{engineer.role} #{engineer.name}", color, true
+    # Print the first 100 releases in the engineer's discography
+    if show_discography && !(artist = discogs.get_artist(CGI.escape(engineer.name))).nil?
+      color_puts "#{artist.aliases} #{artist.aliases} #{artist.namevariations}", color
+      color_puts "#{artist.releases.size} releases in discography", color
+      artist.releases.slice(0,99).each do |disk|
+        color_puts "\t* #{disk.year} #{disk.title} [#{disk.label}]", color
+      end
+      # IDEA: show a cross-section of their work.
+      # maybe start with around the year that current album was released if there are many.
+      # ALSO: could filter their discog. output by x-ref w/ the role they
+      # played on this album. e.g. only show Bob Ludwig's mastering work, not
+      # mixing.  Could be ugly b/c I'll have to pull down every release
+      # individually.
+    end
+  end
+end
+
+
+artist = ARGV[0]
+album = ARGV[1]
+year = ARGV[2]
+releases = find_releases(artist, album, year)
+raise "No releases" if releases.empty?
+puts "Found #{releases.size} releases"
+
+sorted_releases = releases.inject([]) do |rel_array, release|
+  unless (engineers = engineers_for_release(release)).nil?
+    rel_array << [release, engineers]
+  end
+  rel_array
+end.sort_by{|arr| arr.last.size}.reverse
+
+raise "No engineering data though :/" if sorted_releases.empty?
+
+best_guess = sorted_releases.shift
+display_release(best_guess.first, best_guess.last, :color => :green, :show_discography => true)
+
+sorted_releases.each do |release, engineers|
+  display_release(release, engineers)
+end
+
+

data/lib/album_credits/core_ext.rb

@@ -0,0 +1,8 @@
+module Enumerable
+  def group_by
+    inject({}) do |grouped, element|
+      (grouped[yield(element)] ||= []) << element
+      grouped
+    end
+  end
+end

data/lib/album_credits/display.rb

@@ -0,0 +1,82 @@
+module AlbumCredits
+
+  module Display
+
+    COLORS = {
+      :clear => "\e[0m",
+      :bold => "\e[1m",
+      :black => "\e[30m",
+      :white => "\e[37m",
+      :red   => "\e[31m",
+      :green => "\e[32m",
+      :yellow => "\e[33m",
+      :blue => "\e[34m"
+    }
+
+    @default_color = :white
+    attr_accessor :default_color
+
+    def cp(text, opts={})
+      embolden = opts[:bold] ? COLORS[:bold] : ''
+      color = opts[:color] || @default_color
+      puts "#{embolden}#{COLORS[color]}#{text}#{COLORS[:clear]}"
+    end
+
+    def image_uri_for_release(release)
+      return if release.images.nil?
+      img = release.images.detect{|i| i.type == 'primary'}
+      img = release.images.detect{|i| i.type == 'secondary'} if img.nil?
+      img.uri if img
+    end
+
+    def display_release(release, engineers, opts={})
+      @default_color = opts.delete(:color) || :white
+
+      cp "="*40
+      cp "#{release.title} #{release.released} ID: #{release.id}"
+      cp "#{release.tracklist.size} songs"
+      cp image_uri_for_release(release)
+      cp release.notes
+
+      display_engineer_data(engineers, opts)
+    end
+
+    # TODO: Put logical engineer sorting
+    # IDEA: show a cross-section of their work.
+    # maybe start with around the year that current album was released if there are many.
+    # ALSO: could filter their discog. output by x-ref w/ the role they
+    # played on this album. e.g. only show Bob Ludwig's mastering work, not mixing.
+    def display_engineer_data(engineers, opts={})
+      show_discography = opts[:show_discography] == true
+      displayed = []
+
+      cp "Engineers:", :color => :yellow
+      engineers.each do |engineer|
+        next if displayed.include? engineer.name
+        cp "#{engineer.role} #{engineer.name}", :bold => true
+
+        # Print the engineer's discography
+        if show_discography && !(artist = discogs.get_artist(CGI.escape(engineer.name))).nil?
+          aka = artist.aliases || []
+          aka << artist.namevariations || []
+          cp "AKA: #{aka.flatten.uniq.sort.join(', ')}"
+          cp "#{artist.releases.size} releases in discography"
+          # Don't show discog for assistants
+          unless engineer.role =~ /assisted|assistant|additional/i
+            artist.releases.group_by{ |disk| disk.artist }.sort_by{ |artist, albums| artist }.each do |artist, albums|
+              cp artist.to_s + " (#{albums.size} total)", :bold => true, :color => :blue
+              # Print the oldest version of this album
+              albums.group_by{ |a| a.title }.each do |title, albums|
+                artist_release = albums.sort_by{ |album| album.year.to_i }.first
+                cp "\t* #{artist_release.title} [#{artist_release.year} #{artist_release.label}]"
+              end
+            end
+          end
+
+          displayed << engineer.name
+          puts
+        end
+      end
+    end
+  end
+end

data/lib/album_credits/finder.rb

@@ -0,0 +1,73 @@
+module AlbumCredits
+
+  class Finder
+    include Display
+
+    attr_reader :discogs
+
+    def initialize(api_key="bff9085fc7")
+      @discogs = Discogs::Wrapper.new(api_key)
+    end
+
+    def parse_discogs_id(search_result)
+      search_result.uri.split('/').last
+    end
+
+    def find_releases(artist, album, year=nil)
+      releases = []
+      [nil, 'CD', 'HDCD', 'vinyl'].each do |format|
+        format = " AND format:#{format}" if format
+        query = CGI.escape("#{album} AND artist:#{artist}#{format}")
+        begin
+          possibilities = discogs.search(query, :type => 'releases')
+        rescue  Discogs::UnknownResource => e
+          puts "Not found: #{e}"
+          next
+        end
+        if possibilities.searchresults.size > 0
+          possibilities.searchresults.each do |found_album|
+            # puts "trying #{found_album.inspect}"
+            release = discogs.get_release(parse_discogs_id(found_album))
+            # Make sure the album is actually what we think it is and that it
+            # is in an Accepted state (as per Discogs).
+            if release.title =~ /#{album}/i && release.status == 'Accepted'
+              releases << release
+            end
+          end
+        else
+          # puts "no results for #{query}"
+        end
+      end
+
+      # Could put this later but still trying to figure out if we want to narrow
+      # by year if it removes all potential results.
+      releases.reject!{ |r| r.released.to_s.split('-').first.to_s != year } if year
+
+      # Sometimes Discogs returns duplicate releases so
+      # filter out any duplicates based on id.
+      seen = {}
+      uniq_releases = releases.inject([]) do |uniq, rel|
+        unless seen.has_key?(rel.id)
+          seen[rel.id] = 1
+          uniq << rel
+        end
+        uniq
+      end
+
+      # Only return with nil release date filter unless it filters out everything.
+      pristine_releases = uniq_releases.reject{|release| release.released.nil?}
+      pristine_releases.size < uniq_releases.size ? pristine_releases : uniq_releases
+    end
+
+    def engineers_for_release(release)
+      if release.extraartists && !(engineers = release.extraartists.select{|a| a.role =~ /mix|master|engineer/i}).empty?
+        return engineers
+      end
+    end
+
+    def discography_for_artist(artist)
+      discogs.get_artist(CGI.escape(artist)) rescue []
+    end
+
+  end
+end

data/lib/album_credits/version.rb

@@ -0,0 +1,3 @@
+module AlbumCredits
+  VERSION = "0.0.2"
+end

data/lib/album_credits.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'cgi'
+require 'discogs'
+require 'album_credits/core_ext'
+require 'album_credits/display'
+require 'album_credits/finder'
+
+module AlbumCredits
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification 
+name: album_credits
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- bassnode
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-12 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruby-debug
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bassnode-discogs
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: Searches databases for a given artist + album combination and returns recording engineering information.
+email: 
+- bassnode@gmail.com
+executables: 
+- album_credits
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- album_credits.gemspec
+- bin/album_credits
+- engineering_data.rb
+- lib/album_credits.rb
+- lib/album_credits/core_ext.rb
+- lib/album_credits/display.rb
+- lib/album_credits/finder.rb
+- lib/album_credits/version.rb
+has_rdoc: true
+homepage: https://github.com/bassnode/album_credits
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: album_credits
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Provides album engineering credits
+test_files: []
+