discid 1.0.0.a1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+*~
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+rvm:
+  - "1.8.7"
+  - "1.9.3"
+  - jruby-18mode # JRuby in 1.8 mode
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx-18mode
+  - rbx-19mode
+before_install:
+  - sudo apt-get update -qq
+  - sudo apt-get install -qq libdiscid0
+script: bundle exec rake test

data/.yardopts

@@ -0,0 +1 @@
+--no-private --markup markdown

data/CHANGES

@@ -0,0 +1,42 @@
+= Changelog
+== 1.0.0.a1 (2013-04-22)
+* Use FFI instead of C module
+* Completely overhauled API
+* Full support for MCN, ISRC and libdiscid feature detection
+* Renamed from mb-discid to just discid
+
+== 0.2.0 (2013-02-17)
+* Support for MCN and ISRC (requires libdiscid >= 0.3)
+
+== 0.1.5 (2011-07-02)
+* Added binding for get_webservice_url()
+* Add lib path detection, allows out-of-the-box install when your
+  libdiscid is in /usr/local (Matt Patterson)
+
+== 0.1.4 (2009-11-19)
+* Fixed calling +read+ method without argument
+
+== 0.1.3 (2009-11-19)
+* Added singleton method +sectors_to_seconds+ to convert sectors into seconds
+* Added method +seconds+ to retrieve disc length in seconds
+* Added method +track_info+ for accessing more detailed information about tracks
+* Fixed building with Ruby 1.9 (Mihaly Csomay)
+
+== 0.1.2 (2007-07-04)
+* Support the method +put+ to set the TOC information directly instead of
+  reading it from a device.
+* Fixed possible core dump if +read+ was called twice and failed the
+  second time.
+* New to_s method (returns string representation of the ID itself).
+* Complete RDoc documentation.
+
+== 0.1.1 (2007-06-03)
+* Minor changes to source to support MS compiler
+* Provide Win32 binary gem
+* Changed require of library to "require 'mb-discid'" (was "require 'DiscID'"
+  before, which was likely to cause problems)
+
+== 0.1.0 (2007-06-02)
+* Initial release
+
+$Id$

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in discid.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README.md

@@ -0,0 +1,56 @@
+# Ruby bindings for MusicBrainz libdiscid
+
+## About
+ruby-discid provides Ruby bindings for the MusicBrainz DiscID library libdiscid.
+It allows calculating DiscIDs (MusicBrainz and freedb) for Audio CDs. Additionally
+the library can extract the MCN/UPC/EAN and the ISRCs from disc.
+
+## Requirements
+* Ruby >= 1.8.6
+* Ruby-FFI
+* libdiscid >= 0.2.2
+
+## Installation
+Before installing ruby-discid make sure you have libdiscid installed. See
+http://musicbrainz.org/doc/libdiscid for more information on how to do this.
+
+Installing ruby-discid is best done using RubyGems:
+
+    gem install discid
+
+Or install it from the source tarball:
+
+    rake install
+ 
+## Usage
+### Read only the TOC
+
+    require 'discid'
+
+    device = "/dev/cdrom"
+    disc = DiscId.read(device)
+    puts disc.id
+
+### Read the TOC, MCN and ISRCs
+
+    require 'discid'
+    
+    device = "/dev/cdrom"
+    disc = DiscId.read(device, :mcn, :isrc)
+    
+    # Print information about the disc:
+    puts "DiscID      : #{disc.id}"
+    puts "FreeDB ID   : #{disc.freedb_id}"
+    puts "Total length: #{disc.seconds} seconds"
+    puts "MCN         : #{disc.mcn}"
+
+    # Print information about individual tracks:
+    disc.tracks do |track|
+      puts "Track ##{track.number}"
+      puts "  Length: %02d:%02d (%i sectors)" %
+          [track.seconds / 60, track.seconds % 60, track.sectors]
+      puts "  ISRC  : %s" % track.isrc
+    end
+
+See the documentation of {DiscId} or the files in the `examples` directory for
+more usage information.

data/Rakefile

@@ -0,0 +1,13 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'yard'
+
+desc "Run just the unit tests"
+Rake::TestTask.new(:test) do |test|
+  test.test_files = FileList['test/test*.rb']
+  test.libs = ['lib', 'ext']
+  test.warning = true
+end
+
+YARD::Rake::YardocTask.new do |t|
+end

data/changelog

