Towncrier 24.7.0

[adiroiban]

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

---

This discussion was created from the release Towncrier 24.7.0.