Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

webservice::musicbrainz::query(3pm) [debian man page]

WebService::MusicBrainz::Query(3pm)			User Contributed Perl Documentation		       WebService::MusicBrainz::Query(3pm)

NAME

       WebService::MusicBrainz::Query

SYNOPSIS

ABSTRACT

       WebService::MusicBrainz - Interface with the MusicBrainz web service.

DESCRIPTION

       This module's relationship with WebService::MusicBrainz::Artist, WebService::MusicBrainz::Release, and WebService::MusicBrainz::Track is a
       "has a" relationship.  This module will not be instantiated by any client but will only be used internally within the Artist, Release, or
       Track classes.

METHODS

   new()
       This method is the constructor and it will call for initialization.  An optional HOST parameter can be passed to select a different
       mirrored server.

   set_url_params()
       Define a list of valid URL query parameters.

   set_inc_params()
       Define a list of valid arguments for the "inc" URL query parameter.

   get()
       Perform the URL request (GET) and if success, then return a WebService::MusicBrainz::Response object.  Otherwise die.

AUTHOR

       Bob Faist <bob.faist@gmail.com>

COPYRIGHT AND LICENSE

       Copyright 2006-2009 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

perl v5.10.1							    2009-12-06				       WebService::MusicBrainz::Query(3pm)

Check Out this Related Man Page

WebService::MusicBrainz::ReleaseGroup(3pm)		User Contributed Perl Documentation		WebService::MusicBrainz::ReleaseGroup(3pm)

NAME

       WebService::MusicBrainz::ReleaseGroup

SYNOPSIS

	   use WebService::MusicBrainz::ReleaseGroup;

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

	   my $response = $ws->search({ TITLE => 'ok computer' });

	   my $release = $response->release(); # grab first one in the list

	   print $release->title(), " (", $release->type(), ") - ", $release->artist()->name(), "
";

	   # OUTPUT: OK Computer (Album Official) - Radiohead

DESCRIPTION

METHODS

   new()
       This method is the constructor and it will call for  initialization.

   query()
       This method will return the cached query object;

   search()
       This method is used to search the MusicBrainz database using their web service schema.  The only argument is a hashref to define the search
       parameters.

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

	   my $response = $ws->search({ TITLE => 'Highway to Hell' });
	   my $response = $ws->search({ ARTIST => 'sleater kinney' });
	   my $response = $ws->search({ ARTIST => 'beatles', OFFSET => 4 });
	   my $response = $ws->search({ ARTISTID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab' });
	   my $response = $ws->search({ DISCID => 'XgrrQ8Npf9Uz_trPIFMrSz6Mk6Q-' });
	   my $response = $ws->search({ RELEASETYPES => 'Official', MBID => 'a89e1d92-5381-4dab-ba51-733137d0e431' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'artist' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'counts' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'release-events' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'discs' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'tracks' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'artist-rels' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'release-rels' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'track-rels' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'url-rels' });

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

	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'artist url-rels' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'artist,url-rels' });
	   my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'artist+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

perl v5.10.1							    2009-12-06				WebService::MusicBrainz::ReleaseGroup(3pm)
Man Page