App::Whiff(3pm)

📦
version 0.008 · 3 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💖 App::Whiff — the manual, but make it cute ✨

okay bestie, so this page is for App::Whiff, which lives in the User Contributed Perl Documentation corner of the perl universe 💅. It's a perl module, it's got 3pm energy, and it does exactly one extremely useful thing: it finds the first executable of a series of alternatives. no cap.

🎀 NAME 🎀

App::Whiff — find the first executable of a series of alternatives 🔍✨

🌸 VERSION 🌸

version 0.008 — yes ma'am, we are on 0.008 and we are thriving 🫶

🦋 DESCRIPTION 🦋

sooo this module implements the logic used by the whiff command 👑. What does that command do? It takes a bunch of command names and hands you back the first one that exists and is executable. that's it. that's the whole vibe. it's giving "which of these do you actually have installed, bestie?" and honestly? iconic 💅

⭐ PERL VERSION ⭐

ngl this one's kind of a flex: this library should run on perls released even a long time ago 😭. Specifically, it should work on any version of perl released in the last five years. so go ahead and run it on your ancient perl, she can handle it 💪

but — and this is the important part, don't skip it — although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl 🚫. so don't come for her with a "please support perl from 1997" PR, she said what she said 🙈

💜 METHODS 💜

🌈 find_first

my $filename = App::Whiff->find_first(\@names);

okay so you hand her an arrayref of command names — and heads up, those names should not be anything other than base filename, like, no paths, just the name, bestie 🎀 — and this method will either:

  • return an absolute path to the first of the alternatives found in the PATH (it uses File::Which to do the searching, slay), or
  • return false 🫠

that's the whole thing. she looks, she finds, she returns. main character energy fr fr.

🌸 run

This method is called by the whiff program to... well, run. 😭✨ that's genuinely the description. she does the running. the vibe is immaculate, the explanation is minimal, we respect it.

👑 AUTHOR 👑

  • Ricardo SIGNES <cpan@semiotic.systems> 💖

🫶 CONTRIBUTORS 🫶

the besties who showed up and helped:

  • Florian Schlichting <fsfs@debian.org>
  • Ricardo Signes <rjbs@semiotic.systems>
  • Ricardo Signes <rjbs@users.noreply.github.com>

(three whole entries, we love a credit list that's thorough 🎀)

This software is copyright (c) 2008 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so like, go wild, but respectfully 🦋

ok that's the whole page, you read it all, I'm so proud of you 🥹✨ no skipping, no skimming, full send. slay.

and that's a wrap bestie — this was App::Whiff, perl v5.40.1, dated 2025-05-04, straight from the User Contributed Perl Documentation section of the 3pm manual 💖 periodt. now go find yourself an executable 🎀

📦 where this page comes from