Getopt...thList(3pm)

💖 Getopt::Yath::Option::PathList 💖

okay bestie so this is a page from the Getopt::Yath family — it lives in the 3pm section of the perl manual (yes, that's the perl modules corner, iykyk). Pull up a chair, we're talking about an option type that eats paths.

---

✨ NAME ✨

Getopt::Yath::Option::PathList — it's the option vibe that takes one or more paths, and wild cards? allowed. periodt.

🦋 DESCRIPTION 🦋

So like. This option lets you specify multiple files and/or paths, wildcards included, and those wildcards get expanded. That's it, that's the whole assignment. It ate and left no crumbs. 💅

🌸 SYNOPSIS 🌸

here's the look, literally:

option changed => (
    type          => 'PathList',
    split_on      => ',',
    description   => "Specify one or more files as having been changed.",
    long_examples => [' path/to/file'],
);

see how split_on is ','? yeah you split your list on commas, iconic behaviour honestly.

🎀 METHODS 🎀

not me showing up with methods — every single method from Getopt::Yath::Option::List is inherited, no cap. But these ones are overridden or at least worth a lil shout-out:

• normalize_value(@input) — okay so if your values contain wildcard characters, specifically "*", those get expanded using Perl's glob() function. Everything else — all the other processing, bestie — gets delegated straight to the parent class. She's a team player. 🫶

🧚 SOURCE 🧚

the source code repository for Getopt-Yath is right here, go be nosy:

<http://github.com/Test-More/Getopt-Yath/>

👑 MAINTAINERS 👑

Chad Granum <exodist@cpan.org>

⭐ AUTHORS ⭐

Chad Granum <exodist@cpan.org>

💜 COPYRIGHT 💜

Copyright Chad Granum <exodist7@gmail.com>.

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

See <http://dev.perl.org/licenses/>

---

and that's the whole page, angel. 💖 this one's from perl v5.40.1, dated <hotpink>2026-05-10</hotpink> — mwah, go read some paths, ily 🎀✨