0
0
mirror of https://github.com/django/django.git synced 2024-11-27 17:16:33 +01:00
django/docs/howto/delete-app.txt
Marcelo Galigniana 2ddfa3e2b6 Fixed #34309 -- Doc'd how to fully delete an app.
Co-authored-by: nessita <124304+nessita@users.noreply.github.com>
Co-authored-by: shangxiao <shang.xiao.sanders@gmail.com>
Co-authored-by: sarahboyce <42296566+sarahboyce@users.noreply.github.com>
Co-authored-by: felixxm <felisiak.mariusz@gmail.com>
2023-07-11 10:48:01 +02:00

30 lines
1.0 KiB
Plaintext

==================================
How to delete a Django application
==================================
Django provides the ability to group sets of features into Python packages
called :doc:`applications</ref/applications/>`. When requirements change, apps
may become obsolete or unnecessary. The following steps will help you delete an
application safely.
#. Remove all references to the app (imports, foreign keys etc.).
#. Remove all models from the corresponding ``models.py`` file.
#. Create relevant migrations by running :djadmin:`makemigrations`. This step
generates a migration that deletes tables for the removed models, and any
other required migration for updating relationships connected to those
models.
#. :ref:`Squash <migration-squashing>` out references to the app in other apps'
migrations.
#. Apply migrations locally, runs tests, and verify the correctness of your
project.
#. Deploy/release your updated Django project.
#. Remove the app from :setting:`INSTALLED_APPS`.
#. Finally, remove the app's directory.