Skip to main content

What's new in 2.12.0? 🆕

· 3 min read
Orhun Parmaksız
Orhun Parmaksız
Author of git-cliff

git-cliff is a command-line tool that provides a highly customizable way to generate changelogs from the Git history.

What's new? ⛰️​

The full changelog can be found here.

📡 Offline Mode​

Now you can run git-cliff in offline mode using the --offline flag!

This feature disables contacting any external services, even if they are configured. This can be useful in scenarios where you want to avoid network calls or when working in a restricted environment.

$ git cliff --offline

This can be also configured as a part of the the remote configuration, for example:

[remote.gitlab]
owner = "archlinux"
repo = "arch-repro-status"
offline = true

⏩ Skip Tags via CLI​

Skipping certain tags with regex was already possible via the configuration file:

[git]
skip_tags = "beta|alpha"

Now you can also specify the same via the command-line using the --skip-tags argument:

$ git cliff --skip-tags "beta|alpha"

↩️ Revert Log Verbosity​

A couple of users reported the new verbosity level introduced in 2.11.0 was too noisy for their use cases.

With this release, we reverted that change and started exploring alternative ways to provide more detailed logs in a less-overwhelming way.

Related issues: #1352, #1354, #1327

🌀 Rename Azure DevOps variable​

⚠️ This is a breaking change for those using Azure DevOps remote integration.

In your template, rename {{ azureDevops.contributors }} to {{ azure_devops.contributors }}.

- {% for contributor in azureDevops.contributors | filter(attribute="is_first_time", value=true) %}
+ {% for contributor in azure_devops.contributors | filter(attribute="is_first_time", value=true) %}

See #1318 for the rationale behind this change.

🧰 Other​

  • (config) Respect the changelog.output configuration (#1349) - (cfcc5ae)
  • (remote) Avoid false first-time contributors when tag timestamp missing (#1348) - (de7cf02)
  • (remote) Remove reqwest::Response::error_for_status (#1336) - (081ba68)

New Contributors ❤️​

  • @taladar made their first contribution in #1319
  • @barskern made their first contribution in #1321
  • @ooooo-create made their first contribution in #1334
  • @jylenhof made their first contribution in #1320

Any contribution is highly appreciated! See the contribution guidelines for getting started.

Feel free to submit issues and join our Discord / Matrix for discussion!

Follow git-cliff on Twitter & Mastodon to not miss any news!

Support 🌟​

If you liked git-cliff and/or my other projects on GitHub, consider donating to support my open source endeavors.

Have a fantastic day! ⛰️