':param float value: socket timeout value; NOTE: this is mostly unused
now, owing to switchover to to non-blocking socket setting after
initial socket conection establishment.'

@socket_timeout.setter
def socket_timeout(self, value):

    if (value is not None):
        if (not isinstance(value, numbers.Real)):
            raise TypeError(('socket_timeout    must    be    a    float    or    int,    but    got    %r' % (value,)))
        if (not (value > 0)):
            raise ValueError(('socket_timeout    must    be    >    0,    but    got    %r' % (value,)))
    self._socket_timeout = value