@@ -0,0 +1,35 @@
+mb-discid (0.2.0-1) quantal; urgency=low
+
+  * Fixed build dependencies 
+
+ -- Philipp Wolfer <ph.wolfer@gmail.com>  Mon, 18 Feb 2013 08:59:35 +0100
+
+mb-discid (0.2.0-0) quantal; urgency=low
+
+  * New upstream release
+
+ -- Philipp Wolfer <ph.wolfer@gmail.com>  Sun, 17 Feb 2013 15:56:01 +0100
+
+mb-discid (0.1.5-0) lucid; urgency=low
+
+  * New upstream release
+
+ -- Philipp Wolfer <ph.wolfer@googlemail.com>  Sat, 02 Jul 2011 16:14:51 +0200
+
+mb-discid (0.1.4-2) lucid; urgency=low
+
+  * Fixed building on Maverick and Natty
+
+ -- Philipp Wolfer <ph.wolfer@googlemail.com>  Mon, 16 May 2011 00:05:40 +0200
+
+mb-discid (0.1.4-1) karmic; urgency=low
+
+  * New upstream release
+
+ -- Philipp Wolfer <ph.wolfer@googlemail.com>  Mon, 14 Jun 2010 23:10:51 +0200
+
+mb-discid (0.1.2-1) gutsy; urgency=low
+
+   * Initial packaging
+
+ -- Philipp Wolfer <phw@rubyforge.org>  Mon, 17 Dec 2007 22:56:57 +0100

data/discid.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'discid/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "discid"
+  spec.version       = DiscId::VERSION
+  spec.authors       = ["Philipp Wolfer"]
+  spec.email         = ["ph.wolfer@gmail.com"]
+  spec.description   = %q{ruby-discid provides Ruby bindings for the MusicBrainz DiscID library libdiscid. It allows calculating DiscIDs (MusicBrainz and freedb) for Audio CDs. Additionally the library can extract the MCN/UPC/EAN and the ISRCs from disc.}
+  spec.summary       = %q{Ruby bindings for libdiscid}
+  spec.homepage      = "https://github.com/phw/ruby-discid"
+  spec.license       = "LGPL3"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "ffi", "~> 1.6.0"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "yard"
+  spec.add_development_dependency "redcarpet"
+end

data/examples/discid.rb

@@ -0,0 +1,63 @@
+#!/usr/bin/env ruby
+#
+# Example script for DiscId.
+# 
+# This script will read the disc ID from the default device and print
+# the results. You can specify an alternate device to use by giving the
+# device's name as the first command line argument.
+# 
+# Example:
+#  ./discid.rb /dev/dvd
+
+# Just make sure we can run this example from the command
+# line even if DiscId is not yet installed properly.
+$: << 'lib/' << 'ext/' << '../ext/' << '../lib/'
+
+require 'discid'
+
+# Read the device name from the command line or use the default.
+device = $*[0] ? $*[0] : DiscId.default_device
+
+# Create a new DiscID object and read the disc information.
+# In case of errors exit the application.
+puts "Reading TOC from device '#{device}'."
+begin
+  disc = DiscId.read(device, :isrc, :mcn)
+  
+  # Instead of reading from a device we could set the TOC directly:
+  #disc = DiscId.put(1, 82255, [150, 16157, 35932, 57527])
+rescue Exception => e
+  puts e
+  exit(1)
+end
+
+# Print information about the disc:
+print <<EOF
+
+Device      : #{disc.device}
+DiscID      : #{disc.id}
+FreeDB ID   : #{disc.freedb_id}
+First track : #{disc.first_track_num}
+Last track  : #{disc.last_track_num}
+Total length: #{disc.seconds} seconds
+Sectors     : #{disc.sectors}
+MCN         : #{disc.mcn}
+
+EOF
+
+# Print information about individual tracks:
+disc.tracks do |track|
+  puts "Track ##{track.number}"
+  puts "  Length: %02d:%02d (%i sectors)" %
+      [track.seconds / 60, track.seconds % 60, track.sectors]
+  puts "  Start : %02d:%02d (sector %i)" %
+      [track.start_time / 60, track.start_time % 60, track.start_sector]
+  puts "  End   : %02d:%02d (sector %i)" %
+      [track.end_time / 60, track.end_time % 60, track.end_sector]
+  puts "  ISRC  : %s" % track.isrc
+end
+
+# Print a submission URL that can be used to submit
+# the disc ID to MusicBrainz.org.
+puts "\nSubmit via #{disc.submission_url}"
+#puts "\nWebservice #{disc.webservice_url}"

