[Zope-dev] RFC: Proposed new style for documenting and testing ZTK packages

[Wichert Akkerman]

On 4/19/10 15:48 , Marius Gedminas wrote:
>      def doctest_MyClass_bar():
>          """Test MyClass.bar
>
>              >>>  y = MyClass()
>
>           The bar method peforms a bar calculation that typically returns
>           twenty-three:
>
>              >>>  y.bar()
>              23
>
>          """

What is the advantage of that over:

     def test_something(self):
          # Test MyClass.bar

          y=MyClass()

          # The bar method peforms a bar calculation that typically
          # returns 23.

          self.assertEqual(y.bar(), 23)

It reads the same, and as a bonus you can step through it with pdb and 
syntax highlighting works normally in most editors.

Wichert.