The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.


Dist::Zilla::Plugin::CheckChangesHasContent - Ensure Changes has content before releasing


version 0.011


  # in dist.ini



This is a "before release" Dist::Zilla plugin that ensures that your Changes file actually has some content since the last release. If it doesn't find any, it will abort the release process.

This can be contrasted to Dist::Zilla::Plugin::Test::ChangesHasContent, which generates a test to perform the check.

The algorithm is very naive. It looks for an unindented line starting with the version to be released. It then looks for any text from that line until the next unindented line (or the end of the file), ignoring whitespace.

For example, in the file below, algorithm will find "- blah blah blah":

  Changes file for Foo-Bar


    - blah blah blah

  0.001  Wed May 12 13:49:13 EDT 2010

    - the first release

If you had nothing but whitespace between {{$NEXT}} and 0.001, the release would be halted.

If you name your change log something other than "Changes", you can configure the name with the changelog argument:

  changelog = ChangeLog


* Dist::Zilla::Plugin::Test::ChangesHasContent * Dist::Zilla


Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

  git clone


  • David Golden <>

  • Karen Etheridge <>


  • David Golden <>

  • Randy Stauner <>


This software is Copyright (c) 2017 by David Golden.

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004