Move over to using poetry for packaging and pre-commit for code checking

This MR is big but largely mechanical.

The first commit moves from using setup.py over to using poetry for packaging. This aligns better with our current Python project guidelines. No package version specifiers have been changed from the original requirements.txt list and the resulting package should be identical.

The second commit adds our .pre-commit-config.yaml file and fixes up the code base via black and isort. No functionality changes are present but this did catch a type annotation bug with the override_permissions_spec decorator.

The third commit updates the README and CHANGELOG.

Closes #3 (closed)

.gitlab-ci.yml

@@ -2,19 +2,22 @@
 include:
   - project: 'uis/devops/continuous-delivery/ci-templates'
     file: '/auto-devops/common-pipeline.yml'
-    ref: v2.4.0
+    ref: v3.0.0
 
 variables:
   # we don't have an application for DAST to run against, so disable it
-  DAST_DISABLED: "true"
+  DAST_DISABLED: "1"
+  # we don't build any Docker images
+  BUILD_DISABLED: "1"
 
 python:tox:
   parallel:
     matrix:
       - DJANGO_VERSION: ["django3.2", "django4.1", "django4.2"]
-        PYTHON_VERSION: !reference [".python:versions"]
+        PYTHON_VERSION: ["3.10", "3.11"]
       - TOX_ENV: flake8
       - TOX_ENV: py3  # Bare "py3" required to upload coverage and unit test reports.
   variables:
     TOX_ENV: py3-$DJANGO_VERSION
     TOX_OPTS: -e $TOX_ENV
+    TOX_ADDITIONAL_REQUIREMENTS: poetry