开发者

Docstrings in C extensions to Python?

开发者 https://www.devze.com 2023-03-11 01:50 出处:网络
When creating a C extension to Python, is it possible to be able to somehow write comments that are exposed as docstrings to users of the开发者_如何学运维 extension? Docstrings for types can be includ

When creating a C extension to Python, is it possible to be able to somehow write comments that are exposed as docstrings to users of the开发者_如何学运维 extension?


Docstrings for types can be included as the tp_doc member in the PyTypeObject structure, see an example in the docs.

Docstrings for functions can be included in the ml_doc field of the module's method table. If you want your docstrings to be "physically close" to the actual functions, you could include string constants above your function definitions which you reference in the method table.

Docstrings for methods can be assigned to the doc field in the type's member table.

Docstrings for modules can be passed as a parameter to the Py_InitModule3() or Py_InitModule4() functions.


UPDATE: Python3 does not support Py_InitModule3(), and the method has been replaced with PyModule_Create().

0

精彩评论

暂无评论...
验证码 换一张
取 消

关注公众号