Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Apply autosummary for module but not nested classes #19

Closed
piyushk opened this issue Sep 18, 2019 · 3 comments · Fixed by #20
Closed

Apply autosummary for module but not nested classes #19

piyushk opened this issue Sep 18, 2019 · 3 comments · Fixed by #20

Comments

@piyushk
Copy link
Contributor

piyushk commented Sep 18, 2019

I'm using autodocsumm along with sphinx-apidoc to generate documentation.

My current usage is as follows:

.. automodule:: {{ pkgname }}
   :members:
   :undoc-members:
   :inherited-members:
   :autosummary:

This creates the summary table as desired for the module, but also causes each class etc. in the package added by automodule to have a summary table, which is not desired. Is there an easy way I can get just the summary table for the module, and not for nested structures?

@Chilipp
Copy link
Owner

Chilipp commented Sep 18, 2019

Hi piyushk! Unfortunately, no, not yet. I see that this feature can be useful and it would be good to implement it! It should not be too difficult.

Do you have any time that you can invest into this? I can work on it, but probably not much during the next four weeks since I am finishing my PhD. I am happy to discuss and review any new implementation.

@piyushk
Copy link
Contributor Author

piyushk commented Sep 18, 2019

I'll take a look at it tomorrow. I haven't looked at the code in detail yet -- any quick pointers on how to implement the feature would be appreciated, but not necessary.

@piyushk
Copy link
Contributor Author

piyushk commented Sep 19, 2019

I managed to find some time right now to look at this issue. I have opened a draft PR for this issue #20 which attempts a fix. We can continue discussion there. I'm unsure if my solution is correct, as I do not have familiarity with sphinx or autodoc code.

We can also follow up at a later date when you're more available. I'm currently using my branch, so I'm not blocked.

piyushk added a commit to piyushk/autodocsumm that referenced this issue Sep 19, 2019
Closes Chilipp#19

- Add new option `autosummary-no-nesting`
- New parameter allows for non-nested generation of autosummary tables.
- Docs and tests for new feature.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants