taglib-ruby 0.6.0 → 0.7.0

data/test/data/Makefile

@@ -1,6 +1,6 @@
 .PHONY: all clean
 
-all:: add-relative-volume id3v1-create vorbis-create flac-create mp4-create
+all:: add-relative-volume id3v1-create vorbis-create flac-create mp4-create wav-create wav-dump
 
 add-relative-volume: add-relative-volume.cpp
 	g++ -o $@ $< -ltag -I/usr/include/taglib
@@ -17,5 +17,11 @@ flac-create: flac-create.cpp
 mp4-create: mp4-create.cpp
 	g++ -o $@ $< -ltag -I/usr/include/taglib
 
+wav-create: wav-create.cpp
+	g++ -o $@ $< -ltag -I/usr/include/taglib
+
+wav-dump: wav-dump.cpp
+	g++ -o $@ $< -ltag -I/usr/include/taglib
+
 clean::
-	-rm add-relative-volume id3v1-create vorbis-create flac-create mp4-create
+	-rm add-relative-volume id3v1-create vorbis-create flac-create mp4-create wav-create wav-dump

data/test/data/wav-create.cpp

@@ -0,0 +1,55 @@
+#include <taglib/taglib.h>
+#include <taglib/wavfile.h>
+#include <taglib/wavproperties.h>
+#include <taglib/attachedpictureframe.h>
+
+#include "get_picture_data.cpp"
+
+using namespace TagLib;
+
+
+int main(int argc, char **argv) {
+  if (argc != 2) {
+    std::cout << "usage: " << argv[0] << " file.wav" << std::endl;
+    exit(1);
+  }
+  char *filename = argv[1];
+
+  RIFF::WAV::File file(filename);
+  ID3v2::Tag *tag = file.tag();
+
+  tag->setArtist("WAV Dummy Artist Name");
+  tag->setAlbum("WAV Dummy Album Title");
+  tag->setTitle("WAV Dummy Track Title");
+  tag->setTrack(5);
+  tag->setYear(2014);
+  tag->setGenre("Jazz");
+  tag->setComment("WAV Dummy Comment");
+
+  tag->removeFrames("APIC");
+
+  ByteVector picture_data;
+  ID3v2::AttachedPictureFrame *apic;
+
+  picture_data = getPictureData("globe_east_540.jpg");
+  apic = new ID3v2::AttachedPictureFrame();
+  apic->setPicture(picture_data);
+  apic->setMimeType("image/jpeg");
+  apic->setType(ID3v2::AttachedPictureFrame::FrontCover);
+  apic->setDescription("WAV Dummy Front Cover-Art");
+  apic->setTextEncoding(String::UTF8);
+  tag->addFrame(apic);
+
+  picture_data = getPictureData("globe_east_90.jpg");
+  apic = new ID3v2::AttachedPictureFrame();
+  apic->setPicture(picture_data);
+  apic->setMimeType("image/jpeg");
+  apic->setType(ID3v2::AttachedPictureFrame::Other);
+  apic->setDescription("WAV Dummy Thumbnail");
+  apic->setTextEncoding(String::UTF8);
+  tag->addFrame(apic);
+
+  file.save();
+}
+
+// vim: set filetype=cpp sw=2 ts=2 expandtab:

data/test/data/wav-dump.cpp

