[z3-five] Functional doctests for Five

[Martijn Faassen]

Philipp von Weitershausen wrote:
> Martijn Faassen wrote:

>>> Sidnei implemented functional doctests in ZopeTestCase;
>>> Create a branch to convert Five tests to this.
>>
>> All of them?
> 
> Why not? :)

Because I think some of the tests exercise python-level functionality, 
though I think most don't and make sense as functional tests.

What is the new ZopeTestCase requirement? Do we need a new version? I 
only want to depend on released versions of ZopeTestCase if at all 
possible. I also saw ZopeTestCase is being folded into the Zope core; 
how does this relate to that?

>> I'm not yet overwhelmed by the greatness of the functional doctest 
>> paradigm,
> 
> Care to explain?

I'm not yet convinced functional doctests are the most writeable and 
readable form of tests. That doesn't mean I'm convinced they're not, but 
I'll just have to see. I think adding documentation in the tests will be 
helpful, as we're testing many interesting cases which need more 
description.

>> but we'll see what this branch will look like. :)
> 
> Ok. I'll convert a few tests and then you can say whether you like it or 
> not.

As importantly, you can also figure out whether you like them for Five 
or not. :)

Regards,

Martijn