taglib-ruby 0.1.0 → 0.1.1

data/README.md

@@ -14,6 +14,21 @@ to do (contributors very welcome):
 * Pre-compiled Gem for Windows
 * More coverage of the library besides ID3v2
 
+Installation
+------------
+
+Before you install the gem, make sure to have [taglib][taglib] installed
+with header files (and a C++ compiler of course):
+
+* Debian/Ubuntu: `sudo apt-get install libtag1-dev`
+* Fedora/RHEL: `sudo yum install taglib-devel`
+* Brew: `brew install taglib`
+* MacPorts: `sudo port install taglib`
+
+Then do:
+
+    gem install taglib-ruby
+
 Usage
 -----
 

data/Rakefile

@@ -16,8 +16,14 @@ require './lib/taglib/version.rb'
 Jeweler::Tasks.new do |gem|
   # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
   gem.name = "taglib-ruby"
-  gem.summary = %Q{Ruby interface for the complete taglib C++ library}
-  gem.description = File.read('README.md')
+  gem.summary = %Q{Ruby interface for the taglib C++ library}
+  gem.description = <<-DESC
+Ruby interface for the taglib C++ library.
+
+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.
+  DESC
+  gem.requirements = 'taglib (libtag1-dev in Debian/Ubuntu, taglib-devel in Fedora/RHEL)'
   gem.version = TagLib::Version::STRING
   gem.license = "MIT"
   gem.email = "robin@nibor.org"

data/ext/extconf_common.rb

@@ -12,7 +12,14 @@ if not have_library('stdc++')
 end
 
 if not have_library('tag')
-  error "You must have taglib installed in order to use taglib-ruby."
+  error <<-DESC
+You must have taglib installed in order to use taglib-ruby.
+
+Debian/Ubuntu: sudo apt-get install libtag1-dev
+Fedora/RHEL: sudo yum install taglib-devel
+Brew: brew install taglib
+MacPorts: sudo port install taglib
+DESC
 end
 
 $CFLAGS << " -DSWIG_TYPE_TABLE=taglib"

data/lib/taglib/version.rb

@@ -2,7 +2,7 @@ module TagLib
   module Version
     MAJOR = 0
     MINOR = 1
-    PATCH = 0
+    PATCH = 1
     BUILD = nil
 
     STRING = [MAJOR, MINOR, PATCH, BUILD].compact.join('.')

data/taglib-ruby.gemspec

@@ -0,0 +1,90 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "taglib-ruby"
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Robin Stocker"]
+  s.date = "2011-09-17"
+  s.description = "Ruby interface for the taglib C++ library.\n\nIn contrast to other libraries, this one wraps the C++ API using SWIG,\nnot only the minimal C API. This means that all tags can be accessed.\n"
+  s.email = "robin@nibor.org"
+  s.extensions = ["ext/taglib_base/extconf.rb", "ext/taglib_mpeg/extconf.rb", "ext/taglib_id3v2/extconf.rb"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.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",
+    "taglib-ruby.gemspec",
+    "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"
+  ]
+  s.homepage = "http://github.com/robinst/taglib-ruby"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.requirements = ["taglib (libtag1-dev in Debian/Ubuntu, taglib-devel in Fedora/RHEL)"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "Ruby interface for the taglib C++ library"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rake-compiler>, ["~> 0.7"])
+      s.add_development_dependency(%q<shoulda>, ["~> 2.11"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.9"])
+    else
+      s.add_dependency(%q<rake-compiler>, ["~> 0.7"])
+      s.add_dependency(%q<shoulda>, ["~> 2.11"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.9"])
+    end
+  else
+    s.add_dependency(%q<rake-compiler>, ["~> 0.7"])
+    s.add_dependency(%q<shoulda>, ["~> 2.11"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.9"])
+  end
+end
+

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: taglib-ruby
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: 
   segments: 
   - 0
   - 1
-  - 0
-  version: 0.1.0
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - Robin Stocker
@@ -108,44 +108,12 @@ dependencies:
   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"
+description: |
+  Ruby interface for the taglib C++ library.
+  
+  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: []
 
@@ -180,6 +148,7 @@ files:
 - lib/taglib/id3v2.rb
 - lib/taglib/mpeg.rb
 - lib/taglib/version.rb
+- taglib-ruby.gemspec
 - test/data/globe_east_540.jpg
 - test/data/sample.mp3
 - test/data/unicode.mp3
@@ -216,12 +185,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       segments: 
       - 0
       version: "0"
-requirements: []
-
+requirements: 
+- taglib (libtag1-dev in Debian/Ubuntu, taglib-devel in Fedora/RHEL)
 rubyforge_project: 
 rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
-summary: Ruby interface for the complete taglib C++ library
+summary: Ruby interface for the taglib C++ library
 test_files: []