Module...figData(3pm)

🌸 NAME 🌸

Okay so bestie, Module::Build::ConfigData is literally the configuration-data holder for the Module::Build module — it's giving backstage-pass energy for config. 💅 This page is Module...figData(3pm), from the User Contributed Perl Documentation crew. ✨

🎀 SYNOPSIS 🎀

Here's the copy-paste-ready group chat cheat sheet:

use Module::Build::ConfigData;
$value = Module::Build::ConfigData->config('foo');
$value = Module::Build::ConfigData->feature('bar');

@names = Module::Build::ConfigData->config_names;
@names = Module::Build::ConfigData->feature_names;

Module::Build::ConfigData->set_config(foo => $new_value);
Module::Build::ConfigData->set_feature(bar => $new_value);
Module::Build::ConfigData->write;  # Save changes

🦋 DESCRIPTION 🦋

This module holds the configuration data for the Module::Build module, no cap. It also gives you a programmatic interface for getting or setting that configuration data. 🫶

⚠️ Real talk: to actually make changes, you'll have to have write access to the Module::Build::ConfigData module, and you should attempt to understand the repercussions of your actions. Like, please read the room before editing, okay? 😭

💖 METHODS 💖

💅 config($name)

Give it a string argument and it returns the value of the configuration item with that name — or undef if no such item exists. Simple. Iconic. ✨

🍓 feature($name)

Give it a string argument and it returns the value of the feature with that name — or undef if no such feature exists. 💜

🌈 set_config($name, $value)

Sets the configuration item with the given name to the given value. The value may be any Perl scalar that will serialize correctly using Data::Dumper. That includes references, objects (usually), and complex data structures. It probably does not include transient things like filehandles or sockets. 🙈

🧚 set_feature($name, $value)

Sets the feature with the given name to the given boolean value. The value gets converted to 0 or 1 automatically. Slay, booleans. 👑

⭐ config_names()

Returns a list of all the names of config items currently defined in Module::Build::ConfigData — or, in scalar context, the number of items. 🎀

🦋 feature_names()

Returns a list of all the names of features currently defined in Module::Build::ConfigData — or, in scalar context, the number of features. 💖

🌸 auto_feature_names()

Returns a list of all the names of features whose availability is dynamically determined — or, in scalar context, the number of such features. It does not include such features that have later been set to a fixed value. iykyk. 💫

🔥 write()

Commits any changes from set_config() and set_feature() to disk. Requires write access to the Module::Build::ConfigData module. Periodt. 💅

👑 AUTHOR 👑

Module::Build::ConfigData was automatically created using Module::Build. Module::Build was written by Ken Williams, but he holds no authorship claim or copyright claim to the contents of Module::Build::ConfigData. Respect the lore. 🫶

---

Cute sign-off time: this page is from perl v5.42.0, dated 2023-04-29, and the footer vibe is Module...figData(3pm). Byeee, bestie! 💖✨🎀