Path: csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!news.dougwise.org!gegeweb.org!de-l.enfer-du-nord.net!feeder1.enfer-du-nord.net!feeder.news-service.com!news2.euro.net!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type:content-transfer-encoding; b=TGREPMmDRibs2uVrKbz2oXi3DKL28O+gSEecboLF6uCJ6W6uhEujUd+bfbItsWPL+M vtp639d4oZPS7tKuL/0SHwy4iffllx80nJyzyZeS8HyxbmQZaaTGVsgGj1qO/sEPliKf xadSFW0p6HlyrvJr4GL6CIrMoPR/dBynNoI2o=
MIME-Version: 1.0
In-Reply-To: <BANLkTikqr1s0OVV15Pi4Gz4KPJxtHVASfA@mail.gmail.com>
References: <BANLkTin3FGoxwvH2VDOb4OhAWi2Ea3K-pA@mail.gmail.com> <4DF1FA8B.2020609@tim.thechases.com> <BANLkTikqr1s0OVV15Pi4Gz4KPJxtHVASfA@mail.gmail.com>
From: Ian Kelly <ian.g.kelly@gmail.com>
Date: Fri, 10 Jun 2011 11:26:29 -0600
Subject: Re: how to inherit docstrings?
To: Eric Snow <ericsnowcurrently@gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Cc: python-list <python-list@python.org>
Precedence: list
Newsgroups: comp.lang.python
Message-ID: <mailman.88.1307726821.11593.python-list@python.org>
Lines: 45
NNTP-Posting-Host: 82.94.164.166
Xref: x330-a1.tempe.blueboxinc.net comp.lang.python:7387

On Fri, Jun 10, 2011 at 10:55 AM, Eric Snow <ericsnowcurrently@gmail.com> w=
rote:
> The only problem, as seen in the last line, is that the __doc__ on
> instances is not inherited on instances of the class. =A0Object
> attribute lookup only looks to the type's __dict__ for inheritance,
> and not the types's type. =A0However, that should not be that hard to
> work around.

Everybody always focuses so much on properties and forgets that you
can also just write your own descriptors.

>>> class DocDescriptor(object):
...   def __get__(self, instance, owner):
...     return getattr(owner, "_mydoc", None)
...
>>> class Meta(type):
...   def __init__(cls, name, bases, d):
...     super(Meta, cls).__init__(name, bases, d)
...     cls.__doc__ =3D DocDescriptor()
...
>>> class X(object):
...   __metaclass__ =3D Meta
...
>>> X.__doc__
>>> X().__doc__
>>> X._mydoc =3D 'test'
>>> X.__doc__
'test'
>>> X().__doc__
'test'
>>> class Derived(X): pass
...
>>> Derived.__doc__
'test'
>>> Derived().__doc__
'test'

There you go, a metaclass that adds a __doc__ descriptor that can be
inherited (thanks to the metaclass), can be accessed from either the
class or the instance (thanks to the descriptor), and can easily be
modified to generate the doc string dynamically at call-time if
desired.

Cheers,
Ian