Changes between Version 5 and Version 6 of MagicRemovalCheatSheet

Timestamp:

May 11, 2006, 11:46:47 PM (19 years ago)

Author:

eugene@…

Comment:

added settings

MagicRemovalCheatSheet

@@ -27 +27 @@
    * {{{auth_user_user_permissions}}}
    * {{{django_content_type}}}
- * '''After you finished with code changes''', run {{{django-admin.py syncdb}}} or {{{manage.py syncdb}}}. '''Don't do it now!'''
+ * '''After you finished with code changes''', run {{{manage.py syncdb}}}. '''Don't do it now!'''
 
 It repopulates the content of said tables properly, but an administrator has to reassign group and user permissions again in Admin. Obviously it can be a problem, if you have hundreds of users with arcane permissions.
@@ -56 +56 @@
    * {{{django.core.extensions}}} => {{{django.shortcuts}}}
    * '''renamed:''' {{{django.core.extensions.DjangoContext}}} => {{{django.template.RequestContext}}}
+   * '''moved:''' {{{django.models.core.Session}}} => {{{django.contrib.sessions.models.Session}}}
  1. A former module {{{settings}}} is an instance now. [wiki:RemovingTheMagic#Movedsettingsintoaninstance Import it] using:
 {{{
@@ -91 +92 @@
 == URLs and settings ==
 
+ 1. Update {{{urls.py}}}:
+   1. Admin URLConf was [wiki:RemovingTheMagic#MovedadminURLconftoshortenitspath relocated:
+     * {{{django.contrib.admin.urls.admin}}} => {{{django.contrib.admin.urls}}}
+   1. [wiki:RemovingTheMagic#Changedtheparametersyoupasstogenericviews Change the parameters you pass to generic views]: remove {{{app_label}}} and {{{model_name}}}, add {{{queryset}}}.
+ 1. Update {{{settings.py}}}:
+   1. Update {{{TEMPLATE_LOADERS}}} to reflect [wiki:RemovingTheMagic#Namespacesimplification Namespace simplification]: remove {{{core}} from their names.
+   1. Update {{{INSTALLED_APPS}}} to reflect [wiki:RemovingTheMagic#Namespacesimplification Namespace simplification]:
+     * {{{django.models.auth}}} => {{{django.contrib.auth.models}}}
+     * {{{django.models.core.sites}}} => {{{django.contrib.sites.models}}}
+     * {{{django.models.core.contenttypes}}} => {{{django.contrib.contenttypes.models}}}
+   1. Update {{{INSTALLED_APPS}}} to reflect changes you made in the Models section:
+     * {{{yourproject.apps.yourapp}}} => {{{yourproject.yourapp}}}
+   1. Add additional applications to your {{{INSTALLED_APPS}}} to satisfy dependencies:
+     * Before {{{django.contrib.admin}}} add {{{django.contrib.auth}}} and {{{django.contrib.contenttypes}}}.
+     * Before {{{django.contrib.flatpages}}} and/or {{{django.contrib.redirects}}} add {{{django.contrib.sites}}}.
+   1. The {{{packages}}} module [wiki:RemovingTheMagic#Thepackagesmoduleisnomore has been removed].
+   1. Update {{{MIDDLEWARE_CLASSES}}} to reflect [wiki:RemovingTheMagic#Namespacesimplification Namespace simplification]:
+     * {{{django.middleware.sessions.SessionMiddleware}}} => {{{django.contrib.sessions.middleware.SessionMiddleware}}}
+   1. If you rely on {{{request.user}}} [wiki:RemovingTheMagic#request.userisnowsetviamiddleware anywhere in your code], modify {{{MIDDLEWARE_CLASSES}}}:
+     * Add {{{django.contrib.auth.middleware.AuthenticationMiddleware}}} anywhere after {{{django.contrib.sessions.middleware.SessionMiddleware}}}.
+
 == Post-conversion ==
 
-If you decided to regenerate permissions, now is the good time to execute {{{django-admin.py syncdb}}} or {{{manage.py syncdb}}}. Remember that an administrator should reassign permissions to all users using Admin.
+Debug your changes using {{{manage.py validate}}} and {{{manage.py runserver}}}. If there are any problems, please refer to the appropriate section of this document to verify your changes, and consult [wiki:RemovingTheMagic Removing the magic].
+
+If you decided to regenerate permissions (see the Pre-conversion section above), now is the good time to execute {{{manage.py syncdb}}}. Remember that an administrator should reassign permissions to all users using Admin.