vocalist 1.0.1

data/data/countries/usa.yml

@@ -0,0 +1,44 @@
+--- 
+:tags: 
+- american
+- americana
+- american pop
+- american street punk
+- america
+- american metal
+- american thrash metal
+- brooklyn
+- california
+- californian punk
+- california punk
+- detroit
+- florida
+- iowa
+- jacksonville
+- kentucky
+- louisville
+- los angeles
+- minnesota
+- new wave of american metal
+- new york
+- new york city
+- nyc
+- pennsylvania
+- orange county
+- san diego
+- seattle
+- seattle sound
+- seattle eclectica
+- san francisco
+- texas punk
+- united states
+- usa
+- us
+- washington artists
+- black kids
+- bloodhound gang
+- lady gaga
+- ladygaga
+- metro station
+- mason musso
+:country: United States

data/lib/vocalist/nationality.rb

@@ -0,0 +1,95 @@
+require 'yaml'
+
+module Vocalist
+  # Class which resolves an artist to its nationality
+  class Nationality
+    
+    # Create a new instance. There is no data loaded at this point,
+    # everything needs to be loaded separate.
+    def initialize()
+      @tag_map = {}
+    end
+    
+    # Loads the specified Files 
+    #
+    # @param [Array<String>] files A list of file names (could be regular
+    #                              expressions, e.g. 'lib/**/*.yml')
+    # @return [void]
+    def load_files(files)
+      Dir.glob(files).each do |file|
+        load_file(file)
+      end
+    end
+    
+    # Load a given file
+    #
+    # @param [String] file A file name where to load mappings from.
+    # @return [void]
+    def load_file(file)
+      file_data = YAML.load(File.read(file))
+      country = file_data[:country]
+      file_data[:tags].each do |tag|
+        @tag_map[tag.downcase] = country
+      end
+    end
+    
+        # Add a tag => country mapping to the list.
+    #
+    # @param [String] tag The tag mapped to the country (case-insensitive)
+    # @param [String] country The country identified be tag (case-sensitive)
+    def add_mapping(tag, country)
+      @tag_map[tag.downcase] = country
+    end
+  
+    # Classify an artist by its tags on Last.fm.
+    #
+    # Extended version: Returns all possible countries.
+    #
+    # @param [Array<Scrobbler::Tag>] tags The artist's tags from Last.FM
+    # @return [Hash<String, Fixnum>] The countries this artist may belong to and
+    #   their score (a higher score => probability is higher)
+    def by_scrobbler_tags_ex(tags)
+      countries = {}
+      tags.each do |tag|
+        # by default we only handle tags case-insensitive
+        country = @tag_map[tag.name.downcase]
+        if !country.nil? then
+          countries[country] = Nationality::__count_tag(tag, countries[country])
+        end
+      end
+      
+      countries
+    end
+    
+    
+    # Classify an artist by its tags on Last.fm.
+    #
+    # @param [Array<Scrobbler::Tag>] tags The artist's tags from Last.FM
+    # @return [String] The country this artist may belong to
+    def by_scrobbler_tags(tags)
+      result = by_scrobbler_tags_ex(tags).to_a.each { |s| s.reverse! }.max
+      result[1] unless result.nil?
+    end
+    
+   
+    # Do we already know about a tag?
+    #
+    # @param [String] tag The tag that should be checked if we already have a
+    #                     mapping including it.
+    # @return [Boolean] True, if there is a mapping including this tag.
+    def has_tag?(tag)
+      @tag_map.has_key?(tag.downcase)
+    end
+
+    # Helper function to compute tag count and an maybe-nil entry
+    #
+    # @private
+    # @param tag [Scrobbler::Tag]
+    # @param entry [Fixnum, Nil]
+    def self.__count_tag(tag, entry)
+      count = (entry.nil? ? 0 : entry)
+      count += [tag.count, 1].max
+    end    
+
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'vocalist'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

data/spec/vocalist_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Vocalist" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/vocalist.gemspec

