Class: DiscId::Disc

Inherits:
Object
  • Object
show all
Defined in:
lib/discid/disc.rb

Overview

This class holds information about a disc (TOC, MCN, ISRCs).

Use #read or #put to initialize an instance of Disc.

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#device ⇒ Object (readonly)

The device from which this disc object was read.



29
30
31
 
# File 'lib/discid/disc.rb', line 29

def device
  @device
end

Instance Method Details

#first_track_number ⇒ Integer

The number of the first track on this disc.

Returns:

  • (Integer) —

    The number of the first track or nil if no ID was yet read.



98
99
100
 
# File 'lib/discid/disc.rb', line 98

def first_track_number
  return Lib.get_first_track_num @handle if @read
end

#freedb_id ⇒ String

The FreeDB DiscID.

Returns:

  • (String) —

    The DiscID or nil if no ID was yet read.



91
92
93
 
# File 'lib/discid/disc.rb', line 91

def freedb_id
  return Lib.get_freedb_id @handle if @read
end

#id ⇒ String

The MusicBrainz DiscID.

Returns:

  • (String) —

    The DiscID or nil if no ID was yet read.



84
85
86
 
# File 'lib/discid/disc.rb', line 84

def id
  return Lib.get_id @handle if @read
end

#last_track_number ⇒ Integer

The number of the last track on this disc.

Returns:

  • (Integer) —

    The number of the last track or nil if no ID was yet read.



105
106
107
 
# File 'lib/discid/disc.rb', line 105

def last_track_number
  return Lib.get_last_track_num @handle if @read
end

#mcn ⇒ String

Note:

libdiscid >= 0.3.0 required. Older versions will always return nil. Not available on all platforms, see http://musicbrainz.org/doc/libdiscid#Feature_Matrix.

The media catalogue number on the disc, if present.

Requires libdiscid >= 0.5. If not supported this method will always return nil.

Returns:

  • (String) —

    MCN or nil if no ID was yet read.



133
134
135
 
# File 'lib/discid/disc.rb', line 133

def mcn
  return Lib.get_mcn @handle if @read
end

#seconds ⇒ Integer

The length of the disc in seconds.

Returns:

  • (Integer) —

    Seconds or nil if no ID was yet read.



119
120
121
 
# File 'lib/discid/disc.rb', line 119

def seconds
  DiscId.sectors_to_seconds(sectors) if @read
end

#sectors ⇒ Integer

The length of the disc in sectors.

Returns:

  • (Integer) —

    Sectors or nil if no ID was yet read.



112
113
114
 
# File 'lib/discid/disc.rb', line 112

def sectors
  return Lib.get_sectors @handle if @read
end

#submission_url ⇒ String

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.

Returns:

  • (String) —

    Submission URL



177
178
179
 
# File 'lib/discid/disc.rb', line 177

def submission_url
  return Lib.get_submission_url @handle if @read
end

#to_s ⇒ String

DiscID to String conversion. Same as calling the method #id but guaranteed to return a string.

Returns:

  • (String) —

    The disc ID as a string or an empty string if no ID was yet read.



186
187
188
 
# File 'lib/discid/disc.rb', line 186

def to_s
  id.to_s
end

#toc_string ⇒ String

Return a string representing CD Table Of Contents (TOC).

The TOC suitable as a value of the toc parameter when accessing the MusicBrainz Web Service. This enables fuzzy searching when the actual DiscID is not found.

Note that this is the unencoded value, which still contains spaces.

For libdiscid >= 0.6 the native implementation will be used. For older versions falls back to extract the TOC from #submission_url.

Returns:

  • (String) —

    The TOC string or nil if no ID was yet read.

Raises:

  • (RuntimeError) —

    get_toc_string is unsupported by libdiscid and could not get extracted from #submission_url

Since:

  • 1.3



153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
 
# File 'lib/discid/disc.rb', line 153

def toc_string
  return nil if not @read
  result = Lib.get_toc_string @handle
  if not result
    # probably an old version of libdiscid (< 0.6.0)
    # gather toc string from submission_url
    match = /toc=([0-9+]+)/.match self.submission_url
    if match
      result = match[1].tr("+", " ")
    else
      raise "can't get toc string from submission url"
    end
  end

  return result
end

#tracks {|Track| ... } ⇒ Array<Track>

Returns an array of Track objects. Each Track 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.

Yields:

  • (Track) —

    If a block is given this method returns nil and instead iterates over the block calling the block with one argument.

Yield Returns:

  • (nil)

Returns:



200
201
202
203
204
205
206
207
208
209
210
211
 
# File 'lib/discid/disc.rb', line 200

def tracks(&block)
  if @read
    read_tracks if @tracks.nil?

    if block
      @tracks.each(&block)
      return nil
    else
      return @tracks
    end
  end
end