Tres Seaver wrote:
[let's not suddenly change the behavior of __call__ for backwards
> If so, that code is already broken: it depends on an undocumented
> implementation detail (of a non-API method). The patch makes the
> __call__ method an API, and documents the (new) exception type. Anybody
> whose code breaks when this happens can hold off upgrading
> zope.interface until they fix that usage.
Documentation status aside, are you really maintaining that a feature
that people have been using for many years is not actually part of the
API? So that we can change willy-nilly without any concern for backwards
If you do insist on taking that position, then please note that while
API may not be documented in zope.interface it is certainly documented
in other places. The __call__ behavior and the TypeError behavior for
instance is documented in at least one published book (see bottom of the
Documented for years.
[snip part where changing the name of a parameter is also fine as it's
-1 against merging this.
Zope-Dev maillist - Zope-Dev@zope.org
** No cross posts or HTML encoding! **
(Related lists -