File::...posite(3pm)

🦋 File::...posite(3pm) — bestie, it's the composite key page

okay so this is File::KDBX::Key::Composite, from the User Contributed Perl Documentation corner of the manual, and it is lowkey the moment 💅

✨ VERSION ✨

version 0.906 — yes, she's got a version, she's official 🎀

---

💖 SYNOPSIS 💖

use File::KDBX::Key::Composite;

my $key = File::KDBX::Key::Composite->(\@component_keys);

like, that's it. that's the whole vibe check. you hand her a list of keys and she becomes The Key 🔥

---

🌸 DESCRIPTION 🌸

so a composite key is literally just a lil collection of other keys 🫶 a group chat of keys, if you will.

and here's the tea: a master key that can unlock a KDBX database is always a composite key. always. even when it's got just one single component key in it. one (1) friend in the group chat and she's still a full composite. iconic behavior honestly 👑

she inherits methods and attributes from File::KDBX::Key, so all the family traits come through 💜

---

🦋 ATTRIBUTES 🦋

keys

\@keys = $key->keys;

grab one or more of her component File::KDBX::Keys. that's it, that's the getter, she's not gatekeeping 💅

---

🌈 METHODS 🌈

raw_key

$raw_key = $key->raw_key;
$raw_key = $key->raw_key($challenge);

get the raw key out of every single component key, then get back a generated composite raw key. all the little raw keys holding hands to become one big raw key 😭💖

challenge

$response = $key->challenge(...);

this one issues a challenge to any File::KDBX::Key::ChallengeResponse component keys 🔥 the arguments get passed straight through to each component key, no filter. then all the responses get hashed together and the composite response comes back out at you.

bestie heads up: she returns an empty string if there are no challenge-response component keys. like, nobody showed up to the challenge, so there's nothing to say 🙈

---

💀 BUGS 💀

pls pls pls report any bugs or feature requests on the bugtracker website: <https://github.com/chazmcgarvey/File-KDBX/issues> — ngl the maintainer wants to hear from you fr fr.

and when you do submit a bug or a request, include a test-file or a patch to an existing test-file that shows off the bug or the desired feature. seriously. that's the love language here 🫶

---

👑 AUTHOR 👑

Charles McGarvey <ccm@cpan.org> — the main character, the author, the one who wrote this ✨

---

💜 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, bestie — brought to you by perl v5.40.1, dated 2025-05-04, from the File::...posite(3pm) page itself. periodt. no cap. slay 🌸🦋✨