NAME

WebService::MusicBrainz::Artist

SYNOPSIS

use WebService::MusicBrainz::Artist;

my $ws = WebService::MusicBrainz::Artist->new();

my $response = $ws->search({ NAME => 'white lion' });

my $artist = $response->artist(); # get first in list

print $artist->name(), " ", $artist->life_span_begin(), "-", $artist->life_span_end(), "\n";

# OUTPUT: White Lion 1983-1991

DESCRIPTION

This module is used to query an artist from the MusicBrainz web service.

METHODS

new()

This method is the constructor and it will make a call for initialization. This method will take an optional HOST parameter to specify a mirrored server. The default is "musicbrainz.org".

my $ws = WebService::MusicBrainz::Artist->new(HOST => 'de.musicbrainz.org');

query()

This method returns the cached WebService::MusicBrainz::Query object.

search()

This method will perform the search of the MusicBrainz database through their web service schema and return a response object.

my $ws = WebService::MusicBrainz::Artist->new();

my $response = $ws->search({ MBID => 'd15721d8-56b4-453d-b506-fc915b14cba2' });
my $response = $ws->search({ NAME => 'throwing muses' });
my $response = $ws->search({ NAME => 'james', LIMIT => 5 });
my $response = $ws->search({ NAME => 'beatles', OFFSET => 5 });
my $response = $ws->search({ MBID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab', INC => 'aliases' });
my $response = $ws->search({ MBID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab', INC => 'artist-rels' });
my $response = $ws->search({ MBID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab', INC => 'release-rels' });
my $response = $ws->search({ MBID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab', INC => 'track-rels' });
my $response = $ws->search({ MBID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab', INC => 'url-rels' });

Multiple INC params can be delimited by whitespace, commas, or + characters.

my $response = $ws->search({ MBID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab', INC => 'aliases url-rels' });
my $response = $ws->search({ MBID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab', INC => 'aliases,url-rels' });
my $response = $ws->search({ MBID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab', INC => 'aliases+url-rels' });

AUTHOR

Bob Faist <bob.faist@gmail.com>

COPYRIGHT AND LICENSE

Copyright 2006-2007 by Bob Faist

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

http://wiki.musicbrainz.org/XMLWebService