aboutsummaryrefslogtreecommitdiffstats
path: root/pathod/README.rst
diff options
context:
space:
mode:
Diffstat (limited to 'pathod/README.rst')
-rw-r--r--pathod/README.rst60
1 files changed, 60 insertions, 0 deletions
diff --git a/pathod/README.rst b/pathod/README.rst
new file mode 100644
index 00000000..5593e053
--- /dev/null
+++ b/pathod/README.rst
@@ -0,0 +1,60 @@
+pathod
+^^^^^^
+
+|travis| |coveralls| |downloads| |latest_release| |python_versions|
+
+**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.
+
+Installing
+----------
+
+If you already have **pip** on your system, installing **pathod** and its
+dependencies is dead simple:
+
+.. code-block:: text
+
+ pip install pathod
+
+Documentation
+-------------
+
+The pathod documentation is self-hosted. Just fire up pathod, like so:
+
+.. code-block:: text
+
+ ./pathod
+
+And then browse to:
+
+`<http://localhost:9999>`_
+
+You can always view the documentation for the latest release at the pathod
+website:
+
+`<http://pathod.net>`_
+
+
+.. |travis| image:: https://shields.mitmproxy.org/travis/mitmproxy/pathod/master.svg
+ :target: https://travis-ci.org/mitmproxy/pathod
+ :alt: Build Status
+
+.. |coveralls| image:: https://shields.mitmproxy.org/coveralls/mitmproxy/pathod/master.svg
+ :target: https://coveralls.io/r/mitmproxy/pathod
+ :alt: Coverage Status
+
+.. |downloads| image:: https://shields.mitmproxy.org/pypi/dm/pathod.svg?color=orange
+ :target: https://pypi.python.org/pypi/pathod
+ :alt: Downloads
+
+.. |latest_release| image:: https://shields.mitmproxy.org/pypi/v/pathod.svg
+ :target: https://pypi.python.org/pypi/pathod
+ :alt: Latest Version
+
+.. |python_versions| image:: https://shields.mitmproxy.org/pypi/pyversions/pathod.svg
+ :target: https://pypi.python.org/pypi/pathod
+ :alt: Supported Python versions \ No newline at end of file