[issue21430] Document ssl.pending()

[Bas Wijnen]

Bas Wijnen added the comment:

Alexey: please be more civil.

Antoine: In that case, can you please explain how you would recommend me to implement my use case, where most of my calls are master-initiated and blocking, but some slave-initiated events must be non-blocking?  Should I make a lot of calls to sslsocket.setblocking() to switch it on and off all the time?  AFAIK that is a system call (or isn't it?); while that won't make any real difference in performance in Python, it doesn't feel right to make system calls when there's technically no need for it.

Also, as I suggested previously, if you don't document the method, could you please add the word "pending" somewhere in the text?  This ensures people looking for documentation of what they see in the source will find this explanation.  It may also be good to add a note to the source code that this function should not be used.

----------

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