EnumType __call__ method description does not match the implementation

[Mi-La]

Documentation

See EnumType.call documentation, where the prototype is:

__call__(cls, value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

While in the enum.py source code there is:

def __call__(cls, value, names=_not_given, *values, module=None, qualname=None, type=None, start=1, boundary=None):

1. The _not_given helper behaves differently than None, which even breaks compatibility with previous versions (this change was introduced in 3.12.3), when one needs to do some customization of enum metaclass.

   • e.g. as propsed on the stack overflow to implement enum item deprecation warning - note that this implementation stops working in 3.12.3 since the call of the parent EnumType.__call__ passes None instead of _not_given and it causes different behavior.

2. Note * vs. *values, which I believe even behaves differently.

[Mi-La]

@ethanfurman It seems that the SO answer I mentioned above is yours :-).