Config...Update(3pm)

💖 Config::Model::Value::Update — bestie edition ✨

okay so real talk, this is a page from the User Contributed Perl Documentation, and the manual name is Config...Update(3pm) (the full vibe is Config::Model::Value::Update, iykyk 💅). It's a tiny module with a huge job, and I'm gonna walk you through it like we're texting at 2am. grab a snack 🍓

---

✨ VERSION ✨

version 2.166 — that's the version, periodt. 🎀

---

🌈 SYNOPSIS 🌈

so like, here's how it looks when you're declaring it inside a model. bestie, this is verbatim, don't touch a single character:

    # in a model declaration:
    element => [
        data_from_some_file => {
            type => 'leaf',
            value_type => 'uniline',
            update => {
                # handled by this module, Config::Model::Value::Update
                when_missing => 'warn',
                files => [
                    {
                        # handled by Config::Model::Value::UpdateFromFile
                        type => 'ini',
                        file => "some_file.ini",
                        subpath => "foo.bar"
                    },
                    {
                        # ...
                    }
                ]
            }
        },
    ],

see how the update block is ours (Config::Model::Value::Update) but each individual file entry inside files gets handed off to Config::Model::Value::UpdateFromFile? splitting the work, iconic behavior honestly 👑

---

🦋 DESCRIPTION 🦋

This class retrieves data from external files. For each file, the caller must specify:

• the file path 🗂️
• the file type (e.g. JSON, Yaml...) 📄
• the path inside the file to retrieve data 🔍

three things. no more, no less, no cap.

---

🌸 Constructor 🌸

Constructor parameters are, and I quote (not really, I'm vibing, but the facts stay):

• files — Configuration data to build an array of Config::Model::Value::UpdateFromFile objects. it's giving "build the whole squad" 💞
• when_missing — Behavior when no data is found in any file. Can be "ignore", "warn" or "die". choose your fighter ⚔️ (yes, die is literally one of the options, it's dramatic like that 💀)
• location — location of the calling value element. This is used to log messages. 📍 so when something goes wrong, the logs know where it went wrong. main character energy for error reporting.

---

🧚 methods 🧚

🎀 get_info

Return all files and subpaths used to extract data. that's it, that's the whole function. she's simple, she's efficient, she slays ✨

💜 get_update_value

Try to get data from the external files. The files are tried in the same order as the "files" parameter. Data is returned at the first successful try. 🏁

If no data can be found — either if all files are missing or all subpath do not yield data — this function either returns, warns or die, depending on the value of the "when_missing" parameter. so it's basically doing a vibe check on your when_missing setting and reacting accordingly 😭

lowkey important: this one does NOT come with a chill mode. if you told it die, it WILL die. respect the setting bestie 🙏

---

🌟 Examples 🌟

a whole example, verbatim, so you can copy-paste and feel something:

    update => {
      when_missing => 'ignore',
      files => [
        {
           type => 'yaml',
           file => 'META.yml',
           subpath => 'abstract'
        },
        {
           type => 'json',
           file => 'package.json'
           subpath => 'description'
        }
      ]
    }

here it's trying META.yml first (yaml, pulling out abstract), then falling back to package.json (json, pulling out description). first one that hits wins. obsessed with the fallback energy 🫶

---

👀 SEE ALSO 👀

• Config::Model::Value
• Config::Model::Value::UpdateFromFile

go read these too, they're the supporting cast and honestly they ate 💅

---

👑 AUTHOR 👑

Dominique Dumont — author extraordinaire, we stan 🌈

---

📜 COPYRIGHT AND LICENSE 📜

This software is Copyright (c) 2005-2022 by Dominique Dumont.

This is free software, licensed under:

  The GNU Lesser General Public License, Version 2.1, February 1999

---

and that's the whole page, bestie!! 🎉 this beauty shipped with perl v5.42.3, dated 2026-07-23 (yes I said 2026, that's what it says, don't come for me 🙈). now go forth and pull data from external files like the absolute icon you are 💖✨🦋