Merge pull request #866 from MetRonnie/python

Minimum Python 3.12

Author: oliver-sanders

.github/workflows/create-conda-envs.yml

@@ -25,7 +25,7 @@ jobs:
     timeout-minutes: 30
     strategy:
       matrix:
-        python: ['3.9']
+        python: ['3.x']
     steps:
       - name: checkout cylc-doc
         uses: actions/checkout@v5

.github/workflows/deploy.yml

@@ -67,7 +67,7 @@ jobs:
       - name: configure python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: '3.x'
 
       - name: configure git
         uses: cylc/release-actions/configure-git@v1
@@ -105,7 +105,7 @@ jobs:
         uses: ./docs/.github/actions/create-conda-envs
         if: ${{ ! inputs.skip_conda_environment_check }}
         with:
-          python_version: '3.9'
+          python_version: '3.x'
           working_directory: ./docs
 
       - name: checkout gh-pages

.github/workflows/nightly.yml

@@ -64,7 +64,7 @@ jobs:
       - name: configure python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: '3.x'
 
       - name: checkout cylc-doc
         uses: actions/checkout@v5

.github/workflows/test.yml

@@ -37,12 +37,12 @@ jobs:
       - name: configure python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: '3.x'
 
       - name: configure node
         uses: actions/setup-node@v4
         with:
-            node-version: '16'
+            node-version: 'lts/*'
 
       - name: checkout cylc-doc
         uses: actions/checkout@v5
@@ -80,8 +80,9 @@ jobs:
           print(enchant.list_dicts())
 
       - name: build & test
+        # TODO: re-enable spelling when https://github.com/sphinx-contrib/spelling/issues/234 fixed
         run: |
-          make html spelling linkcheck \
+          make html linkcheck \
             SPHINXOPTS='-Wn --keep-going' FORCE_COLOR=true
 
       - name: debug sphinx failure

.github/workflows/undeploy.yml

@@ -41,7 +41,7 @@ jobs:
       - name: configure python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: '3.x'
 
       - name: configure git
         uses: cylc/release-actions/configure-git@v1

bin/version

@@ -21,7 +21,7 @@ import json
 import pathlib
 import sys
 
-from pkg_resources import parse_version
+from packaging.version import Version
 
 
 DUMMY_FORMATS = [
@@ -66,10 +66,7 @@ def ls(args):
 
 def tidy(args):
     # get list of documented versions
-    versions = [
-        parse_version(version)
-        for version in get_formats(args.builddir)
-    ]
+    versions = [Version(version) for version in get_formats(args.builddir)]
 
     # build dictionary of minor versions
     # versions = [<Version('1.0.1')>, <Version('1.0.2')>]
@@ -78,17 +75,14 @@ def tidy(args):
     # }
     minor_versions = {}
     for version in versions:
-        release = version._version.release
-        if len(release) > 2:
-            major_minor = release[:2]
-            if major_minor not in minor_versions:
-                minor_versions[major_minor] = []
-            minor_versions[major_minor].append(version)
+        if len(version.release) > 2:
+            major_minor = version.release[:2]
+            minor_versions.setdefault(major_minor, []).append(version)
 
     # pull out the versions we don't want any more
     # e.g from ['1.0.1', '1.0.2', '1.0.3'] pull out ['1.0.1', '1.0.2']
     tidy = []
-    for major_minor, versions in minor_versions.items():
+    for _major_minor, versions in minor_versions.items():
         if len(versions) > 1:
             versions.sort()
             tidy.extend(versions[:-1])

setup.cfg

@@ -36,8 +36,6 @@ classifiers =
     License :: OSI Approved :: GNU General Public License v3 (GPLv3)
     Operating System :: POSIX :: Linux
     Programming Language :: Python
-    Programming Language :: Python :: 3.8
-    Programming Language :: Python :: 3.9
     Programming Language :: Python :: 3 :: Only
     Programming Language :: Python :: Implementation :: CPython
     Topic :: Scientific/Engineering :: Atmospheric Science
@@ -50,7 +48,7 @@ install_requires =
     cylc-sphinx-extensions>=1.4.1
     eralchemy==1.2.*
     hieroglyph>=2.1.0
-    setuptools>=50
+    packaging
     sphinx>=7.1, !=7.4.4
     sphinx-copybutton
     sphinx-design>=0.5.0

src/installation.rst

@@ -12,13 +12,12 @@ Quick Installation
 
 Cylc runs on Unix-like systems including Linux and Mac OS.
 
-Via Conda (recommended)
-^^^^^^^^^^^^^^^^^^^^^^^
-
 .. admonition:: Supported Python versions
 
-   * cylc-flow supports Python 3.8+.
-   * cylc-uiserver supports Python 3.9+.
+   Cylc supports Python 3.12+.
+
+Via Conda (recommended)
+^^^^^^^^^^^^^^^^^^^^^^^
 
 .. tip::
 
@@ -46,11 +45,6 @@ Via Conda (recommended)
 Via Pip (+npm)
 ^^^^^^^^^^^^^^
 
-.. admonition:: Supported Python versions
-
-   * cylc-flow supports Python 3.7+.
-   * cylc-uiserver supports Python 3.9+.
-
 .. important::
 
    We recommend installing Cylc versions into virtual environments.

src/lib/cylc_release.py

@@ -2,7 +2,7 @@
 
 from cylc.flow import __version__
 
-from pkg_resources import parse_version
+from packaging.version import Version
 
 
 def pinned_version(version):
@@ -31,7 +31,7 @@ def pinned_version(version):
         '8.0rc1'
 
     """
-    ver = parse_version(version)
+    ver = Version(version)
     if ver.pre and ver.minor == 0 and ver.micro == 0:
         # special handling of major version pre-releases
         ret = (ver.major, str(ver.minor) + ''.join(map(str, ver.pre)))

src/reference/changes.rst

@@ -22,6 +22,9 @@ For more detail see the component changelogs:
 
 ----------
 
+Cylc 8.6
+--------
+
 .. TODO: Modify these URL's and uncomment this block before release
 
    .. admonition:: Cylc Components
@@ -33,6 +36,13 @@ For more detail see the component changelogs:
    :cylc-rose: `1.5 <https://github.com/cylc/cylc-rose/blob/master/CHANGES.md>`__
    :rose: `2.4 <https://github.com/metomi/rose/blob/master/CHANGES.md>`__
 
+Supported Python versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The minimum supported Python version is now 3.12.
+
+
+----------
 
 Cylc 8.5
 --------
@@ -282,6 +292,8 @@ configurations in
 `tornado <https://www.tornadoweb.org/en/stable/web.html#tornado.web.Application.settings>`_.
 
 
+----------
+
 Cylc 8.4
 --------
 
@@ -391,6 +403,8 @@ An info view has been added, displaying
    :width: 80%
 
 
+----------
+
 Cylc 8.3
 --------