ruby-mp3info 0.6.14 → 0.6.15

data/History.txt

@@ -1,3 +1,7 @@
+=== 0.6.15 / 2011-07-18
+
+* support for StringIO as input (thanks to Edd Parris)
+
 === 0.6.14 / 2011-06-17
 
 * Added a check for nil that was seen causing problems when processing files. (thanks to Carl Hall)

data/lib/mp3info.rb

@@ -17,7 +17,7 @@ end
 
 class Mp3Info
 
-  VERSION = "0.6.14"
+  VERSION = "0.6.15"
 
   LAYER = [ nil, 3, 2, 1]
   BITRATE = {
@@ -155,22 +155,45 @@ class Mp3Info
   # "close" method.
   attr_accessor(:tag2)
 
-  # the original filename
+  # the original filename unless used with a StringIO
   attr_reader(:filename)
 
-  # Test the presence of an id3v1 tag in file +filename+
-  def self.hastag1?(filename)
-    File.open(filename,"rb") { |f|
-      f.seek(-TAG1_SIZE, File::SEEK_END)
-      f.read(3) == "TAG"
-    }
+  # Test the presence of an id3v1 tag in file or StringIO +filename_or_io+
+  def self.hastag1?(filename_or_io)
+    if filename_or_io.is_a?(StringIO)
+      io = filename_or_io
+      io.rewind
+    else
+      io = File.new(filename_or_io, "rb")
+    end
+
+    hastag1 = false
+    begin
+      io.seek(-TAG1_SIZE, File::SEEK_END)
+      hastag1 = io.read(3) == "TAG"
+    ensure
+      io.close if io.is_a?(File)
+    end
+    hastag1
   end
 
-  # Test the presence of an id3v2 tag in file +filename+
-  def self.hastag2?(filename)
-    File.open(filename,"rb") { |f|
-      f.read(3) == "ID3"
-    }
+  # Test the presence of an id3v2 tag in file or StringIO +filename_or_io+
+  def self.hastag2?(filename_or_io)
+    if filename_or_io.is_a?(StringIO)
+      io = filename_or_io
+      io.rewind
+    else
+      io = File.new(filename_or_io,"rb")
+    end
+
+    hastag2 = false
+
+    begin
+      hastag2 = io.read(3) == "ID3"
+    ensure
+      io.close if io.is_a?(File)
+    end
+    hastag2
   end
 
   # Remove id3v1 tag from +filename+
@@ -193,24 +216,38 @@ class Mp3Info
   # Specify :parse_tags => false to disable the processing
   # of the tags (read and write).
   # Specify :parse_mp3 => false to disable processing of the mp3
-  def initialize(filename, options = {})
+  def initialize(filename_or_io, options = {})
     warn("#{self.class}::new() does not take block; use #{self.class}::open() instead") if block_given?
-    @filename = filename
+    @filename_or_io = filename_or_io
     options = {:parse_mp3 => true, :parse_tags => true}.update(options)
     @tag_parsing_enabled = options.delete(:parse_tags)
     @mp3_parsing_enabled = options.delete(:parse_mp3)
     @id3v2_options = options
     reload
   end
-
+  
   # reload (or load for the first time) the file from disk
   def reload
-    raise(Mp3InfoError, "empty file") unless File.size?(@filename)
-
     @header = {}
+
+    if @filename_or_io.is_a?(String)
+      @io_is_a_file = true
+      @io = File.new(@filename_or_io, "rb")
+      @io_size = @io.stat.size
+      @filename = @filename_or_io
+    elsif @filename_or_io.is_a?(StringIO)
+      @io_is_a_file = false
+      @io = @filename_or_io
+      @io_size = @io.size
+      @filename = nil
+    end
+
+    if @io_size == 0
+      raise(Mp3InfoError, "empty file or IO")
+    end
     
-    @file = File.new(filename, "rb")
-    @file.extend(Mp3FileMethods)
+
+    @io.extend(Mp3FileMethods)
     @tag1 = @tag = @tag1_orig = @tag_orig = {}
     @tag1.extend(HashKeys)
     @tag2 = ID3v2.new(@id3v2_options)
@@ -253,7 +290,9 @@ class Mp3Info
       end
 
     ensure
-      @file.close
+      if @io_is_a_file
+        @io.close
+      end
     end
   end
 
@@ -302,6 +341,7 @@ class Mp3Info
 
   # write to another filename at close()
   def rename(new_filename)
+    raise(Mp3InfoError, "cannot rename an IO") unless @io_is_a_file
     @filename = new_filename
   end
 
@@ -311,7 +351,7 @@ class Mp3Info
   # [position_in_the_file, length_of_the_data]
   def audio_content
     pos = 0
-    length = File.size(@filename)
+    length = @io_size
     if hastag1?
       length -= TAG1_SIZE
     end
@@ -328,8 +368,10 @@ class Mp3Info
   end
 
   # Flush pending modifications to tags and close the file
+  # not used when source IO is a StringIO
   def close
     puts "close" if $DEBUG
+    return unless @io_is_a_file
     if !@tag_parsing_enabled
       return 
     end
@@ -352,12 +394,12 @@ class Mp3Info
 
     if @tag1 != @tag1_orig
       puts "@tag1 has changed" if $DEBUG
-      raise(Mp3InfoError, "file is not writable") unless File.writable?(@filename)
+      raise(Mp3InfoError, "file is not writable") unless File.writable?(@filename_or_io)
       #@tag1_orig.update(@tag1)
       @tag1_orig = @tag1.dup
-      File.open(@filename, 'rb+') do |file|
+      File.open(@filename_or_io, 'rb+') do |file|
         if @tag1_orig.empty?
-          newsize = file.stat.size - TAG1_SIZE
+          newsize = @io_size - TAG1_SIZE
           file.truncate(newsize)
         else
           file.seek(-TAG1_SIZE, File::SEEK_END)
@@ -384,21 +426,21 @@ class Mp3Info
 
     if @tag2.changed?
       puts "@tag2 has changed" if $DEBUG
-      raise(Mp3InfoError, "file is not writable") unless File.writable?(@filename)
+      raise(Mp3InfoError, "file is not writable") unless File.writable?(@filename_or_io)
       tempfile_name = nil
-      File.open(@filename, 'rb+') do |file|
+      File.open(@filename_or_io, 'rb+') do |file|
         #if tag2 already exists, seek to end of it
         if @tag2.parsed?
           file.seek(@tag2.io_position)
         end
-  #      if @file.read(3) == "ID3"
-  #        version_maj, version_min, flags = @file.read(3).unpack("CCB4")
+  #      if @io.read(3) == "ID3"
+  #        version_maj, version_min, flags = @io.read(3).unpack("CCB4")
   #        unsync, ext_header, experimental, footer = (0..3).collect { |i| flags[i].chr == '1' }
-  #        tag2_len = @file.get_syncsafe
-  #        @file.seek(@file.get_syncsafe - 4, IO::SEEK_CUR) if ext_header
-  #        @file.seek(tag2_len, IO::SEEK_CUR)
+  #        tag2_len = @io.get_syncsafe
+  #        @io.seek(@io.get_syncsafe - 4, IO::SEEK_CUR) if ext_header
+  #        @io.seek(tag2_len, IO::SEEK_CUR)
   #      end
-        tempfile_name = @filename + ".tmp"
+        tempfile_name = @filename_or_io + ".tmp"
         File.open(tempfile_name, "wb") do |tempfile|
           unless @tag2.empty?
             tempfile.write(@tag2.to_bin)
@@ -410,13 +452,14 @@ class Mp3Info
           end
         end
       end
-      File.rename(tempfile_name, @filename)
+      File.rename(tempfile_name, @filename_or_io)
     end
   end
 
   # close and reopen the file, i.e. commit changes to disk and 
-  # reload it
+  # reload it (only works with "true" files, not StringIO ones)
   def flush
+    return unless @io_is_a_file
     close
     reload
   end
@@ -434,16 +477,14 @@ class Mp3Info
   # counter, or whatever you like ;) +frame+ is a hash with the following keys:
   # :layer, :bitrate, :samplerate, :mpeg_version, :padding and :size (in bytes)
   def each_frame
-    File.open(@filename, 'rb') do |file|
-      file.seek(@first_frame_pos, File::SEEK_SET)
-      loop do
-        head = file.read(4).unpack("N").first
-        frame = Mp3Info.get_frames_infos(head)
-        file.seek(frame[:size] -4, File::SEEK_CUR)
-        yield frame
-        #puts "frame #{frame_count} len #{frame[:length]} br #{frame[:bitrate]} @file.pos #{@file.pos}"
-        break if file.eof?
-      end
+    @io.seek(@first_frame_pos, File::SEEK_SET)
+    loop do
+      head = @io.read(4).unpack("N").first
+      frame = Mp3Info.get_frames_infos(head)
+      @io.seek(frame[:size] -4, File::SEEK_CUR)
+      yield frame
+      #puts "frame #{frame_count} len #{frame[:length]} br #{frame[:bitrate]} @io.pos #{@io.pos}"
+      break if @io.eof?
     end
   end
 
@@ -481,49 +522,50 @@ private
       :size => size }
   end
 
