[Checkins] SVN: z3c.testsetup/branches/new_markers/src/z3c/testsetup/tests/othercave/doctest08.py Add example for doctests in Python modules.

[Uli Fouquet]

Log message for revision 94559:
  Add example for doctests in Python modules.

Changed:
  A   z3c.testsetup/branches/new_markers/src/z3c/testsetup/tests/othercave/doctest08.py

-=-
Added: z3c.testsetup/branches/new_markers/src/z3c/testsetup/tests/othercave/doctest08.py
===================================================================
--- z3c.testsetup/branches/new_markers/src/z3c/testsetup/tests/othercave/doctest08.py	                        (rev 0)
+++ z3c.testsetup/branches/new_markers/src/z3c/testsetup/tests/othercave/doctest08.py	2009-01-07 02:34:18 UTC (rev 94559)
@@ -0,0 +1,37 @@
+"""
+Doctests in a Python module
+===========================
+
+We can place doctests also in Python modules.
+
+:doctest:
+
+Here the Cave class is defined::
+
+  >>> from z3c.testsetup.tests.othercave.doctest08 import Cave
+  >>> Cave
+  <class 'z3c.testsetup...doctest08.Cave'>
+
+"""
+class Cave(object):
+    """A Cave.
+
+    A cave has a number::
+
+      >>> hasattr(Cave, 'number')
+      True
+    
+    """
+    number = None
+
+    def __init__(self, number):
+        """Create a Cave.
+
+        We have to give a number if we create a cave::
+
+          >>> c = Cave(12)
+          >>> c.number
+          12
+          
+        """
+        self.number = number