В Sphinx, есть ли способ документировать параметры вместе с их объявлением?
Я предпочитаю документировать каждый параметр (при необходимости) в той же строке, где я объявляю параметр, чтобы применитьD.R.Y.
Если у меня есть такой код:
def foo(
flab_nickers, # a series of under garments to process
has_polka_dots=False,
needs_pressing=False # Whether the list of garments should all be pressed
):
...
Как можно избежать повторения параметров в строке документа и сохранить объяснения параметров?
Я хочу избежать:
def foo(
flab_nickers, # a series of under garments to process
has_polka_dots=False,
needs_pressing=False # Whether the list of garments should all be pressed
):
'''Foo does whatever.
* flab_nickers - a series of under garments to process
* needs_pressing - Whether the list of garments should all be pressed.
[Default False.]
Возможно ли это в Python 2.6 или Python 3 с какими-то манипуляциями декоратора? Есть ли другой способ?