id3tag 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 192009692506623f17cd3c91ff040cb5afddd8db
-  data.tar.gz: ea9a1c3f2009ac8d4cfaad09f5e7d3837a527934
+  metadata.gz: b979a732340ba5dc962c63c0dbb3eeaeaeda5ddc
+  data.tar.gz: 86bf018537df030ace61374ee53dde985eeae97d
 SHA512:
-  metadata.gz: f796886149fa97049de4262cd06d29aa43033d1e61f1c33f80be3298a8c6e9b0fb0109f5ad1518f408644c32e712e1e8da0f482bc6e39de2526f9c4b8808f7d7
-  data.tar.gz: 03b35723226f0a0d93c14958b755bbe79f8064930739f7868241a6a8ea6ec03c846312483457db180e47a1316a8e9d87ca3fd0396823e58b7aad445f6d3e1177
+  metadata.gz: 482d8a339e51dfb36274429a23e497409d11459f9dbfd5f2fcbef75944558070ebaef7d2c688cc3f582723375a7243cab372208652a5c06621051528547a5be1
+  data.tar.gz: 4276bb8473958cb3e8d4de143722bee763324ba0d37f16f0dfb8bd866fa8a62a6b6f49393f932288b76e9e0b7d2f7469ea29a31810de4ee3ba87e6f38dc5a8ee

data/README.md

@@ -25,9 +25,11 @@ mp3_file = File.open('/path/to/your/favorite_song.mp3')
 tag = ID3Tag.read(mp3_file)
 puts "#{tag.artist} - #{tag.title}"
 ```
-`ID3Tag::Tag` class provides easy accessors to frames like `artist`, `title`, `album`, `year`, `track_nr`, `genre` but you can read any frame by using `get_frame(id)` or `get_frame_content(id)` or browsing all frames by calling `frames`.
+`ID3Tag::Tag` class provides easy accessors to frames like `artist`, `title`, `album`, `year`, `track_nr`, `genre`, `comments` but you can read any frame by using `get_frame(id)` or `get_frames(id)` or browsing all frames by calling `frames`.
 When using easy accessors to frames like `artist` the reader will look for v.2.x tags artist frame first and if it can not find it artist frame from v1.x will be returned (if v1.x tag exists)
 
+There can be more than one `comments` frame in the tag. They differ by language, too access specific comment frame an extra argument can be passed (Default is english). For example `tag.comments(:lav)` will look for comments in Latvian. Language codes can be seen here: `https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes`
+
 ```ruby
 mp3s = Dir.entries("/some/dir").select { |filename| filename =~ /\.mp3/i }
 
@@ -41,7 +43,9 @@ mp3s.each do |file|
     puts tag.track_nr
     puts tag.genre
     puts "---"
-    puts tag.get_frame_content(:TIT2)
+    puts tag.get_frame(:TIT2).content
+    puts tag.get_frames(:COMM).first.content
+    puts tag.get_frames(:COMM).last.language
   end
 end
 ```
@@ -78,3 +82,7 @@ You can inspect tag by calling `frame_ids` to see available frame ids or `frames
 Copyright (c) 2013 Krists Ozols. See LICENSE.txt for
 further details.
 
