ExtUtil...tallPAR(3)

✨ ExtUtils::InstallPAR — the manual page, but make it cute ✨

okay so bestie, this is the page for ExtUtils::InstallPAR (perl module, section 3 of the manual, the User Contributed Perl Documentation corner of the world 💖). It's a lil' convenience wrapper and honestly? It's giving "I just want my .par to go into that perl, not this perl" energy. Let's go. 🦋

---

🌸 NAME 🌸

ExtUtils::InstallPAR — install .par's into any installed perl 👑

---

🎀 SYNOPSIS 🎀

use ExtUtils::InstallPAR;

# Install into the currently running perl:
ExtUtils::InstallPAR::install(
  par => './Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
);

# Install into a different perl on the system,
# this requires the ExtUtils::Infer module.
ExtUtils::InstallPAR::install(
  par => './Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
  perl => '/path/to/perl.exe',
);

# If LWP::Simple is available, it works with URLs, too:
ExtUtils::InstallPAR::install(
  par => 'http://foo.com/Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
);

like. it's literally three lines of vibes and you're done. no cap. 💅

---

💜 DESCRIPTION 💜

So here's the tea, bestie ☕: this module installs PAR distributions (aka .par files) into any perl installation on the system.

Now, PAR::Dist? It's already iconic — it can install into the currently running perl by default, and it hands you all the parameters you'd need to override any installation directories. Slay. But here's the problem: figuring out how to actually use those overrides so you can install into some arbitrary other perl on your machine? That's lowkey beyond most users. 😭 Not because they're not smart, just because it's a whole thing.

Enter this module: a convenience wrapper 🫶. It uses ExtUtils::InferConfig to automatically figure out the typical site installation paths of any perl interpreter that the current user is actually able to execute. Automatic. Effortless. Main character energy. ✨

---

🔥 FUNCTIONS 🔥

install

Install a PAR archive into any perl on the system. She takes named parameters, and here they are 👇

• "par => '/path/to/foo.par'" or "par => 'http://URL/to/foo.par'" — this one says where the .par file lives, or gives an URL to go fetch it from (that URL life only works if LWP::Simple is available). This parameter is mandatory, bestie. No par, no party. 🚫🎉
• perl => '/path/to/perl' — use this when you want to point at the specific perl interpreter to install into. If you just... don't include it, or you set it to undef, then the currently running perl becomes the target. And heads up: if you wanna install into different perls, you're gonna need the ExtUtils::InferConfig module installed. That's the toll. 💸
• verbosity => $value — sets how chatty the installation process is. Defaults to 1. So by default it's like a normal amount of yapping, not silent, not screaming. 🗣️

---

💀 CAVEATS 💀

okay so this section is literally empty in the original. The heading is there and then... nothing. The silence. The void. We respect it. 🙈

---

⭐ SEE ALSO ⭐

• PAR and PAR::Dist — for the gist on PAR distributions and archives. the OGs. 👑
• ExtUtils::InferConfig — for the details on how the installation paths actually get determined. the detective of the operation. 🕵️
• ExtUtils::Install — this is what's used to install the files into the system. the muscle. 💪
• "PAR::Dist" — this one can use LWP::Simple to fetch from URLs. the delivery service. 📦

---

🫶 AUTHOR 🫶

Steffen Mueller, <smueller@cpan.org> — thank you for your service, king. 🎀

---

🌈 COPYRIGHT AND LICENSE 🌈

Copyright (C) 2008 by Steffen Mueller

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6 or, at your option, any later version of Perl 5 you may have available.

---

and that's the whole page, bestie!! 💖 this manual page came to you from perl v5.42.0, dated 2025-07-25, and it was ExtUtil...tallPAR(3) all along (the header truncates it like that, we don't make the rules 💅). go install some pars. periodt. ✨🦋🌸