id3tag 0.0.0 → 0.1.0

data/spec/lib/id3tag/audio_file_spec.rb

@@ -0,0 +1,40 @@
+require "spec_helper"
+describe ID3Tag::AudioFile do
+  let(:mp3_with_v1_tag) { mp3_fixture('id3v1_without_track_nr.mp3') }
+  let(:mp3_with_v2_tag) { mp3_fixture('id3v2.mp3') }
+  let(:mp3_with_v1_and_v2_tags) { mp3_fixture('id3v1_and_v2.mp3') }
+
+  describe "Tag presence checking methods" do
+    context "reading file only with ID3v1 tag" do
+      subject { described_class.new(mp3_with_v1_tag) }
+      its(:v1_tag_present?) { should be_true }
+      its(:v2_tag_present?) { should be_false }
+    end
+
+    context "reading file only with ID3v2 tag" do
+      subject { described_class.new(mp3_with_v2_tag) }
+      its(:v1_tag_present?) { should be_false }
+      its(:v2_tag_present?) { should be_true }
+    end
+
+    context "reading file with ID3v1 and ID3v2 tags" do
+      subject { described_class.new(mp3_with_v1_and_v2_tags) }
+      its(:v1_tag_present?) { should be_true }
+      its(:v2_tag_present?) { should be_true }
+    end
+  end
+
+  describe "#v1_tag_body" do
+    subject { described_class.new(mp3_with_v1_tag) }
+    it "should return last 125 bytes of audio file" do
+      subject.v1_tag_body.should == File.read(mp3_with_v1_tag, 125, 579)
+    end
+  end
+
+  describe "#v2_tag_body" do
+    subject { described_class.new(mp3_with_v2_tag) }
+    it "should return frame and padding bytes" do
+      subject.v2_tag_body.should == File.read(mp3_with_v2_tag, 246, 10)
+    end
+  end
+end

data/spec/lib/id3tag/frames/util/genre_name_by_id_finder_spec.rb

@@ -0,0 +1,18 @@
+require "spec_helper"
+
+describe ID3Tag::Frames::Util::GenreNames do
+
+  describe 'self#find_by_id' do
+    subject { described_class.find_by_id(id) }
+
+    context "when calling with id 0 what represents Blues" do
+      let(:id) { 0 }
+      it { should eq('Blues') }
+    end
+
+    context "when calling with id 17 what represents Rock" do
+      let(:id) { 17 }
+      it { should eq('Rock') }
+    end
+  end
+end

data/spec/lib/id3tag/frames/v1/comments_frame_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+describe ID3Tag::Frames::V1::CommentsFrame do
+  describe '#id' do
+    subject { described_class.new('comments', nil).id }
+    it { should == 'comments' }
+  end
+
+  describe '#content' do
+    context 'when comment is present' do
+      subject { described_class.new('comments', 'some comment about the song').content }
+      it { should == 'some comment about the song' }
+    end
+
+    context 'when comment is not present' do
+      subject { described_class.new('comments', '').content }
+      it { should == '' }
+    end
+  end
+
+  describe '#language' do
+    it 'should be unknown' do
+      described_class.new('comments', '').language.should eq('unknown')
+    end
+  end
+
+  describe '#desciption' do
+    it 'should be unknown' do
+      described_class.new('comments', '').desciption.should eq('unknown')
+    end
+  end
+end

data/spec/lib/id3tag/frames/v1/genre_frame_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+describe ID3Tag::Frames::V1::GenreFrame do
+  describe '#id' do
+    subject { described_class.new('genre', nil).id }
+    it { should == 'genre' }
+  end
+
+  describe '#content' do
+    context 'when genre is blues' do
+      subject { described_class.new('genre', [0].pack('c')).content }
+      it { should == 'Blues' }
+    end
+
+    context 'when genre is metal' do
+      subject { described_class.new('genre', [9].pack('c')).content }
+      it { should == 'Metal' }
+    end
+  end
+end
+

data/spec/lib/id3tag/frames/v1/text_frame_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+describe ID3Tag::Frames::V1::TextFrame do
+  describe '#id' do
+    subject { described_class.new('album', nil).id }
+    it { should == 'album' }
+  end
+
+  describe '#content' do
+    context 'when containing track artist' do
+      subject { described_class.new('artist', 'some fancy artist').content }
+      it { should == 'some fancy artist' }
+    end
+  end
+end

data/spec/lib/id3tag/frames/v1/track_nr_frame_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+describe ID3Tag::Frames::V1::TrackNrFrame do
+  describe '#id' do
+    subject { described_class.new('track_nr', nil).id }
+    it { should == 'track_nr' }
+  end
+
+  describe '#content' do
+    context 'when nr is 3' do
+      subject { described_class.new('track_nr', [3].pack('c')).content }
+      it { should == '3' }
+    end
+
+    context 'when nr is 11' do
+      subject { described_class.new('track_nr', [11].pack('c')).content }
+      it { should == '11' }
+    end
+  end
+end

