add a noop introspector (allow introspection to be turned off)

1 files changed, 18 insertions, 2 deletions

diff --git a/docs/narr/introspector.rst b/docs/narr/introspector.rst
index ac0859164..71b41773c 100644
--- a/docs/narr/introspector.rst
+++ b/docs/narr/introspector.rst
@@ -512,8 +512,8 @@ introspectables in categories not described here.
 
      The ``over`` argument passed to ``add_tween`` (a string).
 
-Toolbar Introspection
----------------------
+Introspection in the Toolbar
+----------------------------
 
 The Pyramid debug toolbar (part of the ``pyramid_debugtoolbar`` package)
 provides a canned view of all registered introspectables and their
@@ -521,4 +521,20 @@ relationships.  It looks something like this:
 
 .. image:: tb_introspector.png
 
+Disabling Introspection
+-----------------------
 
+You can disable Pyramid introspection by passing the object
+:attr:`pyramid.registry.noop_introspector` to the :term:`Configurator`
+constructor in your application setup:
+
+.. code-block:: python
+
+   from pyramid.config import Configurator
+   from pyramid.registry import noop_introspector
+   config = Configurator(..., introspector=noop_introspector)
+
+When the noop introspector is active, all introspectables generated by the
+framework are thrown away.  A noop introspector behaves just like a "real"
+introspector, but the methods of a noop introspector do nothing and return
+null values.