debci - setting up a development environment

Install the dependencies and build dependencies (look at debian/control). You probably also want to install a few other packages:

After having the dependencies installed, the first step is to set up the test environment. To do that, you need to run the following command (which needs root permissions):

$ sudo ./bin/debci-setup

If you run debci right now, it would run the tests for every package in Debian, and you don't want that for a development environment. To restrict debci to a list of packages, create a file named whitelist inside the config directory, containing one package name per line. Here is an example with packages whose tests are pretty fast:

$ cat config/whitelist
ruby-defaults
rubygems-integration
ruby-ffi
rake

You might want to test with other packages, that's fine. Just take into consideration that the more packages you have, the longer debci will take to finish a run.

Now you are ready to actually run debci:

$ ./bin/debci-batch
$ ./bin/debci-generate-index

To visualize the web interface, follow the following steps:

$ make
$ ./tools/server.sh

Now browse to localhost:8888/

If you think the web interface looks empty, it is because a single debci run does not provide enough data to work with. You might want to generate some fake data so the web interface will look a lot nicer:

$ ./tools/gen-fake-data.sh