Class SSLSocket

src/py/ssl.py:695–861

SSL socket wrapping a socket.socket. Instances returned by SSLContext.wrap_socket().

class SSLSocket(socket):
    """SSL socket wrapping a socket.socket. Instances returned by SSLContext.wrap_socket()."""

    def __init__(self, *args, **kwargs):
        raise TypeError(
            f"{self.__class__.__name__} does not have a public constructor. "
            f"Instances are returned by SSLContext.wrap_socket()."
        )

    @classmethod
    def _create(
        cls,
        sock,
        server_side=False,
        do_handshake_on_connect=True,
        suppress_ragged_eofs=True,
        server_hostname=None,
        context=None,
        session=None,
    ):
        import _socket

        ssl_sock = cls.__new__(cls)

        # Initialize the C-level _socket.socket with explicit family/type/proto
        # to avoid getsockopt() auto-detection which fails on Emscripten's
        # NodeSockFS file descriptors.
        fd = sock.fileno()
        _socket.socket.__init__(ssl_sock, sock.family, sock.type, sock.proto, fd)
        ssl_sock._io_refs = 0
        ssl_sock._closed = False

        # Detach the original socket so it doesn't close the fd on __del__
        sock.detach()

        ssl_sock._sslobj = None
        ssl_sock._context = context
        ssl_sock._server_hostname = server_hostname
        ssl_sock._server_side = server_side
        ssl_sock._connected = True
        ssl_sock._suppress_ragged_eofs = suppress_ragged_eofs
        ssl_sock._session = session

        if do_handshake_on_connect:
            ssl_sock.do_handshake()
        return ssl_sock

    context = property(lambda self: getattr(self, "_context", None))
    server_hostname = property(lambda self: getattr(self, "_server_hostname", None))
    session = property(lambda self: getattr(self, "_session", None))
    session_reused = property(lambda self: None)

    def dup(self):
        raise NotImplementedError("Can't dup() %s instances" % self.__class__.__name__)

    def read(self, len=1024, buffer=None):
        if buffer is not None:
            # `len` shadows the builtin here, so read straight into the buffer