Developing EKG

Reporting Bugs

In order to report bugs appropriately please make sure to do the following.

• File a bug report on Fedora Hosted
• Please make sure to tag it to the version you are using. If a tag is not available, note it directly in the bug report, and an admin will fix it for you.
• If you installed EKG from an RPM, include the RPM version
• If you are running directly out of the development source code, include the hash code from git
• Include your terminal session, including any stack traces
• Save a copy of your Sqllite database
• Compress (tarballs please) and save a copy of your working directory, so we can check the cache EKG builds. Since most documents are text, compression can save considerable bandwidth and time.

Setting up Development

EKG uses setuptools so setting up an environment with virtualenv is not difficult.

$ sudo yum install python-virtualenv python-setuptools-devel
$ git clone ssh://git.fedorahosted.org/ekg.git ekg
$ cd ekg
ekg $ virtualenv --no-site-packages ~/virtualenvs/ekg
ekg $ source ~/virtualenvs/ekg/bin/activate
(ekg) ekg $ python setup.py develop
(ekg) ekg$ cd ..
(ekg) $ mkdir ekg-run
(ekg) $ cd ekg-run
(ekg) ekg-run $ <run ekg commands here>

Playing Appropriate Music

Loud Music is Good and Good Music is Loud. Good and Loud music is a necessary prerequisite for working on EKG.