Я предпочитаю документировать каждый параметр (по мере необходимости) в той же строке, где я объявляю параметр, чтобы применить 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
):
...
Как я могу избежать повторения параметров в строке doc и сохранить объяснения параметров?
Я хочу избежать:
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 с каким-то образом обработкой декоратора? Есть ли другой способ?