René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"`socket.socketpair`'s `type` parameter accepts `SocketType` on non-Windows","articleBody":"`socket.socketpair`'s `type` parameter on non-Windows platforms is annotated `SocketType | int`:\n\nhttps://github.com/python/typeshed/blob/cd8b26b0ceef26cd84ab614088140d48680ac7f7/stdlib/socket.pyi#L1411-L1413\n\nIt seems like it should be `SocketKind | int`, similar to the `type` parameter of `socket.socket` and `socket.fromfd`:\n\nhttps://github.com/python/typeshed/blob/cd8b26b0ceef26cd84ab614088140d48680ac7f7/stdlib/socket.pyi#L1319-L1321\n\nhttps://github.com/python/typeshed/blob/cd8b26b0ceef26cd84ab614088140d48680ac7f7/stdlib/socket.pyi#L1396\n\nPassing a `SocketKind` (e.g. `socket.socketpair(type=SocketKind.SOCK_STREAM)`) already works fine since `SocketKind` is an `int` subtype. I don't think that `SocketType` is supported though. There don't appear to be any paths in CPython where a `SocketType` is accepted; the only two paths are\n\n*   Pass the `type: SocketType` to `socket.socket`: https://github.com/python/cpython/blob/v3.14.2/Lib/socket.py#L659-L668, which blows up:\n\n    ```\n    Traceback (most recent call last):\n      File \"/tmp/tmp.SPNfuStkPY/eg.py\", line 3, in \u003cmodule\u003e\n        socketlib.socketpair(type=socketlib.socket())\n        ~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^\n      File \"/home/ganden/.pyenv/versions/3.13/lib/python3.13/socket.py\", line 659, in socketpair\n        a, b = _socket.socketpair(family, type, proto)\n               ~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^\n    TypeError: 'socket' object cannot be interpreted as an integer\n    ```\n\n*   Or blow up if `type` is anything but `SocketKind.SOCK_STREAM`:\n\n    https://github.com/python/cpython/blob/v3.14.2/Lib/socket.py#L604-L613","author":{"url":"https://github.com/gschaffner","@type":"Person","name":"gschaffner"},"datePublished":"2026-01-15T06:15:26.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/15283/typeshed/issues/15283"}