-  ### parses the id3 tags of the currently open @file
+  ### parses the id3 tags of the currently open @io
   def parse_tags
-    return if @file.stat.size < TAG1_SIZE  # file is too small
+    return if @io_size < TAG1_SIZE  # file is too small
+
     @tag1_parsed = false
-    @file.seek(0)
-    f3 = @file.read(3)
+    @io.seek(0)
+    f3 = @io.read(3)
     # v1 tag at beginning
     if f3 == "TAG"  
       gettag1 
       @tag1_parsed = true
     end
 
-    @tag2.from_io(@file) if f3 == "ID3"  # v2 tag at beginning
+    @tag2.from_io(@io) if f3 == "ID3"  # v2 tag at beginning
       
     unless @tag1_parsed         # v1 tag at end
       # this preserves the file pos if tag2 found, since gettag2 leaves
       # the file at the best guess as to the first MPEG frame
       pos = (@tag2.io_position || 0)
       # seek to where id3v1 tag should be
-      @file.seek(-TAG1_SIZE, IO::SEEK_END) 
-      if @file.read(3) == "TAG"
+      @io.seek(-TAG1_SIZE, IO::SEEK_END) 
+      if @io.read(3) == "TAG"
         gettag1
       end
-      @file.seek(pos)
+      @io.seek(pos)
     end
   end
   
