Documenting builtin methods

[Chris Angelico]

On Thu, Jul 11, 2013 at 4:06 PM, Steven D'Aprano <steve at pearwood.info> wrote:
> I think the right solution here is the trivial:
>
> def exhaust(it):
>     """Doc string here."""
>     deque(maxlen=0).extend(it)
>
>
> which will be fast enough for all but the tightest inner loops. But if
> you really care about optimizing this:
>
>
> def factory():
>     eatit = deque(maxlen=0).extend
>     def exhaust_iter(it):
>         """Doc string goes here"""
>         eatit(it)
>     return exhaust_iter
>
> exhaust_it = factory()
> del factory
>
>
> which will be about as efficient as you can get while still having a
> custom docstring.

Surely no reason to go for the factory function:

def exhaust(it,eatit=deque(maxlen=0).extend):
	eatit(it)

ChrisA