[issue15474] Differentiate decorator and decorator factory in docs

Raymond Hettinger added the comment: Thanks Andrés. I'm going to close this one as it has been open for a long time and not attracted interest. Also, in practice this ambiguity doesn't seem to be an issue and people almost universally refer to anything usable with the @-notation as a deco

[issue15474] Differentiate decorator and decorator factory in docs

Andrés Delfino added the comment: Hi, no I'm no longer working on this. -- ___ Python tracker ___ ___ Python-bugs-list mailing list

[issue15474] Differentiate decorator and decorator factory in docs

Andrei Daraschenka added the comment: Hi, Andrés Delfino. Are you still working on it? I could help with this issues. -- nosy: +dorosch ___ Python tracker ___ _

[issue15474] Differentiate decorator and decorator factory in docs

Andrés Delfino added the comment: Great! I'll definitely give it a look. I prefer not to make a PR until everything is in its place. You can check the status though: https://github.com/andresdelfino/cpython/tree/decorators-howto Fred was very helpful with his insight :) --

[issue15474] Differentiate decorator and decorator factory in docs

Ezio Melotti added the comment: If you want some early feedback I believe you can already create a PR and mark it as work-in-progress/don't-merge. If you need some material you can find the slides of a talk about decorators that I did at https://www.pycon.it/media/conference/slides/understan

[issue15474] Differentiate decorator and decorator factory in docs

Andrés Delfino added the comment: Hi Windson Yang! Yes, I'm still working on it. I'll have it ready by the end of June. -- ___ Python tracker ___ _

[issue15474] Differentiate decorator and decorator factory in docs

Windson Yang added the comment: Hi, Andrés Delfino. Are you still working on it? -- nosy: +Windson Yang ___ Python tracker ___ ___ P

[issue15474] Differentiate decorator and decorator factory in docs

Andrés Delfino added the comment: Alright! :D Yes, your help will definitely come in handy, thanks! -- ___ Python tracker ___ ___ Py

[issue15474] Differentiate decorator and decorator factory in docs

Fred L. Drake, Jr. added the comment: I like Éric's terminology; giving a concrete name to the concept makes it a lot easier to grasp, and this doesn't require inventing any new component terms. Andrés, if you'd like to tackle this, that's great! I'd be happy to for you to bounce drafts thro

[issue15474] Differentiate decorator and decorator factory in docs

Andrés Delfino added the comment: If deemed appropriate, I can take the task of writing a HOWTO for decorators/decorators factories. -- nosy: +adelfino ___ Python tracker ___

[issue15474] Differentiate decorator and decorator factory in docs

Nick Coghlan added the comment: No, using decorators needs to be in the tutorial, but writing your own is a metaprogramming task that's beyond the tutorial's scope. A HOWTO guide would be appropriate, though. -- ___ Python tracker

[issue15474] Differentiate decorator and decorator factory in docs

Ezio Melotti added the comment: The tutorial doesn't seem to mention decorators, do you think this should be covered there? FWIW while explaining decorators I usually use 3 examples: 1) a simple decorator that accepts a function, does something, and returns the same function; 2) a decorator t

[issue15474] Differentiate decorator and decorator factory in docs

Changes by Ezio Melotti : -- nosy: +chris.jerdonek ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.

[issue15474] Differentiate decorator and decorator factory in docs

Changes by Ezio Melotti : -- keywords: +easy nosy: +ezio.melotti stage: -> needs patch type: -> enhancement versions: +Python 3.4 ___ Python tracker ___ ___

[issue15474] Differentiate decorator and decorator factory in docs

New submission from Éric Araujo : Some of the confusion encountered when writing decorators arise from the difference between a decorator (@something) and a decorator factory (@something(args)). It would help to adopt this clearer terminology in our docs: a decorator takes the decorated funct