Catman...leOnce(3pm)

💖 Catmandu::IterableOnce 💖

okay so bestie, welcome to Catmandu::IterableOnce — the Perl manual page for this lil role, straight out of the User Contributed Perl Documentation corner of the world. it's giving "one and done" energy and honestly? iconic. 🦋

---

✨ NAME ✨

Catmandu::IterableOnce — the role for iterable classes that can only iterate once. yeah. one time. that's the whole vibe. 🙈

---

🌸 SYNOPSIS 🌸

here's the whole look, copy it character-for-character because bestie we do not freestyle code:

package MySingleUseIterator;
use Moo;
with 'Catmandu::Iterable';
with 'Catmandu::Iterableonce';

sub  generator {
    # ...
}

so you make a package, you pull in Moo, you compose in Catmandu::Iterable, then you compose in Catmandu::Iterableonce, and then you define your own generator sub — the # ... is where your actual logic goes, no cap. 💅

heads up bestie: yes, it really is spelled Catmandu::Iterableonce in that second with line. copy it exactly as it appears. don't "fix" it, don't get cute with the capital letters, just type it like the page says. ✨

---

🫶 SEE ALSO 🫶

• Catmandu::Iterable — go read that one too, it's the whole reason this role exists. 🌈

---

and that's the page, babe. no options, no flags, no environment variables, no exit statuses — just a tiny role doing its one-time thing. main character energy, honestly. 👑

kisses, this was rendered from perl v5.40.1, dated 2026-01-24. go iterate once and make it count. 🎀💜