gh-88427: Deprecated socket.SocketType

Doc/library/socket.rst

@@ -909,6 +909,9 @@ The following functions all create :ref:`socket objects <socket-objects>`.
    This is a Python type object that represents the socket object type. It is the
    same as ``type(socket(...))``.
 
+   .. deprecated:: 3.14
+      If type annotation is required, use :class:`~socket.socket`.
+
 
 Other functions
 '''''''''''''''

Lib/socket.py

@@ -67,6 +67,11 @@
            "has_dualstack_ipv6", "AddressFamily", "SocketKind"]
 __all__.extend(os._get_exports_list(_socket))
 
+def __getattr__(name):
+    import warnings
+    if name == "SocketType":
+        warnings.warn(f"{name} is deprecated", DeprecationWarning)
+
 # Set up the socket.AF_* socket.SOCK_* constants as members of IntEnums for
 # nicer string representations.
 # Note that _socket only knows about the integer values. The public interface

Misc/NEWS.d/next/Library/2024-11-01-20-09-53.gh-issue-88427.chYNT6.rst

@@ -0,0 +1 @@
+Deprecated :attr:`!socket.SocketType` from the :mod:`socket`.