From 773f1ea174d10fc7e02375edd2b4594902120481 Mon Sep 17 00:00:00 2001 From: Philip Sargent Date: Mon, 27 Oct 2025 12:02:45 +0000 Subject: [PATCH] rearranged to reflect current priorities, server now running 4.2 - online edit of handbook/troggle/trogdjangup.html --- handbook/troggle/trogdjangup.html | 34 +++++++++++++++++-------------- 1 file changed, 19 insertions(+), 15 deletions(-) diff --git a/handbook/troggle/trogdjangup.html b/handbook/troggle/trogdjangup.html index c3a89c0b8..ad6995fea 100644 --- a/handbook/troggle/trogdjangup.html +++ b/handbook/troggle/trogdjangup.html @@ -9,11 +9,6 @@

CUCC Expedition Handbook

Upgrading Django for Troggle

-

Why this used to be difficult

-

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.

Django versions and update schedule

@@ -104,6 +99,13 @@
+

Why this used to be difficult

+

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. + +

Major, minor and releases

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. -

Django plugins ("apps")

-

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). ]

Troggle software development

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. + +

Django plugins ("apps")

+

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). ] +

Go on to: Troggle architecture