Installation

Dependencies

python-libdiscid depends on the following components:

• libdiscid
• Cython (>= 0.15)

Note that Cython is only required if one builds python-libdiscid from the repository. The released tarballs ship with pre-built C source files for the extension mdoules.

On Debian based systems, the dependencies are only an apt-get away:

apt-get install cython libdiscid0-dev

Cython is also available via PyPI:

pip install cython

Known supported distributions

python-libdiscid is available in some distributions:

• Debian
• Ubuntu
• Arch

PyPI

python-libdiscid is available from PyPI:

pip install python-libdiscid

You can also download the tarball from PyPI manually, unpack it and run:

python setup.py install

A note for Windows users

There are eggs available from the same source too. With these eggs, the extension module comes pre-built. However, you still need to fetch discid.dll from libdiscid and copy the DLL to somewhere it can be found, e.g. to C:\WINDOWS\system32.

Building python-libdiscid locally

If you just want to try python-libdiscid without installing, please note that per default setuptools will build the extension module in build/lib.* and doesn’t copy it to libdiscid. There are many possible ways to work with this limitation:

• Running:

  python setup.py build_ext -i

  will copy the extension modules to libdiscid and one can hack right away.

• Use setuptools develop command. Please read setuptools‘s documentation for further information.

• If you build with python setup.py build, It is also possible to put build/lib.* before the source directory of python-libdiscid in sys.path. Assuming that python-libdiscid is built on a 64 bit Linux and for Python 3.2, one can use the following lines to achieve that:

  import sys, os
  sys.path.insert(0, os.path.abspath('build/lib.linux-x86_64-3.2'))
  import libdiscid
  

  Please note that modification to any file in the libdiscid directory will only be available after another run of python setup.py build.