WebService::MusicBrainz::Artist
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
This module is used to query an artist from the MusicBrainz web service.
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');
This method returns the cached WebService::MusicBrainz::Query object.
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' });
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.
http://wiki.musicbrainz.org/XMLWebService
To install WebService::MusicBrainz, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::MusicBrainz
CPAN shell
perl -MCPAN -e shell install WebService::MusicBrainz
For more information on module installation, please visit the detailed CPAN module installation guide.