README @ 5c274209a7ec webui

Merge the README changes and the review init.
author Steve Losh <steve@stevelosh.com>
date Wed, 21 Oct 2009 19:31:46 -0400
parents 82f04bfc46b8
children f11f57ebfb98
-*- markdown -*-

This is a work in progress.  I wouldn't try it out on anything important...

Installing
==========

`hg-review` requires Mercurial (probably 1.3.1+) and **Python 2.6+**.  Seriously, you need the latest version of Python.  I'm not going to rewrite `os.relpath()` to support older versions, sorry.

Get it:

    hg clone http://bitbucket.org/sjl/hg-review/

Add it to `~/.hgrc`:

    [extensions]
    review = [path to]/hg-review/review/

Try It
======

`hg-review` uses itself for code review.

I know, I know, it's so goddamn meta I think the internet might explode.

If you want to get a quick taste of how it works:

    cd path/to/wherever/you/cloned/hg-review
    hg review --init
    hg review --web

Now visit <http://localhost:8080/> and have fun.  Use `^C` to kill the server when you're done.

Unit Tests
==========

The unit tests require nose:

    pip install nose

Don't have pip?  Get it.  But if you *really* want to `easy_install`...

    easy_install nose

Run the unit tests:

    cd [path to]/hg-review
    nosetests

Progress
========

Take a look at the list of tests to see what I've got working so far:

    cd [path to]/hg-review
    nosetests -v