-  ### gets id3v1 tag information from @file
-  ### assumes @file is pointing to char after "TAG" id
+  ### gets id3v1 tag information from @io
+  ### assumes @io is pointing to char after "TAG" id
   def gettag1
     @tag1_parsed = true
-    @tag1["title"] = @file.read(30).unpack("A*").first
-    @tag1["artist"] = @file.read(30).unpack("A*").first
-    @tag1["album"] = @file.read(30).unpack("A*").first
-    year_t = @file.read(4).to_i
+    @tag1["title"] = @io.read(30).unpack("A*").first
+    @tag1["artist"] = @io.read(30).unpack("A*").first
+    @tag1["album"] = @io.read(30).unpack("A*").first
+    year_t = @io.read(4).to_i
     @tag1["year"] = year_t unless year_t == 0
-    comments = @file.read(30)
+    comments = @io.read(30)
     if comments.getbyte(-2) == 0
       @tag1["tracknum"] = comments.getbyte(-1).to_i
       comments.chop! #remove the last char
     end
     @tag1["comments"] = comments.unpack("A*").first
-    @tag1["genre"] = @file.getbyte
+    @tag1["genre"] = @io.getbyte
     @tag1["genre_s"] = GENRES[@tag1["genre"]] || ""
 
     # clear empty tags
@@ -532,29 +574,30 @@ private
     @tag1.delete("tracknum") if @tag1["tracknum"] == 0
   end
 
-  ### reads through @file from current pos until it finds a valid MPEG header
+  ### reads through @io from current pos until it finds a valid MPEG header
   ### returns the MPEG header as FixNum
   def find_next_frame
-    # @file will now be sitting at the best guess for where the MPEG frame is.
+    # @io will now be sitting at the best guess for where the MPEG frame is.
     # It should be at byte 0 when there's no id3v2 tag.
     # It should be at the end of the id3v2 tag or the zero padding if there
     #   is a id3v2 tag.
