Могу ли я подавить расширение переменных в документации Sphinx?

В моем коде у меня есть

X_DEFAULT = ['a', 'long', 'list', 'of', 'values', 'that', 'is', 'really', 'ugly', 'to', 'see', 'over', 'and', 'over', 'again', 'every', 'time', 'it', 'is', 'referred', 'to', 'in', 'the', 'documentation']

и позже

def some_function(..., x=X_DEFAULT, ...):

так что в моей документации Sphinx, используя (например, используя.. autofunction::и т. д.) я получаю всю длинную и громоздкую стоимостьX_DEFAULT расширен в подписи дляsome_function:

some_function(..., x = ['a', 'long', 'list', 'of', 'values', 'that', 'is', 'реально', 'некрасиво', 'to', 'see' , «над», «и», «над», «снова», «каждый», «время», «это», «это», «указано», «к», «в», «то», « документация'], ...)

Есть ли способ подавить эту замену в сгенерированной документации, в идеале со ссылкой на определениеX_DEFAULT:

some_function(..., х =X_DEFAULT...)

Я знаю, что могу вручную переопределить сигнатуру для каждой функции и метода, которые я явно перечисляю в качестве аргументов директив документации Sphinx, но здесь это не моя цель. Я также знаю, что я мог бы использоватьautodoc_docstring_signature и первая строка строки документации, но это приведет к появлению плохих строк документации, действительно предназначенных для случаев, когда самоанализ не удается (например, C). Я подозреваю, что я могу кое-что сделать вautodoc-process-signature это может быть достаточно (но не идеально), хотя я не уверен, как поступить.

Ответы на вопрос(1)

Ваш ответ на вопрос