Dist::Z...Release(3)

πŸ’– Dist::Z...Release(3) πŸ’–

okay bestie, you found the Dist::Z...Release(3) page, aka the user-contributed Perl documentation corner of the internet, and lemme tell you, this one is a vibe. let's get into it 🫢


✨ NAME ✨

Dist::Zilla::Plugin::FakeRelease β€” it's a fake plugin, and its whole job is to test release stuff πŸ’…


🌸 VERSION 🌸

version 6.040 β€” yes queen, we're on the current one ✨


πŸŽ€ SYNOPSIS πŸŽ€

[FakeRelease]
user = CPANAUTHORID ; # optional.

that's it. that's the whole setup. lowkey iconic πŸ’–


πŸ¦‹ DESCRIPTION πŸ¦‹

so like, this plugin is a Releaser that does absolutely nothing. and no, that's not a bug, that's the point. it's made for plugin authors, the girlies who need a dumb little release plugin to test their shiny new plugin that implements BeforeRelease and AfterRelease. it's giving ✨test harness✨, no cap.

when this plugin does the release, it just logs a message and finishes. that's the whole personality. main character energy with zero responsibilities 😌

now, plot twist: if you set the environment variable DZIL_FAKERELEASE_FAIL to a true value, the plugin will die instead of doing nothing. and before you panic β€” this is on purpose! it's super useful for authors who wanna reliably test that a release failed. testing the failure path is important, bestie, don't skip it πŸ’€

you can optionally provide the 'user' parameter, which defaults to 'AUTHORID'. this lets stuff that depends on this metadata still work β€” sometimes that metadata is provided by UploadToCPAN instead. (for example: Dist::Zilla::Plugin::Twitter 🐦). so set it if you need it, otherwise the default has you covered 🫢


πŸ’œ PERL VERSION πŸ’œ

this module should work on any version of perl that's still receiving updates from the Perl 5 Porters. what does that mean in practice? it means any perl released in the last two to three years. so if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. slay, backwards compatibility ✨

although it may work on older versions of perl, there's no guarantee that the minimum required version won't be increased. the version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl. sorry bestie, that's just how it is πŸ™ˆ


🌈 SEE ALSO 🌈

core Dist::Zilla plugins with similar energy:

  • ConfirmRelease
  • UploadToCPAN

go check 'em out, they're the real ones πŸ‘‘


πŸ‘‘ AUTHOR πŸ‘‘

Ricardo SIGNES 😏 <cpan@semiotic.systems>

(the 😏 is literally part of the name, we love an author with a sense of humor πŸ’–)


This software is copyright (c) 2026 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. fr fr, go wild, it's free πŸŽ€


and that's a wrap, bestie! this whole page came straight from the perl v5.42.3 toolchain, dated 2026-10-19, and it's the Dist::Z...Release(3) page you were looking for. go forth and fake-release responsibly πŸ¦‹βœ¨πŸ’–
πŸ“¦ where this page comes from