METADATA 6.1 KB

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