Попатчить Sphinx-dос за 5 000 рублей

P.S. Если считаете, что мало — пишите, торг уместен.

Что-то как-то напряжно: там сигнатура функции через inspect.getargspec дергается и то что вы хотите это наверно inspect.getsource и парсить самому, нетривиальненько. На github у sphinx-doc есть issue с такой хотелкой и низким приоритетом.

import scipy.constants
import inspect

def mega_method(freq=1e10, prop_speed=scipy.constants.c):
    pass

inspect.getsource(mega_method)
Out[11]: u'def mega_method(freq=1e10, prop_speed=scipy.constants.c):\n    pass\n'

inspect.getargspec(mega_method)
Out[12]: ArgSpec(args=['freq', 'prop_speed'], varargs=None, keywords=None, defaults=(10000000000.0, 299792458.0))

Так это наша хотелка и есть.

А где там вызывается inspect.getargspec? Просто мы так и не нашли того места, где Sphinx генерит путь к питоньему файлу и пытается его попарсить.

Вы точно пистонисты? Он не генерит какой-то там путь. Он импортирует как обычная пистон-программа ваши модули. https://github.com/sphinx-doc/sphinx/blob/master/sphinx/ext/autodoc.py#L1049

Еще добавление к sphinx-build параметра -vvv добавляет понимания.

Ну, и на этот счёт не всё потеряно: можно же атрибут __file__ подёргать.

По идее, там на 84-ю строку в util/inspect.py надо воткнуть что-то, что сделает func_defaults равным массиву необработанных дефолтных значений:

https://github.com/sphinx-doc/sphinx/blob/master/sphinx/util/inspect.py#L84

Аргументы можно попробовать получить из исходника, который берётся из inspect.getsource(func.func_code), но нужно парсить, а это не совсем тривиально в случае сложных аргументов (лямбды там, функции и т.д.).

Не пони зачем за него дергать.

В вашем случае нужно либо закрыть задачу https://github.com/sphinx-doc/sphinx/issues/759, скорее всего добавив опцию в конфиг и разбор аргументов через getsource (как уже советовалось). Либо наследовать директивы, переопределять методы, переписывать sphinx'совский getargspec и пользоваться своим принципиально новым

.. myautofunction::

парсить самому, нетривиальненько.

>>> node = ast.parse("def mega_method(freq=1e10, prop_speed=scipy.constants.c):\
n    pass\n")
>>> print node
<_ast.Module object at 0x0000000002546908>
>>> ast.dump(node)
"Module(body=[FunctionDef(name='mega_method', args=arguments(args=[Name(id='freq
', ctx=Param()), Name(id='prop_speed', ctx=Param())], vararg=None, kwarg=None, d
efaults=[Num(n=10000000000.0), Attribute(value=Attribute(value=Name(id='scipy',
ctx=Load()), attr='constants', ctx=Load()), attr='c', ctx=Load())]), body=[Pass(
)], decorator_list=[])])"

AST от версии к версии часто меняется.

Так ведь тут все константы уже раскрыты?

[ни черта не понимает]

Почему это? Вторая не тронута. Вывод первой - вопрос форматирования чисел.

Чем переписывать sphinx просто копируйте в первую строку docstring сигнатуру функции: http://stackoverflow.com/questions/12082570/override-function-declaration-in-... .

Как временное решение это прокатит. Но копировать код лишний раз очень, очень неохота. Да и сигнатуры временами меняются, и не каждый раз наши разработчики будут успевать поправить докстринги.