Development environment
Before you start hacking on Pythia, let us take a few moments to set up your environment. As Pythia makes use of User-mode Linux, the development environment is required to run on a Linux kernel too.
The following prerequisites are also needed:
Getting the code
The canonical repository is located at https://github.com/pythia-project/pythia. You can get a local clone with
git clone https://github.com/pythia-project/pythia.git
Once your clone is set up, go inside the new directory and run
devtools/git-setup.sh
This will install some git hooks to check the code style before a commit. If you wish to use your own custom hooks, add the .local suffix to the hook name.
Building
Pythia uses GNU Make as its build system. To build the whole platform, simply run make from the root of the source tree. The result is available in the out directory.
More commands are available. You can get a list of them by running make help.
Working with Go
To set up a shell session for working with the go tools, run the following command from the root of the source tree:
. devtools/goenvsetup.sh
This command will set up the GOPATH environment variable as well as others needed for running the unit tests. It will also launch a godoc HTTP server listening on localhost:6060.