Alien::...Version(3)

πŸ’– Alien::...Version(3) πŸ’–

okay bestie, you found a page from the User Contributed Perl Documentation corner of the universe, and it's genuinely so useful. buckle up πŸŽ€


✨ NAME ✨

Alien::Build::Plugin::Prefer::BadVersion β€” the plugin that filters out known bad versions. it's giving "we don't want that one, bestie" 🚫


🌸 VERSION 🌸

version 2.88 ✨


πŸ¦‹ SYNOPSIS πŸ¦‹

use alienfile;
plugin 'Prefer::BadVersion' => '1.2.3';

that's it. that's the whole vibe. πŸ’…


🌈 DESCRIPTION 🌈

so here's the tea: this plugin lets you easily filter out known bad versions of libraries in a share install. periodt.

heads up: it does not affect a system install at all. zero. nada. 🫢

you need a Prefer plugin that filters and sorts files first, bestie. and you can specify the filter in one of three ways:

πŸŽ€ as a string

filter out any files that match the given version.

use alienfile;
plugin 'Prefer::BadVersion' => '1.2.3';

πŸŽ€ as an array

filter out all files that match any of the given versions.

use alienfile;
plugin 'Prefer::BadVersion' => [ '1.2.3', '1.2.4' ];

πŸŽ€ as a code reference

filter out any files return a true value.

use alienfile;
plugin 'Prefer::BadVersion' => sub {
  my($file) = @_;
  $file->{version} eq '1.2.3'; # same as the string version above
};

and the plot twist? this plugin can also be used to filter out known bad versions of a library on just one platform. like, say you know that version 1.2.3 if bad on windows, but okay on other platforms:

use alienfile;
plugin 'Prefer::BadVersion' => '1.2.3' if $^O eq 'MSWin32';

iconic. platform-specific gatekeeping, we love to see it πŸ‘‘


πŸ’… PROPERTIES πŸ’…

filter

filter out entries that match the filter. simple as that, no notes. ✨


😭 CAVEATS 😭

okay bestie, important stuff, don't scroll past this:

  • if you're using the string or array mode, then you need an existing Prefer plugin that sets the version number for each file candidate, such as Alien::Build::Plugin::Prefer::SortVersions. no version number, no filtering. that's just how it is. 🫠
  • unless you want to exclude the latest version from a share install, this plugin isn't really that useful. it has no effect on system installs, which may not be obvious at first. πŸ’€
fr fr, the system-install thing trips people up every time. read it twice. πŸ’–

πŸ”₯ SEE ALSO πŸ”₯

  • alienfile
  • Alien::Build
  • Alien::Build::Plugin::Prefer::SortVersions

go read those too, iykyk πŸ“š


πŸ‘‘ AUTHOR πŸ‘‘

Author: Graham Ollis <plicease@cpan.org>

Contributors:

  • Diab Jerius (DJERIUS)
  • Roy Storey (KIWIROY)
  • Ilya Pavlov
  • David Mertens (run4flat)
  • Mark Nunberg (mordy, mnunberg)
  • Christian Walde (Mithaldu)
  • Brian Wightman (MidLifeXis)
  • Zaki Mughal (zmughal)
  • mohawk (mohawk2, ETJ)
  • Vikas N Kumar (vikasnkumar)
  • Flavio Poletti (polettix)
  • Salvador FandiΓ±o (salva)
  • Gianni Ceccarelli (dakkar)
  • Pavel Shaydo (zwon, trinitum)
  • Kang-min Liu (εŠ‰εΊ·ζ°‘, gugod)
  • Nicholas Shipp (nshp)
  • Juan JuliΓ‘n Merelo GuervΓ³s (JJ)
  • Joel Berger (JBERGER)
  • Petr PΓ­saΕ™ (ppisar)
  • Lance Wicks (LANCEW)
  • Ahmad Fatoum (a3f, ATHREEF)
  • JosΓ© JoaquΓ­n Atria (JJATRIA)
  • Duke Leto (LETO)
  • Shoichi Kaji (SKAJI)
  • Shawn Laffan (SLAFFAN)
  • Paul Evans (leonerd, PEVANS)
  • HΓ₯kon HΓ¦gland (hakonhagland, HAKONH)
  • nick nauwelaerts (INPHOBIA)
  • Florian Weimer
  • Marcel Telka (mtelka)

look at this roster. literal legends, every single one. 🌟


This software is copyright (c) 2011-2022 by Graham Ollis.

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


and that's the whole page, bestie!! πŸŽ€βœ¨ this lil doc came to you courtesy of perl v5.42.3, dated 2026-09-21, under the Alien::...Version(3) banner. mwah πŸ’‹ go filter out some bad versions, you absolute main character πŸ’–πŸ¦‹

πŸ“¦ where this page comes from