id3_tags 0.0.2 → 0.0.3

data/README.md

@@ -1,32 +1,46 @@
 What is ID3 Tags
 ================
 
-A ruby gem to read and write ID3 metadata from/to MP3 files}
+A ruby gem to read and write ID3 metadata from/to MP3/M4A files
+
+[![Build Status](https://travis-ci.org/topspin/id3_tags.png)](https://travis-ci.org/topspin/id3_tags)
 
 Why ID3 Tags was born
-=======================
+=====================
 
 At [Topspin](http://topspinmedia.com) we provide [ArtistLink](http://artistlink.com), a platform for musician to upload and share their songs.
 Artistlink provides a form to read and edit the songs' metadata and stores this information in the ID3 tags of a song.
 For this task, we created the ID3 Tags gem
 
-How to install
-==============
+Requirements
+============
+
+ID3 Tags depends on the [TagLib library](http://taglib.github.io).
+If you don't have TagLib >= 1.7.2 installed, ID3 Tags will ask to install it.
+
+How to use from the command line
+================================
 
-Run `gem install id3_tags`.
-Alternatively, you can include `id3_tags` in the Gemfile of your bundled project.
+Install by running `gem install id3_tags`.
 
-How to use
-==========
+Type `id3_tags` followed by the path of a local file.
+This is will show the ID3 metadata of that file.
 
+How to use from other programs
+==============================
+
+* Include `id3_tags` in the Gemfile of your bundled project and `bundle install`
 * To read metadata from a file, run `Id3Tags.read_from_file(file_path)`
 * To write metadata to a file, run `Id3Tags.write_to_file(file_path, metadata)`
 
 For more details about the format of the metadata, check the [specs](http://github.com/topspin/id3_tags/tree/master/spec/lib) or the [documentation at RubyDoc.info](http://rubydoc.info/github/topspin/id3_tags/frames).
 
+
 How to contribute
 =================
 
 Make sure tests pass, then either submit a Pull Request.
+Please consider testing against the [versions of Ruby supported](https://travis-ci.org/topspin/id3_tags) by ID3 Tags.
+
 A list of [nice TODOs](http://github.com/topspin/id3_tags/tree/master/TODO.md) is provided.
 You can also build a new version of the gem and move it to your gem repository.

data/ext/extconf.rb

@@ -0,0 +1,36 @@
+# Check that Taglib >= 1.7.2 is installed. The easiest way to find the
+# version of the installed TagLib (if present) is through `taglib-config`
+require 'mkmf'
+
+def error(msg)
+  message msg + "\n"
+  abort
+end
+
+taglib_bin = find_executable 'taglib-config'
+taglib_version = `#{taglib_bin} --version`.chomp if taglib_bin
+
+if taglib_bin.nil? || taglib_version < '1.7.2'
+  error <<-DESC
+
+\e[31mYou must have TagLib >= 1.7.2 installed in order to use taglib-ruby.\e[0m
+
+Please download and compile the source from http://taglib.github.io.
+Alternatively, you can install TagLib on OS X by running:
+
+  \e[35mbrew install taglib\e[0m
+
+Or you can install TagLib on Ubuntu 12 or higher by running:
+
+  \e[35msudo add-apt-repository -y ppa:kubuntu-ppa/backports\e[0m
+  \e[35msudo apt-get update\e[0m
+  \e[35msudo apt-get -y install libtag1-dev\e[0m
+
+The add-apt-repository is required given that the default Ubuntu repositories
+provide version 1.7.1 of TagLib, which does not fully support MP4 and M4A files
+(see http://git.io/aureUA).
+
+DESC
+end
+
+create_makefile('id3_tags')

data/lib/id3_tags/version.rb

@@ -1,3 +1,3 @@
 module Id3Tags
-  VERSION = '0.0.2'
+  VERSION = '0.0.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: id3_tags
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-15 00:00:00.000000000 Z
+date: 2013-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: taglib-ruby
@@ -144,7 +144,8 @@ email:
 - claudio@topspinmedia.com
 executables:
 - id3_tags
-extensions: []
+extensions:
+- ext/extconf.rb
 extra_rdoc_files: []
 files:
 - bin/id3_tags
@@ -154,6 +155,7 @@ files:
 - lib/id3_tags.rb
 - MIT-LICENSE
 - README.md
+- ext/extconf.rb
 homepage: https://github.com/topspin/id3_tags
 licenses:
 - MIT
@@ -166,10 +168,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
-      segments:
-      - 0
-      hash: -2869380124724698312
+      version: 1.9.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -178,8 +177,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2869380124724698312
-requirements: []
+      hash: -2525239657657117389
+requirements:
+- taglib >= 1.7.2 (libtag1-dev in Debian/Ubuntu, taglib-devel in Fedora/RHEL)
 rubyforge_project: 
 rubygems_version: 1.8.23
 signing_key: