[issue19842] selectors: refactor BaseSelector implementation

Antoine Pitrou report at bugs.python.org
Sat Nov 30 16:28:05 CET 2013


Antoine Pitrou added the comment:

> > The problem for documentation use is that we're christening it as an
> > official API, and thus it becomes more difficult to refactor the
> > inheritance hierarchy.
> 
> So what would you suggest?

Hmmm... Well I guess your proposal makes sense :-) Aka. having a
documented ABC, and then a private base implementation.

Otherwise, you can also document the methods without saying precisely to
which class they belong, which I started doing on asyncio, but
apparently it confuses some people.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19842>
_______________________________________


More information about the Python-bugs-list mailing list