ExtUti...:Action(3pm)

🌸 NAME 🌸

okay so this is ExtUti...:Action(3pm) from the User Contributed Perl Documentation, and it’s literally the page for ExtUtils::Builder::Action — The ExtUtils::Builder Action role. periodt. 💅

🎀 VERSION 🎀

Version 0.020. slay.

✨ SYNOPSIS ✨

Here’s the vibe in code, bestie:

$_->execute for @actions;

open my $script, '>', 'foo.sh';
print $script shell_quote(@{$_}) for map { $_->to_command } @actions;

🦋 DESCRIPTION 🦋

Actions are the cornerstone of the ExtUtils::Builder framework. They’re the interface between build tools (ExtUtils::MakeMaker, Module::Build) and building extensions. That means both sides can be completely independent from each other, no cap. It’s a flexible abstraction around pieces of work, and that work can be a piece of perl code, an external command, a mix of those, or possibly other things. It’s giving “glue that slays.” 💖

🌈 OVERVIEW 🌈

An action can be consumed in many ways. You can execute it, which is often the simplest way to deal with them. It can be serialized to commands that can be passed on to system, or strings that can be evalled. If a consumer can deal with multiple of these, the preference method can be used to choose between options. On composite actions, flatten can be called to retrieve the constituent actions; on primitive actions it’s just an identity operator. This is particularly useful before calling preference, because different sub-actions are likely to have different preferences.

💅 METHODS 💅

🫶 execute(%arguments) 🫶

Execute this action immediately. This may throw an exception on errors, but doesn’t otherwise return anything. %arguments may be used by the command.

• quiet — if true, this suppresses logging.

⭐ to_command(%options) ⭐

Convert the action into a set of platform appropriate commands. It returns a list of array-refs, each array-ref being an individual command that can be passed to system or equivalent. %options can influence how something is serialized in action-type specific ways, but shouldn’t fundamentally affect the action that is performed. All options are optional.

• perl — this contains the path to the current perl interpreter.
• config — this should contain an ExtUtils::Config object, or equivalent.

🧚 to_code(%options) 🧚

This returns a list of strings that can be evalled to sub-refs. %options can influence how something is serialized in action-type specific ways, but shouldn’t fundamentally affect the action that is performed.

🍓 to_code_hash(%options) 🍓

This returns a list of hashes that can be used to create Action::Code objects.

👑 preference(@possibilities) 👑

This action returns the favored out of @possibilities. Valid values are "execute", "code", "command", "flatten". If no arguments are given, the favorite from all valid values is given.

🔥 flatten 🔥

This action returns all actions behind this action. It may return itself, it may return a long list of actions, it may even return an empty list. Main character energy: unpredictable but valid. 💁‍♀️

💜 AUTHOR 💜

Leon Timmermans <fawaka@gmail.com> — icon behavior.

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2013 by Leon Timmermans.

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. The footer vibe check is perl v5.40.1, dated 2026-02-23, and the manual is ExtUti...:Action(3pm). Slay, bye! 💅✨