python-musicbrainz2: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
m (Adding mention of python-musicbrainz deprecated status.)
(→‎Next Version: also link python-discid as Disc IDs were also part of musicbrainz2.)
(13 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Status|Deprecated as of May 2011. This library is not compatible with the current [[MusicBrainz_Database/Schema|MusicBrainz schema]], but will still work with older versions and with the [[XML_Web_Service/Version_1|ws/1]] legacy web service.}}
__NOTOC__
<small>[[Products]] > python-musicbrainz2 </small>
<small>[[Products]] > python-musicbrainz2 </small>


The '''python-musicbrainz2''' package is a client library written in [http://python.org python] that provides easy object oriented access to the [[MusicBrainz Database]] using the [[XML Web Service]]. It has been written from scratch and uses a different model than its predecessor, python-musicbrainz.
: ''[[Image:Attention.png]] python-musicbrainz has been deprecated and replaced by the new client bindings python-musicbrainz2.''


API documentation can be created from the source code using [http://epydoc.sf.net epydoc] and is also [http://musicbrainz.org/~matt/python-musicbrainz2/html/ available online]. The source distribution comes with [http://bugs.musicbrainz.org/browser/python-musicbrainz2/trunk/examples example code] which demonstrates some of the most important features.
The package '''python-musicbrainz2''' is a client library written in [http://python.org python] which provides easy object oriented access to the MusicBrainz [[Database]] using the [[XML Web Service]]. It has been written from scratch and uses a different model than its predecessor, python-musicbrainz.


API documentation can be created from the source code using [http://epydoc.sf.net epydoc] and is also [http://musicbrainz.org/~matt/python-musicbrainz2/html/ available online]. The source distribution comes with [http://bugs.musicbrainz.org/browser/python-musicbrainz2/trunk/examples example code] which demonstrates some of the most important features. Questions about '''python-musicbrainz2''' can be asked on the MusicBrainz [[Developers Mailing List|developers mailing list]].
Questions about python-musicbrainz2 can be asked on the MusicBrainz [[Mailing_List#Developers.27_Mailing_List|developers mailing list]].


== Download ==
== Download ==


{|
{|
| [[Image:download.gif]] || [http://ftp.musicbrainz.org/pub/musicbrainz/python-musicbrainz2/python-musicbrainz2-0.7.0.tar.gz python-musicbrainz2-0.7.0.tar.gz] (current release) <br/><small>MD5: 7aa39add30fcd7e1724d4b29ba1f050e</small>
| [[Image:download.gif]] || [http://ftp.musicbrainz.org/pub/musicbrainz/python-musicbrainz2/python-musicbrainz2-0.7.4.tar.gz python-musicbrainz2-0.7.4.tar.gz] (current release) <br/><small>MD5: 40ac802d832deca737cce57235cb23a5</small>
|}
|}


==License==
=== License ===


The '''python-musicbrainz2''' library is licensed under a [http://opensource.org/licenses/bsd-license.php BSD style license].
The python-musicbrainz2 library is licensed under a [http://opensource.org/licenses/bsd-license.php BSD style license].


==Get Source Code==
=== Source Code ===


The source code of '''python-musicbrainz2''' is available using anonymous Subversion access. Read the [[Subversion]] document for instructions on how to use Subversion and checkout the '''python-musicbrainz2''' source code. Alternatively, you can browse the '''python-musicbrainz2''' Subversion repository directly using the [http://bugs.musicbrainz.org/browser/python-musicbrainz2/ source browser].
The source code of python-musicbrainz2 is available using anonymous Subversion access. Read the [[Subversion]] document for instructions on how to use Subversion and checkout the python-musicbrainz2 source code. Alternatively, you can browse the python-musicbrainz2 Subversion repository directly using the [http://bugs.musicbrainz.org/browser/python-musicbrainz2/ source browser].


svn checkout http://svn.musicbrainz.org/python-musicbrainz2/trunk python-musicbrainz2
svn checkout http://svn.musicbrainz.org/python-musicbrainz2/trunk python-musicbrainz2


== Troubleshooting ==
==Bugs==


If you find a bug, please report it using the MusicBrainz [http://bugs.musicbrainz.org/ bug tracker] (component '''python-musicbrainz2''') if it is not listed yet. Make sure you have read the relevant documentation (README.txt, INSTALL.txt, API documentation, FAQ) before doing so. Bugs in the [[XML Web Service|XMLWebService]] itself should be filed under the component '''XML Webservice'''.
If you find a bug, please report it on the [http://bugs.musicbrainz.org/ bug tracker] (use python-musicbrainz2 as the component) after checking to make sure it hasn't been listed yet. Also make sure you have read the relevant documentation (README.txt, INSTALL.txt, API documentation, FAQs) before doing so. Bugs regarding the [[XML Web Service]] itself should be filed under the ''XML Webservice'' component.


==FAQ==
=== FAQs ===

===Installation===

====Mac OS X: ctypes 0.9.6 doesn't compile using gcc-4.0====


; ctypes 0.9.6 doesn't compile using gcc-4.0 on Mac OS X
According to [[Ticket:1157|1157]], you have to patch ctypes to make it compile. There is [http://oubiwann.blogspot.com/2006/01/ctypes-on-mac-os-x-104-with-gcc-40.html a patch] against ctypes-0.9.6. You may also use ctypes-0.9.9.3 or later which seems to compile, but this version doesn't work with the old python-tunepimp package, so picard-0.6 won't work. picard-0.7 doesn't require the old python-tunepimp anymore and will work.
According to [[Ticket:1157|1157]], you have to patch ctypes to make it compile. There is [http://oubiwann.blogspot.com/2006/01/ctypes-on-mac-os-x-104-with-gcc-40.html a patch] against ctypes-0.9.6. You may also use ctypes-0.9.9.3 or later which seems to compile, but this version doesn't work with the old python-tunepimp package, so picard-0.6 won't work. picard-0.7 doesn't require the old python-tunepimp anymore and will work.


== Previous Version ==
== Previous Version ==


'''python-musicbrainz''' was a python wrapper for [[libmusicbrainz]] that used the [[RDF]] [[Web Service|web service]], it was a straight python to c binding, and used [http://starship.python.net/crew/theller/ctypes/ ctypes] to avoid having to write c code. It has been deprecated and replaced with python-musicbrainz2.
; python-musicbrainz

: python-musicbrainz was a python wrapper for [[libmusicbrainz]], it was a straight python to c binding, and used [http://starship.python.net/crew/theller/ctypes/ ctypes] to avoid having to write c code. This project is now a part of the [[MusicBrainz]] Client library [[libmusicbrainz]].
== Next Version ==
Planning for the next version of the library, supporting the NGS schema was at [[python-musicbrainz3]].
However that was never finished and [http://python-musicbrainzngs.readthedocs.org/ python-musicbrainzngs] is a working binding for the NGS schema.
You can use [http://python-discid.readthedocs.org/ python-discid] if you need support for reading [[Disc ID]]s.


[[Category:To Be Reviewed]] [[Category:WikiDocs Page]] [[Category:Products]] [[Category:Development]]
[[Category:WikiDocs Page]] [[Category:Products]] [[Category:Development]]

Revision as of 13:42, 6 June 2015

Status: Deprecated as of May 2011. This library is not compatible with the current MusicBrainz schema, but will still work with older versions and with the ws/1 legacy web service.

Products > python-musicbrainz2

The python-musicbrainz2 package is a client library written in python that provides easy object oriented access to the MusicBrainz Database using the XML Web Service. It has been written from scratch and uses a different model than its predecessor, python-musicbrainz.

API documentation can be created from the source code using epydoc and is also available online. The source distribution comes with example code which demonstrates some of the most important features.

Questions about python-musicbrainz2 can be asked on the MusicBrainz developers mailing list.

Download

download.gif python-musicbrainz2-0.7.4.tar.gz (current release)
MD5: 40ac802d832deca737cce57235cb23a5

License

The python-musicbrainz2 library is licensed under a BSD style license.

Source Code

The source code of python-musicbrainz2 is available using anonymous Subversion access. Read the Subversion document for instructions on how to use Subversion and checkout the python-musicbrainz2 source code. Alternatively, you can browse the python-musicbrainz2 Subversion repository directly using the source browser.

svn checkout http://svn.musicbrainz.org/python-musicbrainz2/trunk python-musicbrainz2

Troubleshooting

If you find a bug, please report it on the bug tracker (use python-musicbrainz2 as the component) after checking to make sure it hasn't been listed yet. Also make sure you have read the relevant documentation (README.txt, INSTALL.txt, API documentation, FAQs) before doing so. Bugs regarding the XML Web Service itself should be filed under the XML Webservice component.

FAQs

ctypes 0.9.6 doesn't compile using gcc-4.0 on Mac OS X

According to 1157, you have to patch ctypes to make it compile. There is a patch against ctypes-0.9.6. You may also use ctypes-0.9.9.3 or later which seems to compile, but this version doesn't work with the old python-tunepimp package, so picard-0.6 won't work. picard-0.7 doesn't require the old python-tunepimp anymore and will work.

Previous Version

python-musicbrainz was a python wrapper for libmusicbrainz that used the RDF web service, it was a straight python to c binding, and used ctypes to avoid having to write c code. It has been deprecated and replaced with python-musicbrainz2.

Next Version

Planning for the next version of the library, supporting the NGS schema was at python-musicbrainz3. However that was never finished and python-musicbrainzngs is a working binding for the NGS schema. You can use python-discid if you need support for reading Disc IDs.