python-musicbrainz2: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(Adding previous version information from python-musicbrainz.)
No edit summary
 
(17 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.}}
__NOTOC__
<small>[[Products]] > python-musicbrainz2 </small>


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.
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. Questions about '''python-musicbrainz2''' can be asked on the MusicBrainz [[Developers Mailing List|DevelopersMailingList]].
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 [[Mailing_List#Developers.27_Mailing_List|developers mailing list]].
:[[Image:download.gif]] See the [[python-musicbrainz2 Download|PythonMusicBrainz2Download]] page


==Bugs==
== Download ==


{|
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'''.
| [[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>
|}


==FAQ==
=== License ===


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


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


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

== 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 ==
== 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:End_of_Life_Products]] [[Category:Development]]

Latest revision as of 09:51, 3 May 2020

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.

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.