chore(deps): update dependency towncrier to v24

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
towncrier	~= 22.12.0 -> ~=24.8.0

---

Release Notes

twisted/towncrier (towncrier)

v24.8.0: Towncrier 24.8.0

Compare Source

Towncrier 24.8.0 (2024-08-23)

Features

• Add .gitkeep as an ignored filename.
  (#​643)
• Config ignore option now supports
  wildcard matching via
  fnmatch.
  (#​644)
• Add a config for enforcing issue names using regex.
  (#​649)

Bugfixes

• The template file is now ignored based only on the file name.
  (#​638)
• Control of the header formatting is once again completely up to the
  user when they are writing markdown files (fixes a regression
  introduced in
  [#​610](#​610)).
  (#​651)
• Fixed an issue where issue_template
  failed recognizing the issue name of files with a non-category
  suffix (.md)
  (#​654)
• Fixed a bug where orphan news fragments (e.g. +abc1234.feature)
  would fail when an issue_pattern is
  configured. Orphan news fragments are now excempt from issue_pattern checks.
  (#​655)

Deprecations and Removals

• Moved towncrier version definition from src/towncrier/_version.py
  to pyproject.toml

  towncrier.__version__ was removed, after being deprecated in
  23.6.0. (#​640)

Misc

• #​640,
  #​657

v24.7.1: Towncrier 24.7.1

Compare Source

Towncrier 24.7.1 (2024-07-31)

Bugfixes

• When the template file is stored in the same directory with the news
  fragments, it is automatically ignored when checking for valid
  fragment file names.
  (#​632)

Misc

• #​629,
  #​630

v24.7.0: Towncrier 24.7.0

Compare Source

Towncrier 24.7.0 (2024-07-31)

Features

• towncrier build now handles removing news fragments which are not part of the git repository. For example, uncommitted or unstaged files. (#​357)

• Inferring the version of a Python package now tries to use the metadata of the installed package before importing the package explicitly (which only looks for [package].__version__). (#​432)

• If no filename is given when doing towncrier create, interactively ask for the issue number and fragment type (and then launch an interactive editor for the fragment content).

  Now by default, when creating a fragment it will be appended with the filename option's extension (unless an extension is explicitly provided). For example, towncrier create 123.feature will create news/123.feature.rst. This can be changed in configuration file by setting add_extension = false.

  A new line is now added by default to the end of the fragment contents. This can be reverted in the configuration file by setting add_newline = false. (#​482)

• The temporary file towncrier create creates now uses the correct .rst or .md extension, which may help your editor with with syntax highlighting. (#​594)

• Running towncrier will now traverse back up directories looking for the configuration file. (#​601)

• The towncrier create action now uses sections defined in your config (either interactively, or via the new --section option). (#​603)

• News fragments are now sorted by issue number even if they have non-digit characters.

  For example:

  - some issue (gh-3, gh-10)
  - another issue (gh-4)
  - yet another issue (gh-11)
  

  The sorting algorithm groups the issues first by non-text characters and then by number. (#​608)

• The title_format configuration option now uses a markdown format for markdown templates. (#​610)

• newsfragment categories can now be marked with check = false, causing them to be ignored in towncrier check (#​617)

• towncrier check will now fail if any news fragments have invalid filenames.

  Added a new configuration option called ignore that allows you to specify a list of filenames that should be ignored. If this is set, towncrier build will also fail if any filenames are invalid, except for those in the list. (#​622)

Bugfixes

• Add explicit encoding to read_text. (#​561)
• The default Markdown template now renders a title containing the release version and date, even when the name configuration is left empty. (#​587)
• Orphan news fragments, fragments not associated with an issue, consisting of only digits (e.g. '+12345678.feature') now retain their leading marker character. (#​588)
• Orphan news fragments, fragments not associated with an issue, will now still show in categories that are marked to not show content, since they do not have an issue number to show. (#​612)

Improved Documentation

• Clarify version discovery behavior. (#​432, #​602)
• The tutorial now introduces the filename option in the appropriate paragraph and mentions its default value. (#​586)
• Add docs to explain how towncrier create +.feature.rst (orphan fragments) works. (#​589)

Misc

• #​491, #​561, #​562, #​568, #​569, #​571, #​574, #​575, #​582, #​591, #​596, #​597, #​625

v23.11.0: Towncrier 23.11.0

Compare Source

towncrier 23.11.0 (2023-11-08)

Bugfixes

• build now treats a missing fragments directory the same as an
  empty one, consistent with other operations.
  (#​538)
• Fragments with filenames like fix-1.2.3.feature are now associated
  with the ticket fix-1.2.3. In
  previous versions they were incorrectly associated to ticket 3.
  (#​562)
• Orphan newsfragments containing numeric values are no longer
  accidentally associated to tickets. In previous versions the orphan
  marker was ignored and the newsfragment was associated to a ticket
  having the last numerical value from the filename.
  (#​562)

Misc

• #​558,
  #​559

v23.10.0: Towncrier 23.10.0

Compare Source

towncrier 23.10.0 (2023-10-23)

No significant changes since the previous release candidate.

Features

• Python 3.12 is now officially supported. (#​541)

• Initial support was added for monorepo-style setup. One project with multiple independent news files stored in separate sub-directories, that share the same towncrier config. (#​548)

• Two newlines are no longer always added between the current release notes and the previous content. The newlines are now defined only inside the template.

  Important! If you're using a custom template and want to keep the same whitespace between releases, you may have to modify your template. (#​552)

Bugfixes

• Towncrier now vendors the click-default-group package that prevented installations on modern Pips. (#​540)

Improved Documentation

• The markdown docs now use the default markdown template rather than a simpler custom one. (#​545)
• Cleanup a duplicate backtick in the tutorial. (#​551)

Deprecations and Removals

• The support for Python 3.7 has been dropped. (#​521)

Misc

• #​481, #​520, #​522, #​523, #​529, #​536

v23.6.0: Towncrier 23.6.0

Compare Source

towncrier 23.6.0 (2023-06-06)

This is the last release to support Python 3.7.

Features

• Make towncrier create use the fragment counter rather than failing on existing fragment names.

  For example, if there is an existing fragment named 123.feature, then towncrier create 123.feature will now create a fragment named 123.feature.1. (#​475)

• Provide a default Markdown template if the configured filename ends with .md.

  The Markdown template uses the same rendered format as the default reStructuredText template, but with a Markdown syntax. (#​483)

• Towncrier no longer depends on setuptools & uses importlib.resources (or its backport) instead. (#​496)

• Added pre-commit hooks for checking and updating news in projects using pre-commit. (#​498)

• Calling towncrier check without an existing configuration, will just show only an error message.

  In previous versions, a traceback was generated instead of the error message. (#​501)

Bugfixes

• Fix creating fragment in a section not adding random characters.

  For example, towncrier create some_section/+.feature should end up as a fragment named something like news/some_section/+a4e22da1.feature. (#​468)

• Fix the ReadTheDocs build for towncrier which was broken due to the python version in use being 3.8. Upgrade to 3.11. (#​509)

Improved Documentation

• Moved man page to correct section (#​470)
• Update link to Quick Start in configuration.html to point to Tutorial instead. (#​504)
• Add a note about the build command's --version requiring the command to be explicitly passed. (#​511)
• Fix typos in the Pre-Commit docs. (#​512)

Misc

• #​459, #​462, #​472, #​485, #​486, #​487, #​488, #​495, #​497, #​507, #​1117, #​513

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 87.35%. Comparing base (301f6d8) to head (ade83a9).
Report is 8 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #70   +/-   ##
=======================================
  Coverage   87.35%   87.35%           
=======================================
  Files           3        3           
  Lines         174      174           
  Branches      174      174           
=======================================
  Hits          152      152           
  Misses         12       12           
  Partials       10       10           

Flag	Coverage Δ
cargo-test	69.54% <ø> (ø)
pytest	81.88% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.