• Home
  • History
  • Annotate
  • current directory
Name Date Size #Lines LOC

..16-Aug-2019-

docs/H11-Apr-2016-

examples/H11-Apr-2016-

musicbrainzngs/H11-Apr-2016-

test/H11-Apr-2016-

CHANGESH A D11-Apr-20165 KiB9386

COPYINGH A D19-Jun-20132.1 KiB4131

PKG-INFOH A D11-Apr-2016739 1918

README.rstH A D05-Jan-20162.4 KiB7253

query.pyH A D13-Nov-20151.2 KiB288

setup.pyH A D13-Nov-20152.1 KiB6957

README.rst

1Musicbrainz NGS bindings
2########################
3
4This library implements webservice bindings for the Musicbrainz NGS site, also known as /ws/2
5and the `Cover Art Archive <https://coverartarchive.org/>`_.
6
7For more information on the musicbrainz webservice see `<http://wiki.musicbrainz.org/XML_Web_Service>`_.
8
9Usage
10*****
11
12.. code:: python
13
14    # Import the module
15    import musicbrainzngs
16
17    # If you plan to submit data, authenticate
18    musicbrainzngs.auth("user", "password")
19
20    # Tell musicbrainz what your app is, and how to contact you
21    # (this step is required, as per the webservice access rules
22    # at http://wiki.musicbrainz.org/XML_Web_Service/Rate_Limiting )
23    musicbrainzngs.set_useragent("Example music app", "0.1", "http://example.com/music")
24
25    # If you are connecting to a different server
26    musicbrainzngs.set_hostname("beta.musicbrainz.org")
27
28See the ``query.py`` file for more examples.
29
30More documentation is available at
31`Read the Docs <https://python-musicbrainzngs.readthedocs.org>`_.
32
33Contribute
34**********
35
36If you want to contribute to this repository, please read `the
37contribution guidelines
38<https://github.com/alastair/python-musicbrainzngs/blob/master/CONTRIBUTING.md>`_ first.
39
40
41Authors
42*******
43
44These bindings were written by `Alastair Porter <http://github.com/alastair>`_.
45Contributions have been made by:
46
47* `Adrian Sampson <https://github.com/sampsyo>`_
48* `Corey Farwell <https://github.com/frewsxcv>`_
49* `Galen Hazelwood <https://github.com/galenhz>`_
50* `Greg Ward <https://github.com/gward>`_
51* `Ian McEwen <https://github.com/ianmcorvidae>`_
52* `Jérémie Detrey <https://github.com/jdetrey>`_
53* `Johannes Dewender <https://github.com/JonnyJD>`_
54* `Michael Marineau <https://github.com/marineam>`_
55* `Patrick Speiser <https://github.com/doskir>`_
56* `Pavan Chander <https://github.com/navap>`_
57* `Paul Bailey <https://github.com/paulbailey>`_
58* `Rui Gonçalves <https://github.com/ruippeixotog>`_
59* `Ryan Helinski <https://github.com/rlhelinski>`_
60* `Sam Doshi <https://github.com/samdoshi>`_
61* `Shadab Zafar <https://github.com/dufferzafar>`_
62* `Simon Chopin <https://github.com/laarmen>`_
63* `Thomas Vander Stichele <https://github.com/thomasvs>`_
64* `Wieland Hoffmann <https://github.com/mineo>`_
65
66License
67*******
68
69This library is released under the simplified BSD license except for the file
70``musicbrainzngs/compat.py`` which is licensed under the ISC license.
71See COPYING for details.
72