easytag 0.4.3 → 1.0.0

metadata

@@ -1,57 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: easytag
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 1.0.0
 platform: ruby
 authors:
 - Chris Lucas
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-20 00:00:00.000000000 Z
+date: 2014-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: ruby-imagespec
+  name: taglib-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: 0.3.1
+        version: 0.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: 0.3.1
+        version: 0.6.0
 - !ruby/object:Gem::Dependency
-  name: ruby-mp3info
+  name: ruby-imagespec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: 0.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0.8'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.3.1
 description: |2
       EasyTag is an abstract interface to the TagLib audio tagging library.
       It is designed to provide a simple and consistent API regardless
@@ -69,32 +55,48 @@ files:
 - Rakefile
 - easytag.gemspec
 - lib/easytag.rb
-- lib/easytag/attributes.rb
 - lib/easytag/attributes/base.rb
+- lib/easytag/attributes/flac.rb
 - lib/easytag/attributes/mp3.rb
 - lib/easytag/attributes/mp4.rb
-- lib/easytag/base.rb
-- lib/easytag/file.rb
+- lib/easytag/attributes/ogg.rb
+- lib/easytag/attributes/vorbis.rb
 - lib/easytag/image.rb
-- lib/easytag/interfaces.rb
-- lib/easytag/interfaces/base.rb
-- lib/easytag/interfaces/mp3.rb
-- lib/easytag/interfaces/mp4.rb
+- lib/easytag/taggers/base.rb
+- lib/easytag/taggers/factory.rb
+- lib/easytag/taggers/flac.rb
+- lib/easytag/taggers/mp3.rb
+- lib/easytag/taggers/mp4.rb
+- lib/easytag/taggers/ogg.rb
+- lib/easytag/taggers/vorbis.rb
 - lib/easytag/util.rb
 - lib/easytag/version.rb
-- test/consistency.01.m4a
-- test/consistency.01.mp3
-- test/consistency.02.m4a
-- test/consistency.02.mp3
-- test/musicbrainz.m4a
-- test/no_tags.m4a
-- test/no_tags.mp3
-- test/only_id3v1.mp3
-- test/only_id3v2.mp3
-- test/test_consistency.rb
-- test/test_mp3.rb
-- test/test_mp4.rb
-- test/test_util.rb
+- scripts/build_attributes_table.rb
+- spec/data/consistency.01.m4a
+- spec/data/consistency.01.mp3
+- spec/data/consistency.flac
+- spec/data/consistency.m4a
+- spec/data/consistency.mp3
+- spec/data/consistency.multiple_images.flac
+- spec/data/consistency.multiple_images.m4a
+- spec/data/consistency.multiple_images.mp3
+- spec/data/consistency.multiple_images.ogg
+- spec/data/consistency.ogg
+- spec/data/musicbrainz.m4a
+- spec/data/no_tags.flac
+- spec/data/no_tags.m4a
+- spec/data/no_tags.mp3
+- spec/data/no_tags.ogg
+- spec/data/only_id3v1.mp3
+- spec/data/only_id3v2.mp3
+- spec/flac_tagger_spec.rb
+- spec/mp3_tagger_spec.rb
+- spec/mp4_tagger_spec.rb
+- spec/ogg_tagger_spec.rb
+- spec/shared_examples.rb
+- spec/spec_helper.rb
+- spec/tagger_factory_spec.rb
+- spec/util_spec.rb
 homepage: https://github.com/cjlucas/ruby-easytag
 licenses:
 - MIT
@@ -115,12 +117,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.1.11
 signing_key: 
 specification_version: 4
 summary: A simple audio metadata tagging interface
-test_files:
-- test/test_consistency.rb
-- test/test_mp3.rb
-- test/test_mp4.rb
-- test/test_util.rb
+test_files: []
+has_rdoc: 

data/lib/easytag/base.rb

@@ -1,28 +0,0 @@
-require 'taglib'
-
-require 'easytag/interfaces'
-
-module EasyTag
-  class Base
-    attr_reader :interface
-
-    def self.build_proxy_methods(iface)
-      # generate dynamic getters
-      (iface.instance_methods - Object.instance_methods).each do |m|
-        define_method(m) { proxy_getter(m) }
-      end
-    end
-
-    def proxy_getter(m)
-      unless @interface.respond_to?(m)
-        warn "#{@interface.class} doesn't support method #{m}"
-      end
-      
-      @interface.send(m)
-    end
-
-    # dynamic instance method generation
-    EasyTag::Interfaces.all.each { |iface| self.build_proxy_methods(iface) }
-  end
-end
-

data/lib/easytag/file.rb

