Use 3rd party "decorator" module to fix introspection for decorated functions

[bitprophet]

Description

Some internal functions are decorated by @needs_host or other decorators, and thus lose their ability to be introspected, including by Sphinx autodoc. This makes me sad.

Thankfully, the decorator module has ways to work around this, and looks quite useful. It will add another external dependency but I don't think that's enough of a drawback to be a big concern.

See also an email to me from Matt Wilson dated 2009-09-09 about @needs_host, which is where he informed me about the module in question.

---

Originally submitted by Jeff Forcier (bitprophet) on 2009-11-11 at 11:49pm EST

[bitprophet]

Jeff Forcier (bitprophet) posted:

---

On the one hand, I do hate the broken autodoc. On the other, I don't think a tertiary release is the time to add new dependencies. Bumping this to 1.0.

---

on 2010-05-27 at 08:33pm EDT

[bitprophet]

Axel Rutz (aexl) posted:

---

use functools.wraps

---

on 2010-07-10 at 07:53pm EDT

[bitprophet]

Jeff Forcier (bitprophet) posted:

---

We're already using @wraps, this is something different that it cannot solve by itself, unfortunately.

---

on 2010-07-11 at 09:30pm EDT

[bitprophet]

Bumping to 2.x since it adds a new external dependency.

[bitprophet]

I can confirm that this works well for the intended use case -- I am using it in a work related codebase in the exact same manner.

Torn on whether to add it to Fab before 2.x -- on the one hand it represents a wholly new dependency, which is arguably backwards incompat. On the other hand, we've had to change the SSH lib dependency back and forth a few times, which is arguably as (if not more) disruptive, so there is precedent.