Package musicbrainz2 :: Module webservice
[frames] | no frames]

Module webservice

source code

Classes for interacting with the MusicBrainz XML web service.

The WebService class talks to a server implementing the MusicBrainz XML web service. It mainly handles URL generation and network I/O. Use this if maximum control is needed.

The Query class provides a convenient interface to the most commonly used features of the web service. By default it uses WebService to retrieve data and the XML parser to parse the responses. The results are object trees using the MusicBrainz domain model.


Author: Matthias Friedrich <matt@mafr.de>

Classes
  IWebService
An interface all concrete web service classes have to implement.
  WebServiceError
A web service error has occurred.
  ConnectionError
Getting a server connection failed.
  RequestError
An invalid request was made.
  ResourceNotFoundError
No resource with the given ID exists.
  AuthenticationError
Authentication failed.
  ResponseError
The returned resource was invalid.
  WebService
An interface to the MusicBrainz XML web service via HTTP.
  IFilter
A filter for collections.
  ArtistFilter
A filter for the artist collection.
  LabelFilter
A filter for the label collection.
  ReleaseGroupFilter
A filter for the release group collection.
  ReleaseFilter
A filter for the release collection.
  TrackFilter
A filter for the track collection.
  UserFilter
A filter for the user collection.
  IIncludes
An interface implemented by include tag generators.
  ArtistIncludes
A specification on how much data to return with an artist.
  ReleaseIncludes
A specification on how much data to return with a release.
  ReleaseGroupIncludes
A specification on how much data to return with a release group.
  TrackIncludes
A specification on how much data to return with a track.
  LabelIncludes
A specification on how much data to return with a label.
  Query
A simple interface to the MusicBrainz web service.