gitolite/doc/testing.mkd

testing gitolite

Here's how to run the tests:

git clone git://github.com/sitaramc/gitolite
cd gitolite
git checkout -f g3

# if you're not ok with your ~/.ssh getting clobbered
prove

# if you're ok with your ~/.ssh getting clobbered
# prove t/*.t t/ssh*

Gitolite's test suite is mostly written using tsh -- the "testing shell". Take a look at some of the scripts and you will see what it looks like. It has a few quirks and nuances; if you really care, email me.

The tests also use a somewhat convoluted system of environment variables in order to run entirely as a local user, without going through ssh at all. This lets a complete test suite run in about a fifth or less of the time it would otherwise take.

If you think that defeats the purpose of the testing, you haven't read [this][auth] yet.

There are 2 specific tests that deal with ssh though, which are run only on request, as you can see above, because they clobber your ~/.ssh. You have been warned.