Home | Trees | Index | Help |
---|
Package musicbrainz2 :: Module model :: Class Artist |
|
object
--+ |Entity
--+ | Artist
Represents an artist.
Artists in MusicBrainz can have a type. Currently, this type can be either Person or Group for which the following URIs are assigned:http://musicbrainz.org/ns/mmd-1.0#Person
http://musicbrainz.org/ns/mmd-1.0#Group
TYPE_PERSON
and TYPE_GROUP
constants for comparison.
Method Summary | |
---|---|
Constructor. | |
Adds an alias for this artist. | |
Adds a release to this artist's list of releases. | |
Returns the list of aliases for this artist. | |
Returns the birth/foundation date. | |
Returns the disambiguation attribute. | |
Get the death/dissolving date. | |
Returns the artist's name. | |
Returns a list of releases from this artist. | |
Returns the number of existing releases. | |
Returns the offset of the release list. | |
Returns the artist's sort name. | |
Returns the artist's type. | |
Returns a unique artist name (using disambiguation). | |
Sets the begin/foundation date. | |
Sets the disambiguation attribute. | |
Sets the death/dissolving date. | |
Sets the artist's name. | |
Sets the number of existing releases. | |
Sets the offset of the release list. | |
Sets the artist's sort name. | |
Sets the artist's type. | |
Inherited from Entity | |
Adds a relation. | |
Returns a MusicBrainz ID. | |
Returns a list of relations. | |
Returns a list of relation targets. | |
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 | |
---|---|
aliases : The list of aliases | |
beginDate : The begin/foundation date. | |
disambiguation : The disambiguation comment. | |
endDate : The death/dissolving date. | |
name : The artist's name. | |
releases : The list of releases | |
releasesCount : The total number of releases | |
releasesOffset : The offset of the release list. | |
sortName : The artist's sort name. | |
type : The artist's type. | |
Inherited from Entity | |
id : The MusicBrainz ID. |
Class Variable Summary | |
---|---|
str |
TYPE_GROUP = 'http://musicbrainz.org/ns/mmd-1.0#Group'
|
str |
TYPE_PERSON = 'http://musicbrainz.org/ns/mmd-1.0#Person'...
|
Method Details |
---|
__init__(self,
id_=None,
type_=None,
name=None,
sortName=None)
Constructor.
|
addAlias(self, alias)Adds an alias for this artist.
|
addRelease(self, release)Adds a release to this artist's list of releases.
|
getAliases(self)Returns the list of aliases for this artist.
|
getBeginDate(self)Returns the birth/foundation date. The definition of the begin date depends on the artist's type. For persons, this is the day of birth, for groups it is the day the group was founded. The returned date has the format 'YYYY', 'YYYY-MM', or 'YYYY-MM-DD', depending on how much detail is known.
|
getDisambiguation(self)Returns the disambiguation attribute. This attribute may be used if there is more than one artist with the same name. In this case, disambiguation attributes are added to the artists' names to keep them apart. For example, there are at least three bands named 'Vixen'. Each band has a different disambiguation in the MusicBrainz database, like 'Hip-hop' or 'all-female rock/glam band'.
|
getEndDate(self)Get the death/dissolving date. The definition of the end date depends on the artist's type. For persons, this is the day of death, for groups it is the day the group was dissolved.
|
getName(self)Returns the artist's name.
|
getReleases(self)Returns a list of releases from this artist. This may also include releases where this artist isn't the main artist but has just contributed one or more tracks (aka VA-Releases).
|
getReleasesCount(self)Returns the number of existing releases. This may or may not match with the number of elements thatgetReleases returns. If the count is
higher than the list, it indicates that the list is incomplete.
|
getReleasesOffset(self)Returns the offset of the release list. This is used if the release list is incomplete (ie. the web service only returned part of the release for this artist). Note that the offset value is zero-based, which means release0 is the
first release.
|
getSortName(self)Returns the artist's sort name. The sort name is the artist's name in a special format which is better suited for lexicographic sorting. The MusicBrainz style guide specifies this format.
|
getType(self)Returns the artist's type.
|
getUniqueName(self)Returns a unique artist name (using disambiguation). This method returns the artist name together with the disambiguation attribute in parenthesis if it exists. Example: 'Vixen (Hip-hop)'.
|
setBeginDate(self, dateStr)Sets the begin/foundation date.
|
setDisambiguation(self, disambiguation)Sets the disambiguation attribute.
|
setEndDate(self, dateStr)Sets the death/dissolving date.
|
setName(self, name)Sets the artist's name.
|
setReleasesCount(self, value)Sets the number of existing releases.
|
setReleasesOffset(self, offset)Sets the offset of the release list.
|
setSortName(self, sortName)Sets the artist's sort name.
|
setType(self, type_)Sets the artist's type.
|
Property Details |
---|
aliasesThe list of aliases
|
beginDateThe begin/foundation date.
|
disambiguationThe disambiguation comment.
|
endDateThe death/dissolving date.
|
nameThe artist's name. |
releasesThe list of releases
|
releasesCountThe total number of releases
|
releasesOffsetThe offset of the release list.
|
sortNameThe artist's sort name.
|
typeThe artist's type. |
Class Variable Details |
---|
TYPE_GROUP
|
TYPE_PERSON
|
Home | Trees | Index | Help |
---|
Generated by Epydoc 2.1 on Wed Dec 20 18:19:28 2006 | http://epydoc.sf.net |