data/lib/discid.rb

@@ -0,0 +1,101 @@
+# Copyright (C) 2013 Philipp Wolfer
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require 'discid/lib'
+require 'discid/disc'
+require 'discid/version'
+
+# The DiscId module allows calculating DiscIDs (MusicBrainz and freedb)
+# for Audio CDs. Additionally the library can extract the MCN/UPC/EAN and
+# the ISRCs from disc.
+module DiscId
+
+  # Read the disc in the given CD-ROM/DVD-ROM drive extracting only the
+  # TOC and additionally specified features.
+  #
+  # This function reads the disc in the drive specified by the given device
+  # identifier. If the device is `nil`, the default device, as returned by
+  # {default_device}, is used.
+  #
+  # This function will always read the TOC, but additional features like `:mcn`
+  # and `:isrc` can be set using the features parameter. You can set multiple
+  # features.
+  # 
+  # @example Read only the TOC:
+  #     disc = DiscId.read(device)
+  #
+  # @example Read the TOC, MCN and ISRCs:
+  #     disc = DiscId.read(device, :mcn, :isrc)
+  #
+  # @raise [TypeError] `device` can not be converted to a String.
+  # @raise [Exception] Error reading from `device`. `Exception#message` contains
+  #    error details.
+  # @param device [String] The device identifier.
+  # @param *features [:mcn, :isrc] List of features to use.
+  #     `:read` is always implied.
+  # @return [Disc]
+  def self.read(device, *features)
+    disc = Disc.new
+    disc.read device, *features
+    return disc
+  end
+    
+  # Provides the TOC of a known CD.
+  #
+  # This function may be used if the TOC has been read earlier and you want to
+  # calculate the disc ID afterwards, without accessing the disc drive. 
+  #
+  # @raise [Exception] The TOC could not be set. `Exception#message`contains
+  #    error details.
+  # @param first_track [Integer] The number of the first audio track on the
+  #   disc (usually one).
+  # @param sectors [Integer] The total number of sectors on the disc.
+  # @param offsets [Array] An array with track offsets (sectors) for each track.
+  # @return [Disc]
+  def self.put(first_track, sectors, offsets)
+    disc = Disc.new
+    disc.put first_track, sectors, offsets
+    return disc
+  end
+    
+  # Return the name of the default disc drive for this operating system.
+  #
+  # @return [String] An operating system dependent device identifier
+  def self.default_device
+    Lib.default_device
+  end
+
+  # Check if a certain feature is implemented on the current platform.
+  #
+  # @param feature [:read, :mcn, :isrc]
+  # @return [Boolean] True if the feature is implemented and false if not.
+  def self.has_feature?(feature)
+    feature = feature.to_sym if feature.respond_to? :to_sym
+    result = Lib.has_feature feature if Lib::Features.symbols.include? feature
+    return result == 1
+  end
+
+  # Converts sectors to seconds.
+  # 
+  # According to the red book standard 75 sectors are one second.
+  #
+  # @private
+  # @param sectors [Integer] Number of sectors
+  # @return [Integer] The seconds
+  def self.sectors_to_seconds(sectors)
+    return (sectors.to_f / 75).round
+  end
+
+end

data/lib/discid/disc.rb

