python-musicbrainz2: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
((Imported from MoinMoin))
 
(→‎Next Version: also link python-discid as Disc IDs were also part of musicbrainz2.)
(21 intermediate revisions by 9 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.}}
<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.


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.
==Introduction==


Questions about python-musicbrainz2 can be asked on the MusicBrainz [[Mailing_List#Developers.27_Mailing_List|developers mailing list]].
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|XMLWebService]]. It has been written from scratch and uses a different model than [[python-musicbrainz|PythonMusicbrainz]], the first generation python bindings.


== Download ==
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|DevelopersMailingList]].
<ul><li style="list-style-type:none">[[Image:download.gif]] See the [[python-musicbrainz2 Download|PythonMusicBrainz2Download]] page
</ul>


{|
==Bugs==
| [[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 ===
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 '''MusicBrainz Server'''.


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


===Installation===
=== 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].
====Mac OS X: ctypes 0.9.6 doesn't compile using gcc-4.0====


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

== Troubleshooting ==

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.

=== FAQs ===

; 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 ==
[[Category:To Be Reviewed]] [[Category:WikiDocs Page]] [[Category:Development]]

'''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.

== 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: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.