Convert doctests in 'zope.security.proxy' into Sphinx doctest snppets.

They are still tested under 'tox -e docs'.

2 files changed, 44 insertions, 0 deletions

diff --git a/docs/api/proxy.rst b/docs/api/proxy.rst
new file mode 100644
index 0000000..665912a
--- /dev/null
+++ b/docs/api/proxy.rst
@@ -0,0 +1,43 @@
+:mod:`zope.security.proxy`
+===============================
+
+.. testsetup::
+
+   from zope.component.testing import setUp
+   setUp()
+
+.. autofunction:: zope.security.proxy.getTestProxyItems
+
+.. autofunction:: zope.security.proxy.isinstance
+
+.. doctest::
+
+   >>> from zope.security.proxy import isinstance
+   >>> class C1(object):
+   ...     pass
+
+   >>> c = C1()
+   >>> isinstance(c, C1)
+   True
+
+   >>> from zope.security.checker import ProxyFactory
+   >>> isinstance(ProxyFactory(c), C1)
+   True
+
+   >>> class C2(C1):
+   ...     pass
+
+   >>> c = C2()
+   >>> isinstance(c, C1)
+   True
+
+   >>> from zope.security.checker import ProxyFactory
+   >>> isinstance(ProxyFactory(c), C1)
+   True
+
+
+
+.. testcleanup::
+
+   from zope.component.testing import tearDown
+   tearDown()
diff --git a/docs/index.rst b/docs/index.rst
index 6f772a6..53c12c4 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -14,6 +14,7 @@ API Reference
    api/management
    api/permission
    api/protectclass
+   api/proxy