Document AppEngineInsecureAdapter

docs/adapters.rst

@@ -53,6 +53,25 @@ ways to take advantage of this support at the moment:
 
        appengine.monkeypatch()
 
+If you should need to disable certification validation when monkeypatching (to
+force third-party libraries that use requests to not validate certificates, if
+they do not provide API surface to do so, for example), you can disable it:
+
+   .. code-block:: python
+
+       from requests_toolbelt.adapters import appengine
+       appengine.monkeypatch(validate_certificate=False)
+
+   .. warning::
+
+       If ``validate_certificate`` is ``False``, the monkeypatched adapter
+       will *not* validate certificates. This effectively sets the
+       ``validate_certificate`` argument to urlfetch.Fetch() to ``False``. You
+       should avoid using this wherever possible. Details can be found in the
+       `documentation for urlfetch.Fetch()`__.
+
+       __ https://cloud.google.com/appengine/docs/python/refdocs/google.appengine.api.urlfetch
+
 .. autoclass:: requests_toolbelt.adapters.appengine.AppEngineAdapter
 
 FingerprintAdapter

requests_toolbelt/adapters/appengine.py

@@ -29,6 +29,25 @@
        >>> appengine.monkeypatch()
 
 which will ensure all requests.Session objects use AppEngineAdapter properly.
+
+If you should need to disable certification validation when monkeypatching (to
+force third-party libraries that use requests to not validate certificates, if
+they do not provide API surface to do so, for example), you can disable it:
+
+   .. code-block:: python
+
+       >>> from requests_toolbelt.adapters import appengine
+       >>> appengine.monkeypatch(validate_certificate=False)
+
+   .. warning::
+
+       If ``validate_certificate`` is ``False``, the monkeypatched adapter
+       will *not* validate certificates. This effectively sets the
+       ``validate_certificate`` argument to urlfetch.Fetch() to ``False``. You
+       should avoid using this wherever possible. Details can be found in the
+       `documentation for urlfetch.Fetch()`__.
+
+       __ https://cloud.google.com/appengine/docs/python/refdocs/google.appengine.api.urlfetch
 """
 import requests
 from requests import adapters