PPIx::Utils(3)

💖 PPIx::Utils 💖

okay bestie, so this is the manual page for PPIx::Utils(3) — a whole lil collection of utility functions for working with PPI, and honestly? it's giving "the friend who organizes everything for you" energy. 🫶

---

✨ NAME ✨

PPIx::Utils — literally just utility functions for PPI. that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

use PPIx::Utils qw(:classification :language :traversal);

yes queen, import tags go crazy. 🎀

---

🦋 DESCRIPTION 🦋

so PPIx::Utils is a whole collection of utility functions for working with PPI documents. the functions are organized into submodules (we love structure 💖), and you can import them from whichever submodule you actually need, or just grab them via this module here.

now here's the lore 👑: these functions were originally from Perl::Critic::Utils and its related modules, and then they got split off into this distribution so people could use them outside of Perl::Critic. glow-up era, honestly. ✨

---

👑 MODULES 👑

the import tag :all will import the functions from all modules listed below. yes, all of them. no cap.

🧚 PPIx::Utils::Classification

functions related to classification of PPI elements. all functions from this module can be imported with the import tag :classification. 🍓

💜 PPIx::Utils::Language

functions related to the Perl language. all functions from this module can be imported with the import tag :language. 🌈

⭐ PPIx::Utils::Traversal

functions related to traversal of PPI documents. all functions from this module can be imported with the import tag :traversal. 💫

---

💀 BUGS 💀

report any issues on the public bugtracker. not me being the one to tell you, but like… the bugtracker knows all, bestie. 😭

---

🎀 AUTHOR 🎀

Dan Book <dbook@cpan.org> — main character, fr fr. 💅

code originally from Perl::Critic::Utils by Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>, Perl::Critic::Utils::PPI + Perl::Critic::Utils::Perl + PPIx::Utilities::Node by Elliot Shank <perl@galumph.com>, and PPIx::Utilities::Statement by Thomas R. Wyant, III <wyant@cpan.org>. the whole squad ate. 👑

---

🌈 COPYRIGHT AND LICENSE 🌈

this software is copyright (c) 2005-2011 Imaginative Software Systems, 2007-2011 Elliot Shank, 2009-2010 Thomas R. Wyant, III, 2017 Dan Book.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. free software!! we love to see it!! 🫶

---

🌸 SEE ALSO 🌸

• PPI
• Perl::Critic::Utils
• PPIx::Utilities

go read them, iykyk. 💖

---

and that's the whole page!! mwah 💋 this lil beauty comes to you from perl v5.42.0, dated 2025-08-05 — so like, take care of her, she's iconic. 🌟