-    #dummyproof = @file.stat.size - @file.pos => WAS TOO MUCH
-    dummyproof = [ @file.stat.size - @file.pos, 2000000 ].min
+    #dummyproof = @io.stat.size - @io.pos => WAS TOO MUCH
+
+    dummyproof = [ @io_size - @io.pos, 2000000 ].min
     dummyproof.times do |i|
-      if @file.getbyte == 0xff
-        data = @file.read(3)
-        raise(Mp3InfoError, "end of file reached") if @file.eof?
+      if @io.getbyte == 0xff
+        data = @io.read(3)
+        raise(Mp3InfoError, "end of file reached") if @io.eof?
         head = 0xff000000 + (data.getbyte(0) << 16) + (data.getbyte(1) << 8) + data.getbyte(2)
         begin
           Mp3Info.get_frames_infos(head)
           return head
         rescue Mp3InfoInternalError
-          @file.seek(-3, IO::SEEK_CUR)
+          @io.seek(-3, IO::SEEK_CUR)
         end
       end
     end
-    if @file.eof?
+    if @io.eof?
       raise Mp3InfoError, "cannot find a valid frame: got EOF"
     else
       raise Mp3InfoError, "cannot find a valid frame after reading #{dummyproof} bytes"
@@ -583,7 +626,7 @@ private
     head = nil
     5.times do
       head = find_next_frame() 
-      @first_frame_pos = @file.pos - 4
+      @first_frame_pos = @io.pos - 4
       current_frame = Mp3Info.get_frames_infos(head)
       @mpeg_version = current_frame[:mpeg_version]
       @layer = current_frame[:layer]
@@ -608,20 +651,20 @@ private
       (@channel_num == 3 ? 17 : 32) :       
       (@channel_num == 3 ?  9 : 17)
 
-    @file.seek(seek, IO::SEEK_CUR)
+    @io.seek(seek, IO::SEEK_CUR)
     
-    vbr_head = @file.read(4)
+    vbr_head = @io.read(4)
     if vbr_head == "Xing"
       puts "Xing header (VBR) detected" if $DEBUG
-      flags = @file.get32bits
+      flags = @io.get32bits
       stream_size = frame_count = 0
-      flags[1] == 1 and frame_count = @file.get32bits
-      flags[2] == 1 and stream_size = @file.get32bits 
+      flags[1] == 1 and frame_count = @io.get32bits
+      flags[2] == 1 and stream_size = @io.get32bits 
       puts "#{frame_count} frames" if $DEBUG
       raise(Mp3InfoError, "bad VBR header") if frame_count.zero?
       # currently this just skips the TOC entries if they're found
-      @file.seek(100, IO::SEEK_CUR) if flags[0] == 1
-      #@vbr_quality = @file.get32bits if flags[3] == 1
+      @io.seek(100, IO::SEEK_CUR) if flags[0] == 1
+      #@vbr_quality = @io.get32bits if flags[3] == 1
 
       samples_per_frame = SAMPLES_PER_FRAME[@layer][@mpeg_version] 
       @length = frame_count * samples_per_frame / Float(@samplerate)
@@ -630,7 +673,8 @@ private
       @vbr = true
     else
       # for cbr, calculate duration with the given bitrate
-      stream_size = @file.stat.size - (hastag1? ? TAG1_SIZE : 0) - (@tag2.io_position || 0)
+      
+      stream_size = @io_size - (hastag1? ? TAG1_SIZE : 0) - (@tag2.io_position || 0)
       @length = ((stream_size << 3)/1000.0)/@bitrate
       # read the first 100 frames and decide if the mp3 is vbr and needs full scan
       begin

data/test/test_ruby-mp3info.rb

@@ -10,6 +10,8 @@ require "tempfile"
 require "zlib"
 require "yaml"
 
+system("which id3v2 > /dev/null") || raise("id3v2 not found")
+
 class Mp3InfoTest < Test::Unit::TestCase
 
   TEMP_FILE = File.join(File.dirname(__FILE__), "test_mp3info.mp3")
