1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
Graph models
============
:synopsis: Renders a graphical overview of your project or specified apps.
Creates a GraphViz_ dot file for the specified app names based on their models.py.
You can pass multiple app names and they will all be combined into a single model.
Output is usually directed to a dot file.
Several options are available: grouping models, including inheritance,
excluding models and columns, and changing the layout when rendering to an output
image.
With the latest revisions it's also possible to specify an output file if
pygraphviz_ is installed and render directly to an image or other supported
file-type.
Selecting a library
-------------------
You need to select the library to generate the image. You can do so by passing
the --pygraphviz or --pydot parameter, depending on which library you want to use.
When neither of the command line parameters are given the default is to try and load
pygraphviz or pydot (in that order) to generate the image.
To install pygraphviz you usually need to run this command::
$ pip install pygraphviz
It is possible you can't install it because it needs some C extensions to build. In
that case you can try other methods to install or you can use PyDot.
To install pydot you need to run this command::
$ pip install pyparsing pydot
Installation should be fast and easy. Remember to install this exact version of
pyparsing, otherwise it's possible you get this error:
Couldn't import dot_parser, loading of dot files will not be possible.
Default Settings
----------------
The option GRAPH_MODELS = {} can be used in the settings file to specify default options::
GRAPH_MODELS = {
'all_applications': True,
'group_models': True,
}
It uses the same names as on the command line only with the leading two dashes removed and
the other dashes replaced by underscores. You can specify a list of applications with the *app_labels* key::
GRAPH_MODELS = {
'app_labels': ["myapp1", "myapp2", "auth"],
}
Templates
---------
Django templates are used to generate the dot code. This in turn can be drawn into a image
by libraries like *pygraphviz* or *pydot*. You can extend or override the templates if needed.
Templates used:
- django_extensions/graph_models/digraph.dot
- django_extensions/graph_models/label.dot
- django_extensions/graph_models/relation.dot
Documentation on how to create dot files can be found here: https://www.graphviz.org/documentation/
.. warning::
Modifying Django's default templates behaviour might break *graph_models*
Please be aware that if you use any *template_loaders* or extensions that change the
way templates are rendered that this can cause *graph_models* to fail.
An example of this is
the Django app *django-template-minifier* this automatically removed the newlines before/after
template tags even for non-HTML templates which leads to a malformed file.
Example Usage
-------------
With *django-extensions* installed you can create a dot-file or an
image by using the *graph_models* command::
# Create a dot file
$ ./manage.py graph_models -a > my_project.dot
::
# Create a PNG image file called my_project_visualized.png with application grouping
$ ./manage.py graph_models -a -g -o my_project_visualized.png
# Same example but with explicit selection of pygraphviz or pydot
$ ./manage.py graph_models --pygraphviz -a -g -o my_project_visualized.png
$ ./manage.py graph_models --pydot -a -g -o my_project_visualized.png
::
# Create a dot file for only the 'foo' and 'bar' applications of your project
$ ./manage.py graph_models foo bar > my_project.dot
::
# Create a graph for only certain models
$ ./manage.py graph_models -a -I Foo,Bar -o my_project_subsystem.png
::
# Create a graph excluding certain models
$ ./manage.py graph_models -a -X Foo,Bar -o my_project_sans_foo_bar.png
::
# Create a graph including models matching a given pattern and excluding some of them
# It will first select the included ones, then filter out the ones to exclude
$ ./manage.py graph_models -a -I Product* -X *Meta -o my_project_products_sans_meta.png
::
# Create a graph without showing its edges' labels
$ ./manage.py graph_models -a --hide-edge-labels -o my_project_sans_foo_bar.png
::
# Create a graph with 'normal' arrow shape for relations
$ ./manage.py graph_models -a --arrow-shape normal -o my_project_sans_foo_bar.png
::
# Create a graph with colored edges for relations with on_delete settings
$ ./manage.py graph_models -a --color-code-deletions -o my_project_colored.png
::
# Create a graph with different layout direction,
# supported directions: "TB", "LR", "BT", "RL"
$ ./manage.py graph_models -a --rankdir BT -o my_project_sans_foo_bar.png
::
# Create a graph with different edges ordering,
# supported orders: "in", "out"
$ ./manage.py graph_models -a --ordering in -o my_project_sans_foo_bar.png
.. _GraphViz: https://www.graphviz.org/
.. _pygraphviz: https://pygraphviz.github.io/
.. _pydot: https://pypi.python.org/pypi/pydot
|
