Docs and examples to top level

1 files changed, 27 insertions, 0 deletions

diff --git a/docs/scripting/mitmproxy.rst b/docs/scripting/mitmproxy.rst
new file mode 100644
index 00000000..1626eb5a
--- /dev/null
+++ b/docs/scripting/mitmproxy.rst
@@ -0,0 +1,27 @@
+.. _mitmproxy:
+
+mitmproxy
+=========
+
+.. note::
+
+    We strongly encourage you to use :ref:`inlinescripts` rather than mitmproxy.
+        - Inline Scripts are equally powerful and provide an easier syntax.
+        - Most examples are written as inline scripts.
+        - Multiple inline scripts can be used together.
+        - Inline Scripts can either be executed headless with mitmdump or within the mitmproxy UI.
+
+
+All of mitmproxy's basic functionality is exposed through the **mitmproxy**
+library. The example below shows a simple implementation of the "sticky cookie"
+functionality included in the interactive mitmproxy program. Traffic is
+monitored for ``Cookie`` and ``Set-Cookie`` headers, and requests are rewritten
+to include a previously seen cookie if they don't already have one. In effect,
+this lets you log in to a site using your browser, and then make subsequent
+requests using a tool like curl, which will then seem to be part of the
+authenticated session.
+
+
+.. literalinclude:: ../../examples/stickycookies
+   :caption: examples/stickycookies
+   :language: python