Alien::...gotiate(3)

✨ NAME ✨

okay so this is Alien::Build::Plugin::PkgConfig::Negotiate bestie 💖 it's the package configuration negotiation plugin, and yes the name is a mouthful, we know, we love her anyway 🎀

---

🌸 VERSION 🌸

version 2.88 — that's the vibe check and she passed 💅

---

🦋 SYNOPSIS 🦋

like, here's the whole thing in action, no notes:

use alienfile;
plugin 'PkgConfig' => (
  pkg_name => 'libfoo',
);

iconic. short. slays. ✨

---

💜 DESCRIPTION 💜

okay so real talk: this plugin is the one doing the Probe and Gather steps for pkg-config based packages. it's giving matchmaker energy fr fr — it looks at your platform and your environment and then picks the best PkgConfig plugin for you. you don't have to choose. she chooses. main character behavior honestly 👑

---

🎀 PROPERTIES 🎀

🌈 pkg_name

the package name, bestie. that's it. that's the property.

BUT — and this is the tea ☕ — if this is a list reference, then .pc files with all those package names have to be present, like the whole squad has to show up or nobody gets in 🫶

the first name is the primary one and it's the one used by default once installed. and for the subsequent .pc files? you can use the Alien::Base alt method to go retrieve the alternate configurations once the Alien is installed. iykyk 💫

🌸 atleast_version

the minimum required version that's an acceptable version as provided by the system. like, "at least this, or we're not doing this" ✋

🧚 exact_version

the exact required version that's an acceptable version as provided by the system. not a range. not a vibe. the exact one 💀

⭐ max_version

the max required version that's an acceptable version as provided by the system. the ceiling. the limit. the "do not pass go" 🚧

💖 minimum_version

alias for "atleast_version" for backward compatibility. she's the same girl, just answering to an older name 🥺

---

💅 METHODS 💅

👑 pick

my $name = Alien::Build::Plugin::PkgConfig::Negotiate->pick;

returns the name of the negotiated plugin. that's the whole job. she picked, she told you, she moved on ✨

---

🌈 ENVIRONMENT 🌈

• ALIEN_BUILD_PKG_CONFIG — if you set this, this plugin will be used instead of the built-in logic that tries to automatically pick the best plugin. so basically you're overriding the auto-picker and saying "no bestie, I got this one" 🙈

---

🔥 SEE ALSO 🔥

• Alien::Build
• alienfile
• Alien::Build::MM
• Alien

go read them, they're all part of the same little universe 🫶

---

🥹 AUTHOR 🥹

Author: Graham Ollis <plicease@cpan.org>

Contributors, aka the whole group chat, no one left out, everyone ate 💖:

• 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)

absolute legends, every single one 🌟

---

💜 COPYRIGHT AND LICENSE 💜

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.

fr fr, it's free software, go wild, just respect the terms of the Perl 5 license 🫶

---

and that's the whole page bestie, tysm for reading 🥰 this was Alien::...gotiate(3) from the User Contributed Perl Documentation, shipped with perl v5.42.3 and dated 2026-09-21 — mwah, go build something cute 💅✨🌸