NetSDS...anslate(3pm)

💖 NetSDS::Translate 💖

okay bestie, so this is a page from the User Contributed Perl Documentation collection — it's a 3pm manual, which is Perl-speak for "a module's docs" 🫶. It's called NetSDS::Translate and it's literally the whole entire vibe of "I have a string, I want it in another language, let's go" ✨

---

✨ NAME ✨

NetSDS::Translate — a simple API to gettext 🌸

---

🌈 SYNOPSIS 🌈

Look at this. It's giving effortless:

use NetSDS::Translate;

my $trans = NetSDS::Translate->new(
        lang => 'ru',
        domain => 'NetSDS-IVR',
);

print $trans->translate("Detect CallerID");

No cap, that's the entire workflow. You make a translator, you feed it a string, it hands you back a translated string. Iconic 💅

---

🦋 DESCRIPTION 🦋

So the NetSDS::Translate module is out here providing an API to the gettext translation subsystem. That's it. That's the whole job. It's the little middle-man between you and gettext and honestly? It ate. 🔥

---

👑 CLASS API 👑

🎀 new(%params) — class constructor

This is where you build your translator object, bestie. She takes params:

my $trans = NetSDS::Translate->new(
            lang => 'ru',
            domain => 'NetSDS-IVR',
    );

Main character energy from the very first line ✨

🍓 translate($string) — translate string

Feed her a string, get a string back. Returns the translated string 🫶

print $trans->translate("All ok");

That's it. That's the whole method. She's simple, she's effective, she's booked and busy 💅

---

💀 TODO 💀

Not everything is finished, and we respect the honesty fr fr 🙈

1. Make the language-to-locale conversion configurable in the constructor.
2. Implement the placeholders support that gettext provides.

so like. those two things are not done yet, okay? Don't come for her, she's working on it 😭

---

🌸 SEE ALSO 🌸

• Locale::gettext

---

💜 AUTHOR 💜

Michael Bochkaryov <misha@rattler.kiev.ua> — shoutout to the legend who wrote this 🫡

---

📜 LICENSE 📜

Copyright (C) 2008-2009 Net Style Ltd.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

bestie the warranty thing is serious, okay? Like, no warranty, none, zero, nada. Read the GPL, she means it 💀

---

aaand that's the whole page, bestie 🎀 this one's from perl v5.32.1, dated 2021-12-26, and it lives under the 3pm manual section 🦋 kthxbye, go translate something 💖✨