@@ -0,0 +1,139 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{vocalist}
+  s.version = "1.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Uwe L. Korn"]
+  s.date = %q{2010-08-09}
+  s.description = %q{Library for various music analysis thins, e.g. determing from where an artist comes from.}
+  s.email = %q{uwelk@xhochy.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "data/countries/albania.yml",
+     "data/countries/algeria.yml",
+     "data/countries/argentina.yml",
+     "data/countries/armenia.yml",
+     "data/countries/australia.yml",
+     "data/countries/austria.yml",
+     "data/countries/bahamas.yml",
+     "data/countries/belarus.yml",
+     "data/countries/belgium.yml",
+     "data/countries/benin.yml",
+     "data/countries/bolivia.yml",
+     "data/countries/bonia.yml",
+     "data/countries/brazil.yml",
+     "data/countries/bulgaria.yml",
+     "data/countries/cameroon.yml",
+     "data/countries/canada.yml",
+     "data/countries/cape-verde.yml",
+     "data/countries/chile.yml",
+     "data/countries/china.yml",
+     "data/countries/colombia.yml",
+     "data/countries/croatia.yml",
+     "data/countries/cuba.yml",
+     "data/countries/cyprus.yml",
+     "data/countries/czech-republic.yml",
+     "data/countries/democratic-republic-of-the-congo.yml",
+     "data/countries/denmark.yml",
+     "data/countries/estonia.yml",
+     "data/countries/faroe-islands.yml",
+     "data/countries/finland.yml",
+     "data/countries/france.yml",
+     "data/countries/germany.yml",
+     "data/countries/greece.yml",
+     "data/countries/hungary.yml",
+     "data/countries/iceland.yml",
+     "data/countries/india.yml",
+     "data/countries/iran.yml",
+     "data/countries/ireland.yml",
+     "data/countries/island-of-dominica.yml",
+     "data/countries/israel.yml",
+     "data/countries/italy.yml",
+     "data/countries/ivory-coast.yml",
+     "data/countries/jamaica.yml",
+     "data/countries/japan.yml",
+     "data/countries/kazakhstan.yml",
+     "data/countries/korea.yml",
+     "data/countries/kyrgyzstan.yml",
+     "data/countries/latvia.yml",
+     "data/countries/lebanon.yml",
+     "data/countries/lithuania.yml",
+     "data/countries/luxembourg.yml",
+     "data/countries/macedonia.yml",
+     "data/countries/malaysia.yml",
+     "data/countries/mali.yml",
+     "data/countries/mexico.yml",
+     "data/countries/moldavia.yml",
+     "data/countries/mongolia.yml",
+     "data/countries/morocco.yml",
+     "data/countries/netherlands.yml",
+     "data/countries/new-zealand.yml",
+     "data/countries/norway.yml",
+     "data/countries/peru.yml",
+     "data/countries/philippines.yml",
+     "data/countries/poland.yml",
+     "data/countries/portugal.yml",
+     "data/countries/puerto-rico.yml",
+     "data/countries/romania.yml",
+     "data/countries/russia.yml",
+     "data/countries/senegal.yml",
+     "data/countries/serbia.yml",
+     "data/countries/slovakia.yml",
+     "data/countries/solvenia.yml",
+     "data/countries/south-africa.yml",
+     "data/countries/spain.yml",
+     "data/countries/sweden.yml",
+     "data/countries/switzerland.yml",
+     "data/countries/taiwan.yml",
+     "data/countries/tanzania.yml",
+     "data/countries/thailand.yml",
+     "data/countries/uk.yml",
+     "data/countries/usa.yml",
+     "lib/vocalist.rb",
+     "lib/vocalist/nationality.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/vocalist_spec.rb",
+     "vocalist.gemspec"
+  ]
+  s.homepage = %q{http://github.com/xhochy/vocalist}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Library for various music analysis}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/vocalist_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification 
+name: vocalist
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 1
+  version: 1.0.1
+platform: ruby
+authors: 
+- Uwe L. Korn
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-09 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: Library for various music analysis thins, e.g. determing from where an artist comes from.
+email: uwelk@xhochy.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- data/countries/albania.yml
+- data/countries/algeria.yml
+- data/countries/argentina.yml
+- data/countries/armenia.yml
+- data/countries/australia.yml
+- data/countries/austria.yml
+- data/countries/bahamas.yml
+- data/countries/belarus.yml
+- data/countries/belgium.yml
+- data/countries/benin.yml
+- data/countries/bolivia.yml
+- data/countries/bonia.yml
+- data/countries/brazil.yml
+- data/countries/bulgaria.yml
+- data/countries/cameroon.yml
+- data/countries/canada.yml
+- data/countries/cape-verde.yml
+- data/countries/chile.yml
+- data/countries/china.yml
+- data/countries/colombia.yml
+- data/countries/croatia.yml
+- data/countries/cuba.yml
+- data/countries/cyprus.yml
+- data/countries/czech-republic.yml
+- data/countries/democratic-republic-of-the-congo.yml
+- data/countries/denmark.yml
+- data/countries/estonia.yml
+- data/countries/faroe-islands.yml
+- data/countries/finland.yml
+- data/countries/france.yml
+- data/countries/germany.yml
+- data/countries/greece.yml
+- data/countries/hungary.yml
+- data/countries/iceland.yml
+- data/countries/india.yml
+- data/countries/iran.yml
+- data/countries/ireland.yml
+- data/countries/island-of-dominica.yml
+- data/countries/israel.yml
+- data/countries/italy.yml
+- data/countries/ivory-coast.yml
+- data/countries/jamaica.yml
+- data/countries/japan.yml
+- data/countries/kazakhstan.yml
+- data/countries/korea.yml
+- data/countries/kyrgyzstan.yml
+- data/countries/latvia.yml
+- data/countries/lebanon.yml
+- data/countries/lithuania.yml
+- data/countries/luxembourg.yml
+- data/countries/macedonia.yml
+- data/countries/malaysia.yml
+- data/countries/mali.yml
+- data/countries/mexico.yml
+- data/countries/moldavia.yml
+- data/countries/mongolia.yml
+- data/countries/morocco.yml
+- data/countries/netherlands.yml
+- data/countries/new-zealand.yml
+- data/countries/norway.yml
+- data/countries/peru.yml
+- data/countries/philippines.yml
+- data/countries/poland.yml
+- data/countries/portugal.yml
+- data/countries/puerto-rico.yml
+- data/countries/romania.yml
+- data/countries/russia.yml
+- data/countries/senegal.yml
+- data/countries/serbia.yml
+- data/countries/slovakia.yml
+- data/countries/solvenia.yml
+- data/countries/south-africa.yml
+- data/countries/spain.yml
+- data/countries/sweden.yml
+- data/countries/switzerland.yml
+- data/countries/taiwan.yml
+- data/countries/tanzania.yml
+- data/countries/thailand.yml
+- data/countries/uk.yml
+- data/countries/usa.yml
+- lib/vocalist.rb
+- lib/vocalist/nationality.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/vocalist_spec.rb
+- vocalist.gemspec
+has_rdoc: true
+homepage: http://github.com/xhochy/vocalist
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Library for various music analysis
+test_files: 
+- spec/spec_helper.rb
+- spec/vocalist_spec.rb