Catman...ctional(3pm)

💖 Catmandu::Transactional — the 3pm manual page, but make it make sense 💖

okay bestie, so this one is from the Perl user-contributed docs (that's the 3pm section, iykyk) and it's called Catmandu::Transactional. it's an optional role for transactional stores — optional being the key word, like the cute jacket you don't have to wear but slays when you do ✨

---

🌸 NAME 🌸

Catmandu::Transactional — the optional role for transactional stores 🫶

---

🎀 SYNOPSIS 🎀

# bag will be untouched
my $store->transaction(sub {
    $store->bag('books')->add({title => 'Time must have a stop'});
    die;
});

notice how the comment says the bag stays untouched?? that's the whole point bestie — the die kills the transaction and everything rolls back like nothing happened 💅

---

🦋 METHODS 🦋

✨ transaction($sub) ✨

so transaction takes a coderef and runs it inside the context of a transaction. here's the tea:

• if an error gets thrown → the transaction rolls back 😭 everything undoes itself
• if the code runs all the way through successfully → the transaction gets committed 👑 it's canon now

⚠️ lowkey important: there is no support for nested transactions. if you call transaction inside another transaction, the inner one just gets subsumed by its parent transaction — like, it's absorbed, no separate vibe of its own. periodt. 💀

---

and that's the whole page, no notes 💖✨

this lil gem came to you from perl v5.40.1, dated 2026-01-24 — drink some water, commit your transactions, and stan rollback safety 🎀🦋💜