Use a pyproject.toml for the package and add pre-commit hook to check…

… the pyproject.toml

.github/workflows/publish.yml

@@ -25,12 +25,12 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install setuptools wheel twine
+        pip install build twine
 
     - name: Build and publish
       env:
         TWINE_USERNAME: __token__
         TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
       run: |
-        python setup.py sdist bdist_wheel
+        python -m build
         twine upload dist/*

.github/workflows/release.yml

@@ -28,7 +28,9 @@ jobs:
 
       - name: Get package version
         id: package_version
-        run: echo "python=$(python setup.py --version)" >> $GITHUB_OUTPUT
+        run: |
+          python -m pip install -e .
+          echo "python=$(python -c 'import importlib.metadata; print(importlib.metadata.version("ccs-govuk-frontend-jinja"))')" >> $GITHUB_OUTPUT
 
       - name: Check if version tag already exists
         id: version_tag

.pre-commit-config.yaml

@@ -1,18 +1,20 @@
-# See https://pre-commit.com for more information
-# See https://pre-commit.com/hooks.html for more hooks
+---
 repos:
--   repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: d6d3bd94604578adbd918c5a00d531d98350d86f # v2.3.0
-    hooks:
-    -   id: detect-private-key
--   repo: https://github.com/Yelp/detect-secrets
-    rev: a3e7998bfa4924b13df3f9cb49070abdbdff8802 # v0.13.1
-    hooks:
-    -   id: detect-secrets
-        args: ['--baseline', '.secrets.baseline']
-        exclude: .*/keys/.*|
-              (?x)(
-                     ^package-lock.json$/|
-                     ^Pipfile/|
-                     ^pyproject.toml
-              )
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v5.0.0
+  hooks:
+    - id: trailing-whitespace
+    - id: end-of-file-fixer
+    - id: check-yaml
+    - id: check-added-large-files
+    - id: detect-private-key
+
+- repo: https://github.com/abravalheri/validate-pyproject
+  rev: v0.22
+  hooks:
+    - id: validate-pyproject
+
+- repo: https://github.com/PyCQA/flake8
+  rev: 7.0.0
+  hooks:
+    - id: flake8

CHANGELOG.md

@@ -4,7 +4,11 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased](https://github.com/tim-s-ccs/ccs-govuk-frontend-jinja/compare/1.2.2...main)
+## [Unreleased](https://github.com/tim-s-ccs/ccs-govuk-frontend-jinja/compare/1.3.0...main)
+
+### Changed
+
+- Replace `setup.py` with `pyproject.toml`
 
 ## [1.3.0](https://github.com/tim-s-ccs/ccs-govuk-frontend-jinja/releases/tag/1.3.0) - 14/10/2024
 

MANIFEST.in

@@ -0,0 +1 @@
+prune tests

README.md

@@ -99,6 +99,11 @@ To make a new version:
 
 When the pull request is merged a GitHub Action will tag the new version.
 
+## Pre-commit hooks
+
+This project has a [pre-commit hook][pre-commit hook] to do some general file checks and check the `pyproject.toml`.
+Follow the [Quick start][pre-commit quick start] to see how to set this up in your local checkout of this project.
+
 ## Licence
 
 Unless stated otherwise, the codebase is released under [the MIT License][mit].
@@ -110,3 +115,6 @@ of the [Open Government 3.0][ogl] licence.
 [mit]: LICENCE
 [copyright]: http://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/
 [ogl]: http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/
+
+[pre-commit hook]: https://pre-commit.com/
+[pre-commit quick start]: https://pre-commit.com/#quick-start

pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ccs-govuk-frontend-jinja"
+dynamic = ["version"]
+dependencies = [
+  'jinja2>=3.0.2',
+]
+requires-python = ">=3.10,<3.13"
+authors = [
+  {name = "HM Land Registry Developers"},
+  {name = "CCS Developers"},
+]
+description = "GOV.UK Frontend Jinja Macros"
+readme = "README.md"
+license = {file = "LICENSE"}
+
+[project.urls]
+Homepage = "https://github.com/tim-s-ccs/ccs-govuk-frontend-jinja"
+Repository = "https://github.com/tim-s-ccs/ccs-govuk-frontend-jinja.git"
+Issues = "https://github.com/tim-s-ccs/ccs-govuk-frontend-jinja/issues"
+Changelog = "https://github.com/tim-s-ccs/ccs-govuk-frontend-jinja/CHANGELOG.md"
+
+[tool.setuptools.dynamic]
+version = {attr = "govuk_frontend_jinja.__version__"}
+
+[tool.setuptools.packages.find]
+exclude = ["node_modules*"]
+
+[tool.setuptools.package-data]
+govuk_frontend_jinja = ["**/*.html"]

tasks.py

@@ -6,7 +6,7 @@
 
 @task(ns["virtualenv"], ns["requirements_dev"])
 def test_mypy(c):
-    c.run("mypy app/")
+    c.run("mypy tests/utils/")
 
 
 ns.add_task(npm_install)

tests/conftest.py

@@ -1,6 +1,6 @@
 import pytest
 
-from app import create_app
+from utils.app import create_app
 
 
 @pytest.fixture

app/__init__.py → tests/utils/app.py

@@ -16,7 +16,7 @@ def create_app():
                     "govuk_frontend_jinja": FileSystemLoader(
                         searchpath=os.path.join(
                             os.path.dirname(__file__),
-                            "../govuk_frontend_jinja/templates"
+                            "../../govuk_frontend_jinja/templates"
                         )
                     )
                 }