Add support for python 3.13 (#273)

* Add support for python 3.13

Remove support for python 3.8.

Upgrade all dependencies

Replaced sphinx docs googleanalytics module as current one is
deprecated.

Reformatted code using new version of black..

Use new merge-requires github action

AB#10062

Author: eccles

.env.tools

@@ -0,0 +1 @@
+export TOOLS_BUILDNUMBER=20241115.3

.github/workflows/python-package.yml renamed to .github/workflows/ci.yml

@@ -1,16 +1,17 @@
 # This workflow will install Python dependencies, run tests and lint with a variety of Python versions
 # For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
 
-name: Python Quality Control
+name: Build and test
 
-on: [pull_request]
+on:
+  workflow_call:
 
 jobs:
   build:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12" ]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13" ]
         os: [ubuntu-latest, windows-latest]
     runs-on: ${{ matrix.os }}
     steps:
@@ -66,7 +67,6 @@ jobs:
         ./scripts/unittests.sh
       shell: bash
     - name: Run type-hint checks
-      if: ${{ matrix.python-version != '3.12' }}
       run: |
         ./scripts/version.sh
         python3 -m pyright --stats archivist

.github/workflows/merge-requires.yml

@@ -0,0 +1,34 @@
+# This workflow configures the repository specific choices of which CI builds
+# must pass in order for a build to merge. This allows a sinlge global teraform
+# configured rule to require a "well known" check in each repository. Whilst
+# granting repository stakeholders the ability configure what workflows are
+# appropriate to satisfy that check.
+name: Merge Requires
+on:
+  push:
+
+jobs:
+  ci:
+    secrets: inherit
+    uses: ./.github/workflows/ci.yml
+  release:
+    if: ${{ github.event_name == 'release' }}
+    secrets: inherit
+    uses: ./.github/workflows/package.yml
+
+  merge-checks-ok:
+    runs-on: ubuntu-latest
+    needs: [ci]
+    steps:
+      - name: ok
+        run: |
+          echo "This code is mergeable"
+
+  release-checks-ok:
+    runs-on: ubuntu-latest
+    if: ${{ github.event_name == 'release' }}
+    needs: [ci, release]
+    steps:
+      - name: ok
+        run: |
+          echo "This code is releasable"

.github/workflows/python-publish.yml renamed to .github/workflows/package.yml

@@ -1,14 +1,13 @@
 # This workflow will upload a Python Package using Twine when a release is created
 # For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries
 
-name: Upload Python Package
+name: Package and Publish
 
 on:
-  release:
-    types: [created]
+  workflow_call:
 
 jobs:
-  deploy:
+  build:
 
     runs-on: ubuntu-latest
 

DEVELOPMENT.md

@@ -200,11 +200,11 @@ To run the unittests:
 task unittests
 ```
 
-##### Python 3.9
+##### Python 3.10
 
-To build the docker builder image with Python 3.9:
+To build the docker builder image with Python 3.10:
 ```bash
-task builder-3.9
+task builder-3.10
 ```
 
 To check the style
@@ -217,11 +217,11 @@ To run the unittests:
 task unittests
 ```
 
-##### Python 3.10
+##### Python 3.11
 
-To build the docker builder image with Python 3.10:
+To build the docker builder image with Python 3.11:
 ```bash
-task builder-3.10
+task builder-3.11
 ```
 
 To check the style
@@ -234,11 +234,11 @@ To run the unittests:
 task unittests
 ```
 
-##### Python 3.11
+##### Python 3.12
 
-To build the docker builder image with Python 3.11:
+To build the docker builder image with Python 3.12:
 ```bash
-task builder-3.11
+task builder-3.12
 ```
 
 To check the style
@@ -251,11 +251,11 @@ To run the unittests:
 task unittests
 ```
 
-##### Python 3.12
+##### Python 3.13
 
-To build the docker builder image with Python 3.12:
+To build the docker builder image with Python 3.13:
 ```bash
-task builder-3.12
+task builder-3.13
 ```
 
 To check the style

README.rst

@@ -12,10 +12,10 @@ documented at https://docs.datatrails.ai
 Support
 =======
 
-This package currently is tested against Python versions 3.8,3.9,3.10,3.11 and 3.12.
+This package currently is tested against Python versions 3.9,3.10,3.11, 3.12 and 3.13.
 
-The current default version is 3.8 - this means that this package will not
-use any features specific to versions 3.9 and later.
+The current default version is 3.9 - this means that this package will not
+use any features specific to versions 3.10 and later.
 
 After End of Life of a particular Python version, support is offered on a best effort
 basis. We may ask you to update your Python version to help solve the problem,

Taskfile.yml

@@ -17,11 +17,6 @@ tasks:
       - ./scripts/builder.sh pip-audit -r requirements.txt
 
   builder:
-    desc: Build a docker environment with the right dependencies and utilities
-    cmds:
-      - ./scripts/build.sh "3.8"
-
-  builder-3.9:
     desc: Build a docker environment with the right dependencies and utilities
     cmds:
       - ./scripts/build.sh "3.9"
@@ -41,6 +36,11 @@ tasks:
     cmds:
       - ./scripts/build.sh "3.12"
 
+  builder-3.13:
+    desc: Build a docker environment with the right dependencies and utilities
+    cmds:
+      - ./scripts/build.sh "3.13"
+
   check:
     desc: Check the style, bug and quality of the code
     deps: [about]

archivist/notebooks/Checking the Dog's Weight.ipynb

@@ -35,7 +35,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "\n",
     "from json import dumps as json_dumps\n",
     "from os import getenv\n",
     "\n",

archivist/notebooks/Create Artist and Album Release Info.ipynb

@@ -34,7 +34,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "\n",
     "from json import dumps as json_dumps\n",
     "from os import getenv\n",
     "\n",

archivist/notebooks/Feeding the Dog Hourly.ipynb

@@ -35,7 +35,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "\n",
     "from json import dumps as json_dumps\n",
     "from os import getenv\n",
     "\n",