A comment on a recent SO answer [1] wondered why my aenum library wasn't mentioned in the docs to help guide people that needed/wanted more advanced Enum options to it. I responded that Python was not in the habit of mentioning third-party libraries in the docs. However, I thought I would double-check here to see if it might be a good idea. Pros: - drop-in replacement for the stdlib Enum - has many advanced features such as - auto __init__ building - multi-value members - duplicate value but non-aliasing members - etc. - I'm the primary/only maintainer for both Cons: - third-party library Thoughts? -- ~Ethan~ [1] http://stackoverflow.com/a/43855536/208880
On 09/05/2017 18:05, Ethan Furman wrote:
A comment on a recent SO answer [1] wondered why my aenum library wasn't mentioned in the docs to help guide people that needed/wanted more advanced Enum options to it. I responded that Python was not in the habit of mentioning third-party libraries in the docs.
However, I thought I would double-check here to see if it might be a good idea.
Pros: - drop-in replacement for the stdlib Enum - has many advanced features such as - auto __init__ building - multi-value members - duplicate value but non-aliasing members - etc. - I'm the primary/only maintainer for both
Cons: - third-party library
Thoughts?
-- ~Ethan~
The precedent is all ready set as the third-party regex module gets a mention here https://docs.python.org/3/library/re.html and the requests package here https://docs.python.org/3/library/urllib.request.html. -- My fellow Pythonistas, ask not what our language can do for you, ask what you can do for our language. Mark Lawrence
On Tue, 9 May 2017 at 10:59 Mark Lawrence via Python-Dev < python-dev@python.org> wrote:
On 09/05/2017 18:05, Ethan Furman wrote:
A comment on a recent SO answer [1] wondered why my aenum library wasn't mentioned in the docs to help guide people that needed/wanted more advanced Enum options to it. I responded that Python was not in the habit of mentioning third-party libraries in the docs.
However, I thought I would double-check here to see if it might be a good idea.
Pros: - drop-in replacement for the stdlib Enum - has many advanced features such as - auto __init__ building - multi-value members - duplicate value but non-aliasing members - etc. - I'm the primary/only maintainer for both
Cons: - third-party library
Thoughts?
-- ~Ethan~
The precedent is all ready set as the third-party regex module gets a mention here https://docs.python.org/3/library/re.html and the requests package here https://docs.python.org/3/library/urllib.request.html.
Mark's right that we already do this for select modules. Since aenum is by the author of enum to add things that don't fit in the stdlib and has been out for years (i.e. by you, Ethan :) , I see nothing wrong with linking to it.
Being the one who left the comment, I'm all for adding it.
The reason I wondered why it was not there was because I was aware you are
the author of both so, I believe, the con of it being a 3rd party library
is minimized. I've also seen plenty of people asking around for more
advanced usages of Enums so it's better to direct them to a library that
not only covers many cases but is also reliable due to you authoring it.
I'm afraid that the alternative of adding it to the wiki (as you replied)
would make no tangible difference on its visibility.
On Wed, May 10, 2017 at 1:47 AM, Brett Cannon
On Tue, 9 May 2017 at 10:59 Mark Lawrence via Python-Dev < python-dev@python.org> wrote:
On 09/05/2017 18:05, Ethan Furman wrote:
A comment on a recent SO answer [1] wondered why my aenum library wasn't mentioned in the docs to help guide people that needed/wanted more advanced Enum options to it. I responded that Python was not in the habit of mentioning third-party libraries in the docs.
However, I thought I would double-check here to see if it might be a good idea.
Pros: - drop-in replacement for the stdlib Enum - has many advanced features such as - auto __init__ building - multi-value members - duplicate value but non-aliasing members - etc. - I'm the primary/only maintainer for both
Cons: - third-party library
Thoughts?
-- ~Ethan~
The precedent is all ready set as the third-party regex module gets a mention here https://docs.python.org/3/library/re.html and the requests package here https://docs.python.org/3/library/urllib.request.html.
Mark's right that we already do this for select modules. Since aenum is by the author of enum to add things that don't fit in the stdlib and has been out for years (i.e. by you, Ethan :) , I see nothing wrong with linking to it.
_______________________________________________ Python-Dev mailing list Python-Dev@python.org https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/d. f.hilliard%40gmail.com
On Tue, May 09, 2017 at 10:05:43AM -0700, Ethan Furman wrote:
A comment on a recent SO answer [1] wondered why my aenum library wasn't mentioned in the docs to help guide people that needed/wanted more advanced Enum options to it.
I know that the std lib is where good modules go to die :-) Is the aenum module feature complete? Is it ready to ~~die~~ move to the std lib? If aenum is not going through active development, perhaps the missing features should be ported to enum and then there's no need to recommend a second module.
Pros: - drop-in replacement for the stdlib Enum - has many advanced features such as - auto __init__ building - multi-value members - duplicate value but non-aliasing members - etc.
Those three advanced features sound useful. Is there a reason enum doesn't support them? -- Steve
On 05/10/2017 05:50 PM, Steven D'Aprano wrote:
On Tue, May 09, 2017 at 10:05:43AM -0700, Ethan Furman wrote:
A comment on a recent SO answer [1] wondered why my aenum library wasn't mentioned in the docs to help guide people that needed/wanted more advanced Enum options to it.
I know that the std lib is where good modules go to die :-)
Is the aenum module feature complete? Is it ready to ~~die~~ move to the std lib?
No, it is still under active development.
Pros: - drop-in replacement for the stdlib Enum - has many advanced features such as - auto __init__ building - multi-value members - duplicate value but non-aliasing members - etc.
Those three advanced features sound useful. Is there a reason enum doesn't support them?
New features go to aenum first for experimentation and bug squashing. After I'm happy with them, thay /may/ go to the standard library. Even if all the features end up in the stdlib (unlikely), it would still be a useful recommendation as aenum works as far back as 2.7, possibly further). -- ~Ethan~
On 11 May 2017 at 01:50, Steven D'Aprano
On Tue, May 09, 2017 at 10:05:43AM -0700, Ethan Furman wrote:
A comment on a recent SO answer [1] wondered why my aenum library wasn't mentioned in the docs to help guide people that needed/wanted more advanced Enum options to it.
I know that the std lib is where good modules go to die :-)
Is the aenum module feature complete? Is it ready to ~~die~~ move to the std lib?
The proposal is about mentioning aenum as a 3rd party alternative in the stdlib docs for enum (which, BTW, I think is perfectly fine and a useful thing to do), not to bring aenum into the stdlib. Paul
participants (6)
-
Brett Cannon -
Ethan Furman -
Jim F.Hilliard -
Mark Lawrence -
Paul Moore -
Steven D'Aprano