@@ -1,44 +0,0 @@
-require 'easytag/base'
-
-module EasyTag
-  class EasyTagFileUnsupportedError < Exception; end
-
-  class File < Base
-    attr_reader :file
-
-    def initialize(file)
-      @file = file
-
-      if audio_interface_class.nil?
-        raise EasyTagFileUnsupportedError,
-          "Couldn't determine which interface to use"
-      end
-
-      @interface = audio_interface_class.new(file)
-    end
-
-    # block interface
-    def self.open(file)
-      interface = self.new(file)
-      begin
-        yield interface if block_given?
-      ensure
-        interface.close if interface.respond_to?(:close)
-      end
-    end
-
-    private
-    # sufficient for now
-    def audio_interface_class
-      ext = ::File.extname(@file).downcase[1..-1]
-      case ext
-      when 'mp3'
-        EasyTag::Interfaces::MP3
-      when 'mp4', 'm4a', 'aac'
-        EasyTag::Interfaces::MP4
-      else
-        nil
-      end
-    end
-  end
-end

data/lib/easytag/interfaces.rb

@@ -1,18 +0,0 @@
-require 'easytag/image'
-require 'easytag/interfaces/base'
-require 'easytag/interfaces/mp3'
-require 'easytag/interfaces/mp4'
-
-module EasyTag::Interfaces
-  # get all audio interfaces
-  def self.all
-    # get all classes in Interfaces
-    classes = self.constants.map do |sym|
-      const = self.const_get(sym)
-      const if const.class == Class && const.method_defined?(:info)
-    end
-
-    # filter out nil's
-    classes.compact
-  end
-end

data/lib/easytag/interfaces/base.rb

@@ -1,24 +0,0 @@
-module EasyTag
-  module Interfaces
-    class Base
-      attr_reader :info
-
-      def close
-        @info.close
-      end
-
-      def self.build_attributes(attrib_class, attrib_args)
-        attrib_args.each do |attrib_args|
-          attrib = attrib_class.new(attrib_args)
-          define_method(attrib.name) do
-            instance_variable_get(attrib.ivar) || 
-              instance_variable_set(attrib.ivar, attrib.call(self))
-          end
-
-          attrib.aliases.each { |a| alias_method a, attrib.name}
-        end
-      end
-
-    end
-  end
-end

data/lib/easytag/interfaces/mp3.rb

@@ -1,48 +0,0 @@
-require 'mp3info'
-
-require 'easytag/attributes/mp3'
-
-module EasyTag::Interfaces
-
-  class MP3 < Base
-    ATTRIB_ARGS  = EasyTag::Attributes::MP3_ATTRIB_ARGS
-    ATTRIB_CLASS = EasyTag::Attributes::MP3Attribute
-
-    def initialize(file)
-      @info = TagLib::MPEG::File.new(file)
-
-      add_tdat_to_taglib(file)
-    end
-
-    private
-
-    def add_tdat_to_taglib(file)
-      # this is required because taglib hash issues with the TDAT+TYER
-      # frame (https://github.com/taglib/taglib/issues/127)
-      id3v2_hash = ID3v2.new
-
-      File.open(file) do |fp|
-        fp.read(3) # read past ID3 identifier
-        begin
-          id3v2_hash.from_io(fp)
-        rescue ID3v2Error => e
-          warn 'no id3v2 tags found'
-        end
-      end
-
-      # delete all TDAT frames (taglib-ruby segfaults when trying to read)
-      frames = @info.id3v2_tag.frame_list('TDAT')
-      frames.each { |frame| @info.id3v2_tag.remove_frame(frame) } 
-
-      if id3v2_hash['TDAT']
-        frame = TagLib::ID3v2::TextIdentificationFrame
-          .new('TDAT', TagLib::String::UTF8) 
-
-        frame.text = id3v2_hash['TDAT']
-        @info.id3v2_tag.add_frame(frame)
-      end
-    end
-
-    self.build_attributes(ATTRIB_CLASS, ATTRIB_ARGS)
-  end
-end

data/lib/easytag/interfaces/mp4.rb

@@ -1,14 +0,0 @@
-require 'easytag/attributes/mp4'
-
-module EasyTag::Interfaces
-  class MP4 < Base
-    ATTRIB_ARGS  = EasyTag::Attributes::MP4_ATTRIB_ARGS
-    ATTRIB_CLASS = EasyTag::Attributes::MP4Attribute
-    
-    def initialize(file)
-      @info = TagLib::MP4::File.new(file)
-    end
-
-    self.build_attributes(ATTRIB_CLASS, ATTRIB_ARGS)
-  end
-end

data/test/test_consistency.rb

