Before Django 3.0, whenever Django was upgraded to a new version things broke across the entire django package, including things which we did't conciously use but which were internal dependencies within Django. These were 'the way to do it' when troggle was first written for Django 0.7 in 2006. So upgrading troggle to a new Django version required not just a broad beadth of knowledge across troggle, but also across the entire breadth of Django itself. And the error messages are sometimes very unhelpful. This is no longer the case and the Django organisation has a very clear "non-breaking" policy between LTS releases. -
Now read Django and Troggle if you haven't already. - -
Note that Django 3.2 is out of support since April 2024.
Before Django 3.0, whenever Django was upgraded to a new version things broke across the entire django package, including things which we did't conciously use but which were internal dependencies within Django. These were 'the way to do it' when troggle was first written for Django 0.7 in 2006. So upgrading troggle to a new Django version required not just a broad beadth of knowledge across troggle, but also across the entire breadth of Django itself. And the error messages are sometimes very unhelpful. This is no longer the case and the Django organisation has a very clear "non-breaking" policy between LTS releases. +
Now read Django and Troggle if you haven't already. + +
Note that Django 4.2 will be out of support in April 2026. + +
Django release 4.2.16 is major-version 4, minor-version 2, and patch-release 16. 4.2 is the "feature release" and patch releases within each feature release are not meant to break anything. They are just to fix bugs. @@ -115,16 +117,6 @@ documentation which is maintained by django.
You will also need to read the django guide to upgrading to newer versions. -
Documentation for the plugins is highly variable and plugin projects, being run by volunteers, can just die unexpectedly. For the django-registration plugin there are two sources of current information:
-Docs: django-registration 3.1
-PyPi: django-registration 3.1
-
but only one of these (PyPi) gives release history data - which is what you need if you get behind with the django upgrades. - -
Django plugin documentation cannot be relied upon to tell you which version of django they require. They will complain when you run them if your version of django is too old though. Some experimentation is required. - -
[ However django-extensions looks like it could be useful explicitly to help us through the upgrade process: -pypi.org/project/django-extensions/ (only available for django 2.2 and later). ]
Upgrading the version of django used by troggle can be a serious programming job. It is not just a matter of editing a few config files. You @@ -248,6 +240,18 @@ Follow the instructions in the "Unit tests" section installed locally at docs/in This involves running git clone on the django source repo to download the tests. We hope we never have to do this again but in case we get incomprehensible bugs in future, we should be prepared to do so.
Current upgrade status is documented: here. + +
Documentation for the plugins is highly variable and plugin projects, being run by volunteers, can just die unexpectedly. For the django-registration plugin there are two sources of current information:
+Docs: django-registration 3.1
+PyPi: django-registration 3.1
+
but only one of these (PyPi) gives release history data - which is what you need if you get behind with the django upgrades. + +
Django plugin documentation cannot be relied upon to tell you which version of django they require. They will complain when you run them if your version of django is too old though. Some experimentation is required. + +
[ However django-extensions looks like it could be useful explicitly to help us through the upgrade process: +pypi.org/project/django-extensions/ (only available for django 2.2 and later). ] +