aboutsummaryrefslogtreecommitdiffstats
path: root/README.mkd
diff options
context:
space:
mode:
authorAldo Cortesi <aldo@nullcube.com>2012-06-24 10:18:20 +1200
committerAldo Cortesi <aldo@nullcube.com>2012-06-24 10:18:20 +1200
commit3bc7f4e1cd8f01413b4a697d9009a39c100c8bb0 (patch)
treef120694789272758a6fb9c5e0a6d1bc72ba8d797 /README.mkd
parente236d7746a3780c4d14e57e1c1e6661bb7a3ef21 (diff)
downloadmitmproxy-3bc7f4e1cd8f01413b4a697d9009a39c100c8bb0.tar.gz
mitmproxy-3bc7f4e1cd8f01413b4a697d9009a39c100c8bb0.tar.bz2
mitmproxy-3bc7f4e1cd8f01413b4a697d9009a39c100c8bb0.zip
Documentation skeleton.
Diffstat (limited to 'README.mkd')
-rw-r--r--README.mkd25
1 files changed, 16 insertions, 9 deletions
diff --git a/README.mkd b/README.mkd
index 86c82a5f..9920ec8b 100644
--- a/README.mkd
+++ b/README.mkd
@@ -3,9 +3,12 @@ __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 fiendishly perverse HTTP client.
+- __pathoc__, a perverse HTTP client.
- __libpathod.test__, an API for easily using __pathod__ and __pathoc__ in unit tests.
+
+# pathod
+
At __pathod__'s heart is a tiny, terse language for crafting HTTP responses.
The simplest way to use __pathod__ is to fire up the daemon, and specify the
response behaviour you want using this language in the request URL. Here's a
@@ -31,8 +34,7 @@ various other goodies. Try it by visiting the server root:
-Specifying Responses
-====================
+## Specifying Responses
The general form of a response is as follows:
@@ -117,8 +119,8 @@ once at 10 bytes and once at 20, then disconnects at 5000:
200:b@1m:p10,10:p20,10:d5000
-Features
-========
+## Features
+
#### hKEY=VALUE
@@ -158,8 +160,9 @@ forever. OFFSET can also be "r" to generate a random offset, or "a" for an
offset just after all data has been sent.
-Value Specifiers
-================
+
+
+## Value Specifiers
There are three different flavours of value specification.
@@ -240,7 +243,7 @@ Supported data types are:
bytes
-# API
+## API
__pathod__ exposes a simple API, intended to make it possible to drive and
inspect the daemon remotely for use in unit testing and the like.
@@ -299,6 +302,9 @@ interface.
A POST to this URL clears the log buffer.
+
+
+
# Installing
If you already have __pip__ on your system, installing __pathod__ and its
@@ -307,5 +313,6 @@ dependencies is dead simple:
pip install pathod
The project uses the __nose__ unit testing framework, which you can get here:
-
+
+ FIXME