kodo-python contains a set of high-level python bindings for the Kodo Network Coding C++ library. The bindings provide access to basic functionality provided by Kodo, such as encoding and decoding of data. The examples folder provides sample applications showing usage of the python API.
A valid license is required if you wish to use and install this library. Please request a license by filling out the license request** form.
Note, this project is available under a research- and educational-friendly license, see the details in the LICENSE.rst file.
We provide a pip package for easy installation of the kodo-python library.
- To install this you'll need python and pip installed:
- To get python go here.
- To install pip follow this guide.
Depending on your platform, you will need a set of tools and libraries to build the library.
Common for all platforms is that you will need a recent C++11 compiler. The compilers used by Steinwurf are listed on the buildbot page.
These steps may not work with your specific Linux distribution, but they may guide you in the right direction.
First, acquire the required packages from your package management system:
sudo apt-get update sudo apt-get install python git build-essential libpython-dev
If you are using Python 3, you'll need to install libpython3-dev instead.
When you are ready to install the package, you can simply type:
sudo pip install kodo
Follow this guide to install git.
Install Xcode and Command-line Tools from the Mac Store.
When you are ready to install the package, you can simply type:
sudo pip install kodo
Install Python 2.7 32-bit and Visual Studio 2013 (Express).
Now set the following environment variable VS90COMNTOOLS to:
C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\Tools\
so that Python distutils can detect your new compiler.
To enable the use of pip from the command line, ensure that the Scripts
subdirectory of your Python installation is available on the system PATH.
(This is not done automatically.)
When you are ready to install the package, you can simply type:
pip install kodo
If you prefer not to use pip, you can also build the bindings yourself.
Before doing anything, make sure you've installed the requirements specified in the previous section.
When you have installed all dependencies, you can clone the project:
git clone https://github.com/steinwurf/kodo-python.git
configure and build the project:
cd kodo-python python waf configure python waf build
Now the project is built and you should be able to find the resulting kodo.so file here (the actual path and extension is dependent on your OS and python version.):
build/linux/src/kodo_python/kodo.so
You can add this path to your PYTHONPATH and import the module in your Python script:
>>> import kodo