1Metadata-Version: 1.2
2Name: django-extensions
3Version: 3.0.5
4Summary: Extensions for Django
5Home-page: http://github.com/django-extensions/django-extensions
6Author: Michael Trier
7Author-email: mtrier@gmail.com
8Maintainer: Bas van Oostveen
9Maintainer-email: v.oostveen@gmail.com
10License: MIT License
11Description: ===================
12         Django Extensions
13        ===================
14
15        .. image:: https://img.shields.io/pypi/l/django-extensions.svg
16           :target: https://raw.githubusercontent.com/django-extensions/django-extensions/master/LICENSE
17
18        .. image:: https://secure.travis-ci.org/django-extensions/django-extensions.svg?branch=master
19            :alt: Build Status
20            :target: http://travis-ci.org/django-extensions/django-extensions
21
22        .. image:: https://img.shields.io/pypi/v/django-extensions.svg
23            :target: https://pypi.python.org/pypi/django-extensions/
24            :alt: Latest PyPI version
25
26        .. image:: https://img.shields.io/pypi/wheel/django-extensions.svg
27            :target: https://pypi.python.org/pypi/django-extensions/
28            :alt: Supports Wheel format
29
30        .. image:: https://coveralls.io/repos/django-extensions/django-extensions/badge.svg?branch=master
31           :target: https://coveralls.io/r/django-extensions/django-extensions?branch=master
32           :alt: Coverage
33
34        Django Extensions is a collection of custom extensions for the Django Framework.
35
36
37        Getting Started
38        ===============
39
40        The easiest way to figure out what Django Extensions are all about is to watch the
41        `excellent screencast by Eric Holscher`__ (`watch the video on vimeo`__). In a couple
42        minutes Eric walks you through a half a dozen command extensions. There is also a
43        `short screencast on GoDjango's Youtube Channel`__ to help show you even more.
44
45
46        Requirements
47        ============
48
49        Django Extensions requires Django 2.2 or later.
50
51
52        Getting It
53        ==========
54
55        You can get Django Extensions by using pip::
56
57            $ pip install django-extensions
58
59        If you want to install it from source, grab the git repository from GitHub and run setup.py::
60
61            $ git clone git://github.com/django-extensions/django-extensions.git
62            $ cd django-extensions
63            $ python setup.py install
64
65
66        Installing It
67        =============
68
69        To enable `django_extensions` in your project you need to add it to `INSTALLED_APPS` in your projects
70        `settings.py` file::
71
72            INSTALLED_APPS = (
73                ...
74                'django_extensions',
75                ...
76            )
77
78
79        Using It
80        ========
81
82        Generate (and view) a graphviz graph of app models::
83
84            $ python manage.py graph_models -a -o myapp_models.png
85
86        Produce a tab-separated list of `(url_pattern, view_function, name)` tuples for a project::
87
88            $ python manage.py show_urls
89
90        Check templates for rendering errors::
91
92            $ python manage.py validate_templates
93
94        Run the enhanced django shell::
95
96            $ python manage.py shell_plus
97
98        Run the enhanced django runserver, (requires Werkzeug install)::
99
100            $ python manage.py runserver_plus
101
102
103        Getting Involved
104        ================
105
106        Open Source projects can always use more help. Fixing a problem, documenting a feature, adding
107        translation in your language. If you have some time to spare and like to help us, here are the places to do so:
108
109        - GitHub: https://github.com/django-extensions/django-extensions
110        - Mailing list: http://groups.google.com/group/django-extensions
111        - Translations: https://www.transifex.net/projects/p/django-extensions/
112
113
114        Documentation
115        =============
116
117        You can view documentation online at:
118
119        - https://django-extensions.readthedocs.io
120
121        Or you can look at the docs/ directory in the repository.
122
123
124        Support
125        =======
126
127        Django Extensions is free and always will be. It is development and maintained by developers in an Open Source manner.
128        Any support is welcome. You could help by writing documentation, pull-requests, report issues and/or translations.
129
130        Please remember that nobody is paid directly to develop or maintain Django Extensions so we do have to divide our time
131        between putting food on the table, family, this project and the rest of life :-)
132
133
134        __ http://ericholscher.com/blog/2008/sep/12/screencast-django-command-extensions/
135        __ http://vimeo.com/1720508
136        __ https://www.youtube.com/watch?v=1F6G3ONhr4k
137
138Platform: any
139Classifier: Development Status :: 5 - Production/Stable
140Classifier: Environment :: Web Environment
141Classifier: Framework :: Django
142Classifier: Framework :: Django :: 2.2
143Classifier: Framework :: Django :: 3.0
144Classifier: Framework :: Django :: 3.1
145Classifier: Intended Audience :: Developers
146Classifier: License :: OSI Approved :: MIT License
147Classifier: Operating System :: OS Independent
148Classifier: Programming Language :: Python
149Classifier: Programming Language :: Python :: 3
150Classifier: Programming Language :: Python :: 3 :: Only
151Classifier: Programming Language :: Python :: 3.5
152Classifier: Programming Language :: Python :: 3.6
153Classifier: Programming Language :: Python :: 3.7
154Classifier: Programming Language :: Python :: 3.8
155Classifier: Programming Language :: Python :: Implementation :: CPython
156Classifier: Programming Language :: Python :: Implementation :: PyPy
157Classifier: Topic :: Utilities
158Requires-Python: >=3.5
159