Skip to content
Python bindings for Musicbrainz' NGS webservice
Branch: master
Clone or download
Freso Specify supported version(s) of Python in setup.py
This specifies which versions of Python the library is compatible with.
This both prevents the module from being installed in an incompatible
Python environment, and will also enable users after future releases to
still `pip install musicbrainzngs` and get a version that is compatible
with their Python setup.

Versions are based on the ones currently being tested for in Travis
according to `.travis.yml`.

See https://packaging.python.org/guides/distributing-packages-using-setuptools/#python-requires
and https://packaging.python.org/guides/dropping-older-python-versions/

Signed-off-by: Frederik “Freso” S. Olesen <freso.dk@gmail.com>
Latest commit 4725857 Mar 10, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Update intersphinx and external link mappings Jul 11, 2018
examples improving collection example for different types Jan 30, 2016
musicbrainzngs
test Add missing valid seach parameters Sep 9, 2018
.gitignore Better .gitignore Feb 21, 2016
.travis.yml Make travis python versions match tox versions Jul 11, 2018
CHANGES Update CHANGES for #231 & #237 Jul 17, 2018
CONTRIBUTING.md Move the contribution guidelines to their own file. Jun 2, 2015
COPYING make COPYING readable in default terminal width Jun 7, 2013
MANIFEST.in Add README.rst to manifest.in Feb 10, 2014
README.rst Update hostname example to use a domain which actually exists Jan 5, 2016
query.py Remove puid support Jul 11, 2018
setup.py Specify supported version(s) of Python in setup.py Mar 15, 2019
tox.ini Add Python 3.7 to tox Jul 11, 2018

README.rst

Musicbrainz NGS bindings

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

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 different server
musicbrainzngs.set_hostname("beta.musicbrainz.org")

See the query.py file for more examples.

More documentation is available at Read the Docs.

Contribute

If you want to contribute to this repository, please read the contribution guidelines first.

Authors

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

License

This library is released under the simplified BSD license except for the file musicbrainzngs/compat.py which is licensed under the ISC license. See COPYING for details.

You can’t perform that action at this time.