How to use Sphinx's autodoc to document a class's __init__(self) method?

Question

Sphinx doesn\'t generate docs for __init__(self) by default. I have tried the following:

.. automodule:: mymodule
    :members:

and

Answer 1

Even though this is an older post, for those who are looking it up as of now, there is also another solution introduced in version 1.8. According to the documentation, You can add the special-member key in the autodoc_default_options to your conf.py.

Example:

autodoc_default_options = {
    'members': True,
    'member-order': 'bysource',
    'special-members': '__init__',
    'undoc-members': True,
    'exclude-members': '__weakref__'
}