@@ -86,21 +88,8 @@ class Mp3InfoTest < Test::Unit::TestCase
   end
   
   def test_detected_info
-    Mp3Info.open(TEMP_FILE) do |info|
-      assert_equal(1, info.mpeg_version)
-      assert_equal(3, info.layer)
-      assert_equal(false, info.vbr)
-      assert_equal(128, info.bitrate)
-      assert_equal("JStereo", info.channel_mode)
-      assert_equal(44100, info.samplerate)
-      assert_equal(0.1305625, info.length)
-      assert_equal({:original => true, 
-                    :error_protection => false, 
-                    :padding => false, 
-                    :emphasis => 0, 
-                    :private => true, 
-                    :mode_extension => 2, 
-                    :copyright => false}, info.header)
+    Mp3Info.open(TEMP_FILE) do |mp3|
+      assert_mp3_info_are_ok(mp3)
     end
   end
   
@@ -167,13 +156,23 @@ class Mp3InfoTest < Test::Unit::TestCase
   end
 
   def test_removetag2
-    w = write_temp_file({"TIT2" => "sdfqdsf"})
+    w = write_tag2_to_temp_file({"TIT2" => "sdfqdsf"})
 
     assert( Mp3Info.hastag2?(TEMP_FILE) )
     Mp3Info.removetag2(TEMP_FILE)
     assert( ! Mp3Info.hastag2?(TEMP_FILE) )
   end
 
+  def test_hastags
+    Mp3Info.open(TEMP_FILE) do |info| 
+      info.tag1 = @tag
+    end
+    assert(Mp3Info.hastag1?(TEMP_FILE))
+
+    written_tag = write_tag2_to_temp_file(DUMMY_TAG2)
+    assert(Mp3Info.hastag2?(TEMP_FILE))
+  end
+
   def test_universal_tag
     2.times do 
       tag = {"title" => "title"}
@@ -200,7 +199,7 @@ class Mp3InfoTest < Test::Unit::TestCase
   end
 
   def test_id3v2_version
-    written_tag = write_temp_file(DUMMY_TAG2)
+    written_tag = write_tag2_to_temp_file(DUMMY_TAG2)
     assert_equal( "2.#{ID3v2::WRITE_VERSION}.0", written_tag.version )
   end
 
@@ -215,7 +214,7 @@ class Mp3InfoTest < Test::Unit::TestCase
   end
 
   def test_id3v2_basic
-    w = write_temp_file(DUMMY_TAG2)
+    w = write_tag2_to_temp_file(DUMMY_TAG2)
     assert_equal(DUMMY_TAG2, w)
     id3v2_prog_test(DUMMY_TAG2, w)
   end
@@ -254,13 +253,13 @@ class Mp3InfoTest < Test::Unit::TestCase
       tag[k] = random_string(50)
     end
 
-    got_tag = write_temp_file(tag)
+    got_tag = write_tag2_to_temp_file(tag)
     assert_equal(tag, got_tag)
   end
 
   def test_id3v2_bigtag
     tag = {"APIC" => random_string(1024) }
-    assert_equal(tag, write_temp_file(tag))
+    assert_equal(tag, write_tag2_to_temp_file(tag))
   end
 
   def test_infinite_loop_on_seek_to_v2_end
@@ -270,7 +269,7 @@ class Mp3InfoTest < Test::Unit::TestCase
   def test_leading_char_gets_chopped
     tag2 = DUMMY_TAG2.dup
     tag2["WOAR"] = "http://foo.bar"
-    w = write_temp_file(tag2)
+    w = write_tag2_to_temp_file(tag2)
     assert_equal("http://foo.bar", w["WOAR"])
 
     system(%(id3v2 --WOAR "http://foo.bar" "#{TEMP_FILE}"))
@@ -465,7 +464,7 @@ class Mp3InfoTest < Test::Unit::TestCase
   end
 
   def test_parse_tags_disabled
-    write_temp_file(DUMMY_TAG2)
+    write_tag2_to_temp_file(DUMMY_TAG2)
     Mp3Info.open(TEMP_FILE, :parse_tags => false) do |mp3|
       assert mp3.tag.empty?
       assert mp3.tag1.empty?
