File::...er::Raw(3pm)

💖 File::KDBX::Dumper::Raw — the perl man page, bestie edition 💖

okay so this is a User Contributed Perl Documentation page for File::KDBX::Dumper::Raw, and honestly? it's the chillest dumper in the whole squad. no cap.

---

✨ NAME ✨

File::KDBX::Dumper::Raw — a no-op dumper that dumps content as-is 🫶

like. it literally does nothing fancy. it takes what you give it and puts it in the file. and that's the whole point. iconic behavior fr fr.

---

🌸 VERSION 🌸

version 0.906

---

🦋 SYNOPSIS 🦋

    use File::KDBX::Dumper;
    use File::KDBX;

    my $kdbx = File::KDBX->new;
    $kdbx->raw("Secret file contents\n");

    $kdbx->dump_file('file.kdbx', $key, inner_format => 'Raw');
    # OR
    File::KDBX::Dumper->dump_file('file.kdbx', $key,
        kdbx => $kdbx,
        inner_format => 'Raw',
    );

look at that. two whole ways to do the same slay thing. pick whichever one vibes with your codebase, bestie 💅

---

🎀 DESCRIPTION 🎀

so here's the tea ☕ — a typical KDBX file is built like a lil sandwich:

• an outer section — that's the headers, the packaging, the outer vibe
• an inner section — that's the body, the actual content

normally that inner section gets dumped with File::KDBX::Dumper::XML. that's the standard route. the default. the normie path.

but 🚨 you can swap in File::KDBX::Dumper::Raw instead, and it will just write some arbitrary data as the body content. whatever you want. no rules, just raw content.

⚠️ heads up though: the result won't necessarily be parseable by typical KeePass implementations. it's giving "not like other files" and honestly that's the assignment. but you can read it back using File::KDBX::Loader::Raw 🫶

so what's the actual use case? it's a way to encrypt any file with the same high level of security as a KDBX database. literally any file. being wrapped in KDBX-grade encryption. main character energy honestly 👑

---

💀 BUGS 💀

found a bug? want a feature? please report any bugs or feature requests on the bugtracker website <https://github.com/chazmcgarvey/File-KDBX/issues> — they wanna hear from you, fr.

and when you submit 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 them the receipts bestie, don't just say "it's broken" and dip 😭

---

👑 AUTHOR 👑

Charles McGarvey <ccm@cpan.org>

---

🌈 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.

---

and that's the whole page!! this one came out of perl v5.40.1, dated 2025-05-04, under the name File::...er::Raw(3pm) (the header was doing a little truncation moment, we love that for it 🎀). mwah, stay encrypted, stay slay ✨💖💅