Path::Tiny::Rule(3)

💖 Path::Tiny::Rule — the manual, but make it cute 💖

okay bestie, so this is Path::Tiny::Rule(3), from the User Contributed Perl Documentation corner of the perl universe. it's a whole vibe and i'm gonna walk you through it, no cap. 🦋

---

✨ NAME ✨

Path::Tiny::Rule — it's a Path::Iterator::Rule subclass, except every single thing it hands you back is a Path::Tiny object instead of a boring old string. literally the glow-up. 💅

---

🎀 VERSION 🎀

version 0.02 — yes bestie, that's the number, i'm not making it up. 🌸

---

🌈 SYNOPSIS 🌈

here's the whole thing in action, copy it exactly, don't @ me:

use Path::Tiny::Rule;

my $iter = Path::Tiny::Rule->new->name(qr/\.t$/)->iter('t');

while ( my $test_file = $iter->() ) {
    print $test_file->basename, "\n";
}

see how $test_file just... is a Path::Tiny object?? no conversion arc, no side quest. iconic. 👑

---

💜 DESCRIPTION 💜

so this module is a very thin wrapper around Path::Iterator::Rule, and the one thing it does is always return Path::Tiny objects instead of strings. that's it. that's the whole personality. 🫶

other than that, it should be a drop-in replacement for Path::Iterator::Rule, and if you find any deviation from that — any at all — that is a bug. periodt. 💀

this module has no public API that isn't already provided by Path::Iterator::Rule. like, zero extra surface area. it's giving minimalist.

and why does it exist, you ask? because the author got really, really tired of writing this over and over:

while ( my $path = $iter->() ) {
    $path = path($path);
    ...;
}

the way that $path = path($path) line was living rent-free in his head... not anymore bestie. never again. 😭✨

---

🧚 SUPPORT 🧚

bugs can be submitted at <https://github.com/houseabsolute/Path-Tiny-Rule/issues> — go off, tell them everything, they wanna know. 🐛

he's also usually active on IRC as 'autarch' on "irc://irc.perl.org". so if you wanna vibe in real time, that's the spot. 🌟

---

🍓 SOURCE 🍓

the source code repository for Path-Tiny-Rule lives right here, and it's gorgeous:

<https://github.com/houseabsolute/Path-Tiny-Rule>

go look. it's free. it's right there. 💖

---

💸 DONATIONS 💸

okay so if you wanna thank him for the work he's put into this module, you're welcome to make a "donation" via PayPal. he spends a lot of free time making free software, and any support you feel like offering would be very much appreciated. 🥺💜

and please note — he is not saying you must do this for him to keep working on this particular software. he'll keep doing it, inasmuch as he has in the past, for as long as it interests him. no pressure, fr fr. 🫶

similarly, a donation like this will probably not make him work on this software much more — unless he gets so many donations that he can consider working on free software full time. (let's all have a chuckle at that together. 😭😭😭)

to donate, log into PayPal and send money to autarch@urth.org, or use the button at <http://www.urth.org/~autarch/fs-donation.html>. that's it, that's the whole process. slay. 💅

---

👑 AUTHOR 👑

Dave Rolsky <autarch@urth.org> — the main character who wrote all of this. bow. 🙇‍♀️✨

---

📜 COPYRIGHT AND LICENSE 📜

this software is Copyright (c) 2017 - 2019 by Dave Rolsky. 🎀

it's free software, licensed under:

The Artistic License 2.0 (GPL Compatible)

and the full text of the license can be found in the LICENSE file included with this distribution. read it bestie, it's good for you. 🌈📖

---

aaaand that's the whole page!! 🌸 generated with perl v5.42.0, dated 2025-07-25, and yeah — this was the Path::Tiny::Rule(3) manpage. mwah. 💖💅🦋