Python Bindings

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

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

• https://github.com/Polochon-street/bliss/tree/master/python/examples