Add Bluetooth constants for python 3.14 #15330

dlech · 2026-01-28T15:10:40Z

Please don't move this comment. Instead the new Bluetooth constants should be added somewhere below here.

-Original file line number
+Diff line change
@@ Expand Up / @@ -80,3 +80,10 @@ _msi @@
     msilib(.[a-z]+)?
     ossaudiodev
     spwd
+    # Bluetooth constants added for Python 3.14+ but missing at runtime on Windows test runners
+    _socket.SO_BTH_ENCRYPT
+    _socket.SO_BTH_MTU
+    _socket.SO_BTH_MTU_MAX
+    _socket.SO_BTH_MTU_MIN
+    _socket.SOL_RFCOMM

-Original file line number
+Diff line change
@@ Expand Up @@
     (_?locale.dgettext)?
     (_?locale.gettext)?
     (_?locale.textdomain)?
+    # Bluetooth constants added for Python 3.14+ but missing at runtime on Windows test runners
+    _socket.SO_BTH_ENCRYPT
+    _socket.SO_BTH_MTU
+    _socket.SO_BTH_MTU_MAX
+    _socket.SO_BTH_MTU_MIN
+    _socket.SOL_RFCOMM

-Original file line number
+Diff line change
@@ Expand Up / @@ -21,3 +21,8 @@ msilib(.[a-z]+)? @@
     # doesn't exist in all installations
     (nis)?
+    # Bluetooth constants added for Python 3.14+ but missing at runtime on Ubuntu test runners
+    _socket.HCI_CHANNEL_RAW
+    _socket.SOL_RFCOMM

-Original file line number
+Diff line change
@@ Expand Up / @@ -5,3 +5,11 @@ @@
     # Starting with Python 3.14.1, these methods accept None for some of their
     # parameters, but would raise a TypeError with Python 3.14.0.
     mmap.mmap.madvise
+    # Bluetooth constants new in 3.14 but missing at runtime on Ubuntu test runners
+    _socket.BT_MODE_STREAM
+    _socket.BT_PHY_LE_2M_RX
+    _socket.BT_SCM_PKT_STATUS
+    _socket.BT_VOICE_FOR_MSBC
+    _socket.HCI_CHANNEL_RAW
+    _socket.SOL_RFCOMM

-Original file line number
+Diff line change
@@ Expand Up @@
     (_?socket\.BTPROTO_L2CAP)?
     (_?socket\.BTPROTO_RFCOMM)?
     (_?socket\.BTPROTO_SCO)?
+    (_?socket\.BDADDR_BREDR)?
+    (_?socket\.BDADDR_LE_PUBLIC)?
+    (_?socket\.BDADDR_LE_RANDOM)?
+    (_?socket\.BT_CHANNEL_POLICY)?
+    (_?socket\.BT_CHANNEL_POLICY_BREDR_ONLY)?
+    (_?socket\.BT_CHANNEL_POLICY_BREDR_PREFERRED)?
+    (_?socket\.BT_CODEC)?
+    (_?socket\.BT_DEFER_SETUP)?
+    (_?socket\.BT_FLUSHABLE)?
+    (_?socket\.BT_FLUSHABLE_OFF)?
+    (_?socket\.BT_FLUSHABLE_ON)?
+    (_?socket\.BT_ISO_QOS)?
+    (_?socket\.BT_MODE)?
+    (_?socket\.BT_MODE_BASIC)?
+    (_?socket\.BT_MODE_ERTM)?
+    (_?socket\.BT_MODE_EXT_FLOWCTL)?
+    (_?socket\.BT_MODE_LE_FLOWCTL)?
+    (_?socket\.BT_MODE_STREAMING)?
+    (_?socket\.BT_PHY)?
+    (_?socket\.BT_PHY_BR_1M_1SLOT)?
+    (_?socket\.BT_PHY_BR_1M_3SLOT)?
+    (_?socket\.BT_PHY_BR_1M_5SLOT)?
+    (_?socket\.BT_PHY_EDR_2M_1SLOT)?
+    (_?socket\.BT_PHY_EDR_2M_3SLOT)?
+    (_?socket\.BT_PHY_EDR_2M_5SLOT)?
+    (_?socket\.BT_PHY_EDR_3M_1SLOT)?
+    (_?socket\.BT_PHY_EDR_3M_3SLOT)?
+    (_?socket\.BT_PHY_EDR_3M_5SLOT)?
+    (_?socket\.BT_PHY_LE_1M_RX)?
+    (_?socket\.BT_PHY_LE_1M_TX)?
+    (_?socket\.BT_PHY_LE_2M_TX)?
+    (_?socket\.BT_PHY_LE_CODED_RX)?
+    (_?socket\.BT_PHY_LE_CODED_TX)?
+    (_?socket\.BT_PKT_STATUS)?
+    (_?socket\.BT_POWER)?
+    (_?socket\.BT_POWER_FORCE_ACTIVE_OFF)?
+    (_?socket\.BT_POWER_FORCE_ACTIVE_ON)?
+    (_?socket\.BT_RCVMTU)?
+    (_?socket\.BT_SECURITY)?
+    (_?socket\.BT_SECURITY_FIPS)?
+    (_?socket\.BT_SECURITY_HIGH)?
+    (_?socket\.BT_SECURITY_LOW)?
+    (_?socket\.BT_SECURITY_MEDIUM)?
+    (_?socket\.BT_SECURITY_SDP)?
+    (_?socket\.BT_SNDMTU)?
+    (_?socket\.BT_VOICE)?
+    (_?socket\.BT_VOICE_CVSD_16BIT)?
+    (_?socket\.BT_VOICE_TRANSPARENT)?
+    (_?socket\.BT_VOICE_TRANSPARENT_16BIT)?
+    (_?socket\.HCI_CHANNEL_CONTROL)?
+    (_?socket\.HCI_CHANNEL_LOGGING)?
+    (_?socket\.HCI_CHANNEL_MONITOR)?
+    (_?socket\.HCI_CHANNEL_USER)?
+    (_?socket\.HCI_DEV_NONE)?
+    (_?socket\.L2CAP_LM)?
+    (_?socket\.L2CAP_LM_AUTH)?
+    (_?socket\.L2CAP_LM_ENCRYPT)?
+    (_?socket\.L2CAP_LM_MASTER)?
+    (_?socket\.L2CAP_LM_RELIABLE)?
+    (_?socket\.L2CAP_LM_SECURE)?
+    (_?socket\.L2CAP_LM_TRUSTED)?
+    (_?socket\.SOL_BLUETOOTH)?
+    (_?socket\.SOL_L2CAP)?
+    (_?socket\.SOL_SCO)?
     # These seem like they should be available on Linux, but they're not
     # on GitHub Actions runners for some reason.
     _?socket.IPX_TYPE
@@ Expand Down Expand Up / @@ -69,3 +132,8 @@ termios.TIOCTTYGSTRUCT @@
     tkinter.Tk.createfilehandler  # Methods that come from __getattr__() at runtime
     tkinter.Tk.deletefilehandler  # Methods that come from __getattr__() at runtime
+    # Bluetooth constants added for Python 3.14+ but missing at runtime on Ubuntu test runners
+    _socket.HCI_CHANNEL_RAW
+    _socket.SOL_RFCOMM

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add Bluetooth constants for python 3.14 #15330

Diff view

Diff view

There are no files selected for viewing

dlech Jan 28, 2026

Uh oh!

Uh oh!

-Original file line number
+Diff line change
@@ Expand Up / @@ -11,7 +11,8 @@ _CMSGArg: TypeAlias = tuple[int, int, ReadableBuffer] @@
     # Addresses can be either tuples of varying lengths (AF_INET, AF_INET6,
     # AF_NETLINK, AF_TIPC) or strings/buffers (AF_UNIX).
     # See getsockaddrarg() in socketmodule.c.
-    _Address: TypeAlias = tuple[Any, ...] | str | ReadableBuffer
+    _Address: TypeAlias = tuple[Any, ...] | str | ReadableBuffer | int
+    # int is included because of device_id not packed in a tuple is now accepted for BTPROTO_HCI
     _RetAddress: TypeAlias = Any
     # ===== Constants =====
@@ Expand Down Expand Up / @@ -76,6 +77,11 @@ if sys.platform != "linux": @@
         SO_USELOOPBACK: Final[int]
     if sys.platform == "win32":
         SO_EXCLUSIVEADDRUSE: Final[int]
+        SO_BTH_ENCRYPT: Final[int]
+        SO_BTH_MTU: Final[int]
+        SO_BTH_MTU_MAX: Final[int]
+        SO_BTH_MTU_MIN: Final[int]
+        SOL_RFCOMM: Final[int]
     if sys.platform != "win32":
         SO_REUSEPORT: Final[int]
         if sys.platform != "darwin" or sys.version_info >= (3, 13):
@@ Expand Down Expand Up / @@ -240,11 +246,6 @@ if sys.version_info >= (3, 14): @@
             SO_ORIGINAL_DST: Final[int]
         if sys.platform == "win32":
-            SOL_RFCOMM: Final[int]
-            SO_BTH_ENCRYPT: Final[int]
-            SO_BTH_MTU: Final[int]
-            SO_BTH_MTU_MAX: Final[int]
-            SO_BTH_MTU_MIN: Final[int]
             TCP_QUICKACK: Final[int]
         if sys.platform == "linux":
@@ Expand Down Expand Up / @@ -579,7 +580,47 @@ if sys.platform == "linux": @@
         SO_VM_SOCKETS_BUFFER_SIZE: Final = 0
         SO_VM_SOCKETS_BUFFER_MIN_SIZE: Final = 1
         VM_SOCKETS_INVALID_VERSION: Final = 0xFFFFFFFF  # undocumented