@@ -0,0 +1,188 @@
+# Copyright (C) 2013 Philipp Wolfer
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require 'ffi'
+require 'discid/lib'
+require 'discid/track_info'
+
+module DiscId
+  # This class holds information about a disc (TOC, MCN, ISRCs).
+  #
+  # Use {DiscId#read} or {DiscId#put} to initialize an instance of {Disc}.
+  class Disc
+
+    # The device from which this disc object was read.
+    attr_reader :device
+
+    # @private
+    def initialize
+      pointer = Lib.new
+      @handle = FFI::AutoPointer.new(pointer, Lib.method(:free))
+      @read = false
+    end
+
+    # @private
+    def read(device, *features)
+      @read = false
+      device = self.class.default_device if device.nil?
+      
+      if not device.respond_to? :to_s
+        raise TypeError, 'wrong argument type (expected String)'
+      end
+     
+      @device = device.to_s
+      flags = Lib.features_to_int features
+      result = Lib.read @handle, @device, flags
+
+      if result == 0
+        raise Exception, Lib.get_error_msg(@handle)
+      else
+        @read = true
+      end
+    end
+
+    # @private
+    def put(first_track, sectors, offsets)
+      @read = false
+      @device = nil
+      last_track = offsets.length - 1 + first_track
+      
+      # discid_put expects always an offsets array with exactly 100 elements.
+      FFI::MemoryPointer.new(:int, 100) do |p|
+        p.write_array_of_int([sectors] + offsets)
+        result = Lib.put @handle, first_track, last_track, p
+        
+        if result == 0
+          raise Exception, Lib.get_error_msg(@handle)
+        else
+          @read = true
+        end
+      end
+    end
+
+    # The MusicBrainz DiscID.
+    #
+    # @return [String] The DiscID or `nil` if no ID was yet read.
+    def id
+      return nil unless @read
+      return Lib.get_id @handle
+    end
+
+    # The FreeDB DiscID.
+    #
+    # @return [String] The DiscID or  `nil` if no ID was yet read.
+    def freedb_id
+      return nil unless @read
+      return Lib.get_freedb_id @handle
+    end
+    
+    # The number of the first track on this disc.
+    # 
+    # @return [Integer] The number of the first track or `nil` if no ID was yet read. 
+    def first_track_num
+      return nil unless @read
+      return Lib.get_first_track_num @handle
+    end
+
+    # The number of the last track on this disc.
+    # 
+    # @return [Integer] The number of the last track or `nil` if no ID was yet read. 
+    def last_track_num
+      return nil unless @read
+      return Lib.get_last_track_num @handle
+    end
+
+    # The length of the disc in sectors.
+    # 
+    # @return [Integer] Sectors or `nil` if no ID was yet read. 
+    def sectors
+      return nil unless @read
+      return Lib.get_sectors @handle
+    end
+
+    # The length of the disc in seconds.
+    # 
+    # @return [Integer] Seconds or `nil` if no ID was yet read. 
+    def seconds
+      DiscId.sectors_to_seconds(sectors) if @read
+    end
+
+    # The media catalogue number on the disc, if present.
+    #
+    # Requires libdiscid >= 0.5. If not supported this method will always
+    # return `nil`.
+    # 
+    # @return [String] MCN or `nil` if no ID was yet read. 
+    def mcn
+      return nil unless @read
+      return Lib.get_mcn @handle
+    end
+
+    # An URL for submitting the DiscID to MusicBrainz.
+    #
+    # The URL leads to an interactive disc submission wizard that guides the
+    # user through the process of associating this disc's DiscID with a release
+    # in the MusicBrainz database.
+    #
+    # @return [String] Submission URL
+    def submission_url
+      return nil unless @read
+      return Lib.get_submission_url @handle
+    end
+
+    # DiscID to String conversion. Same as calling the method {#id} but guaranteed
+    # to return a string.
+    #
+    # @return [String] The disc ID as a string or an empty string if no ID
+    #     was yet read.
+    def to_s
+      id.to_s
+    end
+
+    # Returns an array of {TrackInfo} objects. Each TrackInfo object contains
+    # detailed information about the track.
+    # 
+    # Returns always `nil` if no ID was yet read. The block won't be
+    # called in this case.
+    #
+    # @yield [track_info] If a block is given this method returns `nil` and
+    #     instead iterates over the block calling the block with one argument.
+    # @yieldreturn [nil]
+    # @return [Array<TrackInfo>] Array of {TrackInfo} objects.
+    def tracks
+      if @read
+        track_number = self.first_track_num - 1
+        tracks = []
+        
+        while track_number < self.last_track_num do
+          track_number += 1
+          isrc = Lib.get_track_isrc(@handle, track_number)
+          offset = Lib.get_track_offset(@handle, track_number)
+          length = Lib.get_track_length(@handle, track_number)
+          track_info = TrackInfo.new(track_number, offset, length, isrc)
+          
+          if block_given?
+            yield track_info
+          else
+            tracks << track_info
+          end
+        end
+        
+        return tracks unless block_given?
+      end
+    end
+
+  end
+end

data/lib/discid/lib.rb

