Kwoon

Prerequisites

You need Git installed.

If you intend to publish the kata history, you need push rights to a remote Git repository.

Installation

RVM

bash < <( curl http://rvm.beginrescueend.com/releases/rvm-install-head )

Ruby

rvm install 1.9.2
rvm use 1.9.2

(Kwoon should run fine in 1.8 implementations too.)

gem update bundler

(You need Bundler 1.0.2 for kwoon to install correctly)

kwoon

gem install kwoon

Running a kata

kwoon create <kata_name> [--ruby_version=1.9.2]

The --ruby-version flag is optional. Kwoon defaults to creating projects targeting Ruby 1.9.2. The value of --ruby-version must be a valid RVM ruby version. Run rvm list known to see these.

cd <kata_name>

Answer "y" when asked if you trust the .rvmrc file.

Initialise Git:

kwoon git [<remote_git_repo>]

e.g.

kwoon git git@github.com:account_name/repo_name.git

You don't have to specify a remote repository if you aren't going to publish your changes.

Next start a pairing session:

kwoon start <username1> <username2> ... <usernameN>

e.g.

kwoon start fred wilma

This will create a branch "fred-wilma-YYYYMMDDhhmm"

Start autotest.

autotest

(Autotest will refuse to run if you haven't run kwoon start).

Autotest is set up to commit all your work to Git after every change in red/green status.

Hack away! Then, when done...

git push 

Git is configured to create a new branch on the remote repo from your current branch (e.g. "fred-wilma-201010081655").