Dist::...rmatter(3pm)

📦
version 2.052 · 7 versions
, in ubuntu resolute, ubuntu stonking

✨ NAME ✨

Dist::Zilla::Role::Git::StringFormatter — bestie, it literally just hands you a String::Formatter for your commit messages 💅 (this page is from the Dist::...rmatter(3pm) manual, but like, we don't gotta read that part out loud)

🌸 VERSION 🌸

version 2.052 — that's the one, no cap 💖

🦋 DESCRIPTION 🦋

okay so. this role lives inside the Git plugins and its whole job is formatting strings that might have the changes from the current release dropped into them. it's giving "template engine but make it commit message" ✨

these formatting codes are available, and yes you're gonna want all of them:

  • %c — the list of changes in the just-released version (read from "changelog"). it includes the lines between the current version and timestamp and the next non-indented line, except that blank lines at the beginning or end get removed. and it always ends in a newline unless it is the empty string. periodt.
  • "%{dd-MMM-yyyy}d" — the current date. you can use any CLDR format supported by DateTime, so go feral 🗓️. a bare %d means "%{dd-MMM-yyyy}d".
  • %n — a newline. just a lil guy. a break. a breather.
  • %N — the distribution name 👑
  • "%{-TRIAL}t" — expands to -TRIAL (or any other supplied string) if this is a trial release, or the empty string if not. a bare %t means "%{-TRIAL}t".
  • %v — the distribution version
  • %V — The distribution version, but with a leading "v" removed if it exists. so shy, so demure, no v 🎀

💖 ATTRIBUTES 💖

🍓 changelog

The filename of your Changes file. (Must be provided by the class that consumes this role.) so like, it's not optional, bestie — the consumer class has to bring it or nothing works 😭

🧚 time_zone

The time zone used with the %d code. the default is "local", which is honestly so valid of it.

🌈 SUPPORT 🌈

got a bug? same. Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-Git> (or <bug-Dist-Zilla-Plugin-Git@rt.cpan.org>). 🫶

There is also a mailing list available for users of this distribution, at <http://dzil.org/#mailing-list>. ✨

There is also an irc channel available for users of this distribution, at "#distzilla" on "irc.perl.org" <irc://irc.perl.org/#distzilla>. come hang, it's a vibe 💜

👑 AUTHOR 👑

Jerome Quelin — icon behavior, fr fr 💅

This software is copyright (c) 2009 by Jerome Quelin.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay, legally speaking ⚖️✨

okay that's the whole thing, we ate and left no crumbs 🍽️💖 this was perl v5.40.1, dated 2025-09-29 — mwah, go format something gorgeous 🌟

📦 where this page comes from