@@ -0,0 +1,84 @@
+# Copyright (C) 2013 Philipp Wolfer
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require "ffi"
+
+module DiscId
+
+  # This module encapsulates the C interface for libdiscid using FFI.
+  # The Lib module is intended for internal use only and should be considered private.
+  #
+  # @private
+  module Lib
+    extend FFI::Library
+    ffi_lib %w[discid, libdiscid.so.0]
+
+    attach_function :new, :discid_new, [], :pointer
+
+    attach_function :free, :discid_free, [:pointer], :void
+  
+    # TODO: Handle old discid_read
+    attach_function :read, :discid_read_sparse, [:pointer, :string, :uint], :int
+
+    attach_function :put, :discid_put, [:pointer, :int, :int, :pointer], :int
+
+    attach_function :get_error_msg, :discid_get_error_msg, [:pointer], :string
+    
+    attach_function :get_id, :discid_get_id, [:pointer], :string
+
+    attach_function :get_freedb_id, :discid_get_freedb_id, [:pointer], :string
+
+    attach_function :get_submission_url, :discid_get_submission_url, [:pointer], :string
+    
+    attach_function :default_device, :discid_get_default_device, [], :string
+
+    attach_function :get_first_track_num, :discid_get_first_track_num, [:pointer], :int
+
+    attach_function :get_last_track_num, :discid_get_last_track_num, [:pointer], :int
+
+    attach_function :get_sectors, :discid_get_sectors, [:pointer], :int
+
+    attach_function :get_track_offset, :discid_get_track_offset, [:pointer, :int], :int
+
+    attach_function :get_track_length, :discid_get_track_length, [:pointer, :int], :int
+
+    attach_function :get_mcn, :discid_get_mcn, [:pointer], :string
+
+    attach_function :get_track_isrc, :discid_get_track_isrc, [:pointer, :int], :string
+
+    Features = enum(:feature, [:read, 1 << 0,
+                               :mcn, 1 << 1,
+                               :isrc, 1 << 2])
+
+    attach_function :has_feature, :discid_has_feature, [:feature], :int
+
+    #attach_function :get_feature_list, :discid_get_feature_list, [:pointer], :void
+    
+    attach_function :get_version_string, :discid_get_version_string, [], :string
+    
+    def self.features_to_int(features)
+      feature_flag = 0
+      features.each do |feature|
+        if feature.respond_to? :to_sym
+          feature = feature.to_sym
+          feature_flag |= self::Features[feature] if
+            self::Features.symbols.include?(feature)
+        end
+      end
+
+      return feature_flag
+    end
+  end
+end

data/lib/discid/track_info.rb

@@ -0,0 +1,129 @@
+# Copyright (C) 2008 - 2013 Philipp Wolfer
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+module DiscId
+
+  # This class holds information about a single track.
+  # 
+  # Currently this includes the following fields:
+  #
+  # * number:       The number of the track on the disc.
+  # * sectors:      Length of the track in sectors.
+  # * start_sector: Start position of the track on the disc in sectors.
+  # * end_sector:   End position of the track on the disc in sectors.
+  # * seconds:      Length of the track in seconds.
+  # * start_time:   Start position of the track on the disc in seconds.
+  # * end_time:     End position of the track on the disc in seconds.
+  # * isrc:         The track's ISRC (International Standard Recordings Code)
+  #                if available.
+  # 
+  # You can access all fields either directly or with the square bracket
+  # notation:
+  # 
+  #     track = TrackInfo.new(1, 150, 16007)
+  #     puts track.sectors   # 16007
+  #     puts track[:sectors] # 16007
+  #  
+  # @see DiscId::Disc#tracks
+  class TrackInfo
+      
+    # The number of the track on the disc.
+    #
+    # @return [Integer]
+    attr_reader :number
+    
+    # Length of the track in sectors.
+    #
+    # @return [Integer]
+    attr_reader :sectors
+    
+    # Start position of the track on the disc in sectors.
+    #
+    # @return [Integer]
+    attr_reader :start_sector
+    
+    # ISRC number of the trac
+    #
+    # @return [String]
+    attr_reader :isrc
+    
+    # Returns a new TrackInfo.
+    def initialize(number, offset, length, isrc)
+      @number = number
+      @start_sector = offset
+      @sectors = length
+      @isrc = isrc
+    end
+      
+    # End position of the track on the disc in sectors.
+    #
+    # @return [Integer]
+    def end_sector
+      start_sector + sectors
+    end
+      
+    # Length of the track in seconds.
+    #
+    # @return [Integer]
+    def seconds
+      DiscId.sectors_to_seconds(sectors)
+    end
+      
+    # Start position of the track on the disc in seconds.
+    #
+    # @return [Integer]
+    def start_time
+      DiscId.sectors_to_seconds(start_sector)
+    end
+    
+    # End position of the track on the disc in seconds.
+    #
+    # @return [Integer]
+    def end_time
+      DiscId.sectors_to_seconds(end_sector)
+    end
+      
+    # Allows access to all fields similar to accessing values in a hash.
+    # 
+    # Example:
+    #
+    #     track = TrackInfo.new(1, 150, 16007)
+    #     puts track.sectors   # 16007
+    #     puts track[:sectors] # 16007
+    def [](key)
+      if [:number, :sectors, :start_sector, :end_sector,
+          :seconds, :start_time, :end_time].include?(key.to_sym)
+        method(key).call
+      end
+    end
+    
+    # Converts the TrackInfo into a Hash.
+    #
+    # @return [Hash]
+    def to_hash
+      {
+        :sectors      => sectors,
+        :start_sector => start_sector,
+        :end_sector   => end_sector,
+        :seconds      => seconds,
+        :start_time   => start_time,
+        :end_time     => end_time,
+        :isrc         => isrc,
+      }
+    end
+    
+  end
+end

