Add example to intercept/change specific requests

This example captures requests to a specific URL and returns an
arbitrary response instead.  It's common enough that is useful to have
in the docs.

It also adds links to the Request and Response classes to help
developers writing scripts.

1 files changed, 15 insertions, 0 deletions

diff --git a/docs/src/content/addons-scripting.md b/docs/src/content/addons-scripting.md
index f9973b9e..4e9916ca 100644
--- a/docs/src/content/addons-scripting.md
+++ b/docs/src/content/addons-scripting.md
@@ -15,3 +15,18 @@ that adds a header to every request.
 
 
 {{< example src="examples/addons/scripting-headers.py" lang="py" >}}
+
+
+Here's another example that intercepts requests to a particular URL and sends
+an arbitrary response instead:
+
+{{< example src="examples/simple/send_reply_from_proxy.py" lang="py" >}}
+
+
+You can look at the [http][] module, or the [Request][], and
+[Response][] classes for other attributes that you can use when
+scripting.
+
+[http][]: https://github.com/mitmproxy/mitmproxy/blob/master/mitmproxy/http.py
+[Request]: https://github.com/mitmproxy/mitmproxy/blob/master/mitmproxy/net/http/request.py
+[Response]: https://github.com/mitmproxy/mitmproxy/blob/master/mitmproxy/net/http/response.py