Description
Hi!
I just discovered this library and like it very much! There is just one thing that does not work as expected: In my code, there are some enums that contain many members (often more than ten). As all those entries are treated as class members (which they are, since a Python enum is a subclass of enum.Enum
), autodocsumm
creates redundant code: There is a table containing all enum values followed by all enum values.
I worked around that by inserting this code snippet into the docstring of all my enums:
.. autoclasssumm:: ClassName
:autosummary-sections: Methods
Since these enumerations do not have any methods, no summary table is generated (which is my desired behavior). However, it is somewhat tedious to insert this snippet into the docstring of all enums.
Thus my request: Would it be possible to add an option allowing to disable the generation of a summary in such cases. I could think of two ways to achieve this:
- Provide an option like
autodocsumm_disabled_classes
which you can pass a list of classes that should not have a summary. It has the downside that one still needs to manually insert the names of all enum classes. - Provide an option like
autodocsumm_disable_enums
that disables the generation of tables for all subclasses ofenum.Enum
.
I could also imagine that having both settings would be a valuable addition to this library.