Locale:...nslator(3)

💖 Locale::TextDomain::OO::Translator — the translator class, bestie 💖

okay so welcome to the Locale::TextDomain::OO::Translator page, straight out of the User Contributed Perl Documentation, section 3 of your local manual. this is the whole vibe. grab a boba, we're doing i18n. 🧋✨

$Id: Translator.pm 724 2018-12-24 11:50:32Z steffenw $

$HeadURL: svn+ssh://steffenw@svn.code.sf.net/p/perl-gettext-oo/code/module/trunk/lib/Locale/TextDomain/OO/Translator.pm $

---

✨ VERSION ✨

1.035 — that's the one, that's the version, no notes. 💅

---

🌸 DESCRIPTION 🌸

so like… this is the translator class. that's it, that's the girl. 🎀

and the way you make her do stuff is you extend her with plugins, and those plugins show up as Roles. main character energy via extension, fr fr.

---

🦋 SYNOPSIS 🦋

here's the whole serve:

require Locale::TextDomain::OO::Translator;
Locale::TextDomain::OO::Translator->new(
    Locale::TextDomain::OO::Translator->load_plugins,
);

load the plugins, hand 'em to new, boom. iconic. 🔥

---

👑 SUBROUTINES/METHODS 👑

💜 method new

see SYNOPSIS. that's the whole description, she said read the synopsis and i respect that so much. 🙈

💜 class method load_plugins

this one gets called before new, okay? her whole job is loading the plugins.

$hash_ref = Locale::TextDomain::OO::Translator->load_plugins;

look at that hash ref go. 💫

💜 method translate

called from Plugins only. not you. the plugins. iykyk.

$translation = $self->translate(... lots of parameters ...);

yes bestie, literally lots of parameters. they wrote it like that and i'm keeping it like that. 💀

💜 method run_filter

called from plugins only. again! plugins! only! 🫶

$self->run_filter(\$translation);

note the backslash — it takes a reference to the translation. 🎀

---

🌈 EXAMPLE 🌈

inside this distribution there's a directory named example. go read the file README in there first. then run the *.pl files. like, go on, they're right there. ⭐

---

💅 DIAGNOSTICS 💅

confess

that's it. that's the diagnostic. she's confessing. 😭

---

🎀 CONFIGURATION AND ENVIRONMENT 🎀

none

nothing to configure, nothing in the environment, we're chill. 🍓

---

🧚 DEPENDENCIES 🧚

okay so she does NOT come alone, she comes with a whole entourage:

• Carp
• Class::Load
• Locale::TextDomain::OO::Singleton::Lexicon
• Locale::TextDomain::OO::Util::JoinSplitLexiconKeys
• Moo
• MooX::StrictConstructor
• MooX::Types::MooseLike::Base
• namespace::autoclean
• Locale::TextDomain::OO::Role::Logger

squad goals, honestly. 💜

---

💀 INCOMPATIBILITIES 💀

not known

no drama detected. yet. 🙈

---

💀 BUGS AND LIMITATIONS 💀

not known

same energy. nothing known. we move. ✨

---

🌸 AUTHOR 🌸

Steffen Winkler

thank you for your service, king. 👑

---

💖 LICENSE AND COPYRIGHT 💖

Copyright (c) 2013 - 2018, Steffen Winkler "<steffenw at cpan.org>". All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

so like, free software, same terms as Perl itself, redistribute and/or modify to your heart's content. slay. 🫶

---

and that's the page, bestie!! this was rendered by perl v5.42.0 on 2025-07-25, and yes the manual name really does get all scrunched up like Locale:...nslator(3) at the edges — she's just doing her best. mwah. 💅✨