Reads an Audio CD in the disc drive.
This reads a CD's table of contents (TOC) and calculates the
MusicBrainz DiscID, which is a 28 character ASCII string. This DiscID can
be used to retrieve a list of matching releases from the web service (see
musicbrainz2.webservice.Query).
Note that an Audio CD has to be in drive for this to work. The
deviceName argument may be used to set the device. The
default depends on the operating system (on linux, it's
'/dev/cdrom' ). No network connection is needed for this
function.
If the device doesn't exist or there's no valid Audio CD in the drive,
a DiscError exception is raised.
- Parameters:
deviceName - a string containing the CD drive's device name
- Returns:
- a musicbrainz2.model.Disc object
- Raises:
DiscError - if there was a problem reading the disc
NotImplementedError - if DiscID generation isn't supported
|