Python Bindings

Lucas Verney edited this page Dec 9, 2015 · 5 revisions
Clone this wiki locally

Welcome to the bliss wiki for the Python version of Bliss

Compilation

  1. First compile bliss and install the bliss library as per the README
  2. Python 3: For distro's that do not default to python3 install your python3 version of setup_tools

e.g. for Ubuntu 14.04

sudo apt-get install python3-setuptools

Then install the python binding for python3:

cd python
sudo python3 setup.py install

If your distro defaults to python3 then:

cd python
sudo python setup.py install
  1. Python 2: For distro's that do not default to python2 install your python2 version of setup_tools

Then install the python binding for python2:

cd python
sudo python2 setup.py install

If your distro defaults to python2 then:

cd python
sudo python setup.py install

Using the library

The python bindings are a thin wrapper over the library. When creating a bl_song(filename) object remember to explicitly free memory before the end-usage e.g.

b = bl_song(myfullpath)
b.free()

Alternatively use the with syntax:

with bl_song(myfullpath) as b:
    pass

The python/examples folder contains examples showing how to use the library: