Autodoc all apps from a project to Sphinx
Project description
Django is very nice in that way you can reuse a lot of applications in your projects. It means for big projects that you’ll get a long list of applications in your settings.INSTALLED_APP.
If you’re using Django with Sphinx and want to autodoc all these apps in a wink of an eye, then this app is for you.
- A good combinaison for documenting your project would be:
sphinx
django-sphinx-autodoc to generate the doc from your applications
django-sphinxdoc to integrate the sphinx doc in your website
How it works
Copy the generate_autodoc.py file in your project directory, then execute it.
It will scrape all your .py files in each application listed by INSTALLED_APP, then add automodules in your DS_ROOT/modules.rst.
You will then see your applications grouped in 2 different categories:
internal application is an application located in your project directory
external application is an app which is somewhere in your pythonpath (preferably in your virtualenv)
Good Practices
Add a docstring in your application’s __init__.py file to describe it. django-sphinx-autodoc will automatically scrape it for you.
Settings
You can modify some of the settings used by django-sphinx-autodoc:
DS_ROOT: root path for documentation (default to project_dir/doc)
DS_MASTER_DOC: name of your master document (default to “index.rst”)
DS_FILENAME: name for the modules (default to “auto_modules.rst”)
DS_EXCLUDED_APPS: list of applications to exclude (default to [])
DS_EXCLUDED_MODULES: list of files to exclude (default to [“__init__.py”])
TODO
Write tests
improve the not_relevant stuff to auto exclude a file without class or def
Django command extension to update the autodoc
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-sphinx-autodoc-0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c465979baa0205cc21e29232b19b66ad26486c664b7364dd99bd5302baecc99a |
|
MD5 | ffb8262b860a772423c83e79d0778bca |
|
BLAKE2b-256 | aaa1aae6bc426487e44ea47c36f14812db611f5775b6da0b24dc8d6b6c308672 |