Introduce towncrier

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,6 +1,6 @@
 <!-- add an 'x' in the brackets below -->
 
-- [ ] I have added an entry to `docs/changelog.md`
+- [ ] I have added an entry to `changelog.d`
 
 ## Summary of changes
 

.pre-commit-config.yaml

@@ -28,3 +28,7 @@ repos:
     - "packaging>=20"
     - "platformdirs>=2.1"
     - "tomli; python_version < '3.11'"
+- repo: https://github.com/twisted/towncrier
+  rev: 23.11.0
+  hooks:
+    - id: towncrier-check

changelog.d/1081.added.md

@@ -0,0 +1 @@
+Allow skipping maintenance tasks during list command

changelog.d/1089.fixed.md

@@ -0,0 +1 @@
+Raise more user friendly error when provided `--python` version is not found

changelog.d/1142.added.md

@@ -0,0 +1 @@
+Include  into  (zipapp) so that it can be executed with Python 3.10 or earlier

changelog.d/1152.fixed.md

@@ -0,0 +1 @@
+`pipx run`: Verify whether the script name provided is a file before running it

changelog.d/1161.added.md

@@ -0,0 +1 @@
+Introduce towncrier for managing the changelog

changelog.d/1180.changed.1.md

@@ -0,0 +1 @@
+Update `pipx run` on scripts using `/// script` and no `run` table following the updated version of PEP 723

changelog.d/1180.changed.md

@@ -0,0 +1 @@
+Update  on scripts using  and no  table following the updated version of PEP 723

changelog.d/1192.fixed.md

@@ -0,0 +1 @@
+Avoid repeated exception logging in a few rare cases

noxfile.py

@@ -6,7 +6,7 @@
 
 PYTHON_ALL_VERSIONS = ["3.12", "3.11", "3.10", "3.9", "3.8"]
 PYTHON_DEFAULT_VERSION = "3.12"
-DOC_DEPENDENCIES = ["jinja2", "mkdocs", "mkdocs-material", "mkdocs-gen-files"]
+DOC_DEPENDENCIES = ["jinja2", "mkdocs", "mkdocs-material", "mkdocs-gen-files", "towncrier"]
 MAN_DEPENDENCIES = ["argparse-manpage[setuptools]"]
 TEST_DEPENDENCIES = ["pytest", "pypiserver[passlib]", 'setuptools; python_version>="3.12"', "pytest-cov"]
 # Packages whose dependencies need an intact system PATH to compile

pyproject.toml

@@ -74,6 +74,15 @@ lint.mccabe.max-complexity = 15
 [tool.pytest.ini_options]
 markers = ["all_packages: test install with maximum number of packages"]
 
+[tool.towncrier]
+directory = "changelog.d"
+filename = "CHANGELOG.md"
+start_string = "<!-- towncrier release notes start -->\n"
+underlines = ["", "", ""]
+title_format = "## [{version}](https://github.com/pypa/pipx/tree/{version}) - {project_date}"
+issue_format = "[#{issue}](https://github.com/pypa/pipx/issues/{issue})"
+package = "pipx"
+
 [[tool.mypy.overrides]]
 module = ["pipx.version", "pycowsay.*"]
 ignore_missing_imports = true