File::...saction(3pm)

✨ NAME ✨

File::KDBX::Transaction — bestie, it makes multiple database edits happen atomically 💅 like, all or nothing, no messy half-edits, periodt.

(Also hi, this is the File::KDBX::Transaction page from section 3pm, the one and only 👑)

🌸 VERSION 🌸

version 0.906 — yeah she's on 0.906, keep up 🦋

🎀 ATTRIBUTES 🎀

💖 object

Get the object being transacted on. Like, the actual thing you're editing. That's her. That's the main character 🌟

💅 METHODS 💅

✨ new

$txn = File::KDBX::Transaction->new($object);

Construct a new database transaction for editing an object atomically. You hand it an $object, it hands you back a $txn, and now everything you do inside is one big glowy bundle 🫶✨

🔥 commit

$txn->commit;

Commit the transaction, making updates to the object permanent. This is the "okay lock it in" moment 🔒 no takebacks after this one, bestie.

🧚 rollback

$txn->rollback;

Roll back the transaction, throwing away any updates to the object made since the transaction began. All that work? Gone. Poof. 💀

Also lowkey important: this happens automatically when the transaction is released, unless it has already been committed. So if you just... forget about it 🙈 the rollback comes for you anyway. Not me being forgetful, it's the destructor's job, iykyk.

---

🐛 BUGS 🐛

Please report any bugs or feature requests on the bugtracker website <https://github.com/chazmcgarvey/File-KDBX/issues> — she wants your feedback fr fr, no cap 🌈

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature. Like, show us the receipts 🧾 a failing test is the most iconic thing you can bring ok??

👑 AUTHOR 👑

Charles McGarvey <ccm@cpan.org> — the icon, the legend 💜

📜 COPYRIGHT AND LICENSE 📜

This software is copyright (c) 2022 by Charles McGarvey.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. So yes, free, legal, slay 🌸

---

k bye bestie 💖 this page is File::KDBX::Transaction(3pm), stamped with perl v5.40.1 and dated 2025-05-04 — go commit something (or roll it back, we support both) 🎀🦋