@@ -1,233 +0,0 @@
-require 'digest/sha1'
-require 'test/unit'
-
-require 'easytag'
-
-TEST_DIR = File.dirname(File.absolute_path(__FILE__)) << File::SEPARATOR
-
-class TestConsistencyMP301 < Test::Unit::TestCase
-  def setup
-    @mp3 = EasyTag::File.new("#{TEST_DIR}consistency.01.mp3")
-  end
-
-  def test_tags
-    assert_equal('Track Title',         @mp3.title)
-    assert_equal('Artist Name Here',    @mp3.artist)
-    assert_equal('Album Artist Here',   @mp3.album_artist)
-    assert_equal('Album Name Here',     @mp3.album)
-    assert_equal('This is my comment.', @mp3.comment)
-    assert_equal('Polka',               @mp3.genre)
-    assert_equal(1941,                  @mp3.year)
-    assert_equal([5, 0],                @mp3.track_num)
-    assert_equal([3, 0],                @mp3.disc_num)
-    assert_equal(false,                 @mp3.compilation?)
-    assert_equal(0,                     @mp3.bpm)
-  end
-
-  def test_date
-    assert_equal(1941, @mp3.date.year)
-    assert_equal(12,   @mp3.date.month)
-    assert_equal(7,    @mp3.date.day)
-  end
-
-  def test_album_art
-    assert_equal(2, @mp3.album_art.count)
-
-    sha1 = Digest::SHA1.hexdigest(@mp3.album_art[0].data)
-    assert_equal('this is the front cover', @mp3.album_art[0].desc)
-    assert_equal('Cover (front)',           @mp3.album_art[0].type_s)
-    assert_equal('image/jpeg',              @mp3.album_art[0].mime_type)
-    assert_equal(10,                        @mp3.album_art[0].width)
-    assert_equal(5,                         @mp3.album_art[0].height)
-    assert_equal('6555697ca1bf96117608bfb5a44c05cb622f88eb', sha1)
-
-    sha1 = Digest::SHA1.hexdigest(@mp3.album_art[1].data)
-    assert_equal('this is the artist', @mp3.album_art[1].desc)
-    assert_equal('Artist',             @mp3.album_art[1].type_s)
-    assert_equal('image/png',          @mp3.album_art[1].mime_type)
-    assert_equal(10,                   @mp3.album_art[1].width)
-    assert_equal(5,                    @mp3.album_art[1].height)
-    assert_equal('9db2996823fb44ed64dfc8f57dc9df3b970c6b22', sha1)
-  end
-end
-
-class TestConsistency01 < Test::Unit::TestCase
-  def setup
-    @mp3 = EasyTag::File.new("#{TEST_DIR}consistency.01.mp3")
-    @mp4 = EasyTag::File.new("#{TEST_DIR}consistency.01.m4a")
-  end
-
-  def test_tags
-    assert_equal(@mp3.title, @mp4.title)
-    assert_equal(@mp3.artist, @mp4.artist)
-    assert_equal(@mp3.album_artist, @mp4.album_artist)
-    assert_equal(@mp3.album, @mp4.album)
-    assert_equal(@mp3.comments, @mp4.comments)
-    assert_equal(@mp3.genre, @mp4.genre)
-    assert_equal(@mp3.year, @mp4.year)
-  end
-
-  def test_date
-    # MP4 only supports year, so thats all we can test
-    assert_equal(@mp3.date.year, @mp4.date.year)
-  end
-
-  def test_album_art
-    # we're limited to what we can compare here, since mp4 is so limited
-    img_mp3 = @mp3.album_art[0]
-    img_mp4 = @mp4.album_art[0]
-    assert_equal(img_mp3.mime_type, img_mp4.mime_type)
-    assert_equal(img_mp3.data, img_mp4.data)
-  end
-
-end
-
-class TestConsistencyMP302 < Test::Unit::TestCase
-  def setup
-    @mp3 = EasyTag::File.new("#{TEST_DIR}consistency.02.mp3")
-  end
-
-  def test_tags
-    cases = [
-      ['She Lives in My Lap',           @mp3.title],
-      ['',                             @mp3.title_sort_order],
-      ['OutKast feat. Rosario Dawson',  @mp3.artist],
-      ['OutKast feat. Dawson, Rosario', @mp3.artist_sort_order],
-      ['OutKast',                       @mp3.album_artist],
-      ['',                             @mp3.album_artist_sort_order],
-      ['Speakerboxxx / The Love Below', @mp3.album],
-      ['',                             @mp3.album_sort_order],
-      [[],                             @mp3.comments],
-      ['',                             @mp3.genre],
-      [2003,                            @mp3.year],
-      [[8, 21],                         @mp3.track_num],
-      [[2, 2],                          @mp3.disc_num],
-      ['The Love Below',                @mp3.disc_subtitle],
-      ['CD',                            @mp3.media],
-      ['Arista',                        @mp3.label],
-      [true,                            @mp3.compilation?],
-      [0,                               @mp3.bpm],
-      ['B0000AGWFX',                    @mp3.asin],
-    ]
-
-    cases.each do |c|
-      expected, actual = c
-      assert_equal(expected, actual)
-    end
-  end
-
-  def test_date
-    assert_equal(2003, @mp3.date.year)
-    assert_equal(9,   @mp3.date.month)
-    assert_equal(23,    @mp3.date.day)
-
-    assert_equal(2003, @mp3.original_date.year)
-    assert_equal(9,   @mp3.original_date.month)
-    assert_equal(23,    @mp3.original_date.day)
-  end
-
-  def test_musicbrainz_data
-    cases = [
-      [['album'], @mp3.musicbrainz_album_type],
-      ['73fdb566-a9b1-494c-9f32-51768ec9fd27',
-        @mp3.musicbrainz_album_artist_id],
-      [["73fdb566-a9b1-494c-9f32-51768ec9fd27",
-        "9facf8dc-df23-4561-85c5-ece75d692f21"], @mp3.musicbrainz_artist_id],
-      ['468cd19e-d55c-46a2-a5a6-66292d2f0a90', @mp3.musicbrainz_album_id],
-      ['fa64febd-61e0-346e-aaa2-04564ed4f0a3', 
-        @mp3.musicbrainz_release_group_id],
-      ['US', @mp3.musicbrainz_album_release_country],
-      ['official', @mp3.musicbrainz_album_status],
-    ]
-
-    cases.each do |c|
-      expected, actual = c
-      assert_equal(expected, actual)
-    end
-  end
-
-  def test_album_art
-    assert_equal(1, @mp3.album_art.count)
-
-    #sha1 = Digest::SHA1.hexdigest(@mp3.album_art[0].data)
-    #assert_equal('this is the front cover', @mp3.album_art[0].desc)
-    #assert_equal('Cover (front)',           @mp3.album_art[0].type_s)
-    #assert_equal('image/jpeg',              @mp3.album_art[0].mime_type)
-    #assert_equal(10,                        @mp3.album_art[0].width)
-    #assert_equal(5,                         @mp3.album_art[0].height)
-    #assert_equal('6555697ca1bf96117608bfb5a44c05cb622f88eb', sha1)
-  end
-end
-
-class TestConsistency02 < Test::Unit::TestCase
-  def setup
-    @mp3 = EasyTag::File.new("#{TEST_DIR}consistency.02.mp3")
-    @mp4 = EasyTag::File.new("#{TEST_DIR}consistency.02.m4a")
-  end
-
-  def test_tags
-    cases = [
-      :title,
-      :title_sort_order,
-      :artist,
-      :artist_sort_order,
-      #:album_artist_sort_order, # MP3 isn't working
-      :album,
-      :album_sort_order,
-      :comments,
-      :genre,
-      :year,
-      :track_num,
-      :disc_num,
-      :disc_subtitle,
-      :media,
-      :label,
-      :compilation?,
-      :bpm,
-      :asin,
-      :conductor,
-      :remixer,
-      :mood,
-    ]
-
-    cases.each do |c|
-      #puts c
-      assert_equal(@mp3.send(c), @mp4.send(c))
-    end
-
-  end
-
-  def test_date
-    assert_equal(@mp3.date.year, @mp4.date.year)
-    assert_equal(@mp3.date.month, @mp4.date.month)
-    assert_equal(@mp3.date.day, @mp4.date.day)
-  end
-
-  def test_album_art
-    # we're limited to what we can compare here, since mp4 is so limited
-    img_mp3 = @mp3.album_art[0]
-    img_mp4 = @mp4.album_art[0]
-    assert_equal(img_mp3.mime_type, img_mp4.mime_type)
-    assert_equal(img_mp3.data, img_mp4.data)
-  end
-
-  def test_musicbrainz_data
-    cases = [
-      :musicbrainz_album_artist_id,
-      :musicbrainz_album_id,
-      :musicbrainz_album_release_country,
-      :musicbrainz_album_status,
-      :musicbrainz_album_type,
-      :musicbrainz_artist_id,
-      :musicbrainz_release_group_id,
-      :musicbrainz_track_id,
-    ]
-
-    cases.each do |c|
-      #puts c
-      assert_equal(@mp3.send(c), @mp4.send(c))
-    end
-  end
-
-end
-