При создании расширения C на Python возможно ли каким-либо образом писать комментарии, которые отображаются как docstrings пользователям расширение?
Docstrings в расширениях C к Python?
Ответ 1
Докстры для типов могут быть включены как элемент tp_doc
в структуре PyTypeObject
, см. пример в документах.
Докстры для функций могут быть включены в поле ml_doc
таблица методов модуля. Если вы хотите, чтобы ваши docstrings были "физически близки" к фактическим функциям, вы могли бы включить строковые константы над определениями функций, которые вы ссылаетесь в таблице методов.
Docstrings для методов можно присвоить doc
в поле введите таблицу элементов.
Докстры для модулей могут передаваться как параметр Py_InitModule3()
или Py_InitModule4()
.
Ответ 2
Я так не думаю, но вы должны иметь возможность манипулировать docstrings этих объектов из python. Подробнее см. документы python.