@@ -0,0 +1,74 @@
+#include <taglib/taglib.h>
+#include <taglib/wavfile.h>
+#include <taglib/wavproperties.h>
+#include <taglib/attachedpictureframe.h>
+
+using namespace TagLib;
+
+
+void dump_id3v2(ID3v2::Tag *tag)
+{
+  if (!tag || tag->isEmpty())
+  {
+    std::cout << "  NO TAGS" << std::endl;
+    return;
+  }
+
+  std::cout << "  ID3v2." << tag->header()->majorVersion() << "." << tag->header()->revisionNumber() << std::endl;
+  std::cout << "    title:   '" << tag->title() << "'" << std::endl;
+  std::cout << "    artist:  '" << tag->artist() << "'" << std::endl;
+  std::cout << "    album:   '" << tag->album() << "'" << std::endl;
+  std::cout << "    track:   " << tag->track() << std::endl;
+  std::cout << "    year:    " << tag->year() << std::endl;
+  std::cout << "    genre:   '" << tag->genre() << "'" << std::endl;
+  std::cout << "    comment: '" << tag->comment() << "'" << std::endl;
+
+  std::cout << "    Frames" << std::endl;
+  const ID3v2::FrameList frameList = tag->frameList();
+  for(ID3v2::FrameList::ConstIterator it = frameList.begin(); it != frameList.end(); ++it)
+    std::cout << "      " << (*it)->frameID() << " - " << (*it)->toString() << std::endl;
+
+  const ID3v2::FrameList apicList = tag->frameList("APIC");
+  for(ID3v2::FrameList::ConstIterator it = apicList.begin(); it != apicList.end(); ++it)
+  {
+    const ID3v2::AttachedPictureFrame *apic = static_cast<ID3v2::AttachedPictureFrame *>(*it);
+    std::cout << "    Picture" << std::endl;
+    std::cout << "      type:        " << apic->type() << std::endl;
+    std::cout << "      mime_type:   '" << apic->mimeType() << "'" << std::endl;
+    std::cout << "      description: '" << apic->description() << "'" << std::endl;
+    std::cout << "      size:        " << apic->picture().size() << " bytes" << std::endl;
+  }
+}
+
+void dump_audio_properties(AudioProperties *properties)
+{
+  std::cout << "  Audio Properties" << std::endl;
+  std::cout << "    length:      " << properties->length() << " (seconds)" << std::endl;
+  std::cout << "    bitrate:     " << properties->bitrate() << " (kbits/sec)" << std::endl;
+  std::cout << "    sample_rate: " << properties->sampleRate() << " (Hz)" << std::endl;
+  std::cout << "    channels:    " << properties->channels() << std::endl;
+}
+
+void dump_wav_properties(RIFF::WAV::Properties *properties)
+{
+  std::cout << "  WAV-specific Properties" << std::endl;
+  std::cout << "    sample_width: " << properties->sampleWidth() << " (bits)" << std::endl;
+}
+
+int main(int argc, char **argv) {
+  if (argc != 2) {
+    std::cout << "usage: " << argv[0] << " file.wav" << std::endl;
+    exit(1);
+  }
+  char *filename = argv[1];
+
+  std::cout << "WAV file '" << filename << "'..." << std::endl;
+
+  RIFF::WAV::File file(filename);
+
+  dump_id3v2(file.tag());
+  dump_audio_properties(file.audioProperties());
+  dump_wav_properties(file.audioProperties());
+}
+
+// vim: set filetype=cpp sw=2 ts=2 expandtab:

data/test/file_test.rb

@@ -0,0 +1,21 @@
+require File.join(File.dirname(__FILE__), 'helper')
+
+class TestFile < Test::Unit::TestCase
+  context "The sample.mp3 file" do
+    setup do
+      @mpeg_file = TagLib::MPEG::File.new("test/data/sample.mp3", false)
+    end
+
+    context "filename" do
+      should "be the right name" do
+        assert_equal 'test/data/sample.mp3', @mpeg_file.name
+      end
+
+      if HAVE_ENCODING
+        should "have the right encoding" do
+          assert_equal Encoding.find('filesystem'), @mpeg_file.name.encoding
+        end
+      end
+    end
+  end
+end

data/test/id3v2_unknown_frames_test.rb

@@ -0,0 +1,30 @@
+require File.join(File.dirname(__FILE__), 'helper')
+
+class TestID3v2UnknownFrames < Test::Unit::TestCase
+  context "UnknownFrame" do
+    setup do
+      read_properties = false
+      @file = TagLib::MPEG::File.new("test/data/sample.mp3", read_properties)
+      @tag = @file.id3v2_tag
+    end
+
+    should "should be returned with correct class" do
+      f = TagLib::ID3v2::UnknownFrame.new("TDAT")
+      assert_not_nil f
+      @tag.add_frame(f)
+      frames = @tag.frame_list("TDAT")
+      tdat = frames.first
+      assert_not_nil tdat
+      # By looking at ID alone, it would have returned a
+      # TextIdentificationFrame. So make sure the correct
+      # class is returned here, because it would result in
+      # segfaults when calling methods on it.
+      assert_equal TagLib::ID3v2::UnknownFrame, tdat.class
+    end
+
+    teardown do
+      @file.close
+      @file = nil
+    end
+  end
+end

