Bladeren bron

Document further changes necessary when upgrading Django

The main issue is that Oscar relies on it's app configs to keep class
loading working. Hence, appropriate app configs need to be created when
upgrading.
master
Maik Hoepfel 11 jaren geleden
bovenliggende
commit
a0f07bca7f
1 gewijzigde bestanden met toevoegingen van 19 en 1 verwijderingen
  1. 19
    1
      docs/source/releases/v0.8.rst

+ 19
- 1
docs/source/releases/v0.8.rst Bestand weergeven

90
 migrations framework.
90
 migrations framework.
91
 Unfortunately, the changes in Django required a few breaking changes when
91
 Unfortunately, the changes in Django required a few breaking changes when
92
 upgrading Oscar both for users staying on Django 1.6 and for users upgrading to
92
 upgrading Oscar both for users staying on Django 1.6 and for users upgrading to
93
-Django 1.7 at the same time.
93
+Django 1.7 at the same time. These are detailed in the section for
94
+backwards-incompatible changes.
94
 
95
 
95
 Reworked shipping app
96
 Reworked shipping app
96
 ~~~~~~~~~~~~~~~~~~~~~
97
 ~~~~~~~~~~~~~~~~~~~~~
413
    ``oscar_find_duplicate_emails`` management command to check your database
414
    ``oscar_find_duplicate_emails`` management command to check your database
414
    and deal with any conflicts accordingly.
415
    and deal with any conflicts accordingly.
415
 
416
 
417
+Django 1.7 support
418
+------------------
419
+
420
+If you have any plans to upgrade to Django 1.7, more changes beyond
421
+addressing migrations are necessary:
422
+
423
+* You should be aware that Django 1.7 now enforces uniqueness of app labels.
424
+  Oscar dashboard apps now ship with app configs that set their app label
425
+  to ``{oldname}_dashboard``.
426
+* If you have forked any Oscar apps, you must add app configs to them, and
427
+  have them inherit from the Oscar one. See the appropriate section in
428
+  :doc:`/topics/fork_app` for an example.
429
+* Double-check that you address migrations as detailed above.
430
+* Django now enforces that no calls happen to the model registry during
431
+  app startup. This mostly means that you should avoid module-level calls to
432
+  ``get_model``, as that only works with a fully initialised model registry.
433
+
416
 Misc
434
 Misc
417
 ~~~~
435
 ~~~~
418
 
436
 

Laden…
Annuleren
Opslaan