Home | Trees | Index | Help |
---|
Package musicbrainz2 :: Module model :: Class Release |
|
object
--+ |Entity
--+ | Release
Represents a Release.
A release within MusicBrainz is anEntity
which contains Track
objects. Releases may be of more than
one type: There can be albums, singles, compilations, live recordings,
official releases, bootlegs etc.
Note: The current MusicBrainz server implementation supports only a limited set of types.
Method Summary | |
---|---|
Constructor. | |
Adds a disc to this release. | |
Adds a release event to this release. | |
Adds a track to this release. | |
Add a type to the list of types. | |
Returns the main artist of this release. | |
Returns the amazon shop identifier (ASIN). | |
Returns the discs associated with this release. | |
Returns the earliest release date. | |
Returns the earliest release event. | |
Returns the list of release events. | |
Returns the release events represented as a dict. | |
Returns the language used in release and track titles. | |
Returns the script used in release and track titles. | |
Returns the release's title. | |
Returns the tracks this release contains. | |
Returns the offset of the track list. | |
Returns the types of this release. | |
Checks if this is a single artist's release. | |
Sets this release's main artist. | |
Sets the amazon shop identifier (ASIN). | |
Sets the language used in releaes and track titles. | |
Sets the script used in releaes and track titles. | |
Sets the release's title. | |
Sets the offset of the track list. | |
Inherited from Entity | |
Adds a relation. | |
Returns a MusicBrainz ID. | |
Returns a list of relations. | |
Returns a list of target types available for this entity. | |
Sets a MusicBrainz ID. | |
Inherited from object | |
x.__delattr__('name') <==> del x.name | |
x.__getattribute__('name') <==> x.name | |
x.__hash__() <==> hash(x) | |
T.__new__(S, ...) -> a new object with type S, a subtype of T | |
helper for pickle | |
helper for pickle | |
x.__repr__() <==> repr(x) | |
x.__setattr__('name', value) <==> x.name = value | |
x.__str__() <==> str(x) |
Property Summary | |
---|---|
artist : The main artist of this release. | |
asin : The amazon shop identifier. | |
discs : The list of associated discs. | |
releaseEvents : The list of release events. | |
textLanguage : The language used in release and track titles. | |
textScript : The script used in release and track titles. | |
title : The title of this release. | |
tracks : The list of tracks. | |
tracksOffset : The offset of the track list. | |
types : The list of types for this release. | |
Inherited from Entity | |
id : The MusicBrainz ID. |
Class Variable Summary | |
---|---|
str |
TYPE_ALBUM = 'http://musicbrainz.org/ns/mmd-1.0#Album'
|
str |
TYPE_AUDIOBOOK = 'http://musicbrainz.org/ns/mmd-1.0#Audi...
|
str |
TYPE_BOOTLEG = 'http://musicbrainz.org/ns/mmd-1.0#Bootle...
|
str |
TYPE_COMPILATION = 'http://musicbrainz.org/ns/mmd-1.0#Co...
|
str |
TYPE_EP = 'http://musicbrainz.org/ns/mmd-1.0#EP'
|
str |
TYPE_INTERVIEW = 'http://musicbrainz.org/ns/mmd-1.0#Inte...
|
str |
TYPE_LIVE = 'http://musicbrainz.org/ns/mmd-1.0#Live'
|
str |
TYPE_NONE = 'http://musicbrainz.org/ns/mmd-1.0#None'
|
str |
TYPE_OFFICIAL = 'http://musicbrainz.org/ns/mmd-1.0#Offic...
|
str |
TYPE_OTHER = 'http://musicbrainz.org/ns/mmd-1.0#Other'
|
str |
TYPE_PROMOTION = 'http://musicbrainz.org/ns/mmd-1.0#Prom...
|
str |
TYPE_REMIX = 'http://musicbrainz.org/ns/mmd-1.0#Remix'
|
str |
TYPE_SINGLE = 'http://musicbrainz.org/ns/mmd-1.0#Single'...
|
str |
TYPE_SOUNDTRACK = 'http://musicbrainz.org/ns/mmd-1.0#Sou...
|
str |
TYPE_SPOKENWORD = 'http://musicbrainz.org/ns/mmd-1.0#Spo...
|
Method Details |
---|
__init__(self,
id_=None,
title=None)
Constructor.
|
addDisc(self, disc)Adds a disc to this release.
|
addReleaseEvent(self, event)Adds a release event to this release.
|
addTrack(self, track)Adds a track to this release. This appends a track at the end of this release's track list.
|
addType(self, type_)Add a type to the list of types.
|
getArtist(self)Returns the main artist of this release.
|
getAsin(self)Returns the amazon shop identifier (ASIN). The ASIN is a 10-letter code (except for books) assigned by Amazon, which looks like 'B000002IT2' or 'B00006I4YD'.
|
getDiscs(self)Returns the discs associated with this release. Discs are currently containers for MusicBrainz DiscIDs. Note that under rare circumstances (identical TOCs), a DiscID could be associated with more than one release.
|
getEarliestReleaseDate(self)Returns the earliest release date. This favours complete dates. For example, '2006-09' is returned if there is '2000', too. If there is no release event associated with this release, None is returned.
|
getEarliestReleaseEvent(self)Returns the earliest release event. This works likegetEarliestReleaseDate , but instead of
just the date, this returns a ReleaseEvent object.
|
getReleaseEvents(self)Returns the list of release events. ARelease may contain a list of so-called
release events, each represented using a ReleaseEvent object. Release evens
specify where and when this release was, well, released.
|
getReleaseEventsAsDict(self)Returns the release events represented as a dict. Keys are ISO-3166 country codes like 'DE', 'UK', 'FR' etc. Values are dates in 'YYYY', 'YYYY-MM' or 'YYYY-MM-DD' format.
|
getTextLanguage(self)Returns the language used in release and track titles. To represent the language, the ISO-639-2/T standard is used, which provides three-letter terminological language codes like 'ENG', 'DEU', 'JPN', 'KOR', 'ZHO' or 'YID'. Note that this refers to release and track titles, not lyrics.
|
getTextScript(self)Returns the script used in release and track titles. To represent the script, ISO-15924 script codes are used. Valid codes are, among others: 'Latn', 'Cyrl', 'Hans', 'Hebr' Note that this refers to release and track titles, not lyrics.
|
getTitle(self)Returns the release's title.
|
getTracks(self)Returns the tracks this release contains.
|
getTracksOffset(self)Returns the offset of the track list. This is used if the track list is incomplete (ie. the web service only returned part of the tracks on this release). Note that the offset value is zero-based, which means track0 is the first
track.
|
getTypes(self)Returns the types of this release. To test for release types, you can use the constantsTYPE_ALBUM , TYPE_SINGLE , etc.
|
isSingleArtistRelease(self)Checks if this is a single artist's release. Returns setArtist ) for this. The track artists
may be unset.
|
setArtist(self, artist)Sets this release's main artist.
|
setAsin(self, asin)Sets the amazon shop identifier (ASIN).
|
setTextLanguage(self, language)Sets the language used in releaes and track titles.
|
setTextScript(self, script)Sets the script used in releaes and track titles.
|
setTitle(self, title)Sets the release's title.
|
setTracksOffset(self, offset)Sets the offset of the track list.
|
Property Details |
---|
artistThe main artist of this release. |
asinThe amazon shop identifier. |
discsThe list of associated discs.
|
releaseEventsThe list of release events.
|
textLanguageThe language used in release and track titles.
|
textScriptThe script used in release and track titles.
|
titleThe title of this release. |
tracksThe list of tracks.
|
tracksOffsetThe offset of the track list.
|
typesThe list of types for this release.
|
Class Variable Details |
---|
TYPE_ALBUM
|
TYPE_AUDIOBOOK
|
TYPE_BOOTLEG
|
TYPE_COMPILATION
|
TYPE_EP
|
TYPE_INTERVIEW
|
TYPE_LIVE
|
TYPE_NONE
|
TYPE_OFFICIAL
|
TYPE_OTHER
|
TYPE_PROMOTION
|
TYPE_REMIX
|
TYPE_SINGLE
|
TYPE_SOUNDTRACK
|
TYPE_SPOKENWORD
|
Home | Trees | Index | Help |
---|
Generated by Epydoc 2.1 on Sat Aug 26 18:34:32 2006 | http://epydoc.sf.net |