disable automatic autosummary created by numpydoc

Question

Is it possible do disable the complete autosummary when using autodoc?

I've got a class derived from a Python standard library class, which has many public methods. My custom class should work as a wrapper, directly providing methods to communicate with my device using its protocol. Therefore I only want to include a few selected inherited methods in the autosummary table.

.. autoclass:: my_module.MyClass
   :members:
   :show-inheritance:

   .. autosummary::
      my_method
      another_method

The ..autosummary:: block does exactly what I desire, but ..autoclass:: automatically creates a full methods table. Is there a way to disable this feature?

Edit (clarification)

Using the autosummary directive directly, I'm able to produce a method table containing only my_method and another_method:

.. autosummary::
   my_method
   another_method

However, when using autoclass or automodule without a following autosummary directive, I still get a method table looking exactly like the one created by the autosummary block above, only with all methods described:

.. autoclass:: my_module.MyClass
   :members:
   :show-inheritance

Edit 2

The "complete" autosummary table is being generated by numpydoc.

`autoclass` generates an own `autosummary` block, which I'd like to configure (or disable) in order to get the behaviour of the explicit `.. autosummary::` block. — Finwood, Mar 23 '16 at 17:40

score 3 · Accepted Answer · answered Mar 23 '16 at 18:05

The "problem" was not inside autodoc or autosummary.
Though not mentioned in the question I'm using numpydoc, which was generating the additional autosummary table.

As described in numpydoc's documentation, this feature can be disabled by adding numpydoc_show_inherited_class_members = False to the sphinx conf.py.

score 0 · Answer 2 · answered Mar 23 '16 at 14:24

0

You can remove the :members: tag, or include a comma separated list after :members: of only the methods you want to include in your documentation.

answered Mar 23 '16 at 14:24

Ashley Straw

1

This affects only the methods described in detail, not the table generated by autosummary – Finwood Mar 23 '16 at 15:41

disable automatic autosummary created by numpydoc

Edit (clarification)

Edit 2

2 Answers2