Попатчить Sphinx-dос за 5 000 рублей
Братцы-питонщики! В вам обращаюсь я, друзья мои.
Надо попатчить Sphinx-doс. Чтобы тот в сигнатурах методов и функций не раскрывал значения аргументов по умолчанию, а писал их так же, как есть.
Например, есть у меня вот такая сигнатура. Вполне понятная, ко вставке в документацию пригодная.
def mega_method(freq=1e10, prop_speed=scipy.constants.c)
Sphinx её раскроет во что-то такое:
def mega_method(freq=10000000000., prop_speed=299792458.)
Так жить нельзя: если аргументов не два, а 5-7, то сигнатура становится совсем нечитаемой.
Надо сделать так, чтобы в conf.py можно было вставить ещё одну настройку: раскрывать сигнатуры — или таки оставить их как есть.