sphinx-doc/sphinx

autodoc does not recognize Cython property as such

Open

#7,448 创建于 2020年4月9日

在 GitHub 查看
 (3 评论) (1 反应) (0 负责人)Python (1,985 fork)batch import
extensions:autodochelp wantedtype:enhancement

仓库指标

Star
 (5,625 star)
PR 合并指标
 (平均合并 10天 11小时) (30 天内合并 11 个 PR)

描述

Because of implementation details, @property of Cython extension types are not the same as created by the builtin property function. For this reason, autodoc doesn't seem to be able to recognize these descriptor as such.

To Reproduce

First create a sample Cython module with the mentioned elements:

getter = property   # bypass Cython property hijack
setter = lambda fset: property(fset=fset, doc=fset.__doc__)     # noqa


cdef class Spam:
    @property
    def foo(self) -> int: return 42

    @getter
    def bar(self) -> float: return 6.9

    @setter
    def baz(self, value: bool) -> None: pass

as well as a setup.py for compilation

from distutils.core import setup
from Cython.Build import cythonize

setup(name='autospam',
      ext_modules=cythonize('cyspam.pyx',
                            compiler_directives={'binding': True}))

Use pip install . to install and cyspam should be importable.

Now if we create a sample project with the following content (I was a bit lazy to think of the documentations for the properties):

.. autoclass:: cyspam.Spam
   :undoc-members:

the rendered HTML looks like this:

2020-04-09T18:21:24

Expected behavior

It is expected that foo shows up as a property as well.

Sample project

autospam.zip

Environment info

  • OS: [e.g. Unix/Linux/Mac/Win/other with version]
  • Python version: 3.7.7
  • Sphinx version: 3.0.0
  • Sphinx extensions: sphinx.ext.autodoc
  • Extra tools: Cython

贡献者指南