data/test/wav_examples_test.rb

@@ -0,0 +1,42 @@
+require File.join(File.dirname(__FILE__), 'helper')
+
+class WAVExamples < Test::Unit::TestCase
+
+  DATA_FILE_PREFIX = "test/data/wav-"
+
+  context "TagLib::RIFF::WAV::File" do
+
+    should "Run TagLib::RIFF::WAV::File examples" do
+
+
+      # Reading the title
+
+      title = TagLib::RIFF::WAV::File.open("#{DATA_FILE_PREFIX}sample.wav") do |file|
+        file.tag.title
+      end
+
+      # Reading WAV-specific audio properties
+
+      TagLib::RIFF::WAV::File.open("#{DATA_FILE_PREFIX}sample.wav") do |file|
+        file.audio_properties.sample_width  #=>  8
+      end
+
+      # Saving ID3v2 cover-art to disk
+
+      TagLib::RIFF::WAV::File.open("#{DATA_FILE_PREFIX}sample.wav") do |file|
+        id3v2_tag = file.tag
+        cover = id3v2_tag.frame_list('APIC').first
+        ext = cover.mime_type.rpartition('/')[2]
+        File.open("#{DATA_FILE_PREFIX}cover-art.#{ext}", "wb") { |f| f.write cover.picture }
+      end
+
+
+      # checks
+      assert_equal "WAV Dummy Track Title", title
+      assert_equal true, File.exist?("#{DATA_FILE_PREFIX}cover-art.jpeg")
+      FileUtils.rm("#{DATA_FILE_PREFIX}cover-art.jpeg")
+    end
+
+  end
+
+end

data/test/wav_file_test.rb

@@ -0,0 +1,96 @@
+require File.join(File.dirname(__FILE__), 'helper')
+
+class WAVFileTest < Test::Unit::TestCase
+
+  SAMPLE_FILE = "test/data/wav-sample.wav"
+  PICTURE_FILE = "test/data/globe_east_540.jpg"
+
+  context "TagLib::RIFF::WAV::File" do
+    setup do
+      @file = TagLib::RIFF::WAV::File.new(SAMPLE_FILE)
+      @tag = @file.tag
+    end
+
+    should "open" do
+      assert_not_nil @file
+    end
+
+    should "have an ID3v2 tag" do
+      assert_not_nil @tag
+      assert_equal TagLib::ID3v2::Tag, @tag.class
+    end
+
+    should "contain basic tag information" do
+      assert_equal "WAV Dummy Track Title", @tag.title
+      assert_equal "WAV Dummy Artist Name", @tag.artist
+      assert_equal "WAV Dummy Album Title", @tag.album
+      assert_equal "WAV Dummy Comment", @tag.comment
+      assert_equal "Jazz", @tag.genre
+      assert_equal 2014, @tag.year
+      assert_equal 5, @tag.track
+      assert_equal false, @tag.empty?
+    end
+
+    context "APIC frame" do
+      setup do
+        @picture_data = File.open(PICTURE_FILE, 'rb') { |f| f.read }
+        @apic = @tag.frame_list('APIC').first
+      end
+
+      should "exist" do
+        assert_not_nil @apic
+        assert_equal TagLib::ID3v2::AttachedPictureFrame, @apic.class
+      end
+
+      should "have a type" do
+        assert_equal TagLib::ID3v2::AttachedPictureFrame::FrontCover, @apic.type
+      end
+
+      should "have a mime type" do
+        assert_equal "image/jpeg", @apic.mime_type
+      end
+
+      should "have picture bytes" do
+        assert_equal 61649, @apic.picture.size
+        assert_equal @picture_data, @apic.picture
+      end
+    end
+
+    context "audio properties" do
+      setup do
+        @properties = @file.audio_properties
+      end
+
+      should "exist" do
+        assert_not_nil @properties
+      end
+
+      should "contain basic information" do
+        assert_equal 0, @properties.length
+        assert_equal 88, @properties.bitrate
+        assert_equal 11025, @properties.sample_rate
+        assert_equal 1, @properties.channels
+      end
+
+      should "contain WAV-specific information" do
+        assert_equal 8, @properties.sample_width
+      end
+    end
+
+    teardown do
+      @file.close
+      @file = nil
+    end
+  end
+
+  context "TagLib::RIFF::WAV::File.open" do
+    should "have open method" do
+      title = nil
+      TagLib::RIFF::WAV::File.open(SAMPLE_FILE, false) do |file|
+        title = file.tag.title
+      end
+      assert_equal "WAV Dummy Track Title", title
+    end
+  end
+
+end

data/test/wav_file_write_test.rb

@@ -0,0 +1,88 @@
+require File.join(File.dirname(__FILE__), 'helper')
+
+class WAVFileWriteTest < Test::Unit::TestCase
+
+  SAMPLE_FILE = "test/data/wav-sample.wav"
+  OUTPUT_FILE = "test/data/_output.wav"
+  PICTURE_FILE = "test/data/globe_east_90.jpg"
+
+  def reloaded
+    TagLib::RIFF::WAV::File.open(OUTPUT_FILE, false) do |file|
+      yield file
+    end
+  end
+
+  context "TagLib::RIFF::WAV::File" do
+    setup do
+      FileUtils.cp SAMPLE_FILE, OUTPUT_FILE
+      @file = TagLib::RIFF::WAV::File.new(OUTPUT_FILE, false)
+    end
+
+    should "be able to save the title" do
+      tag = @file.tag
+      assert_not_nil tag
+      tag.title = "New Title"
+      success = @file.save
+      assert success
+      @file.close
+      @file = nil
+
+      written_title = reloaded do |file|
+        file.tag.title
+      end
+      assert_equal "New Title", written_title
+    end
+
+    should "have one picture frame" do
+      assert_equal 2, @file.tag.frame_list('APIC').size
+    end
+
+    should "be able to remove all picture frames" do
+      @file.tag.remove_frames('APIC')
+      success = @file.save
+      assert success
+      @file.close
+      @file = nil
+
+      reloaded do |file|
+        assert_equal 0, file.tag.frame_list('APIC').size
+      end
+    end
+
+    should "be able to add a picture frame" do
+      picture_data = File.open(PICTURE_FILE, 'rb') { |f| f.read }
+
+      apic = TagLib::ID3v2::AttachedPictureFrame.new
+      apic.mime_type = "image/jpeg"
+      apic.description = "desc"
+      apic.text_encoding = TagLib::String::UTF8
+      apic.picture = picture_data
+      apic.type = TagLib::ID3v2::AttachedPictureFrame::BackCover
+
+      @file.tag.add_frame(apic)
+      success = @file.save
+      assert success
+      @file.close
+      @file = nil
+
+      reloaded do |file|
+        assert_equal 3, file.tag.frame_list('APIC').size
+      end
+
+      reloaded do |file|
+        written_apic = file.tag.frame_list("APIC")[2]
+        assert_equal "image/jpeg", written_apic.mime_type
+        assert_equal "desc", written_apic.description
+        assert_equal picture_data, written_apic.picture
+      end
+    end
+
+    teardown do
+      if @file
+        @file.close
+        @file = nil
+      end
+      FileUtils.rm OUTPUT_FILE
+    end
+  end
+end

metadata

@@ -1,107 +1,93 @@
 --- !ruby/object:Gem::Specification
 name: taglib-ruby
 version: !ruby/object:Gem::Version
-  version: 0.6.0
-  prerelease: 
+  version: 0.7.0
 platform: ruby
 authors:
 - Robin Stocker
 - Jacob Vosmaer
+- Thomas Chevereau
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-26 00:00:00.000000000 Z
+date: 2014-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
 - !ruby/object:Gem::Dependency
   name: rake-compiler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: shoulda-context
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
 - !ruby/object:Gem::Dependency
   name: kramdown
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-description: ! 'Ruby interface for the taglib C++ library, for reading and writing
-
+description: |
+  Ruby interface for the taglib C++ library, for reading and writing
   meta-data (tags) of many audio formats.
 
-
   In contrast to other libraries, this one wraps the C++ API using SWIG,
-
   not only the minimal C API. This means that all tags can be accessed.
-
-'
 email:
 - robin@nibor.org
 executables: []
@@ -114,12 +100,14 @@ extensions:
 - ext/taglib_vorbis/extconf.rb
 - ext/taglib_flac/extconf.rb
 - ext/taglib_mp4/extconf.rb
+- ext/taglib_aiff/extconf.rb
+- ext/taglib_wav/extconf.rb
 extra_rdoc_files:
 - CHANGES.md
 - LICENSE.txt
 - README.md
 files:
-- .yardopts
+- ".yardopts"
 - CHANGES.md
 - Gemfile
 - Guardfile
@@ -127,6 +115,7 @@ files:
 - README.md
 - Rakefile
 - docs/default/fulldoc/html/css/common.css
+- docs/taglib/aiff.rb
 - docs/taglib/base.rb
 - docs/taglib/flac.rb
 - docs/taglib/id3v1.rb
@@ -134,8 +123,13 @@ files:
 - docs/taglib/mp4.rb
 - docs/taglib/mpeg.rb
 - docs/taglib/ogg.rb
+- docs/taglib/riff.rb
 - docs/taglib/vorbis.rb
+- docs/taglib/wav.rb
 - ext/extconf_common.rb
+- ext/taglib_aiff/extconf.rb
+- ext/taglib_aiff/taglib_aiff.i
+- ext/taglib_aiff/taglib_aiff_wrap.cxx
 - ext/taglib_base/extconf.rb
 - ext/taglib_base/includes.i
 - ext/taglib_base/taglib_base.i
@@ -162,9 +156,13 @@ files:
 - ext/taglib_vorbis/extconf.rb
 - ext/taglib_vorbis/taglib_vorbis.i
 - ext/taglib_vorbis/taglib_vorbis_wrap.cxx
+- ext/taglib_wav/extconf.rb
+- ext/taglib_wav/taglib_wav.i
+- ext/taglib_wav/taglib_wav_wrap.cxx
 - ext/valgrind-suppressions.txt
 - ext/win.cmake
 - lib/taglib.rb
+- lib/taglib/aiff.rb
 - lib/taglib/base.rb
 - lib/taglib/flac.rb
 - lib/taglib/id3v1.rb
@@ -174,14 +172,19 @@ files:
 - lib/taglib/ogg.rb
 - lib/taglib/version.rb
 - lib/taglib/vorbis.rb
+- lib/taglib/wav.rb
 - taglib-ruby.gemspec
 - tasks/docs_coverage.rake
 - tasks/ext.rake
 - tasks/gemspec_check.rake
 - tasks/swig.rake
+- test/aiff_examples_test.rb
+- test/aiff_file_test.rb
+- test/aiff_file_write_test.rb
 - test/base_test.rb
 - test/data/Makefile
 - test/data/add-relative-volume.cpp
+- test/data/aiff-sample.aiff
 - test/data/crash.mp3
 - test/data/flac-create.cpp
 - test/data/flac.flac
@@ -197,12 +200,16 @@ files:
 - test/data/unicode.mp3
 - test/data/vorbis-create.cpp
 - test/data/vorbis.oga
-- test/helper.rb
+- test/data/wav-create.cpp
+- test/data/wav-dump.cpp
+- test/data/wav-sample.wav
+- test/file_test.rb
 - test/fileref_open_test.rb
 - test/fileref_properties_test.rb
 - test/fileref_write_test.rb
 - test/flac_file_test.rb
 - test/flac_file_write_test.rb
+- test/helper.rb
 - test/id3v1_tag_test.rb
 - test/id3v2_frames_test.rb
 - test/id3v2_header_test.rb
@@ -210,6 +217,7 @@ files:
 - test/id3v2_relative_volume_test.rb
 - test/id3v2_tag_test.rb
 - test/id3v2_unicode_test.rb
+- test/id3v2_unknown_frames_test.rb
 - test/id3v2_write_test.rb
 - test/mp4_file_test.rb
 - test/mp4_file_write_test.rb
@@ -219,37 +227,33 @@ files:
 - test/unicode_filename_test.rb
 - test/vorbis_file_test.rb
 - test/vorbis_tag_test.rb
+- test/wav_examples_test.rb
+- test/wav_file_test.rb
+- test/wav_file_write_test.rb
 homepage: http://robinst.github.io/taglib-ruby/
 licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -3989506221310826679
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -3989506221310826679
 requirements:
 - taglib (libtag1-dev in Debian/Ubuntu, taglib-devel in Fedora/RHEL)
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.2.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Ruby interface for the taglib C++ library
 test_files: []
 has_rdoc: