METADATA 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125
  1. Metadata-Version: 2.1
  2. Name: django-schema-graph
  3. Version: 2.2.1
  4. Summary: An interactive graph of your Django model structure.
  5. Home-page: https://github.com/meshy/django-schema-graph
  6. License: MIT
  7. Author: Charlie Denton
  8. Author-email: charlie@meshy.co.uk
  9. Requires-Python: >=3.6
  10. Classifier: Development Status :: 4 - Beta
  11. Classifier: Framework :: Django
  12. Classifier: Framework :: Django :: 1.11
  13. Classifier: Framework :: Django :: 2.0
  14. Classifier: Framework :: Django :: 2.1
  15. Classifier: Framework :: Django :: 2.2
  16. Classifier: Framework :: Django :: 3.0
  17. Classifier: Framework :: Django :: 3.1
  18. Classifier: Framework :: Django :: 3.2
  19. Classifier: Framework :: Django :: 4.0
  20. Classifier: Framework :: Django :: 4.1
  21. Classifier: Intended Audience :: Developers
  22. Classifier: License :: OSI Approved :: MIT License
  23. Classifier: Natural Language :: English
  24. Classifier: Programming Language :: Python
  25. Classifier: Programming Language :: Python :: 3
  26. Classifier: Programming Language :: Python :: 3.6
  27. Classifier: Programming Language :: Python :: 3.7
  28. Classifier: Programming Language :: Python :: 3.8
  29. Classifier: Programming Language :: Python :: 3.9
  30. Classifier: Programming Language :: Python :: 3.10
  31. Classifier: Programming Language :: Python :: 3.11
  32. Classifier: Programming Language :: Python :: 3
  33. Classifier: Programming Language :: Python :: 3.10
  34. Classifier: Programming Language :: Python :: 3.11
  35. Classifier: Programming Language :: Python :: 3.6
  36. Classifier: Programming Language :: Python :: 3.7
  37. Classifier: Programming Language :: Python :: 3.8
  38. Classifier: Programming Language :: Python :: 3.9
  39. Classifier: Topic :: Database
  40. Classifier: Topic :: Documentation
  41. Classifier: Topic :: Utilities
  42. Requires-Dist: attrs (>=21.4.0)
  43. Project-URL: Repository, https://github.com/meshy/django-schema-graph
  44. Description-Content-Type: text/markdown
  45. # Django Schema Graph
  46. Django-schema-graph makes a colourful diagram out of your Django models. The
  47. diagram is interactive, and makes it easy to toggle models and apps on/off at
  48. will.
  49. It looks like this:
  50. | Feature | Screenshot |
  51. | --- | --- |
  52. | Models | ![models screenshot](docs-images/models.png) |
  53. | Apps | ![apps screenshot](docs-images/apps.png) |
  54. | Both together | ![models and apps screenshot](docs-images/combination.png) |
  55. | Graph editor | ![menu screenshot](docs-images/menu.png) |
  56. (Apologies that the images above don't work on PyPI. [Check it out on
  57. GitHub](https://github.com/meshy/django-schema-graph/blob/master/README.md).)
  58. ## Installation
  59. Install from PyPI:
  60. ```bash
  61. pip install django-schema-graph
  62. ```
  63. Add to `INSTALLED_APPS`:
  64. ```python
  65. INSTALLED_APPS = [
  66. ...
  67. 'schema_graph',
  68. ...
  69. ]
  70. ```
  71. Add to your URLs.
  72. ```python
  73. from schema_graph.views import Schema
  74. urlpatterns += [
  75. # On Django 2+:
  76. path("schema/", Schema.as_view()),
  77. # Or, on Django < 2:
  78. url(r"^schema/$", Schema.as_view()),
  79. ]
  80. ```
  81. ## Use
  82. Browse to `/schema/` (assuming that's where you put it in your URLs).
  83. You can control access to this page using the `SCHEMA_GRAPH_VISIBLE` setting,
  84. or by subclassing `schema_graph.views.Schema` and overriding `access_permitted`.
  85. By default the page is only visible when `DEBUG` is `True`,
  86. because we assume that you don't want to leak sensitive information about your
  87. website outside of local development.
  88. ## Support
  89. Tests run on sensible combinations of:
  90. - Python (3.6-3.11)
  91. - Django (1.11-4.1)
  92. If you're stuck on old version of Python or Django, you may consider installing
  93. old versions.
  94. They will probably have fewer features, and there will be no support for them.
  95. The last version to support Python 2.7 and 3.5 was 1.2.0
  96. The last version to support Django 1.8 was 1.2.0
  97. ## Alternatives
  98. - [`django-spaghetti-and-meatballs`](https://github.com/LegoStormtroopr/django-spaghetti-and-meatballs)
  99. is great. At the time of writing, it offers a lot more detailed information
  100. on the models in the diagram, but doesn't allow them to be turned on/off in
  101. the page.