In enum module the functional API for enum creation has the following signature:Enum(value='NewEnumName', names=<...>, *, module='...', qualname='...', type=<mixed-in class>)so that the numeration always starts with 1. In some cases it is convenient to start numbering from other base, e.g., 0. It would be of great help to add an additional parameter, say start, to make the following call possible:Animal = Enum('Animal', 'ant bee cat dog', start = 0)

That is certainly nicer than the current idiom:  Animal = Enum('Animal', zip('ant bee cat dog'.split(), range(4)))

Is it really worthwhile to complicate the API for the sake of providing a less flexible solution for rare cases that saves a few keystrokes?

Playing devil's advocate:The issue is not so much the keystrokes saved as the improvement in reading and understanding what was intended.  If you are happy with starting at 1 the idiom is easy to both write, read, and understand; but if you want some other starting number you have to uglify your code with parenthesis, .methods, and add an extra iterator which you have to manually re-sync if you later add another name...I think that is the real issue -- not keystrokes.

I think that the situation when you want start numbering from 0 is rather common, especially when you need to define bit fields as enumeration or when you need to implement an interface with other languages (e.g., C).

Looks sensible to me. Except for being name-only, this duplicates the api of enumerate.

New changesetec016ba862ba by Ethan Furman in branch 'default':Closeissue21706: add 'start' parameter to functional APIhttps://hg.python.org/cpython/rev/ec016ba862ba

New changeset713ee49ec3ba by Berker Peksag in branch 'default':Issue#21706: Add a versionchanged directive to the functional API docs.https://hg.python.org/cpython/rev/713ee49ec3ba