@@ -480,6 +479,34 @@ class Mp3InfoTest < Test::Unit::TestCase
     end
   end
 
+  def test_string_io
+    io = load_string_io
+    Mp3Info.open(io) do |mp3|
+      assert_mp3_info_are_ok(mp3)
+    end
+  end
+
+  def test_trying_to_rename_a_stringio_should_raise_an_error
+    io = load_string_io
+    Mp3Info.open(io) do |mp3|
+      assert_raises(Mp3InfoError) do
+        mp3.rename("whatever_filename_is_error_should_be_raised.mp3")
+      end
+    end
+  end
+
+  def test_hastag_class_methods_with_a_stringio
+    Mp3Info.open(TEMP_FILE) do |info| 
+      info.tag1 = @tag
+    end
+    io = load_string_io
+    assert(Mp3Info.hastag1?(io))
+
+    written_tag = write_tag2_to_temp_file(DUMMY_TAG2)
+    io = load_string_io
+    assert(Mp3Info.hastag2?(io))
+  end
+
   def compute_audio_content_mp3_digest(mp3)
     pos, size = mp3.audio_content
     data = File.open(mp3.filename) do |f|
@@ -489,7 +516,7 @@ class Mp3InfoTest < Test::Unit::TestCase
     Digest::MD5.new.update(data).hexdigest
   end
 
-  def write_temp_file(tag)
+  def write_tag2_to_temp_file(tag)
     Mp3Info.open(TEMP_FILE) do |mp3|
       mp3.tag2.update(tag)
     end
@@ -503,6 +530,31 @@ class Mp3InfoTest < Test::Unit::TestCase
     out
   end
 
+  def assert_mp3_info_are_ok(mp3)
+    assert_equal(1, mp3.mpeg_version)
+    assert_equal(3, mp3.layer)
+    assert_equal(false, mp3.vbr)
+    assert_equal(128, mp3.bitrate)
+    assert_equal("JStereo", mp3.channel_mode)
+    assert_equal(44100, mp3.samplerate)
+    assert_equal(0.1305625, mp3.length)
+    assert_equal({:original => true, 
+                  :error_protection => false, 
+                  :padding => false, 
+                  :emphasis => 0, 
+                  :private => true, 
+                  :mode_extension => 2, 
+                  :copyright => false}, mp3.header)
+  end
+
+  def load_string_io(filename = TEMP_FILE)
+    io = StringIO.new
+    data = File.read(filename)
+    io.write(data)
+    io.rewind
+    io
+  end
+
 =begin
 
   def test_encoder

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-mp3info
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: 
   segments: 
   - 0
   - 6
-  - 14
-  version: 0.6.14
+  - 15
+  version: 0.6.15
 platform: ruby
 authors: 
 - Guillaume Pierronnet
@@ -15,40 +15,23 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-17 00:00:00 Z
+date: 2011-07-18 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: hoe-yard
+  name: hoe
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 31
+        hash: 23
         segments: 
-        - 0
-        - 1
         - 2
-        version: 0.1.2
+        - 10
+        version: "2.10"
   type: :development
   version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: hoe
-  prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 47
-        segments: 
-        - 2
-        - 8
-        - 0
-        version: 2.8.0
-  type: :development
-  version_requirements: *id002
 description: |-
   * written in pure ruby 
   * read low-level informations like bitrate, length, samplerate, etc...
@@ -107,14 +90,14 @@ files:
 - lib/mp3info/extension_modules.rb
 - lib/mp3info/id3v2.rb
 - test/test_ruby-mp3info.rb
+- .gemtest
 homepage: 
 licenses: []
 
 post_install_message: 
 rdoc_options: 
-- --title
-- RubyMp3info Documentation
-- --quiet
+- --main
+- README.txt
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -138,7 +121,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: ruby-mp3info
-rubygems_version: 1.8.5
+rubygems_version: 1.7.2
 signing_key: 
 specification_version: 3
 summary: ruby-mp3info is a pure-ruby library to retrieve low level informations on mp3 files and manipulate id3v1 and id3v2 tags