File::...irtual(3pm)

💖 File::Find::Rule::Filesys::Virtual 💖

okay bestie, so this is a page from the Perl manual (section 3pm, the module pages, iykyk) and it's literally called File::...irtual(3pm) which is giving "the man page system ran out of room and started abbreviating" energy. iconic honestly.

---

✨ NAME ✨

File::Find::Rule::Filesys::Virtual — File::Find::Rule, but adapted to Filesys::Virtual. that's it, that's the whole pitch 🫶

---

🌸 SYNOPSIS 🌸

here's the vibe, copy-paste ready, no notes:

use File::Find::Rule::Filesys::Virtual;
use Filesys::Virtual::Ninja;
my $vfs = Filesys::Virtual::Ninja->new;
my @virtual_ninja_foos = File::Find::Rule::Filesys::Virtual
  ->virtual( $vfs )
  ->name( "foo.*' )
  ->in( '/' );

yes the quote situation in ->name( "foo.*' ) is a whole mess (starts with ", ends with ', no cap) but that is exactly what the original says so we are leaving it alone, periodt. 🎀

---

💅 DESCRIPTION 💅

so the way this works: this module lets you use File::Find::Rule file-finding semantics on filesystems that derive from Filesys::Virtual. same energy as File::Find::Rule, but make it virtual. slay. ✨

---

🦋 CAVEATS 🦋

ngl, there's a warning here and you need to hear it:

• the File::Find emulation will probably not be full enough for other File::Find::Rule extensions to do their thang. 😭

so if some other extension is trying to ride on top of this, temper your expectations bestie. it's giving "good enough for the basics, not a full File::Find cosplay".

---

👑 AUTHOR 👑

Richard Clamp <richardc@unixbeard.net> — king behaviour, we love to see it. 💜

---

🌈 COPYRIGHT 🌈

Copyright 2004, 2006 Richard Clamp. All Rights Reserved.

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

---

🎀 SEE ALSO 🎀

go touch grass in these other docs, they're all part of the same friend group:

• File::Find::Rule
• Filesys::Virtual
• Net::DAV::Server

---

and that's the whole page fr fr. this one came off perl v5.36.0, dated 2022-12-08, courtesy of User Contributed Perl Documentation — mwah, thanks for reading, ily, go find some virtual files. 💖✨🦋