nntp2http.com
Posting
Suche
Optionen
Hilfe & Kontakt

Attribut als Funktion dokumentieren?

Von: Ole Streicher (ole-usenet-spam@gmx.net) [Profil]
Datum: 02.10.2009 10:34
Message-ID: <ytzbpkq42kc.fsf@news.ole.ath.cx>
Newsgroup: de.comp.lang.python
Hallo,

als Ergebnis zu der hier parallel laufenden Diskussion zum asynchronen
Updaten tritt jetzt ein neues Problem auf: ich habe ein Attribut,
welches eigentlich eine (extern aufrufbare) Funktion ist und welches ich
auch gerne als solche dokumentieren möchte. Mit epydoc sieht die
Dokumentation so aus:

--------------------8<------------------------------------
from other_posting import DoAsync

class MyClass(object):
'''Ipsis at urbi...

:ivar update: call this when the object should be updated.
:type update: argument-less function
'''
def __init__(self):
self.update = DoAsync(self._do_update)

def _do_update(self):
...
--------------------8<------------------------------------

Das führt jedoch dazu, dass self.update nicht unter den Funktionen,
sondern unter den Attributen gelistet wird. Auch mit dem normalen pydoc
hat "self.update" keinen passenden Docstring. Wie bekomme ich da einen
unter?

Viele Grüße

Ole
[ Auf dieses Posting antworten ]

Antworten