data/lib/discid/version.rb

@@ -0,0 +1,19 @@
+# Copyright (C) 2013 Philipp Wolfer
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+module DiscId
+  VERSION = "1.0.0.a1"
+end

data/test/test_discid.rb

@@ -0,0 +1,162 @@
+# Author::    Philipp Wolfer (mailto:ph.wolfer@gmail.com)
+# Copyright:: Copyright (c) 2007-2013, Philipp Wolfer
+# License::   RBrainz is free software distributed under LGPLv3.
+#             See LICENSE[file:../LICENSE.txt] for permissions.
+
+require 'test/unit'
+require 'discid'
+
+# Helper class which can't be converted into a string.
+class NotAString
+  
+  private
+  
+  def to_s
+  end
+
+end
+
+# Unit test for the MusicBrainz::DiscID class.
+class TestDiscID < Test::Unit::TestCase
+
+  def setup
+    @fiction_disc_id     = 'Wn8eRBtfLDfM0qjYPdxrz.Zjs_U-'
+    @fiction_first_track = 1
+    @fiction_last_track  = 10
+    @fiction_sectors     = 206535
+    @fiction_seconds     = 2754
+    @fiction_offsets     = [150, 18901, 39738, 59557, 79152, 100126,
+                            124833, 147278, 166336, 182560]
+    @fiction_lengths     = [18751, 20837, 19819, 19595, 20974,
+                            24707, 22445, 19058, 16224, 23975]
+  end
+
+  def teardown
+  end
+  
+  # Test reading the disc id from a device.
+  # We would need some kind of small test data to do this.
+  #def test_read
+  #  assert false, "Not implemented yet"
+  #end
+  
+  # Test how read reacts on different arguments.
+  # Those reads should all fail, but they must never cause a segmentation fault.
+  def test_read_invalid_arguments
+    assert_raise(TypeError) {DiscId.read(NotAString.new)}
+    assert_raise(Exception) {DiscId.read(1)}
+    assert_raise(Exception) {DiscId.read('invalid_device')}
+    assert_raise(Exception) {DiscId.read(:invalid_device)}
+    # assert_raise(ArgumentError) {disc.read(DiscId::DiscId.default_device,
+    #                                       'second argument')}
+  end
+  
+  # Test calculation of the disc id if the TOC information
+  # gets set by the put method.
+  # All attributes should be nil after a failure, even if there was a
+  # successfull put before.
+  def test_put
+    disc = DiscId::Disc.new
+    assert_equal nil, disc.id
+    assert_equal '', disc.to_s
+    assert_equal nil, disc.first_track_num
+    assert_equal nil, disc.last_track_num
+    assert_equal nil, disc.sectors
+    assert_equal nil, disc.seconds
+    assert_equal nil, disc.tracks
+    assert_equal nil, disc.device
+
+    # Erroneous put
+    assert_raise(Exception) {disc = DiscId.put(-1, @fiction_sectors, @fiction_offsets)}
+    assert_equal nil, disc.id
+    assert_equal '', disc.to_s
+    assert_equal nil, disc.first_track_num
+    assert_equal nil, disc.last_track_num
+    assert_equal nil, disc.sectors
+    assert_equal nil, disc.seconds
+    assert_equal nil, disc.tracks
+    assert_equal nil, disc.device
+    
+    # Second successfull put
+    assert_nothing_raised {disc = DiscId.put(@fiction_first_track, @fiction_sectors,
+                                             @fiction_offsets)}
+    assert_equal @fiction_disc_id, disc.id
+    assert_equal @fiction_disc_id, disc.to_s
+    assert_equal @fiction_first_track, disc.first_track_num
+    assert_equal @fiction_last_track, disc.last_track_num
+    assert_equal @fiction_sectors, disc.sectors
+    assert_equal @fiction_seconds, disc.seconds
+    assert_equal @fiction_offsets, disc.tracks.map{|t| t.start_sector}
+    assert_equal @fiction_lengths, disc.tracks.map{|t| t.sectors}
+    assert_equal nil, disc.device
+  end
+  
+  # Test the tracks method and TrackInfo objects
+  def test_tracks
+    disc = nil
+    
+    assert_nothing_raised {disc = DiscId.put(@fiction_first_track, @fiction_sectors,
+                                             @fiction_offsets)}
+    
+    
+    # Save a block for testing each track
+    number = 0
+    proc_test_track = lambda do |track|
+      assert_equal number + 1, track.number
+      
+      assert_equal @fiction_offsets[number], track.start_sector
+      assert_equal @fiction_lengths[number], track.sectors
+      assert_equal @fiction_offsets[number]+ @fiction_lengths[number],
+                   track.end_sector
+                   
+      assert_equal DiscId.sectors_to_seconds(@fiction_offsets[number]), track.start_time
+      assert_equal DiscId.sectors_to_seconds(@fiction_lengths[number]), track.seconds
+      assert_equal DiscId.sectors_to_seconds(
+                     @fiction_offsets[number]+ @fiction_lengths[number]),
+                     track.end_time
+      
+      assert_equal track.number, track[:number]
+      assert_equal track.sectors, track[:sectors]
+      assert_equal track.start_sector, track[:start_sector]
+      assert_equal track.end_sector, track[:end_sector]
+      assert_equal track.seconds, track[:seconds]
+      assert_equal track.start_time, track[:start_time]
+      assert_equal track.end_time, track[:end_time]
+      
+      assert_equal nil, track[:invalid_value]
+      
+      number += 1
+    end
+    
+    # Call track_info and retrieve an Array
+    track_info = []                               
+    assert_nothing_raised {track_info = disc.tracks}
+    assert track_info.is_a?(Array)
+    track_info.each(&proc_test_track)
+    assert_equal disc.last_track_num, number
+    
+    # Calling track_info directly with a given block
+    number = 0 # Reset the number of tracks (the above block is a closure, so this works)
+    assert_equal nil, disc.tracks(&proc_test_track)
+    assert_equal disc.last_track_num, number
+  end
+  
+  # Test the conversion from sectors to seconds
+  def test_sectors_to_seconds
+    assert_equal 0, DiscId.sectors_to_seconds(0)
+    assert_equal @fiction_seconds,
+                 DiscId.sectors_to_seconds(@fiction_sectors)
+  end
+
+  def test_has_feature
+    assert(DiscId.has_feature?(:read),
+           "Feature :read should be supported")
+    assert(DiscId.has_feature?("read"),
+           "Feature 'read' should be supported")
+    assert(!DiscId.has_feature?(:notafeature),
+           "Feature :notafeature should not be supported")
+    assert(!DiscId.has_feature?("notafeature"),
+           "Feature 'notafeature' should not be supported")
+  end
+  
+end

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: discid
+version: !ruby/object:Gem::Version
+  version: 1.0.0.a1
+  prerelease: 6
+platform: ruby
+authors:
+- Philipp Wolfer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ruby-discid provides Ruby bindings for the MusicBrainz DiscID library
+  libdiscid. It allows calculating DiscIDs (MusicBrainz and freedb) for Audio CDs.
+  Additionally the library can extract the MCN/UPC/EAN and the ISRCs from disc.
+email:
+- ph.wolfer@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- .yardopts
+- CHANGES
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- changelog
+- discid.gemspec
+- examples/discid.rb
+- lib/discid.rb
+- lib/discid/disc.rb
+- lib/discid/lib.rb
+- lib/discid/track_info.rb
+- lib/discid/version.rb
+- test/test_discid.rb
+homepage: https://github.com/phw/ruby-discid
+licenses:
+- LGPL3
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Ruby bindings for libdiscid
+test_files:
+- test/test_discid.rb
+has_rdoc: