Prima::...pWindow(3)

💅 Prima::Widget::StartupWindow — a whole manpage, and it's slaying

ok bestie so real quick — this is from the User Contributed Perl Documentation section of the manual (that's the <italic>Prima::...pWindow(3)</italic> page, the 3 means it's a library/module page, iykyk), and it's about one tiny little module that does one tiny little thing. But it does it adorably.

---

✨ NAME ✨

Prima::Widget::StartupWindow — a simplistic startup banner window 🎀

Like, it's a banner. It shows up when you start. It's simplistic. That's the whole vibe check.

---

🦋 DESCRIPTION 🦋

Okay so here's the tea, bestie: when this module gets imported by the use call, it creates a temporary window that pops up showing the text 'loading...' while the modules your program needs are still loading. It's literally giving "hang on, I'm getting ready" main character energy. 💅

The window's parameters can be modified by passing custom parameters after the use Prima::Widget::StartupWindow statement — those get passed straight through to the Prima::Window class as creation parameters. So you're not stuck with the default look, you can absolutely customize it if you want. 🫶

And then? The window is discarded by explicit unimporting of the module (go peek at SYNOPSIS below for how that actually looks, bestie, it's literally one line).

no cap, that's the entire module. temporary window appears, temporary window goes away. iconic behaviour honestly.

---

🌸 SYNOPSIS 🌸

        use Prima;
        use Prima::Application;
        use Prima::Widget::StartupWindow; # the window is created here

        use Prima::Buttons;
        .... # lots of 'use' of other modules

        no Prima::Widget::StartupWindow; # the window is discarded here

See how the use line creates it and the no line discards it? That's the moment. That's the whole lifecycle. 💖

---

👑 AUTHORS 👑

Give it up for the people who made this happen:

• Anton Berezin <tobez@tobez.org>
• Dmitry Karasik <dmitry@karasik.eu.org> (documentation)

---

🌈 SEE ALSO 🌈

Go check out Prima and Prima::Application, bestie — that's where the rest of the lore lives. 🔥

---

🌸💖 cute lil sign-off 💖🌸

and that's the page! 🎀 it's from perl v5.42.0, dated 2024-08-20, and yeah — the footer says Prima::...pWindow(3) again, because manpages love a little encore. periodt. 💅✨