rubycue 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+*.swp

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2010 Blake Smith
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.rdoc

@@ -0,0 +1,48 @@
+= RubyCue: A library to parse cuesheet song files
+
+RubyCue is a Ruby interface for parsing and accessing cuesheet data.
+
+= Usage:
+
+=== Basic usage
+
+  require 'rubycue'
+
+  cuesheet = RubyCue::Cuesheet.new(File.read("cuesheet.cue"))
+  cuesheet.parse!
+  
+  cuesheet.songs.each do |song|
+    puts "#{song[:performer]} - #{song[:title]} at #{song[:index]}"
+  end
+
+=== Calculated Song Durations
+
+RubyCue will also calculate song durations. In order to calculate the last song's duration, you must pass the optional track duration (in seconds) for the entire file.
+
+  cuesheet = RubyCue::Cuesheet.new(File.read("cuesheet.cue"), 7143)
+
+=== Current Song Position
+
+After a cuesheet is instantiated, you can pass a current track position, and the cuesheet will return which song is currently playing at that position:
+
+  # with seconds
+  cuesheet.position(4352)
+   => {:index=>#<RubyCue::Index:0x101025240 @seconds=7, @minutes=71, @frames=31>, :track=>32, :performer=>"Netsky", :title=>"Iron Heart", :duration=>#<RubyCue::Index:0x10100f2d8 @seconds=55, @minutes=2, @frames=38>} 
+
+ # with an array [minutes, seconds, frames]
+ cuesheet.position([43, 23, 45])
+  => {:index=>#<RubyCue::Index:0x101027590 @seconds=27, @minutes=39, @frames=57>, :track=>19, :performer=>"Legion feat. Adam Wright", :title=>"Both Sides", :duration=>#<RubyCue::Index:0x101013130 @seconds=45, @minutes=4, @frames=13>} 
+
+=== Index objects
+
+Index objects are a time representation of the position in a track. They are represented with fields [minutes, seconds, frames]. There are 75 frames in each second. You can access the values of the index object like so:
+
+  index = Index.new([30, 23, 73])
+  index.minutes => 30
+  index.seconds => 23
+  index.frames => 73
+  index.to_i => 1823
+  index.to_f => 1823.97333333333
+
+There's other stuff you can do with them, check out the source for more in-depth usage.
+

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'spec/rake/spectask'
+
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_files = FileList['spec/unit/*_spec.rb']
+end
+
+task :default => :spec
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "rubycue"
+    gemspec.summary = "Ruby cuesheet track parser"
+    gemspec.description = "Basic ruby parser for song cuesheets"
+    gemspec.email = "blakesmith0@gmail.com"
+    gemspec.homepage = "http://github.com/blakesmith/rubycue"
+    gemspec.authors = ["Blake Smith"]
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/rubycue/cuesheet.rb

@@ -0,0 +1,92 @@
+module RubyCue
+  class Cuesheet
+    attr_reader :cuesheet, :songs, :track_duration
+
+    def initialize(cuesheet, track_duration=nil)
+      @cuesheet = cuesheet      
+      @reg = {
+        :track => %r(TRACK (\d{1,3}) AUDIO), 
+        :performer => %r(PERFORMER "(.*)"), 
+        :title => %r(TITLE "(.*)"), 
+        :index => %r(INDEX \d{1,3} (\d{1,3}):(\d{1,2}):(\d{1,2}))
+      }
+      @track_duration = RubyCue::Index.new(track_duration) if track_duration
+    end
+
+    def parse!
+      @songs = parse_titles.map{|title| {:title => title}}
+      @songs.each_with_index do |song, i|
+        song[:performer] = parse_performers[i]
+        song[:track] = parse_tracks[i]
+        song[:index] = parse_indices[i]
+      end
+      raise RubyCue::InvalidCuesheet.new("Field amounts are not all present. Cuesheet is malformed!") unless valid?
+      calculate_song_durations!
+      true
+    end
+
+    def position(value)
+      index = Index.new(value)
+      return @songs.first if index < @songs.first[:index]
+      @songs.each_with_index do |song, i|
+        return song if song == @songs.last
+        return song if between(song[:index], @songs[i+1][:index], index)
+      end
+    end
+
+    def valid?
+      @songs.all? do |song|
+        [:performer, :track, :index, :title].all? do |key|
+          song[key] != nil
+        end
+      end
+    end
+
+    private
+
+    def calculate_song_durations!
+      @songs.each_with_index do |song, i|
+        if song == @songs.last
+          song[:duration] = (@track_duration - song[:index]) if @track_duration
+          return
+        end
+        song[:duration] = @songs[i+1][:index] - song[:index]
+      end
+    end
+
+    def between(a, b, position_index)
+      (position_index > a) && (position_index < b)
+    end
+
+    def parse_titles
+      unless @titles
+        @titles = cuesheet_scan(:title).map{|title| title.first}
+        @titles.delete_at(0)
+      end
+      @titles
+    end
+
+    def parse_performers
+      unless @performers
+        @performers = cuesheet_scan(:performer).map{|performer| performer.first}
+        @performers.delete_at(0)
+      end
+      @performers
+    end
+
+    def parse_tracks
+      @tracks ||= cuesheet_scan(:track).map{|track| track.first.to_i}
+    end
+
+    def parse_indices
+      @indices ||= cuesheet_scan(:index).map{|index| RubyCue::Index.new([index[0].to_i, index[1].to_i, index[2].to_i])}
+    end
+
+    def cuesheet_scan(field)
+      scan = @cuesheet.scan(@reg[field])
+      raise InvalidCuesheet.new("No fields were found for #{field.to_s}") if scan.empty?
+      scan
+    end
+
+  end
+end

data/lib/rubycue/exceptions.rb

@@ -0,0 +1,3 @@
+module RubyCue
+  class InvalidCuesheet < ::RuntimeError; end
+end

data/lib/rubycue/index.rb

@@ -0,0 +1,108 @@
+module RubyCue
+  class Index
+    SECONDS_PER_MINUTE = 60
+    FRAMES_PER_SECOND = 75
+    FRAMES_PER_MINUTE = FRAMES_PER_SECOND * 60
+
+    attr_reader :minutes, :seconds, :frames
+
+    def initialize(value=nil)
+      case value
+      when Array
+        set_from_array!(value)
+      when Integer
+        set_from_integer!(value)
+      end
+    end
+
+    def to_f
+      ((@minutes * SECONDS_PER_MINUTE) + (@seconds) + (@frames.to_f / FRAMES_PER_SECOND)).to_f
+    end
+
+    def to_i
+      to_f.floor
+    end
+
+    def to_a
+      [@minutes, @seconds, @frames]
+    end
+
+    def to_s
+      "#{'%02d' % @minutes}:#{'%02d' % @seconds}:#{'%02d' % @frames}"
+    end
+
+    def +(other)
+      self.class.new(carrying_addition(other))
+    end
+
+    def -(other)
+      self.class.new(carrying_subtraction(other))
+    end
+
+    def >(other)
+      self.to_f > other.to_f
+    end
+
+    def <(other)
+      self.to_f < other.to_f
+    end
+
+    def ==(other)
+      self.to_a == other.to_a
+    end
+
+    def each
+      to_a.each {|value| yield value }
+    end
+
+    private
+
+    def carrying_addition(other)
+      minutes, seconds, frames = *[@minutes + other.minutes, 
+        @seconds + other.seconds, @frames + other.frames]
+
+      seconds, frames = *convert_with_rate(frames, seconds, FRAMES_PER_SECOND)
+      minutes, seconds = *convert_with_rate(seconds, minutes, SECONDS_PER_MINUTE)
+      [minutes, seconds, frames]
+    end
+
+    def carrying_subtraction(other)
+      seconds = minutes = 0
+
+      my_frames = @frames + (@seconds * FRAMES_PER_SECOND) + (@minutes * FRAMES_PER_MINUTE)
+      other_frames = other.frames + (other.seconds * FRAMES_PER_SECOND) + (other.minutes * FRAMES_PER_MINUTE)
+      frames = my_frames - other_frames
+
+      seconds, frames = *convert_with_rate(frames, seconds, FRAMES_PER_SECOND)
+      minutes, seconds = *convert_with_rate(seconds, minutes, SECONDS_PER_MINUTE)
+      [minutes, seconds, frames]
+    end
+
+    def convert_with_rate(from, to, rate, step=1)
+      while from >= rate
+        to += step
+        from -= rate
+      end
+      [to, from]
+    end
+
+    def set_from_array!(array)
+      if array.size != 3 || array.any?{|element| !element.is_a?(Integer)}
+        raise ArgumentError.new("Must be initialized with an array in the format of [minutes, seconds,frames], all integers")
+      end
+      @minutes, @seconds, @frames = *array
+    end
+
+    def set_from_integer!(seconds)
+      @minutes = 0
+      @frames = 0
+      @seconds = seconds
+
+      while @seconds >= SECONDS_PER_MINUTE
+        @minutes += 1
+        @seconds -= SECONDS_PER_MINUTE
+      end
+    end
+
+  end
+end

data/lib/rubycue.rb

@@ -0,0 +1,5 @@
+$:.unshift File.join(File.dirname(__FILE__), "rubycue")
+
+require 'cuesheet'
+require 'index'
+require 'exceptions'

data/spec/fixtures/malformed.cue

@@ -0,0 +1,214 @@
+PERFORMER "Netsky"
+TITLE "Essential Mix (2010-10-09)"
+FILE "2010-10-09 - Essential Mix - Netsky.mp3" MP3
+  TRACK 01 AUDIO
+    PERFORMER "Essential Mix"
+    TITLE "Intro"
+    INDEX 01 00:00:00
+  TRACK 02 AUDIO
+    PERFORMER "Shameboy vs. Friction, Camo & Krooked feat. Dynamite MC"
+    TITLE "Strobot (Netsky Remix) vs. Stand Up"
+    INDEX 01 01:50:07
+  TRACK 03 AUDIO
+    PERFORMER "Danny Byrd feat. I-Kay"
+    TITLE "Ill Behaviour"
+    INDEX 01 05:26:67
+  TRACK 04 AUDIO
+    PERFORMER "Die & Interface feat. William Cartwright"
+    TITLE "Bright Lights (Netsky Remix)"
+    INDEX 01 07:16:59
+  TRACK 05 AUDIO
+    PERFORMER "Nu:Tone feat. Natalie Williams"
+    TITLE "Shine In"
+    INDEX 01 10:33:72
+  TRACK 06 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Porcelain VIP vs. I Refuse (Acapella)"
+    INDEX 01 12:56:64
+  TRACK 07 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Do It Do It vs. I Refuse (Acapella)"
+    INDEX 01 15:52:31
+  TRACK 08 AUDIO
+    PERFORMER "Brookes Brothers"
+    TITLE "Beautiful"
+    INDEX 01 17:31:10
+  TRACK 09 AUDIO
+    PERFORMER "Muffler"
+    TITLE "Uplifter"
+    INDEX 01 20:26:47
+  TRACK 10 AUDIO
+    PERFORMER "Indivision & Livewire feat. Nelver"
+    TITLE "Irresistible"
+    INDEX 01 22:15:03
+  TRACK 11 AUDIO
+    PERFORMER "Bcee & S.P.Y."
+    TITLE "Is There Anybody Out There?"
+    INDEX 01 23:44:12
+  TRACK 12 AUDIO
+    PERFORMER "Nu:Logic vs. Brooklyn"
+    TITLE "Bleeper vs. With All My Heart"
+    INDEX 01 25:33:68
+  TRACK 13 AUDIO
+    PERFORMER "Chords"
+    TITLE "Radio"
+    INDEX 01 27:23:42
+  TRACK 14 AUDIO
+    PERFORMER "Danny Byrd feat. Netsky"
+    TITLE "Tonight"
+    INDEX 01 29:46:15
+  TRACK 15 AUDIO
+    PERFORMER "Leftfield"
+    TITLE "Release The Pressure (Netsky Remix)"
+    INDEX 01 31:24:68
+  TRACK 16 AUDIO
+    PERFORMER "Danny Byrd feat. London Elektricity"
+    TITLE "Failsafe"
+    INDEX 01 35:04:31
+  TRACK 17 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Everyday"
+    INDEX 01 37:16:06
+  TRACK 18 AUDIO
+    PERFORMER "Zero 7"
+    TITLE "In The Waiting Line (D+B Remix)"
+    INDEX 01 38:21:66
+  TRACK 19 AUDIO
+    PERFORMER "Legion feat. Adam Wright"
+    TITLE "Both Sides"
+    INDEX 01 39:27:57
+  TRACK 20 AUDIO
+    PERFORMER "New Zealand Shapeshifter"
+    TITLE "The Touch (Netsky Remix)"
+    INDEX 01 44:12:70
+  TRACK 21 AUDIO
+    PERFORMER "Swedish House Mafia"
+    TITLE "One (Netsky Remix)"
+    INDEX 01 46:23:20
+  TRACK 22 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Pirate Bay VIP"
+    INDEX 01 48:36:23
+  TRACK 23 AUDIO
+    PERFORMER "Danny Byrd feat. Cyantific"
+    TITLE "Judgement Day VIP"
+    INDEX 01 51:09:68
+  TRACK 24 AUDIO
+    PERFORMER "Netsky vs. Sidney Samson"
+    TITLE "Tomorrow's Another Dub VIP vs. Riverside (Breakage Remix)"
+    INDEX 01 53:21:46
+  TRACK 25 AUDIO
+    PERFORMER "The Bloody Beetroots feat. Steve Aoki"
+    TITLE "Warp (Dirtyphonics Remix)"
+    INDEX 01 55:37:44
+  TRACK 26 AUDIO
+    PERFORMER "Danny Byrd vs. Burial"
+    TITLE "We Can Have It All vs. Archangel (Edit)"
+    INDEX 01 56:05:01
+  TRACK 27 AUDIO
+    PERFORMER "DJ Fresh & Sigma vs. Netsky"
+    TITLE "Lassitude VIP vs. Escape"
+    INDEX 01 59:03:20
+  TRACK 28 AUDIO
+    PERFORMER "Commix"
+    TITLE "Painted Smile"
+    INDEX 01 63:04:52
+  TRACK 29 AUDIO
+    PERFORMER "Eastcolors"
+    TITLE "Go To Nowhere"
+    INDEX 01 66:00:20
+  TRACK 30 AUDIO
+    PERFORMER "Nu:Logic"
+    TITLE "Bigfoot"
+    INDEX 01 67:49:73
+  TRACK 31 AUDIO
+    PERFORMER "Random Movement"
+    TITLE "Can't Resist (S.P.Y. Remix)"
+    INDEX 01 69:17:50
+  TRACK 32 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Iron Heart"
+    INDEX 01 71:07:31
+  TRACK 33 AUDIO
+    PERFORMER "Unicorn Kid vs. DJ Fresh & Sigma"
+    TITLE "Wild Life (Nu:Tone Remix) vs. Cylon"
+    INDEX 01 74:02:69
+  TRACK 34 AUDIO
+    PERFORMER "Agent Alvin"
+    TITLE "Move"
+    INDEX 01 76:35:15
+  TRACK 35 AUDIO
+    PERFORMER "S.P.Y."
+    TITLE "Go With The Flow"
+    INDEX 01 78:01:51
+  TRACK 36 AUDIO
+    PERFORMER "Metrik"
+    TITLE "T 1000"
+    INDEX 01 79:37:45
+  TRACK 37 AUDIO
+    PERFORMER "Culture Shock"
+    TITLE "Cathedral"
+    INDEX 01 81:21:27
+  TRACK 38 AUDIO
+    PERFORMER "Blokhe4d"
+    TITLE "The Way Life Used To Be"
+    INDEX 01 83:33:35
+  TRACK 39 AUDIO
+    PERFORMER "Hamilton"
+    TITLE "Soundboy"
+    INDEX 01 85:45:13
+  TRACK 40 AUDIO
+    PERFORMER "Squash"
+    TITLE "Divine"
+    INDEX 01 87:34:63
+  TRACK 41 AUDIO
+    PERFORMER "Above & Beyond & Gareth Emery"
+    TITLE "On A Good Day (J Majik & Wickaman Remix)"
+    INDEX 01 89:24:45
+  TRACK 42 AUDIO
+    PERFORMER "Metrik"
+    TITLE "Arrival (Instrumental)"
+    INDEX 01 91:36:16
+  TRACK 43 AUDIO
+    PERFORMER "Spy"
+    TITLE "By Your Side (Logistics Remix)"
+    INDEX 01 94:09:53
+  TRACK 44 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Come Back Home"
+    INDEX 01 97:05:34
+  TRACK 45 AUDIO
+    PERFORMER "Axwell & Sebastian Ingrosso"
+    TITLE "Together (D+B Remix)"
+    INDEX 01 99:16:36
+  TRACK 46 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Rise & Shine"
+    INDEX 01 101:28:54
+  TRACK 47 AUDIO
+    PERFORMER "Apex"
+    TITLE "String Theory"
+    INDEX 01 102:56:39
+  TRACK 48 AUDIO
+    PERFORMER "DJ Marky & S.P.Y."
+    TITLE "Touch Me"
+    INDEX 01 105:52:04
+  TRACK 49 AUDIO
+    PERFORMER "Subwave"
+    TITLE "Road Rage"
+    INDEX 01 107:19:56
+  TRACK 50 AUDIO
+    PERFORMER "Joe Syntax"
+    TITLE "Slingshot"
+    INDEX 01 109:53:36
+  TRACK 51 AUDIO
+    PERFORMER "Pendulum"
+    TITLE "Witchcraft (Netsky Remix)"
+    INDEX 01 110:58:14
+  TRACK 52 AUDIO
+    PERFORMER "London Elektricity"
+    TITLE "The Great Drum & Bass Swindle (Logistics Remix)"
+    INDEX 01 112:27:02
+  TRACK 53 AUDIO
+    PERFORMER "Netsky vs. Genetic Bros"
+    TITLE "The Lotus Symphony vs. Uplifting"

data/spec/fixtures/test.cue

@@ -0,0 +1,215 @@
+PERFORMER "Netsky"
+TITLE "Essential Mix (2010-10-09)"
+FILE "2010-10-09 - Essential Mix - Netsky.mp3" MP3
+  TRACK 01 AUDIO
+    PERFORMER "Essential Mix"
+    TITLE "Intro"
+    INDEX 01 00:00:00
+  TRACK 02 AUDIO
+    PERFORMER "Shameboy vs. Friction, Camo & Krooked feat. Dynamite MC"
+    TITLE "Strobot (Netsky Remix) vs. Stand Up"
+    INDEX 01 01:50:07
+  TRACK 03 AUDIO
+    PERFORMER "Danny Byrd feat. I-Kay"
+    TITLE "Ill Behaviour"
+    INDEX 01 05:26:67
+  TRACK 04 AUDIO
+    PERFORMER "Die & Interface feat. William Cartwright"
+    TITLE "Bright Lights (Netsky Remix)"
+    INDEX 01 07:16:59
+  TRACK 05 AUDIO
+    PERFORMER "Nu:Tone feat. Natalie Williams"
+    TITLE "Shine In"
+    INDEX 01 10:33:72
+  TRACK 06 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Porcelain VIP vs. I Refuse (Acapella)"
+    INDEX 01 12:56:64
+  TRACK 07 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Do It Do It vs. I Refuse (Acapella)"
+    INDEX 01 15:52:31
+  TRACK 08 AUDIO
+    PERFORMER "Brookes Brothers"
+    TITLE "Beautiful"
+    INDEX 01 17:31:10
+  TRACK 09 AUDIO
+    PERFORMER "Muffler"
+    TITLE "Uplifter"
+    INDEX 01 20:26:47
+  TRACK 10 AUDIO
+    PERFORMER "Indivision & Livewire feat. Nelver"
+    TITLE "Irresistible"
+    INDEX 01 22:15:03
+  TRACK 11 AUDIO
+    PERFORMER "Bcee & S.P.Y."
+    TITLE "Is There Anybody Out There?"
+    INDEX 01 23:44:12
+  TRACK 12 AUDIO
+    PERFORMER "Nu:Logic vs. Brooklyn"
+    TITLE "Bleeper vs. With All My Heart"
+    INDEX 01 25:33:68
+  TRACK 13 AUDIO
+    PERFORMER "Chords"
+    TITLE "Radio"
+    INDEX 01 27:23:42
+  TRACK 14 AUDIO
+    PERFORMER "Danny Byrd feat. Netsky"
+    TITLE "Tonight"
+    INDEX 01 29:46:15
+  TRACK 15 AUDIO
+    PERFORMER "Leftfield"
+    TITLE "Release The Pressure (Netsky Remix)"
+    INDEX 01 31:24:68
+  TRACK 16 AUDIO
+    PERFORMER "Danny Byrd feat. London Elektricity"
+    TITLE "Failsafe"
+    INDEX 01 35:04:31
+  TRACK 17 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Everyday"
+    INDEX 01 37:16:06
+  TRACK 18 AUDIO
+    PERFORMER "Zero 7"
+    TITLE "In The Waiting Line (D+B Remix)"
+    INDEX 01 38:21:66
+  TRACK 19 AUDIO
+    PERFORMER "Legion feat. Adam Wright"
+    TITLE "Both Sides"
+    INDEX 01 39:27:57
+  TRACK 20 AUDIO
+    PERFORMER "New Zealand Shapeshifter"
+    TITLE "The Touch (Netsky Remix)"
+    INDEX 01 44:12:70
+  TRACK 21 AUDIO
+    PERFORMER "Swedish House Mafia"
+    TITLE "One (Netsky Remix)"
+    INDEX 01 46:23:20
+  TRACK 22 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Pirate Bay VIP"
+    INDEX 01 48:36:23
+  TRACK 23 AUDIO
+    PERFORMER "Danny Byrd feat. Cyantific"
+    TITLE "Judgement Day VIP"
+    INDEX 01 51:09:68
+  TRACK 24 AUDIO
+    PERFORMER "Netsky vs. Sidney Samson"
+    TITLE "Tomorrow's Another Dub VIP vs. Riverside (Breakage Remix)"
+    INDEX 01 53:21:46
+  TRACK 25 AUDIO
+    PERFORMER "The Bloody Beetroots feat. Steve Aoki"
+    TITLE "Warp (Dirtyphonics Remix)"
+    INDEX 01 55:37:44
+  TRACK 26 AUDIO
+    PERFORMER "Danny Byrd vs. Burial"
+    TITLE "We Can Have It All vs. Archangel (Edit)"
+    INDEX 01 56:05:01
+  TRACK 27 AUDIO
+    PERFORMER "DJ Fresh & Sigma vs. Netsky"
+    TITLE "Lassitude VIP vs. Escape"
+    INDEX 01 59:03:20
+  TRACK 28 AUDIO
+    PERFORMER "Commix"
+    TITLE "Painted Smile"
+    INDEX 01 63:04:52
+  TRACK 29 AUDIO
+    PERFORMER "Eastcolors"
+    TITLE "Go To Nowhere"
+    INDEX 01 66:00:20
+  TRACK 30 AUDIO
+    PERFORMER "Nu:Logic"
+    TITLE "Bigfoot"
+    INDEX 01 67:49:73
+  TRACK 31 AUDIO
+    PERFORMER "Random Movement"
+    TITLE "Can't Resist (S.P.Y. Remix)"
+    INDEX 01 69:17:50
+  TRACK 32 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Iron Heart"
+    INDEX 01 71:07:31
+  TRACK 33 AUDIO
+    PERFORMER "Unicorn Kid vs. DJ Fresh & Sigma"
+    TITLE "Wild Life (Nu:Tone Remix) vs. Cylon"
+    INDEX 01 74:02:69
+  TRACK 34 AUDIO
+    PERFORMER "Agent Alvin"
+    TITLE "Move"
+    INDEX 01 76:35:15
+  TRACK 35 AUDIO
+    PERFORMER "S.P.Y."
+    TITLE "Go With The Flow"
+    INDEX 01 78:01:51
+  TRACK 36 AUDIO
+    PERFORMER "Metrik"
+    TITLE "T 1000"
+    INDEX 01 79:37:45
+  TRACK 37 AUDIO
+    PERFORMER "Culture Shock"
+    TITLE "Cathedral"
+    INDEX 01 81:21:27
+  TRACK 38 AUDIO
+    PERFORMER "Blokhe4d"
+    TITLE "The Way Life Used To Be"
+    INDEX 01 83:33:35
+  TRACK 39 AUDIO
+    PERFORMER "Hamilton"
+    TITLE "Soundboy"
+    INDEX 01 85:45:13
+  TRACK 40 AUDIO
+    PERFORMER "Squash"
+    TITLE "Divine"
+    INDEX 01 87:34:63
+  TRACK 41 AUDIO
+    PERFORMER "Above & Beyond & Gareth Emery"
+    TITLE "On A Good Day (J Majik & Wickaman Remix)"
+    INDEX 01 89:24:45
+  TRACK 42 AUDIO
+    PERFORMER "Metrik"
+    TITLE "Arrival (Instrumental)"
+    INDEX 01 91:36:16
+  TRACK 43 AUDIO
+    PERFORMER "Spy"
+    TITLE "By Your Side (Logistics Remix)"
+    INDEX 01 94:09:53
+  TRACK 44 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Come Back Home"
+    INDEX 01 97:05:34
+  TRACK 45 AUDIO
+    PERFORMER "Axwell & Sebastian Ingrosso"
+    TITLE "Together (D+B Remix)"
+    INDEX 01 99:16:36
+  TRACK 46 AUDIO
+    PERFORMER "Netsky"
+    TITLE "Rise & Shine"
+    INDEX 01 101:28:54
+  TRACK 47 AUDIO
+    PERFORMER "Apex"
+    TITLE "String Theory"
+    INDEX 01 102:56:39
+  TRACK 48 AUDIO
+    PERFORMER "DJ Marky & S.P.Y."
+    TITLE "Touch Me"
+    INDEX 01 105:52:04
+  TRACK 49 AUDIO
+    PERFORMER "Subwave"
+    TITLE "Road Rage"
+    INDEX 01 107:19:56
+  TRACK 50 AUDIO
+    PERFORMER "Joe Syntax"
+    TITLE "Slingshot"
+    INDEX 01 109:53:36
+  TRACK 51 AUDIO
+    PERFORMER "Pendulum"
+    TITLE "Witchcraft (Netsky Remix)"
+    INDEX 01 110:58:14
+  TRACK 52 AUDIO
+    PERFORMER "London Elektricity"
+    TITLE "The Great Drum & Bass Swindle (Logistics Remix)"
+    INDEX 01 112:27:02
+  TRACK 53 AUDIO
+    PERFORMER "Netsky vs. Genetic Bros"
+    TITLE "The Lotus Symphony vs. Uplifting"
+    INDEX 01 115:22:47

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'rubygems'
+require 'rspec'
+
+require File.join(File.dirname(__FILE__), "../lib/rubycue")
+
+def load_cuesheet(cuename)
+  File.read(File.join(File.dirname(__FILE__), "fixtures/#{cuename}.cue"))
+end

data/spec/unit/cuesheet_spec.rb

@@ -0,0 +1,102 @@
+require File.join(File.dirname(__FILE__), "../spec_helper")
+
+describe RubyCue::Cuesheet do
+  before do
+    @cuesheet_file = load_cuesheet("test")
+    @cuesheet = RubyCue::Cuesheet.new(@cuesheet_file)
+    @cuesheet.parse!
+  end
+
+  it "stores the cuesheet string" do
+    cuesheet = RubyCue::Cuesheet.new(@cuesheet_file)
+    cuesheet.cuesheet.should == @cuesheet_file
+  end
+
+  describe "#parse!" do
+    context "properly formatted cuesheet" do
+      it "returns true if successfully parsed" do
+        @cuesheet.parse!.should be_true
+      end
+
+      it "has the right first track" do
+        @cuesheet.songs.first[:title].should == "Intro"
+      end
+
+      it "has the right last track" do
+        @cuesheet.songs.last[:title].should == "The Lotus Symphony vs. Uplifting"
+      end
+
+      it "has the right first performer" do
+        @cuesheet.songs.first[:performer].should == "Essential Mix"
+      end
+
+      it "has the right last performer" do
+        @cuesheet.songs.last[:performer].should == "Netsky vs. Genetic Bros"
+      end
+
+      it "has the right first index" do
+        @cuesheet.songs.first[:index].should == [0, 0, 0]
+      end
+
+      it "has the right last index" do
+        @cuesheet.songs.last[:index].should == [115, 22, 47]
+      end
+
+      it "has the right first track" do
+        @cuesheet.songs.first[:track].should == 1
+      end
+
+      it "has the right last track" do
+        @cuesheet.songs.last[:track].should == 53
+      end
+
+      it "has the right amonut of tracks" do
+        @cuesheet.songs.size.should == 53
+      end
+
+      describe "#calculate_song_duration!" do
+        it "properly calculates song duration at the beginning of the track" do
+          @cuesheet.songs.first[:duration].to_a.should == [1, 50, 07]
+        end
+
+        it "properly calculates song duration in the middle of the track" do
+          @cuesheet.songs[20][:duration].to_a.should == [2, 13, 3]
+        end
+
+        it "properly calculates song duration of the last song given the user inputs the total track length" do
+          cuesheet = RubyCue::Cuesheet.new(load_cuesheet('test'), 7185)
+          cuesheet.parse!
+          cuesheet.songs.last[:duration].to_a.should == [4, 22, 28]
+        end
+      end
+    end
+
+    context "improperly formatted cuesheet" do
+      it "should raise an exception for a bogus formatted cuesheet" do
+        cuesheet = RubyCue::Cuesheet.new("Something bogus")
+        lambda { cuesheet.parse! }.should raise_error(RubyCue::InvalidCuesheet)
+      end
+
+      it "raises an exception if all our fields don't find the same amount of items" do
+        cue = load_cuesheet('malformed')
+        cuesheet = RubyCue::Cuesheet.new(cue)
+        lambda { cuesheet.parse! }.should raise_error(RubyCue::InvalidCuesheet)
+      end
+    end
+  end
+
+  describe "#position" do
+    it "returns the current song in the cuesheet based on the designated position" do
+      @cuesheet.position(1943).should == @cuesheet.songs[14]
+    end
+
+    it "returns the first song if a negative position is passed" do
+      @cuesheet.position(-5).should == @cuesheet.songs[0]
+    end
+
+    it "returns the last song if a position greater than the last index is passed" do
+      @cuesheet.position(10000000).should == @cuesheet.songs.last
+    end
+  end
+
+end

data/spec/unit/index_spec.rb

@@ -0,0 +1,243 @@
+require File.join(File.dirname(__FILE__), "../spec_helper")
+
+describe RubyCue::Index do
+  describe "init" do
+    it "allows empty initialization" do
+      lambda { RubyCue::Index.new }.should_not raise_error
+    end
+
+    it "initializes from an array if specified default" do
+      index = RubyCue::Index.new([5, 0, 75])
+      index.minutes.should == 5
+      index.seconds.should == 0
+      index.frames.should == 75
+    end
+
+    it "initializes from integer seconds less than a minute" do
+      index = RubyCue::Index.new(30)
+      index.minutes.should == 0
+      index.seconds.should == 30
+      index.frames.should == 0
+    end
+
+    it "initializes from integer seconds over a minute" do
+      index = RubyCue::Index.new(90)
+      index.minutes.should == 1
+      index.seconds.should == 30
+      index.frames.should == 0
+    end
+    
+    it "initializes from integer seconds at a minute" do
+      index = RubyCue::Index.new(60)
+      index.minutes.should == 1
+      index.seconds.should == 0
+      index.frames.should == 0
+    end
+
+    it "raises an error if the array size is not size 3" do
+      lambda { RubyCue::Index.new([0, 0, 0, 0]) }.should raise_error(ArgumentError)
+    end
+
+    it "raises an error if not all the array elements are integers" do
+      lambda { RubyCue::Index.new([0, "moose", 0]) }.should raise_error(ArgumentError)
+    end
+
+    context "conversions" do
+      describe "#to_f" do
+        it "converts an array value under a minute" do
+          index = RubyCue::Index.new([0, 30, 0])
+          index.to_f.should == 30.0
+        end
+
+        it "converts an array value over a minute" do
+          index = RubyCue::Index.new([1, 30, 0])
+          index.to_f.should == 90.0
+        end
+
+        it "converts an array value over a minute with frames" do
+          index = RubyCue::Index.new([1, 30, 74])
+          index.to_f.should == (90 + (74 / 75.0)).to_f
+        end
+      end
+
+      describe "#to_s" do
+        it "renders the index as a string with leading zeroes" do
+          index = RubyCue::Index.new([1, 30, 74]).to_s.should == "01:30:74"
+        end
+      end
+
+      describe "#to_i" do
+        it "converts to seconds and rounds down" do
+          index = RubyCue::Index.new([0, 30, 74])
+          index.to_i.should == 30
+        end
+      end
+
+      describe "#to_a" do
+        it "converts to an array" do
+          index = RubyCue::Index.new([1, 2, 3])
+          index.to_a.should == [1, 2, 3]
+        end
+      end
+    end
+
+    context "computations" do
+      describe "#+" do
+        it "returns an object of Class Index" do
+          index1 = RubyCue::Index.new([0, 30, 0])
+          index2 = RubyCue::Index.new([0, 30, 0])
+
+          (index1 + index2).class.should == RubyCue::Index
+        end
+
+        it "adds two indices under a minute" do
+          index1 = RubyCue::Index.new([0, 30, 0])
+          index2 = RubyCue::Index.new([0, 30, 0])
+
+          (index1 + index2).to_a.should == [1, 0, 0]
+        end
+
+        it "adds two indices over a minute" do
+          index1 = RubyCue::Index.new([1, 30, 0])
+          index2 = RubyCue::Index.new([2, 20, 0])
+
+          (index1 + index2).to_a.should == [3, 50, 0]
+        end
+
+        it "adds two indices with frames" do
+          index1 = RubyCue::Index.new([1, 30, 50])
+          index2 = RubyCue::Index.new([2, 20, 50])
+
+          (index1 + index2).to_a.should == [3, 51, 25]
+        end
+
+        it "adds two indices with only frames" do
+          index1 = RubyCue::Index.new([0, 0, 50])
+          index2 = RubyCue::Index.new([0, 0, 25])
+
+          (index1 + index2).to_a.should == [0, 1, 0]
+        end
+      end
+
+      describe "#-" do
+        it "returns an object of Class Index" do
+          index1 = RubyCue::Index.new([0, 30, 0])
+          index2 = RubyCue::Index.new([0, 30, 0])
+
+          (index1 - index2).class.should == RubyCue::Index
+        end
+
+        it "subtracts two indices with only frames" do
+          index1 = RubyCue::Index.new([0, 0, 50])
+          index2 = RubyCue::Index.new([0, 0, 25])
+
+          (index1 - index2).to_a.should == [0, 0, 25]
+        end
+
+        it "subtracts two indices with minutes" do
+          index1 = RubyCue::Index.new([3, 20, 50])
+          index2 = RubyCue::Index.new([2, 40, 25])
+
+          (index1 - index2).to_a.should == [0, 40, 25]
+        end
+
+        it "subtracts two indices with even minutes" do
+          index1 = RubyCue::Index.new([3, 0, 0])
+          index2 = RubyCue::Index.new([2, 0, 0])
+
+          (index1 - index2).to_a.should == [1, 0, 0]
+        end
+
+      end
+
+      describe "#>" do
+        it "returns true for frames" do
+          index1 = RubyCue::Index.new([0, 0, 50])
+          index2 = RubyCue::Index.new([0, 0, 25])
+
+          (index1 > index2).should be_true
+        end
+
+        it "returns true for seconds" do
+          index1 = RubyCue::Index.new([0, 30, 50])
+          index2 = RubyCue::Index.new([0, 29, 25])
+
+          (index1 > index2).should be_true
+        end
+
+        it "returns true for minutes" do
+          index1 = RubyCue::Index.new([2, 30, 50])
+          index2 = RubyCue::Index.new([1, 29, 25])
+
+          (index1 > index2).should be_true
+        end
+
+        it "returns true for the same time" do
+          index1 = RubyCue::Index.new([1, 30, 50])
+          index2 = RubyCue::Index.new([1, 30, 50])
+
+          (index1 > index2).should be_false
+        end
+      end
+
+      describe "#<" do
+        it "returns false for frames" do
+          index1 = RubyCue::Index.new([0, 0, 50])
+          index2 = RubyCue::Index.new([0, 0, 25])
+
+          (index1 < index2).should be_false
+        end
+
+        it "returns false for seconds" do
+          index1 = RubyCue::Index.new([0, 30, 50])
+          index2 = RubyCue::Index.new([0, 29, 25])
+
+          (index1 < index2).should be_false
+        end
+
+        it "returns false for minutes" do
+          index1 = RubyCue::Index.new([2, 30, 50])
+          index2 = RubyCue::Index.new([1, 29, 25])
+
+          (index1 < index2).should be_false
+        end
+
+        it "returns false for the same time" do
+          index1 = RubyCue::Index.new([1, 30, 50])
+          index2 = RubyCue::Index.new([1, 30, 50])
+
+          (index1 < index2).should be_false
+        end
+      end
+
+      describe "#==" do
+        it "returns true if they're the same" do
+          index1 = RubyCue::Index.new([1, 30, 50])
+          index2 = RubyCue::Index.new([1, 30, 50])
+
+          (index1 == index2).should be_true
+        end
+        
+        it "returns false if they're not the same" do
+          index1 = RubyCue::Index.new([1, 30, 50])
+          index2 = RubyCue::Index.new([1, 30, 51])
+
+          (index1 == index2).should be_false
+        end
+      end
+    end
+
+    describe "#each" do
+      it "yields each minute, second, frame value" do
+        array = []
+        index = RubyCue::Index.new([1, 30, 45])
+        index.each do |value|
+          array << value
+        end
+
+        array.to_a.should == index.to_a
+      end
+    end
+
+  end
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification 
+name: rubycue
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Blake Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-26 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Basic ruby parser for song cuesheets
+email: blakesmith0@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/rubycue.rb
+- lib/rubycue/cuesheet.rb
+- lib/rubycue/exceptions.rb
+- lib/rubycue/index.rb
+- spec/fixtures/malformed.cue
+- spec/fixtures/test.cue
+- spec/spec_helper.rb
+- spec/unit/cuesheet_spec.rb
+- spec/unit/index_spec.rb
+has_rdoc: true
+homepage: http://github.com/blakesmith/rubycue
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby cuesheet track parser
+test_files: 
+- spec/spec_helper.rb
+- spec/unit/cuesheet_spec.rb
+- spec/unit/index_spec.rb