FINDRULE(1)

✨ FINDRULE(1) — findrule ✨

okay so bestie, welcome to the User Contributed Perl Documentation page for findrule, the command-line wrapper to File::Find::Rule. It’s giving “tiny CLI, big module family” energy, fr fr. 💖

🎀 NAME 🎀

findrule — command line wrapper to File::Find::Rule

🌸 USAGE 🌸

findrule [path...] [expression]

🦋 DESCRIPTION 🦋

findrule mostly borrows the interface from GNU find(1) to provide a command-line interface onto the File::Find::Rule heirarchy of modules. No cap, that’s the whole vibe. 🫶

The syntax for expressions is the rule name, preceded by a dash, followed by an optional argument. If the argument is an opening parenthesis it is taken as a list of arguments, terminated by a closing parenthesis. Literally that simple, bestie. ✨

Some examples, because examples are iconic:

find -file -name ( foo bar )

files named foo or bar, below the current directory.

find -file -name foo -bar

files named foo, that have pubs (for this is what our ficticious bar clause specifies), below the current directory. keeping the typo, it’s part of the lore 💅

find -file -name ( -bar )

files named -bar, below the current directory. In this case if we’d have omitted the parenthesis it would have parsed as a call to name with no arguments, followed by a call to -bar.

💅 Supported switches 💅

Real talk: the author says “I’m very slack.” 💀 Please consult the File::Find::Rule manpage for now, and prepend - to the commands that you want.

🌈 Extra bonus switches 🌈

findrule automatically loads all of your installed File::Find::Rule::* extension modules, so check the documentation to see what those would be. It’s giving bonus DLC, honestly. 🦋

👑 AUTHOR 👑

Richard Clamp <richardc@unixbeard.net> from a suggestion by Tatsuhiko Miyagawa

💖 COPYRIGHT 💖

Copyright (C) 2002 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 ⭐

File::Find::Rule

---

💖 That’s the whole FINDRULE(1) situation, bestie — shipped with perl v5.42.0, dated 2025-06-11. Go off. 💅