taglib-ruby 0.1.0

data/test/test_id3v2_write.rb

@@ -0,0 +1,95 @@
+require 'helper'
+
+require 'fileutils'
+
+class TestID3v2Write < Test::Unit::TestCase
+
+  SAMPLE_FILE = "test/data/sample.mp3"
+  OUTPUT_FILE = "test/data/output.mp3"
+
+  context "TagLib::MPEG::File" do
+    setup do
+      FileUtils.cp SAMPLE_FILE, OUTPUT_FILE
+      @file = TagLib::MPEG::File.new(OUTPUT_FILE, false)
+    end
+
+    should "be able to strip the tag" do
+      assert_not_nil @file.id3v2_tag
+      success = @file.strip
+      assert success
+      assert_nil @file.id3v2_tag
+    end
+
+    context "with a fresh tag" do
+      setup do
+        @file.strip
+        @tag = @file.id3v2_tag(true)
+      end
+
+      should "be able to create a new tag" do
+        assert_not_nil @tag
+        assert_equal 0, @tag.frame_list.size
+      end
+
+      should "be able to save it" do
+        success = @file.save
+        assert success
+      end
+
+      should "be able to add a new frame to it and read it back" do
+        picture_data = File.open("test/data/globe_east_540.jpg", '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::FrontCover
+
+        @tag.add_frame(apic)
+
+        success = @file.save
+        assert success
+        @file = nil
+
+        written_file = TagLib::MPEG::File.new(OUTPUT_FILE, false)
+        written_apic = written_file.id3v2_tag.frame_list("APIC").first
+        assert_equal "image/jpeg", written_apic.mime_type
+        assert_equal "desc", written_apic.description
+        assert_equal picture_data, written_apic.picture
+      end
+
+      should "be able to set field_list" do
+        tit2 = TagLib::ID3v2::TextIdentificationFrame.new("TIT2", TagLib::String::UTF8)
+        texts = ["one", "two"]
+        tit2.field_list = texts
+        assert_equal texts, tit2.field_list
+        @tag.add_frame(tit2)
+        success = @file.save
+        assert success
+      end
+
+      if HAVE_ENCODING
+        should "be able to set unicode fields" do
+          # Hello, Unicode Snowman (not in Latin1)
+          text = "Hello, \u{2603}"
+
+          # If we don't set the default text encoding to UTF-8, taglib
+          # will print a warning
+          frame_factory = TagLib::ID3v2::FrameFactory.instance
+          frame_factory.default_text_encoding = TagLib::String::UTF8
+
+          @tag.title = text
+          @file.save
+
+          assert_equal text, @tag.title
+        end
+      end
+    end
+
+    teardown do
+      @file = nil
+      FileUtils.rm OUTPUT_FILE
+    end
+  end
+end

data/test/test_tag.rb

@@ -0,0 +1,21 @@
+require 'helper'
+
+class TestTag < Test::Unit::TestCase
+  context "The sample.mp3 file" do
+    setup do
+      @fileref = TagLib::FileRef.new("test/data/sample.mp3", false)
+      @tag = @fileref.tag
+    end
+
+    should "have basic tag information" do
+      assert_equal 'Dummy Title', @tag.title
+      assert_equal 'Dummy Artist', @tag.artist
+      assert_equal 'Dummy Album', @tag.album
+      assert_equal 'Dummy Comment', @tag.comment
+      assert_equal 'Pop', @tag.genre
+      assert_equal 2000, @tag.year
+      assert_equal 1, @tag.track
+      assert_equal false, @tag.empty?
+    end
+  end
+end

metadata

@@ -0,0 +1,227 @@
+--- !ruby/object:Gem::Specification 
+name: taglib-ruby
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Robin Stocker
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-17 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 0
+        - 7
+        version: "0.7"
+  version_requirements: *id001
+  name: rake-compiler
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 2
+        - 11
+        version: "2.11"
+  version_requirements: *id002
+  name: shoulda
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  version_requirements: *id003
+  name: bundler
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 6
+        - 4
+        version: 1.6.4
+  version_requirements: *id004
+  name: jeweler
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  version_requirements: *id005
+  name: rcov
+  prerelease: false
+  type: :development
+- !ruby/object:Gem::Dependency 
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 3
+        - 9
+        version: "3.9"
+  version_requirements: *id006
+  name: rdoc
+  prerelease: false
+  type: :development
+description: "taglib-ruby\n\
+  ===========\n\n\
+  Ruby interface for the [TagLib C++ library][taglib].\n\n\
+  In contrast to other libraries, this one wraps the full C++ API using\n\
+  SWIG, not only the minimal C API. This means that all tags can be\n\
+  accessed.\n\n\
+  taglib-ruby is work in progress, here are some of the things still left\n\
+  to do (contributors very welcome):\n\n\
+  * Wrap TagLib::MPEG::Properties\n\
+  * Pre-compiled Gem for Windows\n\
+  * More coverage of the library besides ID3v2\n\n\
+  Usage\n\
+  -----\n\n\
+  Here's an example for reading an ID3v2 tag:\n\n    require 'taglib'\n\n    # Load an ID3v2 tag from a file\n    file = TagLib::MPEG::File.new(\"wake_up.mp3\")\n    tag = file.id3v2_tag\n\n    # Read basic attributes\n    tag.title  #=> \"Wake Up\"\n    tag.artist  #=> \"Arcade Fire\"\n    tag.track  #=> 7\n\n    # Access all frames\n    tag.frame_list.size  #=> 13\n\n    # Track frame\n    track = tag.frame_list('TRCK').first\n    track.to_s  #=> \"7/10\"\n\n    # Attached picture frame\n    cover = tag.frame_list('APIC').first\n    cover.mime_type  #=> \"image/jpeg\"\n    cover.picture  #=> \"\\xFF\\xD8\\xFF\\xE0\\x00\\x10JFIF...\"\n\n\
+  And here's an example for writing one:\n\n    file = TagLib::MPEG::File.new(\"joga.mp3\")\n    tag = file.id3v2_tag\n\n    # Write basic attributes\n    tag.artist = \"Bj\xC3\xB6rk\"\n    tag.title = \"J\xC3\xB3ga\"\n\n    # Add attached picture frame\n    apic = TagLib::ID3v2::AttachedPictureFrame.new\n    apic.mime_type = \"image/jpeg\"\n    apic.description = \"Cover\"\n    apic.type = TagLib::ID3v2::AttachedPictureFrame::FrontCover\n    apic.picture = File.open(\"cover.jpg\", 'rb'){ |f| f.read }\n\n    tag.add_frame(apic)\n\n    file.save\n\n\
+  ### Encoding\n\n\
+  By default, taglib stores text frames as ISO-8859-1 (Latin-1), if the\n\
+  text contains only characters that are available in that encoding. If\n\
+  not (e.g. with Cyrillic, Chinese, Japanese), it prints a warning and\n\
+  stores the text as UTF-8.\n\n\
+  When you already know that you want to store the text as UTF-8, you can\n\
+  change the default text encoding:\n\n    frame_factory = TagLib::ID3v2::FrameFactory.instance\n    frame_factory.default_text_encoding = TagLib::String::UTF8\n\n\
+  Another option is using the advanced API:\n\n    title = tag.frame_list('TIT2').first\n    title.text = \"J\xC3\xB3ga\"\n    title.text_encoding = TagLib::String::UTF8\n\n\
+  Contributing\n\
+  ------------\n\n\
+  * Check out the latest master to make sure the feature hasn't been\n  implemented or the bug hasn't been fixed yet\n\
+  * Check out the issue tracker to make sure someone already hasn't\n  requested it and/or contributed it\n\
+  * Fork the project\n\
+  * Start a feature/bugfix branch\n\
+  * Commit and push until you are happy with your contribution\n\
+  * Make sure to add tests for it. This is important so I don't break it\n  in a future version unintentionally.\n\
+  * Please try not to mess with the Rakefile, version, or history. If you\n  want to have your own version, or is otherwise necessary, that is\n  fine, but please isolate to its own commit so I can cherry-pick around\n  it.\n\n\
+  License\n\
+  -------\n\n\
+  taglib-ruby is distributed under the MIT License,\n\
+  see LICENSE.txt for details.\n\n\
+  Copyright (c) 2010, 2011 Robin Stocker.\n\n\
+  [taglib]: http://developer.kde.org/~wheeler/taglib.html\n"
+email: robin@nibor.org
+executables: []
+
+extensions: 
+- ext/taglib_base/extconf.rb
+- ext/taglib_mpeg/extconf.rb
+- ext/taglib_id3v2/extconf.rb
+extra_rdoc_files: 
+- LICENSE.txt
+- README.md
+files: 
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- ext/Rakefile
+- ext/extconf_common.rb
+- ext/taglib_base/extconf.rb
+- ext/taglib_base/includes.i
+- ext/taglib_base/taglib_base.i
+- ext/taglib_base/taglib_base_wrap.cxx
+- ext/taglib_id3v2/extconf.rb
+- ext/taglib_id3v2/taglib_id3v2.i
+- ext/taglib_id3v2/taglib_id3v2_wrap.cxx
+- ext/taglib_mpeg/extconf.rb
+- ext/taglib_mpeg/taglib_mpeg.i
+- ext/taglib_mpeg/taglib_mpeg_wrap.cxx
+- ext/valgrind-suppressions.txt
+- lib/taglib.rb
+- lib/taglib/base.rb
+- lib/taglib/id3v2.rb
+- lib/taglib/mpeg.rb
+- lib/taglib/version.rb
+- test/data/globe_east_540.jpg
+- test/data/sample.mp3
+- test/data/unicode.mp3
+- test/helper.rb
+- test/test_id3v2_frames.rb
+- test/test_id3v2_memory.rb
+- test/test_id3v2_tag.rb
+- test/test_id3v2_unicode.rb
+- test/test_id3v2_write.rb
+- test/test_tag.rb
+homepage: http://github.com/robinst/taglib-ruby
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Ruby interface for the complete taglib C++ library
+test_files: []
+