如何使 pybind11 属性文档字符串显示出来？

Question

我有以下代码：

py::class_<Logger> logger(m, "Logger");
logger.doc() = "class docstring";
logger.def("setLevels", [](uint16_t levels)
    {
        LoggerInstance.setLevels(levels);
    },
    R"(
        Turns on/off different logging levels
        Parameters
        * levels Logging level flags
    )"
    );

//expose values as constant fields
logger.def_property_readonly_static("LOG_NONE", [](py::object /* self */){return LOG_NONE;}, "no log level turned on");
logger.def_property_readonly_static("LOG_INFO", [](py::object /* self */){return LOG_INFO;}, "info level logs turned on");
logger.def_property_readonly_static("LOG_DEBUG", [](py::object /* self */){return LOG_DEBUG;}, "debug level logs turned on");
logger.def_property_readonly_static("LOG_WARN", [](py::object /* self */){return LOG_WARN;}, "warning logs turned on");
logger.def_property_readonly_static("LOG_ERROR", [](py::object /* self */){return LOG_ERROR;}, "error logs turned on");

根据这个答案，这是传递文档字符串的正确方法。 但是当我在 python (3.6) 中检查它时

帮助（记录器）

我得到空的数据描述符：

我怎样才能让文档字符串出现在 python 帮助中？

Answer 1

我认为这是一个错误（见这里）。 如果您可以更改 C++ 源，您可以尝试使这些成员非静态，然后使用def_property_readonly （至少在我的测试中会显示文档字符串）。