IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

refactor: autodoc: if-block for callable object is no longer needed

Browse Source 
The if-block for callable object was added to FunctionDocumenter at
5c3a0e4e40 (see #5447).  At that time, it helps to introspect
the function signature for a callable object because
``sphinx.util.inspect:Signature`` emits a warning when a callable
object is given.

For now, ``sphinx.util.inspect:signature()` does not emit a warning
even if a callable object is given.  So this if-block is no longer
needed.
This commit is contained in:
Takeshi KOMIYA 2020-05-06 01:30:26 +09:00
parent f0df9ac725
commit b6e8f63066
1 changed files with 2 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
sphinx/ext/autodoc/__init__.py
View File

@ -1045,18 +1045,8 @@ class FunctionDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter): # typ
# cannot introspect arguments of a C function or method
return None
try:
if (not inspect.isfunction(unwrapped) and
not inspect.ismethod(unwrapped) and
not inspect.isbuiltin(unwrapped) and
not inspect.is_cython_function_or_method(unwrapped) and
not inspect.isclass(unwrapped) and
hasattr(unwrapped, '__call__')):
self.env.app.emit('autodoc-before-process-signature',
unwrapped.__call__, False)
sig = inspect.signature(unwrapped.__call__)
else:
self.env.app.emit('autodoc-before-process-signature', unwrapped, False)
sig = inspect.signature(unwrapped)
self.env.app.emit('autodoc-before-process-signature', unwrapped, False)
sig = inspect.signature(unwrapped)
args = stringify_signature(sig, **kwargs)
except TypeError:
if (inspect.is_builtin_class_method(unwrapped, '__new__') and