data/spec/lib/id3tag/frames/v2/basic_frame_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe ID3Tag::Frames::V2::BasicFrame do
+  let(:id) { 'foo' }
+  let(:raw_content) { 'bar' }
+  let(:flags) { nil }
+  let(:major_version_number) { 4 }
+  let(:frame) { described_class.new(id, raw_content, flags, major_version_number) }
+
+  describe '#id' do
+    subject { frame.id }
+    it { should == :foo }
+  end
+
+  describe '#content' do
+    subject { frame.content }
+    it { should == 'bar' }
+  end
+
+  describe '#inspect' do
+    it 'should be pretty inspectable' do
+      frame.inspect.should eq('<ID3Tag::Frames::V2::BasicFrame foo: bar>')
+    end
+  end
+end

data/spec/lib/id3tag/frames/v2/comments_frame_spec.rb

@@ -0,0 +1,45 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe ID3Tag::Frames::V2::CommentsFrame do
+  let(:id) { "COMM" }
+  let(:raw_content) do
+    text.encode(target_encoding).prepend(separator).prepend(short_desc).prepend(lang).prepend(encoding)
+  end
+  let(:separator) { "\x00".force_encoding(target_encoding) }
+  let(:short_desc) { 'bob once said'.force_encoding(target_encoding) }
+  let(:lang) { 'lav'.force_encoding(target_encoding) }
+  let(:encoding) { encoding_byte.force_encoding(target_encoding) }
+  let(:flags) { nil }
+  let(:major_version_number) { 4 }
+  let(:target_encoding) { Encoding::UTF_8 }
+  let(:encoding_byte) { "\x03" }
+  let(:text) { "Glāzšķūņrūķīši" }
+  let(:frame) { described_class.new(id, raw_content, flags, major_version_number) }
+
+  describe '#id' do
+    subject { frame.id }
+    it { should == :COMM }
+  end
+
+  describe '#content' do
+    subject { frame.content }
+    it { should == 'Glāzšķūņrūķīši' }
+  end
+
+  describe '#language' do
+    subject { frame.language }
+    it { should == 'lav' }
+  end
+
+  describe '#description' do
+    subject { frame.description }
+    it { should == 'bob once said' }
+  end
+
+  describe '#inspect' do
+    it 'should be pretty inspectable' do
+      frame.inspect.should eq('<ID3Tag::Frames::V2::CommentsFrame COMM: Glāzšķūņrūķīši>')
+    end
+  end
+end

data/spec/lib/id3tag/frames/v2/genre_frame/genre_parser_24_spec.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe ID3Tag::Frames::V2::GenreFrame::GenreParser24 do
+  describe '#genres' do
+
+    subject { described_class.new(genre_string).genres }
+
+    context "when version is 2.4" do
+      context "with remix and cover" do
+        let(:genre_string) { "RX\x00CR" }
+        it { should == ['Remix', 'Cover'] }
+      end
+      context "with refinement and number" do
+        let(:genre_string) { "ABC\x0017" }
+        it { should == ['ABC', 'Rock'] }
+      end
+      context "with one genre" do
+        let(:genre_string) { "17" }
+        it { should == ['Rock'] }
+      end
+    end
+
+  end
+end
+

data/spec/lib/id3tag/frames/v2/genre_frame/genre_parser_pre_24_spec.rb

@@ -0,0 +1,48 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe ID3Tag::Frames::V2::GenreFrame::GenreParserPre24 do
+  describe '#genres' do
+
+    subject { described_class.new(genre_string).genres }
+
+    context "without refinements" do
+      context "with one genre" do
+        let(:genre_string) { '(17)' }
+        it { should == ['Rock'] }
+      end
+      context "with multiple genres" do
+        let(:genre_string) { '(17)(18)' }
+        it { should == ['Rock', 'Techno'] }
+      end
+      context "with remix and cover" do
+        let(:genre_string) { '(RX)(CR)' }
+        it { should == ['Remix', 'Cover'] }
+      end
+    end
+    context "with refinements" do
+      context "with one genre" do
+        let(:genre_string) { '(17)qwerty' }
+        it { should == ['qwerty'] }
+      end
+      context "with miltiple genres but only 1 refinement" do
+        let(:genre_string) { '(0)(16)(17)qwerty' }
+        it { should == ['Blues', 'Reggae', 'qwerty'] }
+      end
+      context "with multiple genres" do
+        let(:genre_string) { '(17)qwerty(18)abcdef' }
+        it { should == ['qwerty', 'abcdef'] }
+      end
+    end
+    context "with refinement containing '('" do
+      context "with one genre" do
+        let(:genre_string) { '(55)((I think...)' }
+        it { should == ['(I think...)'] }
+      end
+      context "with multiple genres" do
+        let(:genre_string) { '(55)((I think...)(17)' }
+        it { should == ['(I think...)', 'Rock'] }
+      end
+    end
+  end
+end

