diff --git a/math/py-permutation/Makefile b/math/py-permutation/Makefile
index c35b2a9f59ac..00bddc4580e0 100644
--- a/math/py-permutation/Makefile
+++ b/math/py-permutation/Makefile
@@ -1,38 +1,28 @@
 PORTNAME=	permutation
-DISTVERSION=	0.4.0
-PORTREVISION=	1
+DISTVERSION=	0.5.0
 CATEGORIES=	math python
 MASTER_SITES=	PYPI
 PKGNAMEPREFIX=	${PYTHON_PKGNAMEPREFIX}
 
 MAINTAINER=	yuri@FreeBSD.org
 COMMENT=	Permutations of finitely many positive integers
 WWW=		https://github.com/jwodder/permutation
 
 LICENSE=	MIT
 LICENSE_FILE=	${WRKSRC}/LICENSE
 
-BUILD_DEPENDS=	${PY_SETUPTOOLS} \
-		${PYTHON_PKGNAMEPREFIX}wheel>0:devel/py-wheel@${PY_FLAVOR}
-TEST_DEPENDS=	${PYTHON_PKGNAMEPREFIX}coverage>0:devel/py-coverage@${PY_FLAVOR}
+BUILD_DEPENDS=	${PYTHON_PKGNAMEPREFIX}hatchling>0:devel/py-hatchling@${PY_FLAVOR}
 
 USES=		python
 USE_PYTHON=	pep517 autoplist pytest
 
 NO_ARCH=	yes
 
-pre-configure: # permutation is officially built with "build" (https://github.com/pypa/build), but this is easily circumvented with this simple setup.py
-	@( \
-		${ECHO} "from setuptools import setup" && \
-		${ECHO} "setup()" \
-	) > ${WRKSRC}/setup.py
-
-do-test: install # instructions from tox.ini
+do-test: install # instructions from tox.ini; coverage combine/report dropped because pytest on .rst doctest files collects no coverage data
 	@cd ${WRKSRC} && \
-		coverage erase && \
-		coverage run -m pytest --doctest-modules --pyargs permutation && \
-		coverage run -m pytest test README.rst docs/index.rst && \
-		coverage combine && \
-		coverage report
+		${PYTHON_CMD} -m pytest --doctest-modules --pyargs permutation && \
+		${PYTHON_CMD} -m pytest test README.rst docs/index.rst
+
+# tests as of 0.5.0: 1 passed (doctest modules), 3991 passed (test/README.rst/docs/index.rst)
 
 .include <bsd.port.mk>
diff --git a/math/py-permutation/distinfo b/math/py-permutation/distinfo
index 7d538957ac4c..f04a0128c0be 100644
--- a/math/py-permutation/distinfo
+++ b/math/py-permutation/distinfo
@@ -1,3 +1,3 @@
-TIMESTAMP = 1679896268
-SHA256 (permutation-0.4.0.tar.gz) = 1d33e2c90ea26c6d6dc85be14dfd78900bcce5d4c1b43363660a0b7f3bc05d32
-SIZE (permutation-0.4.0.tar.gz) = 17502
+TIMESTAMP = 1785521877
+SHA256 (permutation-0.5.0.tar.gz) = 568b94f68a466f424f7d18f3d5c6dee2ffad8052d4ad9ae5caae7c9a6ee0fbd7
+SIZE (permutation-0.5.0.tar.gz) = 16453
diff --git a/math/py-permutation/files/patch-pyproject.toml b/math/py-permutation/files/patch-pyproject.toml
new file mode 100644
index 000000000000..e6ce60c07fd7
--- /dev/null
+++ b/math/py-permutation/files/patch-pyproject.toml
@@ -0,0 +1,15 @@
+-- Convert the deprecated string form of project.license to the PEP 621
+-- table form and remove project.license-files, which the setuptools version
+-- in the ports tree does not accept.
+--- pyproject.toml.orig	2026-07-31 21:30:25.202514000 -0700
++++ pyproject.toml
+@@ -8,8 +8,7 @@
+ description = "Permutations of finitely many positive integers"
+ readme = "README.rst"
+ requires-python = ">=3.8"
+-license = "MIT"
+-license-files = { paths = ["LICENSE"] }
++license = {text = "MIT"}
+ authors = [
+     { name = "John Thorvald Wodder II", email = "permutation@varonathe.org" }
+ ]