Сфинкс, автосуммария и динамические методы.

Question

Я нашел много использования с помощью setattr() для создания динамически генерируемых методов и атрибутов класса.Я также использовал sphinx для создания документации, и это фантастика.

Проблема заключается в том, что я не могу использовать функцию автоматического подсчета sphinx, если атрибуты и методы являются динамическими.Есть ли умный способ сделать это?Динамические методы и атрибуты создаются при инициализации.

Answer 1

Попробуйте это (немного странно):

1. Создайте экземпляр вашего класса в файле conf.py.
2. Используйте событие autodoc-process-docstring , чтобы запустить обработчик (который вам нужно будет написать), чтобы скопировать элементы __doc__ для различных динамических методов из экземпляра, созданного в 1), в выход для класса.

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