+
+
+[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/krists/id3tag/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
+

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.5.0

data/id3tag.gemspec

@@ -2,15 +2,15 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: id3tag 0.4.0 ruby lib
+# stub: id3tag 0.5.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "id3tag"
-  s.version = "0.4.0"
+  s.version = "0.5.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Krists Ozols"]
-  s.date = "2013-10-22"
+  s.date = "2013-11-10"
   s.description = "Native Ruby ID3 tag reader that aims for 100% covarage of ID3v2.x and ID3v1.x standards"
   s.email = "krists@iesals.lv"
   s.extra_rdoc_files = [
@@ -44,13 +44,17 @@ Gem::Specification.new do |s|
     "lib/id3tag/frames/v2/genre_frame/genre_parser.rb",
     "lib/id3tag/frames/v2/genre_frame/genre_parser_24.rb",
     "lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24.rb",
+    "lib/id3tag/frames/v2/involved_people_list_frame.rb",
+    "lib/id3tag/frames/v2/private_frame.rb",
     "lib/id3tag/frames/v2/text_frame.rb",
     "lib/id3tag/frames/v2/unique_file_id_frame.rb",
     "lib/id3tag/frames/v2/unsychronized_transcription_frame.rb",
+    "lib/id3tag/frames/v2/user_text_frame.rb",
     "lib/id3tag/id3_v1_frame_parser.rb",
     "lib/id3tag/id3_v2_frame_parser.rb",
     "lib/id3tag/id3_v2_tag_header.rb",
     "lib/id3tag/number_util.rb",
+    "lib/id3tag/scope.rb",
     "lib/id3tag/string_util.rb",
     "lib/id3tag/synchsafe_integer.rb",
     "lib/id3tag/tag.rb",
@@ -61,6 +65,10 @@ Gem::Specification.new do |s|
     "spec/fixtures/id3v1_with_track_nr.mp3",
     "spec/fixtures/id3v1_without_track_nr.mp3",
     "spec/fixtures/id3v2.mp3",
+    "spec/fixtures/pov_20131018-2100a.mp3.v1_tag_body",
+    "spec/fixtures/pov_20131018-2100a.mp3.v2_3_tag_body",
+    "spec/fixtures/signals_1.mp3.v2_3_tag_body",
+    "spec/id3tag_extract_tags",
     "spec/lib/id3tag/audio_file_spec.rb",
     "spec/lib/id3tag/frames/util/genre_name_by_id_finder_spec.rb",
     "spec/lib/id3tag/frames/v1/comments_frame_spec.rb",
@@ -97,7 +105,7 @@ Gem::Specification.new do |s|
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
   s.required_ruby_version = Gem::Requirement.new(">= 1.9.2")
-  s.rubygems_version = "2.1.5"
+  s.rubygems_version = "2.1.10"
   s.summary = "Native Ruby ID3 tag reader that aims for 100% covarage of ID3v2.x and ID3v1.x standards"
 
   if s.respond_to? :specification_version then

data/lib/id3tag.rb

@@ -9,6 +9,7 @@ require "id3tag/id3_v1_frame_parser"
 require "id3tag/id3_v2_frame_parser"
 require "id3tag/frame_id_advisor"
 require "id3tag/tag"
+require "id3tag/scope"
 require "id3tag/frames/util/genre_names"
 require "id3tag/frames/v1/text_frame"
 require "id3tag/frames/v1/genre_frame"
@@ -16,7 +17,10 @@ require "id3tag/frames/v1/comments_frame"
 require "id3tag/frames/v1/track_nr_frame"
 require "id3tag/frames/v2/basic_frame"
 require "id3tag/frames/v2/text_frame"
+require "id3tag/frames/v2/user_text_frame"
+require "id3tag/frames/v2/involved_people_list_frame"
 require "id3tag/frames/v2/unique_file_id_frame"
+require "id3tag/frames/v2/private_frame"
 require "id3tag/frames/v2/comments_frame"
 require "id3tag/frames/v2/unsychronized_transcription_frame"
 require "id3tag/frames/v2/genre_frame"
@@ -27,8 +31,8 @@ require "id3tag/frames/v2/frame_fabricator"
 require "id3tag/frames/v2/frame_flags"
 
 module ID3Tag
-  def self.read(source, version = :all)
-    tag = Tag.read(source, version)
+  def self.read(source, scope = :all)
+    tag = Tag.read(source, scope)
     yield tag if block_given?
     tag
   end

data/lib/id3tag/audio_file.rb

@@ -57,7 +57,13 @@ module ID3Tag
 
     def get_v2_extended_header_size
       if v2_tag_header.extended_header?
-        SynchsafeInteger.decode(NumberUtil.convert_string_to_32bit_integer(v2_extended_header_size_bytes))
+        if v2_tag_major_version_number == 3
+          # ext. header size for 2.3.0 does not include size bytes.
+          # There are only 2 possible sizes - 6 or 10 bytes, which means extended header can take 10 or 14 bytes.
+          4 + NumberUtil.convert_string_to_32bit_integer(v2_extended_header_size_bytes)
+        else
+          SynchsafeInteger.decode(NumberUtil.convert_string_to_32bit_integer(v2_extended_header_size_bytes))
+        end
       else
         0
       end

data/lib/id3tag/frame_id_advisor.rb

@@ -1,5 +1,7 @@
 module ID3Tag
   class FrameIdAdvisor
+    ANY_MAJOR_VERSION = 'x'
+
     COMMON_FRAME_IDS_BY_VERSION = {
       'v1.x' => {
         :artist => :artist,

data/lib/id3tag/frames/v2/comments_frame.rb

@@ -2,6 +2,7 @@ module  ID3Tag
   module Frames
     module  V2
       class CommentsFrame < TextFrame
+        LANGUAGE_BYTE_COUNT = 3
 
         # language code according to https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
         def language
@@ -9,11 +10,11 @@ module  ID3Tag
         end
 
         def description
-          @desciption ||= encoded_text_and_content_parts.first
+          @desciption ||= parts.first
         end
 
         def text
-          @text ||= cut_at_null_byte(encoded_text_and_content_parts.last)
+          @text ||= StringUtil.cut_at_null_byte(parts.last)
         end
 
         def content
@@ -26,23 +27,22 @@ module  ID3Tag
 
         private
 
-        def encoded_text_and_content_parts
-          @encoded_text_and_content_parts ||= encoded_text_and_content.split(NULL_BYTE)
+        def parts
+          @parts ||= encoded_content.split(StringUtil::NULL_BYTE, 2)
         end
 
-        def encoded_text_and_content
-          raw_text_and_content.encode(destination_encoding, source_encoding)
+        def encoded_content
+          content_without_encoding_byte_and_language.encode(destination_encoding, source_encoding)
         end
 
-        def raw_text_and_content
-          content_without_encoding_byte[3..-1]
+        def content_without_encoding_byte_and_language
+          content_without_encoding_byte.byteslice(LANGUAGE_BYTE_COUNT, content_without_encoding_byte.bytesize - LANGUAGE_BYTE_COUNT)
         end
 
         def get_language
-          content_without_encoding_byte[0..2].downcase
+          content_without_encoding_byte[0...LANGUAGE_BYTE_COUNT].downcase
         end
       end
     end
   end
 end
-

data/lib/id3tag/frames/v2/frame_fabricator.rb

@@ -20,6 +20,8 @@ module  ID3Tag
           case @id
           when /^(TCON|TCO)$/
             GenreFrame
+          when /^TXX$/
+            UserTextFrame
           when /^T/
             TextFrame
           when /^(COM|COMM)$/
@@ -28,6 +30,10 @@ module  ID3Tag
             UnsychronizedTranscriptionFrame
           when /^UFID$/
             UniqueFileIdFrame
+          when /^(IPL|IPLS)$/
+            InvolvedPeopleListFrame
+          when /^PRIV$/
+            PrivateFrame
           else
             BasicFrame
           end

data/lib/id3tag/frames/v2/involved_people_list_frame.rb

@@ -0,0 +1,8 @@
+module  ID3Tag
+  module Frames
+    module  V2
+      class InvolvedPeopleListFrame < TextFrame
+      end
+    end
+  end
+end

data/lib/id3tag/frames/v2/private_frame.rb

@@ -0,0 +1,8 @@
+module  ID3Tag
+  module Frames
+    module  V2
+      class PrivateFrame < UniqueFileIdFrame
+      end
+    end
+  end
+end

data/lib/id3tag/frames/v2/text_frame.rb

@@ -2,7 +2,6 @@ module  ID3Tag
   module Frames
     module  V2
       class TextFrame < BasicFrame
-        NULL_BYTE = "\x00"
         UnsupportedTextEncoding = Class.new(StandardError)
         ENCODING_MAP = {
           0b0 => Encoding::ISO8859_1,
@@ -12,22 +11,21 @@ module  ID3Tag
         }
 
         def content
-          @content ||= cut_at_null_byte(content_without_encoding_byte.encode(destination_encoding, source_encoding))
+          @content ||= StringUtil.cut_at_null_byte(encoded_content)
         end
 
-        alias inspectable_content content
-
-        def cut_at_null_byte(string)
-          string.split(NULL_BYTE, 2).first
+        def inspectable_content
+          content
         end
 
         private
 
-        def source_encoding
-          ENCODING_MAP.fetch(get_encoding_byte) { raise UnsupportedTextEncoding }
+        def encoded_content
+          content_without_encoding_byte.encode(destination_encoding, source_encoding)
         end
 
-        def current_encoding_map
+        def source_encoding
+          ENCODING_MAP.fetch(get_encoding_byte) { raise UnsupportedTextEncoding }
         end
 
         def destination_encoding

data/lib/id3tag/frames/v2/unique_file_id_frame.rb

@@ -17,7 +17,7 @@ module  ID3Tag
         private
 
         def content_split_apart_by_null_byte
-          usable_content.split("\x00", 2)
+          usable_content.split(StringUtil::NULL_BYTE, 2)
         end
       end
     end

data/lib/id3tag/frames/v2/user_text_frame.rb

@@ -0,0 +1,22 @@
+module  ID3Tag
+  module Frames
+    module  V2
+      class UserTextFrame < TextFrame
+
+        def content
+          StringUtil.cut_at_null_byte(content_parts.last)
+        end
+
+        def description
+          content_parts.first
+        end
+
+        private
+
+        def content_parts
+          @parts ||= encoded_content.split(StringUtil::NULL_BYTE, 2)
+        end
+      end
+    end
+  end
+end

data/lib/id3tag/id3_v1_frame_parser.rb

@@ -73,7 +73,7 @@ module ID3Tag
       value = ""
       limit.times do
         char = @input.getc
-        break if char == "\x00"
+        break if char == StringUtil::NULL_BYTE
         value << char
       end
       value

data/lib/id3tag/scope.rb

@@ -0,0 +1,19 @@
+module ID3Tag
+  class Scope
+    UnsupportedScopeError = Class.new(ArgumentError)
+    SUPPORTED_SCOPES = [:v1, :v2, :all]
+
+    def initialize(version)
+      raise UnsupportedScopeError unless SUPPORTED_SCOPES.include?(version)
+      if version == :all
+        @included_versions = [:v1, :v2]
+      else
+        @included_versions = [version]
+      end
+    end
+
+    def include?(version)
+      @included_versions.include?(version)
+    end
+  end
+end

data/lib/id3tag/string_util.rb

@@ -1,5 +1,7 @@
 module ID3Tag
   module StringUtil
+    NULL_BYTE = "\x00"
+
     def self.blank?(string)
       string !~ /[^[:space:]]/
     end
@@ -15,5 +17,9 @@ module ID3Tag
       unsynch.remove
       unsynch.output
     end
+
+    def self.cut_at_null_byte(string)
+      string.split(NULL_BYTE, 2).first
+    end
   end
 end

data/lib/id3tag/tag.rb

@@ -1,53 +1,49 @@
 module ID3Tag
   class Tag
-    class MultipleFrameError < StandardError; end
+    MultipleFrameError =  Class.new(StandardError)
 
     class << self
-      def read(source, version = :all)
-        new(source, version)
+      def read(source, scope = :all)
+        new(source, scope)
       end
     end
 
-    def initialize(source, version = :all)
-      @source, @version = source, version
+    def initialize(source, scope = :all)
+      @source, @scope = source, Scope.new(scope)
     end
 
-    def artist
-      get_frame_content(frame_id(:v2, :artist), frame_id(:v1, :artist))
-    end
-
-    def title
-      get_frame_content(frame_id(:v2, :title), frame_id(:v1, :title))
-    end
-
-    def album
-      get_frame_content(frame_id(:v2, :album), frame_id(:v1, :album))
-    end
+    attr_reader :source, :scope
 
-    def year
-      get_frame_content(frame_id(:v2, :year), frame_id(:v1, :year))
-    end
-
-    def track_nr
-      get_frame_content(frame_id(:v2, :track_nr), frame_id(:v1, :track_nr))
+    [:artist, :title, :album, :year, :track_nr, :genre].each do |name|
+      define_method(name) do
+        frame = first_frame_by_id(*possible_frame_ids_by_name(name))
+        frame && frame.content
+      end
     end
 
-    def genre
-      get_frame_content(frame_id(:v2, :genre), frame_id(:v1, :genre))
+    # TODO: Add Terms of use frame and Synchronised lyrics/text frame
+    [:comments, :unsychronized_transcription].each do |name|
+      define_method(name) do |lang = :eng|
+        frame = all_frames_by_id(*possible_frame_ids_by_name(name)).find { |x| x.language == lang.to_s }
+        frame && frame.content
+      end
     end
 
-    def comments
-      get_frame_content(frame_id(:v2, :comments), frame_id(:v1, :comments))
+    def first_frame_by_id(*ids)
+      first_existing_id = ids.find { |id| frame_ids.include?(id) }
+      first_existing_id && get_frame(first_existing_id)
     end
 
-    def unsychronized_transcription
-      get_frame_content(frame_id(:v2, :unsychronized_transcription))
+    def all_frames_by_id(*ids)
+      ids.inject([]) do |frames, id|
+        frames += get_frames(id)
+      end
     end
 
     def get_frame(frame_id)
       frames = get_frames(frame_id)
       if frames.count > 1
-        raise MultipleFrameError, "Could not return only one frame with id: #{frame_id}. Tag has #{frames.count} of them"
+        raise MultipleFrameError, "Could not return only one frame with id: #{frame_id}. Tag has #{frames.count} of them. Try #get_frames to get all of them"
       else
         frames.first
       end
@@ -58,7 +54,7 @@ module ID3Tag
     end
 
     def frame_ids
-      frames.map { |frame| frame.id }
+      @frame_ids ||= frames.map { |frame| frame.id }
     end
 
     def frames
@@ -66,7 +62,7 @@ module ID3Tag
     end
 
     def v2_frames
-      if audio_file.v2_tag_present? && [:v2, :all].include?(@version)
+      if audio_file.v2_tag_present? && scope.include?(:v2)
         ID3V2FrameParser.new(audio_file.v2_tag_body, audio_file.v2_tag_major_version_number).frames
       else
         []
@@ -74,39 +70,28 @@ module ID3Tag
     end
 
     def v1_frames
-      if audio_file.v1_tag_present? && [:v1, :all].include?(@version)
+      if audio_file.v1_tag_present? && scope.include?(:v1)
         ID3V1FrameParser.new(audio_file.v1_tag_body).frames
       else
         []
       end
     end
 
-    def get_frame_content(frame_id, *alt_frame_ids)
-      frame = nil
-      alt_frame_ids.unshift(frame_id).each do |frame_id|
-        frame = get_frame(frame_id)
-        break if frame
-      end
-      frame && frame.content
+    def audio_file
+      @audio_file ||= AudioFile.new(@source)
     end
 
-    private
-
-    def frame_id(version, name)
-      case version
-      when :v2
-        if audio_file.v2_tag_present?
-          FrameIdAdvisor.new(2, audio_file.v2_tag_major_version_number).advise(name)
-        end
-      when :v1
-        FrameIdAdvisor.new(1, 'x').advise(name)
-      else
-        nil
+    def possible_frame_ids_by_name(name)
+      ids = []
+      if scope.include?(:v2) && audio_file.v2_tag_present?
+        id = FrameIdAdvisor.new(2, audio_file.v2_tag_major_version_number).advise(name)
+        ids << id if id
       end
-    end
-
-    def audio_file
-      @audio_file ||= AudioFile.new(@source)
+      if scope.include?(:v1) && audio_file.v1_tag_present?
+        id = FrameIdAdvisor.new(1, FrameIdAdvisor::ANY_MAJOR_VERSION).advise(name)
+        ids << id if id
+      end
+      ids
     end
   end
 end

data/spec/id3tag_extract_tags

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby
+#
+$LOAD_PATH.unshift(File.expand_path('../lib', File.dirname(__FILE__)))
+require "id3tag"
+
+ARGV.each do |file|
+  audio_file = ID3Tag.read(File.open(file, "r")).send(:audio_file)
+  if audio_file.v1_tag_present?
+    handle = File.open(file + ".v1_tag_body", "w")
+    handle.write(audio_file.v1_tag_body)
+    handle.close
+  end
+  if audio_file.v2_tag_present?
+    handle = File.open(file + ".v2_#{audio_file.v2_tag_major_version_number}_tag_body", "w")
+    handle.write(audio_file.v2_tag_body)
+    handle.close
+  end
+end

data/spec/lib/id3tag/audio_file_spec.rb

@@ -39,7 +39,7 @@ describe ID3Tag::AudioFile do
       end
     end
     context "when extended header is present" do
-      subject { described_class.new(StringIO.new("ID3\u0003\u0000\u0040\u0000\u0000\u0000\u0011" + "\u0000\u0000\u0000\u000E" + ("\u0000" * 10) + "ABC")) }
+      subject { described_class.new(StringIO.new("ID3\u0003\u0000\u0040\u0000\u0000\u0000\u0011" + "\u0000\u0000\u0000\u000A" + ("\u0000" * 10) + "ABC")) }
       it "should return frame and padding bytes" do
         subject.v2_tag_body.should == "ABC"
       end

data/spec/lib/id3tag/id3_v1_frame_parser_spec.rb

@@ -60,4 +60,12 @@ describe ID3Tag::ID3V1FrameParser do
       end
     end
   end
+
+  describe "Test with real-world tag" do
+    let(:tag_body) { File.read mp3_fixture("pov_20131018-2100a.mp3.v1_tag_body") }
+    subject { described_class.new(tag_body) }
+    it "have title" do
+      subject.frames.find { |f| f.id == :title }.content.should eq("pov_20131018-2100a.mp3")
+    end
+  end
 end

data/spec/lib/id3tag/tag_spec.rb

@@ -3,56 +3,6 @@ require "spec_helper"
 describe ID3Tag::Tag do
   describe "class method #read"
 
-  context "when file has v2.4.x tag and v.1.x tag" do
-    subject { described_class.read(nil) }
-    before :each do
-      ID3Tag::AudioFile.any_instance.stub(:v2_tag_present?) { true }
-      ID3Tag::AudioFile.any_instance.stub(:v2_tag_major_version_number) { 4 }
-    end
-
-    describe "#artist" do
-      it "reads TPE1 or v1 artist" do
-        subject.should_receive(:get_frame_content).with(:TPE1, :artist).and_return('A')
-        subject.artist.should eq('A')
-      end
-    end
-
-    describe "#title" do
-      it "reads TIT2 or v1 title" do
-        subject.should_receive(:get_frame_content).with(:TIT2, :title).and_return('A')
-        subject.title.should eq('A')
-      end
-    end
-
-    describe "#album" do
-      it "reads TALB or v1 album" do
-        subject.should_receive(:get_frame_content).with(:TALB, :album).and_return('A')
-        subject.album.should eq('A')
-      end
-    end
-
-    describe "#year" do
-      it "reads TDRC or v1 year" do
-        subject.should_receive(:get_frame_content).with(:TDRC, :year).and_return('A')
-        subject.year.should eq('A')
-      end
-    end
-
-    describe "#track_nr" do
-      it "reads TRCK or v1 track_nr" do
-        subject.should_receive(:get_frame_content).with(:TRCK, :track_nr).and_return('A')
-        subject.track_nr.should eq('A')
-      end
-    end
-
-    describe "#genre" do
-      it "reads TCON or v1 genre" do
-        subject.should_receive(:get_frame_content).with(:TCON, :genre).and_return('A')
-        subject.genre.should eq('A')
-      end
-    end
-  end
-
   describe "#get_frame" do
     subject { described_class.read(nil) }
     context "when more that one frame by that ID exists" do
@@ -219,46 +169,81 @@ describe ID3Tag::Tag do
     end
   end
 
-  describe "#get_frame_content" do
-    subject { described_class.read(nil, :all) }
-    let(:frame_1) { ID3Tag::Frames::V1::TextFrame.new(:some_id, 'some content') }
-    let(:frame_2) { ID3Tag::Frames::V1::TextFrame.new(:some_other_id, 'some other content') }
-    context "with one ID as argument" do
-      context "when frame with ID exists" do
-        before :each do
-          subject.stub(:get_frame).with(:some_id) { frame_1 }
-        end
-        it "should return frame" do
-          subject.get_frame_content(:some_id).should == 'some content'
-        end
-      end
-      context "when frame with ID does not exists" do
-        before :each do
-          subject.stub(:get_frame).with(:some_id) { nil }
-        end
-        it "should return none" do
-          subject.get_frame_content(:some_id).should be_nil
-        end
-      end
-    end
-
-    context "with multiple ID as armguments" do
-      context "when first one does exist" do
-        before :each do
-          subject.stub(:get_frame).with(:some_id) { frame_1 }
-          subject.stub(:get_frame).with(:some_other_id) { frame_2 }
-        end
-        it "should return first existing frame's content" do
-          subject.get_frame_content(:some_id, :some_other_id).should eq 'some content'
-        end
-      end
-      context "when second exists" do
-        before :each do
-          subject.stub(:get_frame).with(:some_id) { nil }
-          subject.stub(:get_frame).with(:some_other_id) { frame_2 }
-        end
-        it "should return first existing frame's content" do
-          subject.get_frame_content(:some_id, :some_other_id).should eq 'some other content'
+  describe "Tests with real-world tags" do
+    let(:audio_file) { double("Fake Audio file") }
+
+    context "signals_1.mp3.v2_3_tag_body" do
+      before(:each) do
+        subject.stub(:audio_file) { audio_file }
+        audio_file.stub({
+          :v1_tag_present? => true,
+          :v2_tag_present? => true,
+          :v2_tag_body => File.read(mp3_fixture("signals_1.mp3.v2_3_tag_body")),
+          :v2_tag_major_version_number => 3
+        })
+      end
+      context "Reading only v2" do
+        subject { described_class.new(nil, :v2) }
+        its(:artist) { should eq("Sabled Sun") }
+        its(:title) { should eq("Sabled Sun - Signals I") }
+        its(:album) { should eq("Signals I") }
+        its(:year) { should eq("2013") }
+        its(:track_nr) { should eq "1" }
+        its(:genre) { should eq "Jazz" }
+        its(:comments) { should eq("Visit http://cryochamber.bandcamp.com") }
+        it "should return eng comment" do
+          subject.comments(:eng).should eq("Visit http://cryochamber.bandcamp.com")
+        end
+        it "should read private frames" do
+          subject.get_frames(:PRIV).find { |f| f.owner_identifier == "WM/MediaClassPrimaryID" }.should be_kind_of(ID3Tag::Frames::V2::PrivateFrame)
+        end
+      end
+    end
+
+    context "pov_20131018-2100a.mp3" do
+      before(:each) do
+        subject.stub(:audio_file) { audio_file }
+        audio_file.stub({
+          :v1_tag_present? => true,
+          :v2_tag_present? => true,
+          :v1_tag_body => File.read(mp3_fixture("pov_20131018-2100a.mp3.v1_tag_body")),
+          :v2_tag_body => File.read(mp3_fixture("pov_20131018-2100a.mp3.v2_3_tag_body")),
+          :v2_tag_major_version_number => 3
+        })
+      end
+      context "Reading only v1" do
+        subject { described_class.new(nil, :v1) }
+        its(:artist) { should eq("") }
+        its(:title) { should eq("pov_20131018-2100a.mp3") }
+        its(:album) { should eq("") }
+        its(:year) { should eq("") }
+        its(:track_nr) { should be_nil }
+        its(:genre) { should eq("Blues") }
+        its(:comments) { should be_nil }
+        its(:frame_ids) { should eq [:title, :artist, :album, :year, :comments, :genre] }
+      end
+      context "Reading only v2" do
+        subject { described_class.new(nil, :v2) }
+        its(:artist) { should eq("BBC Radio 4") }
+        its(:title) { should eq("PoV: Lisa Jardine: Machine Intelligence: 18 Oct 13") }
+        its(:album) { should eq("A Point of View") }
+        its(:year) { should eq("2013") }
+        its(:track_nr) { should be_nil }
+        it "should return nil for genre as this tag have incorect genre frame" do
+          subject.genre.should eq("")
+        end
+        its(:comments) { should eq("Lisa Jardine compares the contributions of Ada Lovelace and Alan Turing a century later to computer science and contrasts their views on the potential of and limits to machine intelligence. \r\nProducer: Sheila Cook") }
+        it "should return eng comment" do
+          subject.comments(:eng).should eq("Lisa Jardine compares the contributions of Ada Lovelace and Alan Turing a century later to computer science and contrasts their views on the potential of and limits to machine intelligence. \r\nProducer: Sheila Cook")
+        end
+        it "should return blank string for latvian comments" do
+          subject.comments(:lav).should be_nil
+        end
+        its(:frame_ids) { should eq [:TALB, :TPE1, :COMM, :USLT, :TCON, :TIT2, :TYER, :TCOP, :APIC] }
+        it "should have comments frame with short desc and language code" do
+          subject.get_frames(:COMM).size.should eq(1)
+          subject.get_frame(:COMM).language.should eq("eng")
+          subject.get_frame(:COMM).description.should eq("")
         end
       end
     end

data/tags

@@ -26,8 +26,12 @@ Frames	lib/id3tag/frames/v2/genre_frame.rb	/^  module Frames$/;"	m	class:ID3Tag
 Frames	lib/id3tag/frames/v2/genre_frame/genre_parser.rb	/^  module Frames$/;"	m	class:ID3Tag
 Frames	lib/id3tag/frames/v2/genre_frame/genre_parser_24.rb	/^  module Frames$/;"	m	class:ID3Tag
 Frames	lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24.rb	/^  module Frames$/;"	m	class:ID3Tag
+Frames	lib/id3tag/frames/v2/involved_people_list.rb	/^  module Frames$/;"	m	class:ID3Tag
+Frames	lib/id3tag/frames/v2/involved_people_list_frame.rb	/^  module Frames$/;"	m	class:ID3Tag
+Frames	lib/id3tag/frames/v2/private_frame.rb	/^  module Frames$/;"	m	class:ID3Tag
 Frames	lib/id3tag/frames/v2/text_frame.rb	/^  module Frames$/;"	m	class:ID3Tag
 Frames	lib/id3tag/frames/v2/unique_file_id_frame.rb	/^  module Frames$/;"	m	class:ID3Tag
+Frames	lib/id3tag/frames/v2/user_text_frame.rb	/^  module Frames$/;"	m	class:ID3Tag
 GenreFrame	lib/id3tag/frames/v1/genre_frame.rb	/^      class GenreFrame$/;"	c	class:ID3Tag.Frames.V1
 GenreFrame	lib/id3tag/frames/v2/genre_frame.rb	/^      class GenreFrame < BasicFrame$/;"	c	class:ID3Tag.Frames.V2
 GenreFrame	lib/id3tag/frames/v2/genre_frame/genre_parser.rb	/^      class GenreFrame$/;"	c	class:ID3Tag.Frames.V2
@@ -54,22 +58,32 @@ ID3Tag	lib/id3tag/frames/v2/genre_frame.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/frames/v2/genre_frame/genre_parser.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/frames/v2/genre_frame/genre_parser_24.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24.rb	/^module ID3Tag$/;"	m
+ID3Tag	lib/id3tag/frames/v2/involved_people_list.rb	/^module  ID3Tag$/;"	m
+ID3Tag	lib/id3tag/frames/v2/involved_people_list_frame.rb	/^module  ID3Tag$/;"	m
+ID3Tag	lib/id3tag/frames/v2/private_frame.rb	/^module  ID3Tag$/;"	m
 ID3Tag	lib/id3tag/frames/v2/text_frame.rb	/^module  ID3Tag$/;"	m
 ID3Tag	lib/id3tag/frames/v2/unique_file_id_frame.rb	/^module  ID3Tag$/;"	m
+ID3Tag	lib/id3tag/frames/v2/user_text_frame.rb	/^module  ID3Tag$/;"	m
 ID3Tag	lib/id3tag/id3_v1_frame_parser.rb	/^module ID3Tag$/;"	m
+ID3Tag	lib/id3tag/id3_v2_extended_header.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/id3_v2_frame_parser.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/id3_v2_tag_header.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/number_util.rb	/^module ID3Tag$/;"	m
+ID3Tag	lib/id3tag/scope.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/string_util.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/synchsafe_integer.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/tag.rb	/^module ID3Tag$/;"	m
 ID3Tag	lib/id3tag/unsynchronization.rb	/^module ID3Tag$/;"	m
 ID3V1FrameParser	lib/id3tag/id3_v1_frame_parser.rb	/^  class ID3V1FrameParser$/;"	c	class:ID3Tag
 ID3V2FrameParser	lib/id3tag/id3_v2_frame_parser.rb	/^  class ID3V2FrameParser$/;"	c	class:ID3Tag
+ID3v2ExtendedHeader	lib/id3tag/id3_v2_extended_header.rb	/^  class ID3v2ExtendedHeader$/;"	c	class:ID3Tag
 ID3v2TagHeader	lib/id3tag/id3_v2_tag_header.rb	/^  class ID3v2TagHeader$/;"	c	class:ID3Tag
+InvolvedPeopleList	lib/id3tag/frames/v2/involved_people_list.rb	/^      class InvolvedPeopleList < TextFrame$/;"	c	class:ID3Tag.Frames.V2
+InvolvedPeopleListFrame	lib/id3tag/frames/v2/involved_people_list_frame.rb	/^      class InvolvedPeopleListFrame < TextFrame$/;"	c	class:ID3Tag.Frames.V2
 MissingGenreParser	lib/id3tag/frames/v2/genre_frame.rb	/^        class MissingGenreParser < StandardError; end$/;"	c	class:ID3Tag.Frames.V2.GenreFrame
-MultipleFrameError	lib/id3tag/tag.rb	/^    class MultipleFrameError < StandardError; end$/;"	c	class:ID3Tag.Tag
 NumberUtil	lib/id3tag/number_util.rb	/^  module NumberUtil$/;"	m	class:ID3Tag
+PrivateFrame	lib/id3tag/frames/v2/private_frame.rb	/^      class PrivateFrame < UniqueFileIdFrame$/;"	c	class:ID3Tag.Frames.V2
+Scope	lib/id3tag/scope.rb	/^  class Scope$/;"	c	class:ID3Tag
 StringUtil	lib/id3tag/string_util.rb	/^  module StringUtil$/;"	m	class:ID3Tag
 SynchsafeInteger	lib/id3tag/synchsafe_integer.rb	/^  class SynchsafeInteger$/;"	c	class:ID3Tag
 Tag	lib/id3tag/tag.rb	/^  class Tag$/;"	c	class:ID3Tag
@@ -78,6 +92,7 @@ TextFrame	lib/id3tag/frames/v2/text_frame.rb	/^      class TextFrame < BasicFram
 TrackNrFrame	lib/id3tag/frames/v1/track_nr_frame.rb	/^      class TrackNrFrame$/;"	c	class:ID3Tag.Frames.V1
 UniqueFileIdFrame	lib/id3tag/frames/v2/unique_file_id_frame.rb	/^      class UniqueFileIdFrame < BasicFrame$/;"	c	class:ID3Tag.Frames.V2
 Unsynchronization	lib/id3tag/unsynchronization.rb	/^  class Unsynchronization$/;"	c	class:ID3Tag
+UserTextFrame	lib/id3tag/frames/v2/user_text_frame.rb	/^      class UserTextFrame < TextFrame$/;"	c	class:ID3Tag.Frames.V2
 Util	lib/id3tag/frames/util/genre_names.rb	/^    module Util$/;"	m	class:ID3Tag.Frames
 V1	lib/id3tag/frames/v1/comments_frame.rb	/^    module V1$/;"	m	class:ID3Tag.Frames
 V1	lib/id3tag/frames/v1/genre_frame.rb	/^    module V1$/;"	m	class:ID3Tag.Frames
@@ -92,16 +107,19 @@ V2	lib/id3tag/frames/v2/genre_frame.rb	/^    module  V2$/;"	m	class:ID3Tag.Frame
 V2	lib/id3tag/frames/v2/genre_frame/genre_parser.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
 V2	lib/id3tag/frames/v2/genre_frame/genre_parser_24.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
 V2	lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
+V2	lib/id3tag/frames/v2/involved_people_list.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
+V2	lib/id3tag/frames/v2/involved_people_list_frame.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
+V2	lib/id3tag/frames/v2/private_frame.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
 V2	lib/id3tag/frames/v2/text_frame.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
 V2	lib/id3tag/frames/v2/unique_file_id_frame.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
+V2	lib/id3tag/frames/v2/user_text_frame.rb	/^    module  V2$/;"	m	class:ID3Tag.Frames
 additional_info_byte_count	lib/id3tag/frames/v2/basic_frame.rb	/^        def additional_info_byte_count$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 additional_info_byte_count	lib/id3tag/frames/v2/frame_flags.rb	/^        def additional_info_byte_count$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 additional_info_flags_in_effect	lib/id3tag/frames/v2/frame_flags.rb	/^        def additional_info_flags_in_effect$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 advise	lib/id3tag/frame_id_advisor.rb	/^    def advise(frame_name)$/;"	f	class:ID3Tag.FrameIdAdvisor
-album	lib/id3tag/tag.rb	/^    def album$/;"	f	class:ID3Tag
 album_frame	lib/id3tag/id3_v1_frame_parser.rb	/^    def album_frame$/;"	f	class:ID3Tag.ID3V1FrameParser
+all_frames_by_id	lib/id3tag/tag.rb	/^    def all_frames_by_id(*ids)$/;"	f	class:ID3Tag
 apply	lib/id3tag/unsynchronization.rb	/^    def apply$/;"	f	class:ID3Tag.Unsynchronization
-artist	lib/id3tag/tag.rb	/^    def artist$/;"	f	class:ID3Tag
 artist_frame	lib/id3tag/id3_v1_frame_parser.rb	/^    def artist_frame$/;"	f	class:ID3Tag.ID3V1FrameParser
 audio_file	lib/id3tag/tag.rb	/^    def audio_file$/;"	f	class:ID3Tag
 blank	lib/id3tag/string_util.rb	/^    def self.blank?(string)$/;"	F	class:ID3Tag.StringUtil
@@ -119,53 +137,59 @@ content	lib/id3tag/frames/v2/comments_frame.rb	/^        def content$/;"	f	class
 content	lib/id3tag/frames/v2/genre_frame.rb	/^        def content$/;"	f	class:ID3Tag.Frames.V2.GenreFrame
 content	lib/id3tag/frames/v2/text_frame.rb	/^        def content$/;"	f	class:ID3Tag.Frames.V2.TextFrame
 content	lib/id3tag/frames/v2/unique_file_id_frame.rb	/^        def content$/;"	f	class:ID3Tag.Frames.V2.UniqueFileIdFrame
+content	lib/id3tag/frames/v2/user_text_frame.rb	/^        def content$/;"	f	class:ID3Tag.Frames.V2.UserTextFrame
+content_parts	lib/id3tag/frames/v2/user_text_frame.rb	/^        def content_parts$/;"	f	class:ID3Tag.Frames.V2.UserTextFrame
 content_split_apart_by_null_byte	lib/id3tag/frames/v2/unique_file_id_frame.rb	/^        def content_split_apart_by_null_byte$/;"	f	class:ID3Tag.Frames.V2.UniqueFileIdFrame
 content_without_encoding_byte	lib/id3tag/frames/v2/text_frame.rb	/^        def content_without_encoding_byte$/;"	f	class:ID3Tag.Frames.V2.TextFrame
+content_without_encoding_byte_and_language	lib/id3tag/frames/v2/comments_frame.rb	/^        def content_without_encoding_byte_and_language$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
 convert_32bit_integer_to_string	lib/id3tag/number_util.rb	/^    def self.convert_32bit_integer_to_string(integer)$/;"	F	class:ID3Tag.NumberUtil
 convert_string_to_32bit_integer	lib/id3tag/number_util.rb	/^    def self.convert_string_to_32bit_integer(string)$/;"	F	class:ID3Tag.NumberUtil
 current_additional_info_map	lib/id3tag/frames/v2/frame_flags.rb	/^        def current_additional_info_map$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
-current_encoding_map	lib/id3tag/frames/v2/text_frame.rb	/^        def current_encoding_map$/;"	f	class:ID3Tag.Frames.V2.TextFrame
 current_flag_map	lib/id3tag/frames/v2/frame_flags.rb	/^        def current_flag_map$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
-cut_at_null_byte	lib/id3tag/frames/v2/text_frame.rb	/^        def cut_at_null_byte(string)$/;"	f	class:ID3Tag.Frames.V2.TextFrame
+cut_at_null_byte	lib/id3tag/string_util.rb	/^    def self.cut_at_null_byte(string)$/;"	F	class:ID3Tag.StringUtil
 data_length_indicator?	lib/id3tag/frames/v2/basic_frame.rb	/^        def data_length_indicator?$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 data_length_indicator?	lib/id3tag/frames/v2/frame_flags.rb	/^        def data_length_indicator?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 decode	lib/id3tag/synchsafe_integer.rb	/^      def decode(synchsafe_int)$/;"	f	class:ID3Tag.SynchsafeInteger.encode
 desciption	lib/id3tag/frames/v1/comments_frame.rb	/^        def desciption$/;"	f	class:ID3Tag.Frames.V1.CommentsFrame
 description	lib/id3tag/frames/v2/comments_frame.rb	/^        def description$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
+description	lib/id3tag/frames/v2/user_text_frame.rb	/^        def description$/;"	f	class:ID3Tag.Frames.V2.UserTextFrame
 destination_encoding	lib/id3tag/frames/v1/text_frame.rb	/^        def destination_encoding$/;"	f	class:ID3Tag.Frames.V1.TextFrame
 destination_encoding	lib/id3tag/frames/v2/text_frame.rb	/^        def destination_encoding$/;"	f	class:ID3Tag.Frames.V2.TextFrame
 do_unsynchronization	lib/id3tag/string_util.rb	/^    def self.do_unsynchronization(input)$/;"	F	class:ID3Tag.StringUtil
 encode	lib/id3tag/synchsafe_integer.rb	/^      def encode(int)$/;"	f	class:ID3Tag.SynchsafeInteger
-encoded_text_and_content	lib/id3tag/frames/v2/comments_frame.rb	/^        def encoded_text_and_content$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
-encoded_text_and_content_parts	lib/id3tag/frames/v2/comments_frame.rb	/^        def encoded_text_and_content_parts$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
+encoded_content	lib/id3tag/frames/v2/comments_frame.rb	/^        def encoded_content$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
+encoded_content	lib/id3tag/frames/v2/text_frame.rb	/^        def encoded_content$/;"	f	class:ID3Tag.Frames.V2.TextFrame
 encoding_byte_from_flags	lib/id3tag/frames/v2/frame_header_flags.rb	/^        def encoding_byte_from_flags$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 encrypted?	lib/id3tag/frames/v2/basic_frame.rb	/^        def encrypted?$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 encrypted?	lib/id3tag/frames/v2/frame_flags.rb	/^        def encrypted?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 encrypted?	lib/id3tag/frames/v2/frame_header_flags.rb	/^        def encrypted?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 encryption_id	lib/id3tag/frames/v2/basic_frame.rb	/^        def encryption_id$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 expand_abbreviation	lib/id3tag/frames/v2/genre_frame/genre_parser.rb	/^          def expand_abbreviation(abbreviation)$/;"	f	class:ID3Tag.Frames.V2.GenreFrame.GenreParser
+experimental?	lib/id3tag/id3_v2_extended_header.rb	/^    def experimental?$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 experimental?	lib/id3tag/id3_v2_tag_header.rb	/^    def experimental?$/;"	f	class:ID3Tag.ID3v2TagHeader
+extended_header?	lib/id3tag/id3_v2_extended_header.rb	/^    def extended_header?$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 extended_header?	lib/id3tag/id3_v2_tag_header.rb	/^    def extended_header?$/;"	f	class:ID3Tag.ID3v2TagHeader
 fabricate	lib/id3tag/frames/v2/frame_fabricator.rb	/^          def fabricate(id, content, flags, major_version_number)$/;"	f	class:ID3Tag.Frames.V2.FrameFabricator
 fabricate	lib/id3tag/frames/v2/frame_fabricator.rb	/^        def fabricate$/;"	f	class:ID3Tag.Frames.V2
 final_size	lib/id3tag/frames/v2/basic_frame.rb	/^        def final_size$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 find_by_id	lib/id3tag/frames/util/genre_names.rb	/^        def self.find_by_id(id)$/;"	F	class:ID3Tag.Frames.Util.GenreNames
 find_position_and_length_for_additional_info	lib/id3tag/frames/v2/frame_flags.rb	/^        def find_position_and_length_for_additional_info(*methods_of_interest)$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
+first_frame_by_id	lib/id3tag/tag.rb	/^    def first_frame_by_id(*ids)$/;"	f	class:ID3Tag
 flag	lib/id3tag/frames/v2/frame_flags.rb	/^        def flag(scope, name)$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
+flags_byte	lib/id3tag/id3_v2_extended_header.rb	/^    def flags_byte$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 flags_byte	lib/id3tag/id3_v2_tag_header.rb	/^    def flags_byte$/;"	f	class:ID3Tag.ID3v2TagHeader
 flags_byte_pair	lib/id3tag/frames/v2/frame_header_flags.rb	/^        def flags_byte_pair$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 flags_for_scope	lib/id3tag/frames/v2/frame_flags.rb	/^        def flags_for_scope(scope)$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
+footer_present?	lib/id3tag/id3_v2_extended_header.rb	/^    def footer_present?$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 footer_present?	lib/id3tag/id3_v2_tag_header.rb	/^    def footer_present?$/;"	f	class:ID3Tag.ID3v2TagHeader
 frame_class	lib/id3tag/frames/v2/frame_fabricator.rb	/^        def frame_class$/;"	f	class:ID3Tag.Frames.V2
 frame_flags	lib/id3tag/frames/v2/basic_frame.rb	/^        def frame_flags$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
-frame_id	lib/id3tag/tag.rb	/^    def frame_id(version, name)$/;"	f	class:ID3Tag
 frame_id_length	lib/id3tag/id3_v2_frame_parser.rb	/^    def frame_id_length$/;"	f	class:ID3Tag.ID3V2FrameParser
 frame_ids	lib/id3tag/tag.rb	/^    def frame_ids$/;"	f	class:ID3Tag
 frames	lib/id3tag/id3_v1_frame_parser.rb	/^    def frames$/;"	f	class:ID3Tag.ID3V1FrameParser
 frames	lib/id3tag/id3_v2_frame_parser.rb	/^    def frames$/;"	f	class:ID3Tag.ID3V2FrameParser
 frames	lib/id3tag/tag.rb	/^    def frames$/;"	f	class:ID3Tag
 frames_has_flags?	lib/id3tag/id3_v2_frame_parser.rb	/^    def frames_has_flags?$/;"	f	class:ID3Tag.ID3V2FrameParser
-genre	lib/id3tag/tag.rb	/^    def genre$/;"	f	class:ID3Tag
 genre_frame	lib/id3tag/id3_v1_frame_parser.rb	/^    def genre_frame$/;"	f	class:ID3Tag.ID3V1FrameParser
 genre_parser	lib/id3tag/frames/v2/genre_frame.rb	/^        def genre_parser$/;"	f	class:ID3Tag.Frames.V2.GenreFrame
 genres	lib/id3tag/frames/v2/genre_frame.rb	/^        def genres$/;"	f	class:ID3Tag.Frames.V2.GenreFrame
@@ -173,14 +197,15 @@ genres	lib/id3tag/frames/v2/genre_frame/genre_parser.rb	/^          def genres$/
 genres	lib/id3tag/frames/v2/genre_frame/genre_parser_24.rb	/^          def genres$/;"	f	class:ID3Tag.Frames.V2.GenreFrame.GenreParser24
 genres	lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24.rb	/^          def genres$/;"	f	class:ID3Tag.Frames.V2.GenreFrame.GenreParserPre24
 get_encoding_byte	lib/id3tag/frames/v2/text_frame.rb	/^        def get_encoding_byte$/;"	f	class:ID3Tag.Frames.V2.TextFrame
+get_flags_byte	lib/id3tag/id3_v2_extended_header.rb	/^    def get_flags_byte$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 get_flags_byte	lib/id3tag/id3_v2_tag_header.rb	/^    def get_flags_byte$/;"	f	class:ID3Tag.ID3v2TagHeader
 get_frame	lib/id3tag/tag.rb	/^    def get_frame(frame_id)$/;"	f	class:ID3Tag
-get_frame_content	lib/id3tag/tag.rb	/^    def get_frame_content(frame_id, *alt_frame_ids)$/;"	f	class:ID3Tag
 get_frames	lib/id3tag/id3_v1_frame_parser.rb	/^    def get_frames$/;"	f	class:ID3Tag.ID3V1FrameParser
 get_frames	lib/id3tag/id3_v2_frame_parser.rb	/^    def get_frames$/;"	f	class:ID3Tag.ID3V2FrameParser
 get_frames	lib/id3tag/tag.rb	/^    def get_frames(frame_id)$/;"	f	class:ID3Tag
 get_genres	lib/id3tag/frames/v2/genre_frame.rb	/^        def get_genres$/;"	f	class:ID3Tag.Frames.V2.GenreFrame
 get_language	lib/id3tag/frames/v2/comments_frame.rb	/^        def get_language$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
+get_tag_size	lib/id3tag/id3_v2_extended_header.rb	/^    def get_tag_size$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 get_tag_size	lib/id3tag/id3_v2_tag_header.rb	/^    def get_tag_size$/;"	f	class:ID3Tag.ID3v2TagHeader
 get_tag_version_1_1?	lib/id3tag/id3_v1_frame_parser.rb	/^    def get_tag_version_1_1?$/;"	f	class:ID3Tag.ID3V1FrameParser
 get_v2_extended_header_size	lib/id3tag/audio_file.rb	/^    def get_v2_extended_header_size$/;"	f	class:ID3Tag.AudioFile
@@ -189,6 +214,7 @@ group_id	lib/id3tag/frames/v2/basic_frame.rb	/^        def group_id$/;"	f	class:
 grouped?	lib/id3tag/frames/v2/basic_frame.rb	/^        def grouped?$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 grouped?	lib/id3tag/frames/v2/frame_flags.rb	/^        def grouped?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 grouped?	lib/id3tag/frames/v2/frame_header_flags.rb	/^        def grouped?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
+include?	lib/id3tag/scope.rb	/^    def include?(version)$/;"	f	class:ID3Tag.Scope
 index_of_flag	lib/id3tag/frames/v2/frame_flags.rb	/^        def index_of_flag(scope, name)$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 initialize	lib/id3tag/audio_file.rb	/^    def initialize(file)$/;"	f	class:ID3Tag.AudioFile
 initialize	lib/id3tag/frame_id_advisor.rb	/^    def initialize(version, major_version)$/;"	f	class:ID3Tag.FrameIdAdvisor
@@ -201,33 +227,41 @@ initialize	lib/id3tag/frames/v2/frame_flags.rb	/^        def initialize(flag_byt
 initialize	lib/id3tag/frames/v2/frame_header_flags.rb	/^        def initialize(flag_bytes, major_version_number)$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 initialize	lib/id3tag/frames/v2/genre_frame/genre_parser.rb	/^          def initialize(genre_string)$/;"	f	class:ID3Tag.Frames.V2.GenreFrame.GenreParser
 initialize	lib/id3tag/id3_v1_frame_parser.rb	/^    def initialize(input)$/;"	f	class:ID3Tag.ID3V1FrameParser
+initialize	lib/id3tag/id3_v2_extended_header.rb	/^    def initialize(header_chunk)$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 initialize	lib/id3tag/id3_v2_frame_parser.rb	/^    def initialize(input, major_version_number)$/;"	f	class:ID3Tag.ID3V2FrameParser
 initialize	lib/id3tag/id3_v2_tag_header.rb	/^    def initialize(header_chunk)$/;"	f	class:ID3Tag.ID3v2TagHeader
-initialize	lib/id3tag/tag.rb	/^    def initialize(source, version = :all)$/;"	f	class:ID3Tag
+initialize	lib/id3tag/scope.rb	/^    def initialize(version)$/;"	f	class:ID3Tag.Scope
+initialize	lib/id3tag/tag.rb	/^    def initialize(source, scope = :all)$/;"	f	class:ID3Tag
 initialize	lib/id3tag/unsynchronization.rb	/^    def initialize(input)$/;"	f	class:ID3Tag.Unsynchronization
 input_bytes	lib/id3tag/unsynchronization.rb	/^    def input_bytes$/;"	f	class:ID3Tag.Unsynchronization
 inspect	lib/id3tag/frames/v2/basic_frame.rb	/^        def inspect$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
+inspect	lib/id3tag/id3_v2_extended_header.rb	/^    def inspect$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 inspect	lib/id3tag/id3_v2_tag_header.rb	/^    def inspect$/;"	f	class:ID3Tag.ID3v2TagHeader
 inspectable_content	lib/id3tag/frames/v2/basic_frame.rb	/^        def inspectable_content$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 inspectable_content	lib/id3tag/frames/v2/comments_frame.rb	/^        def inspectable_content$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
+inspectable_content	lib/id3tag/frames/v2/text_frame.rb	/^        def inspectable_content$/;"	f	class:ID3Tag.Frames.V2.TextFrame
 inspectable_content	lib/id3tag/frames/v2/unique_file_id_frame.rb	/^        def inspectable_content$/;"	f	class:ID3Tag.Frames.V2.UniqueFileIdFrame
 just_genres	lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24.rb	/^          def just_genres$/;"	f	class:ID3Tag.Frames.V2.GenreFrame.GenreParserPre24
 just_requirements	lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24.rb	/^          def just_requirements$/;"	f	class:ID3Tag.Frames.V2.GenreFrame.GenreParserPre24
 language	lib/id3tag/frames/v1/comments_frame.rb	/^        def language$/;"	f	class:ID3Tag.Frames.V1.CommentsFrame
 language	lib/id3tag/frames/v2/comments_frame.rb	/^        def language$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
+major_version_number	lib/id3tag/id3_v2_extended_header.rb	/^    def major_version_number$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 major_version_number	lib/id3tag/id3_v2_tag_header.rb	/^    def major_version_number$/;"	f	class:ID3Tag.ID3v2TagHeader
+minor_version_number	lib/id3tag/id3_v2_extended_header.rb	/^    def minor_version_number$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 minor_version_number	lib/id3tag/id3_v2_tag_header.rb	/^    def minor_version_number$/;"	f	class:ID3Tag.ID3v2TagHeader
 mp3_fixture	spec/support/mp3_fixtures.rb	/^def mp3_fixture(filename)$/;"	f
 output	lib/id3tag/unsynchronization.rb	/^    def output$/;"	f	class:ID3Tag.Unsynchronization
 output_bytes	lib/id3tag/unsynchronization.rb	/^    def output_bytes$/;"	f	class:ID3Tag.Unsynchronization
 owner_identifier	lib/id3tag/frames/v2/unique_file_id_frame.rb	/^        def owner_identifier$/;"	f	class:ID3Tag.Frames.V2.UniqueFileIdFrame
 padding_or_eof_reached?	lib/id3tag/id3_v2_frame_parser.rb	/^    def padding_or_eof_reached?$/;"	f	class:ID3Tag.ID3V2FrameParser
+parts	lib/id3tag/frames/v2/comments_frame.rb	/^        def parts$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
 position_and_count_of_data_length_bytes	lib/id3tag/frames/v2/basic_frame.rb	/^        def position_and_count_of_data_length_bytes$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 position_and_count_of_data_length_bytes	lib/id3tag/frames/v2/frame_flags.rb	/^        def position_and_count_of_data_length_bytes$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 position_and_count_of_encryption_id_bytes	lib/id3tag/frames/v2/basic_frame.rb	/^        def position_and_count_of_encryption_id_bytes$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 position_and_count_of_encryption_id_bytes	lib/id3tag/frames/v2/frame_flags.rb	/^        def position_and_count_of_encryption_id_bytes$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 position_and_count_of_group_id_bytes	lib/id3tag/frames/v2/basic_frame.rb	/^        def position_and_count_of_group_id_bytes$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 position_and_count_of_group_id_bytes	lib/id3tag/frames/v2/frame_flags.rb	/^        def position_and_count_of_group_id_bytes$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
+possible_frame_ids_by_name	lib/id3tag/tag.rb	/^    def possible_frame_ids_by_name(name)$/;"	f	class:ID3Tag
 preserve_on_file_alteration?	lib/id3tag/frames/v2/basic_frame.rb	/^        def preserve_on_file_alteration?$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 preserve_on_file_alteration?	lib/id3tag/frames/v2/frame_flags.rb	/^        def preserve_on_file_alteration?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 preserve_on_file_alteration?	lib/id3tag/frames/v2/frame_header_flags.rb	/^        def preserve_on_file_alteration?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
@@ -235,9 +269,8 @@ preserve_on_tag_alteration?	lib/id3tag/frames/v2/basic_frame.rb	/^        def pr
 preserve_on_tag_alteration?	lib/id3tag/frames/v2/frame_flags.rb	/^        def preserve_on_tag_alteration?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 preserve_on_tag_alteration?	lib/id3tag/frames/v2/frame_header_flags.rb	/^        def preserve_on_tag_alteration?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
 raw_content_io	lib/id3tag/frames/v2/basic_frame.rb	/^        def raw_content_io$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
-raw_text_and_content	lib/id3tag/frames/v2/comments_frame.rb	/^        def raw_text_and_content$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
-read	lib/id3tag.rb	/^  def self.read(source, version = :all)$/;"	F	class:ID3Tag
-read	lib/id3tag/tag.rb	/^      def read(source, version = :all)$/;"	f	class:ID3Tag.Tag
+read	lib/id3tag.rb	/^  def self.read(source, scope = :all)$/;"	F	class:ID3Tag
+read	lib/id3tag/tag.rb	/^      def read(source, scope = :all)$/;"	f	class:ID3Tag.Tag
 read_additional_info_byte	lib/id3tag/frames/v2/basic_frame.rb	/^        def read_additional_info_byte(position, byte_count)$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 read_from_pos_till_limit	lib/id3tag/id3_v1_frame_parser.rb	/^    def read_from_pos_till_limit(position, limit)$/;"	f	class:ID3Tag.ID3V1FrameParser
 read_from_pos_till_null_byte_or_limit	lib/id3tag/id3_v1_frame_parser.rb	/^    def read_from_pos_till_null_byte_or_limit(position, limit)$/;"	f	class:ID3Tag.ID3V1FrameParser
@@ -253,16 +286,17 @@ rewind_input	lib/id3tag/id3_v2_frame_parser.rb	/^    def rewind_input$/;"	f	clas
 source_encoding	lib/id3tag/frames/v1/text_frame.rb	/^        def source_encoding$/;"	f	class:ID3Tag.Frames.V1.TextFrame
 source_encoding	lib/id3tag/frames/v2/text_frame.rb	/^        def source_encoding$/;"	f	class:ID3Tag.Frames.V2.TextFrame
 status_byte_from_flags	lib/id3tag/frames/v2/frame_header_flags.rb	/^        def status_byte_from_flags$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
+tag_size	lib/id3tag/id3_v2_extended_header.rb	/^    def tag_size$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 tag_size	lib/id3tag/id3_v2_tag_header.rb	/^    def tag_size$/;"	f	class:ID3Tag.ID3v2TagHeader
+tag_size_bytes	lib/id3tag/id3_v2_extended_header.rb	/^    def tag_size_bytes$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 tag_size_bytes	lib/id3tag/id3_v2_tag_header.rb	/^    def tag_size_bytes$/;"	f	class:ID3Tag.ID3v2TagHeader
 tag_version_1_1?	lib/id3tag/id3_v1_frame_parser.rb	/^    def tag_version_1_1?$/;"	f	class:ID3Tag.ID3V1FrameParser
 text	lib/id3tag/frames/v1/comments_frame.rb	/^        def text$/;"	f	class:ID3Tag.Frames.V1.CommentsFrame
 text	lib/id3tag/frames/v2/comments_frame.rb	/^        def text$/;"	f	class:ID3Tag.Frames.V2.CommentsFrame
-title	lib/id3tag/tag.rb	/^    def title$/;"	f	class:ID3Tag
 title_frame	lib/id3tag/id3_v1_frame_parser.rb	/^    def title_frame$/;"	f	class:ID3Tag.ID3V1FrameParser
-track_nr	lib/id3tag/tag.rb	/^    def track_nr$/;"	f	class:ID3Tag
 track_nr_frame	lib/id3tag/id3_v1_frame_parser.rb	/^    def track_nr_frame$/;"	f	class:ID3Tag.ID3V1FrameParser
 undo_unsynchronization	lib/id3tag/string_util.rb	/^    def self.undo_unsynchronization(input)$/;"	F	class:ID3Tag.StringUtil
+unsynchronisation?	lib/id3tag/id3_v2_extended_header.rb	/^    def unsynchronisation?$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 unsynchronisation?	lib/id3tag/id3_v2_tag_header.rb	/^    def unsynchronisation?$/;"	f	class:ID3Tag.ID3v2TagHeader
 unsynchronised?	lib/id3tag/frames/v2/basic_frame.rb	/^        def unsynchronised?$/;"	f	class:ID3Tag.Frames.V2.BasicFrame
 unsynchronised?	lib/id3tag/frames/v2/frame_flags.rb	/^        def unsynchronised?$/;"	f	class:ID3Tag.Frames.V2.FrameFlags
@@ -284,7 +318,7 @@ v2_tag_minor_version_number	lib/id3tag/audio_file.rb	/^    def v2_tag_minor_vers
 v2_tag_present?	lib/id3tag/audio_file.rb	/^    def v2_tag_present?$/;"	f	class:ID3Tag.AudioFile
 v2_tag_version	lib/id3tag/audio_file.rb	/^    def v2_tag_version$/;"	f	class:ID3Tag.AudioFile
 version_ids	lib/id3tag/frame_id_advisor.rb	/^    def version_ids$/;"	f	class:ID3Tag.FrameIdAdvisor
+version_number	lib/id3tag/id3_v2_extended_header.rb	/^    def version_number$/;"	f	class:ID3Tag.ID3v2ExtendedHeader
 version_number	lib/id3tag/id3_v2_tag_header.rb	/^    def version_number$/;"	f	class:ID3Tag.ID3v2TagHeader
 version_of_interest	lib/id3tag/frame_id_advisor.rb	/^    def version_of_interest$/;"	f	class:ID3Tag.FrameIdAdvisor
-year	lib/id3tag/tag.rb	/^    def year$/;"	f	class:ID3Tag
 year_frame	lib/id3tag/id3_v1_frame_parser.rb	/^    def year_frame$/;"	f	class:ID3Tag.ID3V1FrameParser

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: id3tag
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Krists Ozols
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-22 00:00:00.000000000 Z
+date: 2013-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: debugger
@@ -143,13 +143,17 @@ files:
 - lib/id3tag/frames/v2/genre_frame/genre_parser.rb
 - lib/id3tag/frames/v2/genre_frame/genre_parser_24.rb
 - lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24.rb
+- lib/id3tag/frames/v2/involved_people_list_frame.rb
+- lib/id3tag/frames/v2/private_frame.rb
 - lib/id3tag/frames/v2/text_frame.rb
 - lib/id3tag/frames/v2/unique_file_id_frame.rb
 - lib/id3tag/frames/v2/unsychronized_transcription_frame.rb
+- lib/id3tag/frames/v2/user_text_frame.rb
 - lib/id3tag/id3_v1_frame_parser.rb
 - lib/id3tag/id3_v2_frame_parser.rb
 - lib/id3tag/id3_v2_tag_header.rb
 - lib/id3tag/number_util.rb
+- lib/id3tag/scope.rb
 - lib/id3tag/string_util.rb
 - lib/id3tag/synchsafe_integer.rb
 - lib/id3tag/tag.rb
@@ -160,6 +164,10 @@ files:
 - spec/fixtures/id3v1_with_track_nr.mp3
 - spec/fixtures/id3v1_without_track_nr.mp3
 - spec/fixtures/id3v2.mp3
+- spec/fixtures/pov_20131018-2100a.mp3.v1_tag_body
+- spec/fixtures/pov_20131018-2100a.mp3.v2_3_tag_body
+- spec/fixtures/signals_1.mp3.v2_3_tag_body
+- spec/id3tag_extract_tags
 - spec/lib/id3tag/audio_file_spec.rb
 - spec/lib/id3tag/frames/util/genre_name_by_id_finder_spec.rb
 - spec/lib/id3tag/frames/v1/comments_frame_spec.rb
@@ -211,7 +219,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.5
+rubygems_version: 2.1.10
 signing_key: 
 specification_version: 4
 summary: Native Ruby ID3 tag reader that aims for 100% covarage of ID3v2.x and ID3v1.x