data/spec/lib/id3tag/frames/v2/genre_frame_spec.rb

@@ -0,0 +1,44 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe ID3Tag::Frames::V2::GenreFrame do
+  let(:id) { "TCON" }
+  let(:raw_content) { "(17)" }
+  let(:flags) { nil }
+  let(:major_version_number) { 3 }
+  let(:frame) { described_class.new(id, raw_content, flags, major_version_number) }
+
+  describe '#id' do
+    subject { frame.id }
+    it { should == :TCON }
+  end
+
+  describe '#content' do
+    subject { frame.content }
+
+    context "when one genre" do
+      before do
+        ID3Tag::Frames::V2::GenreFrame::GenreParserPre24.any_instance.stub(:genres) { ['A'] }
+      end
+
+      it { should eq('A') }
+    end
+    context "when two genres" do
+      before do
+        ID3Tag::Frames::V2::GenreFrame::GenreParserPre24.any_instance.stub(:genres) { ['A', 'B'] }
+      end
+
+      it { should eq('A, B') }
+    end
+  end
+
+  describe '#inspect' do
+    before do
+      frame.stub(:content) { 'Rock' }
+    end
+
+    it 'should be pretty inspectable' do
+      frame.inspect.should eq('<ID3Tag::Frames::V2::GenreFrame TCON: Rock>')
+    end
+  end
+end

data/spec/lib/id3tag/frames/v2/text_frame_spec.rb

@@ -0,0 +1,59 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe ID3Tag::Frames::V2::TextFrame do
+  let(:id) { "artist" }
+  let(:raw_content) { text.encode(target_encoding).prepend(encoding_byte.force_encoding(target_encoding)) }
+  let(:flags) { nil }
+  let(:major_version_number) { 4 }
+
+  let(:frame) { described_class.new(id, raw_content, flags, major_version_number) }
+  let(:target_encoding) { Encoding::UTF_8 }
+  let(:encoding_byte) { "\x03" }
+  let(:text) { "Glāzšķūņrūķīši" }
+
+  describe '#id' do
+    subject { frame.id }
+    it { should == :artist }
+  end
+
+  describe '#content' do
+    subject { frame.content }
+
+    context "when encoding byte is not present" do
+      let(:encoding_byte) { "" }
+      it { expect { subject }.to raise_error(ID3Tag::Frames::V2::TextFrame::UnsupportedTextEncoding) }
+    end
+
+    context "when encoding is ISO08859_1" do
+      let(:target_encoding) { Encoding::ISO8859_1 }
+      let(:encoding_byte) { "\x00" }
+      let(:text) { "some fancy artist" }
+      it { should == 'some fancy artist' }
+    end
+
+    context "when encoding is UTF_16" do
+      let(:target_encoding) { Encoding::UTF_16 }
+      let(:encoding_byte) { "\x01" }
+      it { should == 'Glāzšķūņrūķīši' }
+    end
+
+    context "when encoding is UTF_16BE" do
+      let(:target_encoding) { Encoding::UTF_16BE }
+      let(:encoding_byte) { "\x02" }
+      it { should == 'Glāzšķūņrūķīši' }
+    end
+
+    context "when encoding is UTF_8" do
+      let(:target_encoding) { Encoding::UTF_8 }
+      let(:encoding_byte) { "\x03" }
+      it { should == 'Glāzšķūņrūķīši' }
+    end
+  end
+
+  describe '#inspect' do
+    it 'should be pretty inspectable' do
+      frame.inspect.should eq('<ID3Tag::Frames::V2::TextFrame artist: Glāzšķūņrūķīši>')
+    end
+  end
+end

data/spec/lib/id3tag/frames/v2/unique_file_id_frame_spec.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+require 'spec_helper'
+
+describe ID3Tag::Frames::V2::UniqueFileIdFrame do
+  let(:id) { "UFID" }
+  let(:raw_content) { "ZXC\x00foobar" }
+  let(:flags) { nil }
+  let(:major_version_number) { 4 }
+  let(:frame) { described_class.new(id, raw_content, flags, major_version_number) }
+
+  describe '#id' do
+    subject { frame.id }
+    it { should == :UFID }
+  end
+
+  describe '#owner_identifier' do
+    subject { frame.owner_identifier }
+    it { should == 'ZXC' }
+  end
+
+  describe '#content' do
+    subject { frame.content }
+    it { should == 'foobar' }
+  end
+
+  describe '#inspect' do
+    it 'should be pretty inspectable' do
+      frame.inspect.should eq('<ID3Tag::Frames::V2::UniqueFileIdFrame UFID: ZXC>')
+    end
+  end
+end