Ver código fonte

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 anos atrás
pai
commit
a0f07bca7f
1 arquivos alterados com 19 adições e 1 exclusões
  1. 19
    1
      docs/source/releases/v0.8.rst

+ 19
- 1
docs/source/releases/v0.8.rst Ver arquivo

@@ -90,7 +90,8 @@ now ships with sets of migrations both for South and the new native
90 90
 migrations framework.
91 91
 Unfortunately, the changes in Django required a few breaking changes when
92 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 96
 Reworked shipping app
96 97
 ~~~~~~~~~~~~~~~~~~~~~
@@ -413,6 +414,23 @@ the host portion is lowercased.
413 414
    ``oscar_find_duplicate_emails`` management command to check your database
414 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 434
 Misc
417 435
 ~~~~
418 436
 

Carregando…
Cancelar
Salvar