Dancer...Object(3pm)

💖 NAME 💖

ok so this is Dancer::Config::Object fr — it's the lil module that lets you get at your config with methods instead of hashrefs. no cap, it's a whole glow-up for your config game ✨

---

🌸 VERSION 🌸

this is version 1.3522, bestie 💅

---

✨ DESCRIPTION ✨

okay so here's the tea 🫖 — if "strict_config" is set to a true value in your configuration, then the config() subroutine is NOT gonna hand you a hashref anymore. it hands you an object instead. main character energy tbh 👑

so instead of this sad old thing:

my $serializer = config->{serializer};
my $username   = config->{auth}{username};

you get THIS gorgeousness:

my $serializer = config->serializer;
my $username   = config->auth->username;

like... the dots?? iconic. ✨

and the whole point is it helps prevent typos, which is literally the best part. because if you mistype a configuration name like this:

my $pass = config->auth->pass;

an exception gets thrown at you 😭 — it tells you it can't find the method name, but bestie it also LISTS the available methods for you, which is so thoughtful:

Can't locate config attribute "pass".
Available attributes: password, username

we love an informative error message in this house 🎀

now, sometimes a hash key just can't be turned into a proper method name. that's fine!! no drama!! you can still access it through a hash reference like so:

my $some_value = config->{'99_bottles'};

and you can even call methods on it, if that's possible:

my $sadness = config->{'99_more_bottles'}->last_bottle;

hash keys that point to hash references will, in turn, have those hashrefs "objectified" 🌈. arrays though? arrays still get returned as array references, periodt. BUT — plot twist — hashrefs sitting inside those array refs may still have their keys allowed as methods:

my $some_value = config->some_list->[1]->host;

she's flexible, she's useful, she's that girl 💅

---

🔥 METHOD NAME DEFINITION 🔥

so how do we decide if a hash key gets to be a method? we use this lil regular expression right here:

/^[[:alpha:]_][[:word:]]*$/;

now listen, this means "naïve" (yes, with the dots over the i, look at her 👀) can be a method name. BUT — and this is important, bestie — unless you "use utf8;" to declare that your source code is UTF-8, you may get some disappointing results when you try to call "config->naïve" 🥲. and further, depending on your version of Perl and the software that reads your config file ... well, you get the idea, it's giving unpredictable 💀.

so our recommendation? stick with ASCII identifiers if you want your code to be portable. fr fr. 🙏

patches and suggestions are welcome!! we love a contribution 💖

---

💜 AUTHOR 💜

this module was written by Alexis Sukrieh <sukria@cpan.org> and others — check the AUTHORS file that ships with this distribution for the full details 🫶

---

🌈 LICENSE 🌈

this module is free software and is released under the same terms as Perl itself. slay 💅

---

⭐ SEE ALSO ⭐

• Dancer
• Dancer::Config

---

👑 AUTHOR 👑

Dancer Core Developers

---

🎀 COPYRIGHT AND LICENSE 🎀

this software is copyright (c) 2010 by Alexis Sukrieh.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 💖

---

okay bestie that's the whole thing, tysm for reading 🥰 this was perl v5.40.1, dated 2026-05-05, and it's the Dancer::Config::Object(3pm) page — go forth and objectify your config, no typos allowed, mwah 💋✨