PPI::PowerToys(3)

📦
version 0.14 · 2 versions
, in fedora 43

💖 PPI::PowerToys 💖

okay bestie so this is a page from the Perl manual — specifically the one for the module PPI::PowerToys, living its best life in section 3 of the User Contributed Perl Documentation. grab a snack, we're doing this 🍓

✨ NAME ✨

PPI::PowerToys — a handy little collection of small utilities built on top of PPI 🧰✨

🦋 DESCRIPTION 🦋

The PPI PowerToys are, and I quote the vibe here, a small collection of utilities for working with Perl files, modules and distributions. like, all the fiddly little stuff you'd rather not do by hand, bestie.

And to kick the whole collection off, the author has added a very simple and raw version of one of his own little tools. no cap. it's giving humble beginnings 💅

🌸 ppi_version 🌸

> ppi_version show
> ppi_version change 0.01 0.02

ppi_version is your girl for working with version numbers across groups of modules. not one file. groups. iconic behavior honestly 👑

the show command

ppi_version show will scan through your distribution — starting in the current directory and working down from there — and locate all the versions for the various Perl files in the distribution. a full sweep. a version census. we love to see it 🕵️♀️✨

It scans through all files inside the current directory that contain one-only instance of the line:

$VERSION = '0.01';
bestie, read that again: one-only instance. exactly one. not two, not zero. that's the vibe check this thing runs on 🌈

the change command

ppi_version change scans through your distribution — again, starting in the current directory and working down — and locates all the cases where the $VERSION is the first param, then replaces it (safely 🫶) with the second params.

so in ppi_version change 0.01 0.02, 0.01 is the first param (the one getting swapped out) and 0.02 is the second param (the glow-up it's getting replaced with). safe replacement. no messy find-and-replace regrets. periodt 💅

🌈 TO DO 🌈

the roadmap, bestie, in its full glory:

  • Add extra commands to ppi_version 💖
  • Include more useful utilities ✨
  • Any improvements to the current utilities are also very welcome 🫶

🎀 SUPPORT 🎀

Found bugs? Got patches? The official move is to report them via the CPAN bug tracker at:

<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=PPI-PowerToys>

For other issues, contact the author directly. he's listening 👂💜

👑 AUTHOR 👑

Adam Kennedy <adamk@cpan.org> — the mastermind, the main character, the one who made the PowerToys 🫡✨

Copyright 2006 - 2009 Adam Kennedy.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, honestly 🌈

The full text of the license can be found in the LICENSE file included with this module. go read it, it's right there, it's not gonna read itself 📜💖

and that's the whole page, bestie!! 🎉 this one's from perl v5.42.0, dated 2025-07-25 — so yeah, the manual's been around a minute and it still ate. no cap. bye luv u 💅✨🦋

📦 where this page comes from