This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Some socket constants are not enums
Type: enhancement Stage:
Components: Versions: Python 3.5
process
Status: closed Resolution: rejected
Dependencies: Superseder:
Assigned To: Nosy List: barry, eli.bendersky, ethan.furman, neologix, pitrou, r.david.murray
Priority: low Keywords:

Created on 2014-05-01 12:17 by pitrou, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Messages (7)
msg217691 - (view) Author: Antoine Pitrou (pitrou) * (Python committer) Date: 2014-05-01 12:17
Many constants in the socket module, are not int enums. Examples are socket.CAN_BCM, socket.BTPROTO_RFCOMM, etc.

For example when creating a bluetooth socket, you may get the following repr():

>>> socket.socket(socket.AF_BLUETOOTH, socket.SOCK_STREAM, socket.BTPROTO_RFCOMM)
<socket.socket fd=3, family=AddressFamily.AF_BLUETOOTH, type=SocketType.SOCK_STREAM, proto=3, laddr=('00:00:00:00:00:00', 0), raddr=('00:00:00:00:00:00', 0)>

(notice the integer "proto")
msg217712 - (view) Author: Charles-François Natali (neologix) * (Python committer) Date: 2014-05-01 17:33
Enum are for, well, enumerated values, so for values within a finite
and known range (like days, cards, etc).
OTOH, I'm not sure all socket constants could be categorized like this.
It makes sense for address families, especially since they're used so
much, but when it comes to e.g. SO_REUSEADDR or BTPROTO_RFCOMM, I'm
not sure how we could categorize them.
Unless would declare them all in a "SocketConstant" Enum?
msg217714 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2014-05-01 19:27
This is why we should have had named constants and not Enums :)

But no, nothing in the python Enum implementation restricts it to a value *range*.  It is really a collection of named constants.
msg217715 - (view) Author: Charles-François Natali (neologix) * (Python committer) Date: 2014-05-01 19:42
> But no, nothing in the python Enum implementation restricts it to a value *range*.  It is really a collection of named constants.

I didn't say in the implementation, I said in spirit.
Would you describe all possible Unix PIDs are a Enum?

Also, the problem is that many such constant can have identical values
(because they can be passed at different syscalls/argument offset),
and in this case the IntEnum equality isn't wanted:
cf@neobox:~/python/hg/default$ cat /tmp/test.py
from enum import IntEnum

class Const(IntEnum):

    AF_INET = 1
    SO_REUSEADDR = 1

print(Const.AF_INET == Const.SO_REUSEADDR)
cf@neobox:~/python/hg/default$ ./python /tmp/test.py
True

Really?
msg217716 - (view) Author: Antoine Pitrou (pitrou) * (Python committer) Date: 2014-05-01 19:54
> It makes sense for address families, especially since they're used so
> much, but when it comes to e.g. SO_REUSEADDR or BTPROTO_RFCOMM,

Hmm, I was thinking mostly about protocol numbers. All the BTPROTO_* constants should be part of a given enum (BlueToothProtocol?), the CAN_* constants part of another one.
msg217717 - (view) Author: Charles-François Natali (neologix) * (Python committer) Date: 2014-05-01 19:58
To put it slightly differently:
AF_XXX constant actually whome belong to the same namespace, the
socket address family namespace.
So we put them all in AddressFamily Enum.

Now, for many constants defined in system header files, it's not so
clear, e.g. BTPROTO_RFCOMM, TIPC_ADDR_ID, SCM_CREDENTIALS: in which
Enum would you declare them?

I'm not saying it's a bad idea: it actually probably makes sense for
e.g. socket-level options (SO_REUSEADDR & Co), but it don't see any
generic classification scheme that would make sense for all of them.
msg217718 - (view) Author: Antoine Pitrou (pitrou) * (Python committer) Date: 2014-05-01 20:01
Ah, I missed the fact that the "family" and "type" properties are re-computed on the fly; I thought the enum values where stored on the socket object.

Then it makes it harder to do the same for "proto", since there are family-specific namespaces with colliding values, indeed.

>>> socket.IPPROTO_ICMP
1
>>> socket.BTPROTO_HCI
1
History
Date User Action Args
2022-04-11 14:58:03adminsetgithub: 65605
2015-07-21 08:04:46ethan.furmansetstatus: open -> closed
resolution: rejected
2014-05-01 20:01:03pitrousetmessages: + msg217718
2014-05-01 19:58:53neologixsetmessages: + msg217717
2014-05-01 19:54:46pitrousetmessages: + msg217716
2014-05-01 19:42:06neologixsetmessages: + msg217715
2014-05-01 19:27:25r.david.murraysetnosy: + r.david.murray
messages: + msg217714
2014-05-01 17:33:35neologixsetmessages: + msg217712
2014-05-01 12:17:47pitroucreate