Storm::Transaction(3)

💖 Storm::Transaction — the Perl doc page, but make it cute 💖

okay bestie, welcome to Storm::Transaction(3), straight out of the User Contributed Perl Documentation section, and I'm about to make transactions make sense, no cap. ✨

---

🌸 NAME 🌸

Storm::Transaction — execute a code block in a database transaction 🫶

Like, you hand it some code, it runs that code inside a database transaction. That's the whole vibe. 💅

---

✨ SYNOPSIS ✨

use Storm::Transaction;

$txn = Storm::Transaction->new( $storm, sub {

   ... do work on $storm ...

});

eval { $source->commit };

print "transaction successfull" if ! $@;

look at that. new takes your $storm and a sub, you commit inside an eval, and then you print "transaction successfull" if $@ is empty (which means nobody threw anything, which means we ate 🔥). note that the string really is spelled successfull in the example — I'm not fixing it, that's canon, and also no shade, it's iconic. 🎀

---

🦋 DESCRIPTION 🦋

Storm::Transaction executes a block of code inside a database transaction. so like, it's giving "wrap your work up safely" energy. 💜

this requires that the database supports transactions. if the database does not support transactions, the code block will simply be invoked. no transaction, no rollback, it just runs. so know your database, bestie, fr fr. 😭

---

🌈 ATTRIBUTES 🌈

• storm — the Storm object to perform transactions on. it's the main character of this whole operation. 👑
• code — the code to be invoked within the transaction. if the code block finishes without any errors, then the database changes are committed. if errors are encountered, then the changes are rolled back. like, either it slays or it un-slays. periodt. 💅

---

🎀 METHODS 🎀

💫 commit

begins a new transaction and then invokes the code block to perform the work. database changes are committed if the code block executes without any errors. if errors are thrown, then the changes work are rolled back. 🔥

ngl, it is useful to call commit within an eval { } block to trap any errors that are thrown. alternatively, use a module like TryCatch or Try::Tiny and call commit within a try { } block. pick your fighter, both are valid, both are cute. 🧚

---

🫶 AUTHOR 🫶

Jeffrey Ray Hallock <jeffrey.hallock at gmail dot com> — shoutout to the author, the way he wrote this whole thing? obsessed. ⭐

---

💜 COPYRIGHT 💜

Copyright (c) 2010 Jeffrey Ray Hallock. All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.

so yeah, free software, same terms as Perl itself, go wild (responsibly, and legally, and with the copyright notice intact, obviously). 🌸

---

okay that's the whole page!! 🥳 this was perl v5.42.0, dated 2025-07-25, and it's the Storm::Transaction(3) manpage — thanks for reading, mwah, bye bestie 💖🦋✨