From 680801a47edd9cf26f1f1b798ed545d9eb875ff9 Mon Sep 17 00:00:00 2001 From: Aldo Cortesi Date: Sun, 29 Jul 2012 15:49:26 +1200 Subject: README.txt and README.mkd tweaks. --- README.txt | 41 +++++++++++++++++++++++++++++++++-------- 1 file changed, 33 insertions(+), 8 deletions(-) (limited to 'README.txt') diff --git a/README.txt b/README.txt index 6feb5c3c..c531b93a 100644 --- a/README.txt +++ b/README.txt @@ -1,18 +1,43 @@ -__pathod__ is a collection of pathological tools for testing and torturing HTTP +**pathod** is a collection of pathological tools for testing and torturing HTTP clients and servers. The project has three components: -- __pathod__, an pathological HTTP daemon. -- __pathoc__, a perverse HTTP client. -- __libpathod.test__, an API for easily using __pathod__ and __pathoc__ in unit tests. +- **pathod**, an pathological HTTP daemon. +- **pathoc**, a perverse HTTP client. +- **libpathod.test**, an API for easily using pathod and pathoc in unit tests. -# Installing +Documentation +------------- -If you already have __pip__ on your system, installing __pathod__ and its +The pathod documentation is self-hosted. Just fire up pathod, like so: + + ./pathod + +And then browse to: + + http://localhost:9999 + +You can aways view the documentation for the latest release at the pathod +website: + + http://pathod.net + + +Installing +---------- + +If you already have **pip** on your system, installing **pathod** and its dependencies is dead simple: pip install pathod -The project uses the __nose__ unit testing framework, which you can get here: +The project has the following dependencies: + +* netlib_ +* requests_ + +The project's test suite uses the nose_ unit testing framework. - FIXME +.. _netlib: http://github.com/cortesi/netlib +.. _requests: http://docs.python-requests.org/en/latest/index.html +.. _nose: http://nose.readthedocs.org/en/latest/ -- cgit v1.2.3