phw/python-musicbrainz-ngs

Python bindings for Musicbrainz' NGS webservice

Musicbrainz NGS bindings

This library implements webservice bindings for the Musicbrainz NGS site, also known as /ws/2.

For more information on the musicbrainz webservice see http://wiki.musicbrainz.org/XML_Web_Service.

Usage

# Import the module
import musicbrainzngs

# If you plan to submit data, authenticate
musicbrainzngs.auth("user", "password")

# Tell musicbrainz what your app is, and how to contact you
# (this step is required, as per the webservice access rules
# at http://wiki.musicbrainz.org/XML_Web_Service/Rate_Limiting )
musicbrainzngs.set_useragent("Example music app", "0.1", "http://example.com/music")

# If you are connecting to a development server
musicbrainzngs.set_hostname("echoprint.musicbrainz.org")

See the query.py file for more examples.

More documentation is available at https://python-musicbrainz-ngs.readthedocs.org

Contribute

1. Fork the repository on Github.
2. Make and test whatever changes you desire.
3. Signoff and commit your changes using git commit -s.
4. Send a pull request.

Authors

These bindings were written by Alastair Porter. Contributions have been made by:

• Adrian Sampson
• Galen Hazelwood
• Greg Ward
• Ian McEwen
• Johannes Dewender
• Michael Marineau
• Patrick Speiser
• Paul Bailey
• Sam Doshi
• Thomas Vander Stichele
• Wieland Hoffmann

License

This library is released under the simplified BSD license. See COPYING for details.