[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