Add towncrier config

Author: Secrus

.github/workflows/news.yaml

@@ -0,0 +1,22 @@
+name: Check news file
+
+on:
+  pull_request:
+    types: [labeled, unlabeled, opened, reopened, synchronize]
+
+jobs:
+  check-news-entry:
+    name: news entry
+    runs-on: ubuntu-20.04
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          # `towncrier check` runs `git diff --name-only origin/main...`, which
+          # needs a non-shallow clone.
+          fetch-depth: 0
+
+      - name: Check news entry
+        if: "!contains(github.event.pull_request.labels.*.name, 'skip news')"
+        run: |
+          pipx run towncrier check --compare-with origin/${{ github.base_ref }}

CHANGELOG.md

@@ -1,5 +1,7 @@
 # Changelog
 
+<!-- news notes entrypoint -->
+
 ## [2.0.1] - 2022-11-23
 
 - Relax `poetry-core` requirement for PEP 517 builds ([#291](https://github.com/python-poetry/cleo/pull/291)).

news/.gitignore

@@ -0,0 +1 @@
+!.gitignore

news/news_template.jinja2

@@ -0,0 +1,28 @@
+{% if top_line %}
+{{ top_line }}
+{{ top_underline * ((top_line)|length)}}
+{% endif %}
+{% for section in sections %}
+{% if sections[section] %}
+{% for category, val in definitions.items() if category in sections[section] and category != 'trivial' %}
+
+### {{ definitions[category]['name'] }}
+
+{% if definitions[category]['showcontent'] %}
+{% for text, values in sections[section][category]|dictsort(by='value') %}
+- {{ text }} {% if category != 'process' %}{{ values|sort|join(',\n  ') }}{% endif %}
+{% endfor %}
+{% else %}
+- {{ sections[section][category]['']|sort|join(', ') }}
+{% endif %}
+{% if sections[section][category]|length == 0 %}
+
+No significant changes.
+{% else %}
+{% endif %}
+{% endfor %}
+{% else %}
+
+No significant changes.
+{% endif %}
+{% endfor %}

poetry.lock

@@ -1,3 +1,7 @@
+[build-system]
+requires = ["poetry-core>=1.1.0"]
+build-backend = "poetry.core.masonry.api"
+
 [tool.poetry]
 name = "cleo"
 version = "2.1.0.dev0"
@@ -41,6 +45,7 @@ pytest-mock = "^3.8.2"
 pre-commit = "^2.20.0"
 pytest-cov = "^3.0.0"
 mypy = "^0.990"
+towncrier = ">=22.12.0"
 
 [tool.poetry.group.doc.dependencies]
 Sphinx = "^5.2.3"
@@ -100,6 +105,40 @@ exclude_lines = [
     "raise NotImplementedError"
 ]
 
-[build-system]
-requires = ["poetry-core>=1.1.0"]
-build-backend = "poetry.core.masonry.api"
+[tool.towncrier]
+package = "cleo"
+filename = "CHANGELOG.md"
+issue_format = "([#{issue}](https://github.com/python-poetry/cleo/pull/{issue}))"
+directory = "news/"
+title_format = "{version} ({project_date})"
+template = "news/news_template.jinja2"
+underlines = "-~^"
+start_string = "<!-- news notes entrypoint -->\n"
+
+[tool.towncrier.fragment.break]
+name = "Breaking Changes"
+showcontent = true
+
+[tool.towncrier.fragment.feat]
+name = "Features & Improvements"
+showcontent = true
+
+[tool.towncrier.fragment.bugfix]
+name = "Bug Fixes"
+showcontent = true
+
+[tool.towncrier.fragment.docs]
+name = "Documentation"
+showcontent = true
+
+[tool.towncrier.fragment.deps]
+name = "Dependencies"
+showcontent = true
+
+[tool.towncrier.fragment.removal]
+name = "Removals and Deprecations"
+showcontent = true
+
+[tool.towncrier.fragment.misc]
+name = "Miscellaneous"
+showcontent = true