File::CheckTree(3pm)

🌸 NAME 🌸

File::CheckTree — run so many filetest checks on a whole tree, bestie 💖

---

✨ SYNOPSIS ✨

use File::CheckTree;

$num_warnings = validate( q{
    /vmunix                 -e || die
    /boot                   -e || die
    /bin                    cd
        csh                 -ex
        csh                 !-ug
        sh                  -ex
        sh                  !-ug
    /usr                    -d || warn "What happened to $file?\n"
});

---

🦋 DESCRIPTION 🦋

okay so the validate() routine takes one single multiline string made up of directives, and each directive is a filename plus a file test to throw at it. that's it. that's the whole vibe. 🎀

(plot twist tho: the file test can also be a cd, which makes all the relative filenames after it get interpreted relative to that directory. it's giving "we're moving in, pack up the paths" 💅)

after the file test, you can drop a || die in there to make it a fatal error if that file test flops. and if you don't say anything? the default is || warn. no cap. 😌

you can also prepend a ! to the file test to test for the opposite condition — like, "hey, this better NOT be true." iconically petty, we love her.

if you do a cd and then list some relative filenames, you lowkey might wanna indent them a little for readability. purely aesthetic, but slay. ✨

and if you supply your own die() or warn() message? you can use $file to interpolate the filename right into it. chef's kiss. 🤌

🧚 Filetests may be bunched

Like, literally group them: -rwx tests for all of -r, -w, and -x in one go. efficient queen. 👑

⚠️ heads up tho: only the first failed test of the bunch will actually produce a warning. the rest just sit there quietly. 💀

The routine returns the number of warnings issued. that's your receipt, bestie. 🧾

---

👑 AUTHOR 👑

File::CheckTree was derived from lib/validate.pl, which was written by Larry Wall. Then it got revised by Paul Grassie <grassie@perl.com> in 2002. legends only. 🫶

---

📜 HISTORY 📜

okay storytime, gather round 🍓

• File::CheckTree used to not display fatal error messages. like, at all. not me finding out your fatal error was silent the whole time 😭
• it also used to count only those warnings produced by a generic || warn — and not the ones where the user supplied the message. rude honestly.
• and on top of all that? the validate() routine would leave your user program sitting in whatever directory was last entered through the use of cd directives. bro it just left you there. no navigation home. 🙈

These bugs were fixed during the development of perl 5.8. The first fixed version of File::CheckTree was 4.2. periodt. 💅

---

that's the whole page, bestie — this came to you from perl v5.36.0, dated 2022-10-13, and honestly? she ate. stay validated out there, mwah 💖🌈✨