Addons: default to semver for sorting versions

Author: stsewd

readthedocs/projects/migrations/0127_default_to_semver.py

@@ -0,0 +1,84 @@
+# Generated by Django 4.2.16 on 2024-10-15 16:07
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0126_alter_remote_repository_description"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="addonsconfig",
+            name="flyout_sorting",
+            field=models.CharField(
+                choices=[
+                    ("alphabetically", "Alphabetically"),
+                    ("semver-readthedocs-compatible", "SemVer (Read the Docs)"),
+                    ("python-packaging", "Python Packaging (PEP 440 and PEP 425)"),
+                    ("calver", "CalVer (YYYY.0M.0M)"),
+                    ("custom-pattern", "Define your own pattern"),
+                ],
+                default="semver-readthedocs-compatible",
+                max_length=64,
+                verbose_name="Sorting of versions",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="addonsconfig",
+            name="flyout_sorting_custom_pattern",
+            field=models.CharField(
+                blank=True,
+                default=None,
+                help_text='Sorting pattern supported by BumpVer (<a href="https://github.com/mbarkhau/bumpver#pattern-examples">See examples</a>)',
+                max_length=32,
+                null=True,
+                verbose_name="Custom version sorting pattern",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="addonsconfig",
+            name="flyout_sorting_latest_stable_at_beginning",
+            field=models.BooleanField(
+                default=True,
+                verbose_name="Show <code>latest</code> and <code>stable</code> at the beginning",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicaladdonsconfig",
+            name="flyout_sorting",
+            field=models.CharField(
+                choices=[
+                    ("alphabetically", "Alphabetically"),
+                    ("semver-readthedocs-compatible", "SemVer (Read the Docs)"),
+                    ("python-packaging", "Python Packaging (PEP 440 and PEP 425)"),
+                    ("calver", "CalVer (YYYY.0M.0M)"),
+                    ("custom-pattern", "Define your own pattern"),
+                ],
+                default="semver-readthedocs-compatible",
+                max_length=64,
+                verbose_name="Sorting of versions",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicaladdonsconfig",
+            name="flyout_sorting_custom_pattern",
+            field=models.CharField(
+                blank=True,
+                default=None,
+                help_text='Sorting pattern supported by BumpVer (<a href="https://github.com/mbarkhau/bumpver#pattern-examples">See examples</a>)',
+                max_length=32,
+                null=True,
+                verbose_name="Custom version sorting pattern",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicaladdonsconfig",
+            name="flyout_sorting_latest_stable_at_beginning",
+            field=models.BooleanField(
+                default=True,
+                verbose_name="Show <code>latest</code> and <code>stable</code> at the beginning",
+            ),
+        ),
+    ]

readthedocs/projects/models.py

@@ -62,8 +62,8 @@
 from readthedocs.vcs_support.backends import backend_cls
 
 from .constants import (
-    ADDONS_FLYOUT_SORTING_ALPHABETICALLY,
     ADDONS_FLYOUT_SORTING_CHOICES,
+    ADDONS_FLYOUT_SORTING_SEMVER_READTHEDOCS_COMPATIBLE,
     DOWNLOADABLE_MEDIA_TYPES,
     MEDIA_TYPES,
     MULTIPLE_VERSIONS_WITH_TRANSLATIONS,
@@ -187,21 +187,25 @@ class AddonsConfig(TimeStampedModel):
     # Flyout
     flyout_enabled = models.BooleanField(default=True)
     flyout_sorting = models.CharField(
+        verbose_name=_("Sorting of versions"),
         choices=ADDONS_FLYOUT_SORTING_CHOICES,
-        default=ADDONS_FLYOUT_SORTING_ALPHABETICALLY,
+        default=ADDONS_FLYOUT_SORTING_SEMVER_READTHEDOCS_COMPATIBLE,
         max_length=64,
     )
     flyout_sorting_custom_pattern = models.CharField(
         max_length=32,
         default=None,
         null=True,
         blank=True,
+        verbose_name=_("Custom version sorting pattern"),
         help_text="Sorting pattern supported by BumpVer "
         '(<a href="https://github.com/mbarkhau/bumpver#pattern-examples">See examples</a>)',
     )
     flyout_sorting_latest_stable_at_beginning = models.BooleanField(
+        verbose_name=_(
+            "Show <code>latest</code> and <code>stable</code> at the beginning"
+        ),
         default=True,
-        help_text="Show <code>latest</code> and <code>stable</code> at the beginning",
     )
 
     # Hotkeys