skip to navigation
skip to content

django-giza 0.1.4

Autodoc all modules from a Django project's INSTALLED_APPS for Sphinx

Latest Version: 0.1.6


Original code is from This version has been cleaned up and modified to work as a Django management command.

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 combination for documenting your project would be:
  • sphinx
  • cartouche to avoid polluting your docstrings with rst syntax
  • django-giza to generate the doc from your applications
  • django-sphinxdoc to integrate the sphinx doc in your website

How it works

It will scrape all your .py files in each application listed by INSTALLED_APPS, then add automodules in your PROJECT/SPHINX_ROOT/auto_modules.rst.

You will then see your applications grouped in 2 different categories:

  • Project Apps are applications located in your project directory
  • 3rd Party Apps are apps which are somewhere in your pythonpath (preferably in your virtualenv)

Good Practices

Add a docstring in your application’s file to describe it. django-giza will automatically scrape it for you (although files are excluded by default…)


$ pip install django-giza

Then add giza to your INSTALLED_APPS in


$ ./ giza

You can also specify the relative path to your docs root:

$ ./ giza private/documentation


You can modify some of the settings used by django-giza:


    Root path for documentation (absolute path required).

    defaults to:



    Name of your master document.

    defaults to:



    Name for the generated modules doc.

    defaults to:



    Title for the modules page.

    defaults to:

    "Python modules"


    List of applications to exclude. Can use wildcard at the end.

    defaults to: ["django.*", "giza"]


    List of filenames to exclude.

    defaults to: [""]


    List of options to the automodule directive, such as “private-members” (without colon delimiters)

    defaults to:

    ["deprecated", "members", "private-members", "special-members", "show-inheritance"]


  • Write tests
  • improve the not_relevant stuff to auto exclude a file without class or def
File Type Py Version Uploaded on Size
django-giza-0.1.4.tar.gz (md5) Source 2012-09-13 6KB