+        # Bluetooth constants new in 3.14
+        if sys.version_info >= (3, 14):
+            BDADDR_BREDR: int
+            BDADDR_LE_PUBLIC: int
+            BDADDR_LE_RANDOM: int
+            BT_CHANNEL_POLICY_BREDR_ONLY: int
+            BT_CHANNEL_POLICY_BREDR_PREFERRED: int
+            BT_CHANNEL_POLICY: int
+            BT_CODEC: int
+            BT_DEFER_SETUP: int
+            BT_FLUSHABLE_OFF: int
+            BT_FLUSHABLE_ON: int
+            BT_FLUSHABLE: int
+            BT_ISO_QOS: int
+            BT_MODE_BASIC: int
+            BT_MODE_ERTM: int
+            BT_MODE_STREAM: int
+            BT_MODE: int
+            BT_PHY_BR_1M_1SLOT: int
+            BT_PHY_EDR_2M_1SLOT: int
+            BT_PHY_EDR_2M_3SLOT: int
+            BT_PHY_EDR_2M_5SLOT: int
+            BT_PHY_EDR_3M_1SLOT: int
+            BT_PHY_EDR_3M_3SLOT: int
+            BT_PHY_EDR_3M_5SLOT: int
+            BT_PHY_LE_1M_RX: int
+            BT_PHY_LE_1M_TX: int
+            BT_PHY_LE_2M_RX: int
+            BT_PHY_LE_2M_TX: int
+            BT_PHY_LE_CODED_RX: int
+            BT_PHY_LE_CODED_TX: int
+            BT_PHY: int
+            BT_PKT_STATUS: int
+            BT_POWER_FORCE_ACTIVE_OFF: int
+            BT_POWER_FORCE_ACTIVE_ON: int
+            BT_POWER: int
+            BT_RCVMTU: int
+            BT_SCM_PKT_STATUS: int
+            BT_SNDMTU: int
+            BT_VOICE_FOR_MSBC: int
+            BT_VOICE: int
     # Documented as only available on BSD, macOS, but empirically sometimes
     # available on Windows
     if sys.platform != "linux":
@@ Expand Down Expand Up / @@ -630,9 +671,41 @@ if sys.version_info >= (3, 12): @@
             ETHERTYPE_IP: Final[int]
             ETHERTYPE_IPV6: Final[int]
             ETHERTYPE_VLAN: Final[int]
+            # --------------------
+            # Semi-documented constants
+            BT_MODE_EXT_FLOWCTL: Final[int]
+            BT_MODE_LE_FLOWCTL: Final[int]
+            BT_MODE_STREAMING: Final[int]
+            BT_PHY_BR_1M_3SLOT: Final[int]
+            BT_PHY_BR_1M_5SLOT: Final[int]
+            BT_SECURITY_FIPS: Final[int]
+            BT_SECURITY_HIGH: Final[int]
+            BT_SECURITY_LOW: Final[int]
+            BT_SECURITY_MEDIUM: Final[int]
+            BT_SECURITY_SDP: Final[int]
+            BT_SECURITY: Final[int]
+            BT_VOICE_CVSD_16BIT: Final[int]
+            BT_VOICE_TRANSPARENT_16BIT: Final[int]
+            BT_VOICE_TRANSPARENT: Final[int]
+            HCI_CHANNEL_CONTROL: Final[int]
+            HCI_CHANNEL_LOGGING: Final[int]
+            HCI_CHANNEL_MONITOR: Final[int]
+            HCI_CHANNEL_RAW: Final[int]
+            HCI_CHANNEL_USER: Final[int]
+            HCI_DEV_NONE: Final[int]
+            L2CAP_LM_AUTH: Final[int]
+            L2CAP_LM_ENCRYPT: Final[int]
+            L2CAP_LM_MASTER: Final[int]
+            L2CAP_LM_RELIABLE: Final[int]
+            L2CAP_LM_SECURE: Final[int]
+            L2CAP_LM_TRUSTED: Final[int]
+            L2CAP_LM: Final[int]
+            SOL_BLUETOOTH: Final[int]
+            SOL_L2CAP: Final[int]
+            SOL_RFCOMM: Final[int]
+            SOL_SCO: Final[int]
-    # --------------------
-    # Semi-documented constants
     # These are alluded to under the "Socket families" section in the docs
     # https://docs.python.org/3/library/socket.html#socket-families
     # --------------------
@@ Expand Down @@

Uh oh!

Add Bluetooth constants for python 3.14 #15330

Are you sure you want to change the base?

Add Bluetooth constants for python 3.14 #15330

Uh oh!

Uh oh!

Diff view

Diff view

There are no files selected for viewing

dlech Jan 28, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!