Как поместить переменную в строку документации Python

Итак, я пытаюсь создать "динамическую" строку документации, которая выглядит примерно так :

ANIMAL_TYPES = ["mammals", "reptiles", "other"]

def func(animalType):
""" This is a sample function.

    @param animalType: "It takes one of these animal types %s" % ANIMAL_TYPES
"""

, чтобы в основном строка документации для @param animalTypeпоказывала что угодно ANIMAL_TYPESимеет; так что, когда эта переменная обновляется, строка документации будет обновляться автоматически.

Однако, к сожалению, это не работает... Кто-нибудь знает, есть ли способ добиться этого?

46
задан Mark Amery 2 January 2017 в 20:55
поделиться