mitmproxy/README.mkd

40 lines
1.2 KiB
Markdown
Raw Normal View History

[![Build Status](https://travis-ci.org/mitmproxy/pathod.png?branch=master)](https://travis-ci.org/mitmproxy/pathod) [![Coverage Status](https://coveralls.io/repos/mitmproxy/pathod/badge.png?branch=master)](https://coveralls.io/r/mitmproxy/pathod)
2013-12-16 03:47:29 +00:00
__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.
2012-06-23 22:18:20 +00:00
- __pathoc__, a perverse HTTP client.
- __libpathod.test__, an API for easily using __pathod__ and __pathoc__ in unit tests.
2012-07-29 03:49:26 +00:00
# Documentation
2012-07-29 03:36:00 +00:00
The pathod documentation is self-hosted. Just fire up pathod, like so:
./pathod
And then browse to:
http://localhost:9999
2012-07-29 03:49:26 +00:00
You can aways view the documentation for the latest release at the pathod
website:
http://pathod.net
2012-06-23 22:18:20 +00:00
2012-04-29 10:13:47 +00:00
# Installing
2012-04-29 10:08:35 +00:00
2012-06-21 04:58:10 +00:00
If you already have __pip__ on your system, installing __pathod__ and its
dependencies is dead simple:
2012-04-29 10:08:35 +00:00
pip install pathod
2012-07-29 03:36:00 +00:00
The project has the following dependencies:
* [netlib](http://github.com/cortesi/netlib)
* [requests](http://docs.python-requests.org/en/latest/index.html)
2012-06-23 22:18:20 +00:00
2012-07-29 03:36:00 +00:00
The project's test suite uses the
[nose](http://nose.readthedocs.org/en/latest/) unit testing framework.