Skip to content

Instantly share code, notes, and snippets.

@perrygeo
Created April 13, 2013 21:44
Show Gist options
  • Save perrygeo/5380196 to your computer and use it in GitHub Desktop.
Save perrygeo/5380196 to your computer and use it in GitHub Desktop.
Generate UML diagram of django app models
apt-get install python-pygraphviz
pip install django-extensions
# add 'django_extensions' to INSTALLED_APPS in settings.py
python manage.py graph_models trees -o test.png
@leonel-lordford
Copy link

Didn't work for me :-( Gives me django.template.exceptions.TemplateDoesNotExist: django_extensions/graph_models/digraph.dot
Just notice I'm using django-orm standalone outside a web app... just using it for accessing DB from API...
Any help for generating my models diagram?
LordFord.

@leonel-lordford
Copy link

I'm just using django-orm-standalone and got this error: django.template.exceptions.TemplateDoesNotExist: django_extensions/graph_models/digraph.dot
I did install django-extensions etc... using pip in python3....
Maybe I need to set some ENV_VARS...
Any help?

@syabro
Copy link

syabro commented Dec 21, 2017

If you have this error for OS X and brew

Collecting pygraphviz
  Using cached pygraphviz-1.3.1.zip
Installing collected packages: pygraphviz
  Running setup.py install for pygraphviz ... error
    Complete output from command /Users/syabro/.virtualenvs/hoaas/bin/python3.6 -u -c "import setuptools, tokenize;__file__='/private/var/folders/zy/9d1g10s11d744d62zvxb67d40000gn/T/pip-build-nej0gni5/pygraphviz/setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" install --record /var/folders/zy/9d1g10s11d744d62zvxb67d40000gn/T/pip-u8xfe9h1-record/install-record.txt --single-version-externally-managed --compile --install-headers /Users/syabro/.virtualenvs/hoaas/include/site/python3.6/pygraphviz:
    running install
    Trying pkg-config
    Failed to find pkg-config
    Trying dotneato-config
    Failed to find dotneato-config
    Failed to find dotneato-config

    Your Graphviz installation could not be found.

            1) You don't have Graphviz installed:
               Install Graphviz (http://graphviz.org)

            2) Your Graphviz package might incomplete.
               Install the binary development subpackage (e.g. libgraphviz-dev or similar.)

            3) You are using Windows
               There are no PyGraphviz binary packages for Windows but you might be
               able to build it from this source.  See
               http://networkx.lanl.gov/pygraphviz/reference/faq.html

            If you think your installation is correct you will need to manually
            change the include_dirs and library_dirs variables in setup.py to
            point to the correct locations of your graphviz installation.

            The current setting of library_dirs and include_dirs is:
    library_dirs=None
    include_dirs=None

    error: Error locating graphviz.

try

pip install --install-option="--include-path=/usr/local/include/" --install-option="--library-path=/usr/local/lib/" pygraphviz

@ivancarrancho
Copy link

with python 3 :(
1__ivan_ivans-imac____documents_projects_mintic-appsco__zsh_

@bmjr
Copy link

bmjr commented Mar 27, 2018

For anyone with @leonel-lordford problem of Template-Does-Not-Exist ensure that you enable App_Dirs under the template settings in your chosen settings file. That worked for me!

@browniebroke
Copy link

For people who have issues installing graphviz libraries (for some reason)

If you remove the -o option it'll print as a dot file to the stdout, which you can redirect to a file. From there, you have online converters to generate an image. This one has an interactive codepen-like editor: https://dreampuf.github.io/GraphvizOnline/

@jneuendorf
Copy link

jneuendorf commented Jun 29, 2018

Thanks, @syabro your command worked for me (on macOS 10.13.5)! :)

@caot
Copy link

caot commented Nov 12, 2018

Is there a way to generate a graph of a selected set of models and the related only?

@mcardozo
Copy link

mcardozo commented Jan 3, 2019

For anyone with @leonel-lordford problem of Template-Does-Not-Exist ensure that you enable App_Dirs under the template settings in your chosen settings file. That worked for me!

and for me! thank you!

@wesvetter
Copy link

@browniebroke thanks for this tip! I couldn't get graphviz working but the dot output worked so I was able to get a graph via your link.

@moojen
Copy link

moojen commented May 20, 2020

Thanks, @syabro your command worked for me (on macOS 10.13.5)! :)

@syabro Same here, worked after using brew (on macOS 10.15.4). Cheers!!

@jhonvidal
Copy link

Get it working, thanks.

I have a question, the graph only shows me the attributes of all kinds.

How can I get it to also show the methods of all classes?

@jhonvidal
Copy link

Thanks, @syabro your command worked for me (on macOS 10.13.5)! :)

@syabro Same here, worked after using brew (on macOS 10.15.4). Cheers!!

Do you know how to also show the methods of a class?

@AgustinPardo
Copy link

How to only show one app diagram?

@dunmininu
Copy link

is there a way I can customize the output (image generated)?
and also the many to many tables are not being generated. How do I go about it please?

@lalit97
Copy link

lalit97 commented Jun 21, 2022

these steps worked for me on ubuntu 20.04

sudo apt install graphviz
pip install django-extensions
pip install pyparsing pydot
python manage.py graph_models -a -o diagram.png
python manage.py graph_models -a -g -o diagram-grouped.png

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment