Working with the Source

Setting up a Development Sandbox

  1. Set up a server or virtual machine.

  2. Clone the kwapi project to the machine:

    $ git clone
    $ cd ./kwapi-g5k
  3. Once this is done, use install option of file to install kwapi locally:

    $ python install
  4. If some dependant packages are missing, fix them with pip install:

    $ pip install -r requirements.txt
  1. You can start to hack kwapi. If you are preparing a patch, create a topic branch and switch to it before making any changes:

    $ git checkout -b TOPIC-BRANCH
  2. Use git to push your changes and ask for a pull request.

  3. Package your solution for Debian installation:

    $ python --command-packages=stdeb.command bdist_deb
    $ cd deb_dist/

    All the deb archives are exported in this directory.

  4. Import the new generated packages of kwapi-g5k on the remote apt repository.

  5. Execute Puppet on the VM to install the latest version of Kwapi or simply run:

    $ apt-get update && apt-get install python-kwapi-g5k

Code Reviews

Kwapi uses the GitHub to hos all code and developer documentation contributions. You can report an issue or a feature request on this repository.

Bugzilla can also be used for API related bugs or device configuration problems.