NetSDS...:Kannel(3pm)

πŸ“¦
version 1.300 Β· 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute

πŸ’– NetSDS::Feature::Kannel β€” the manual page, but make it make sense πŸ’–

okay bestie, so you're looking at a page from the User Contributed Perl Documentation, filed under NetSDS...:Kannel(3pm) (yes the header mangles the colons, we don't talk about it πŸ’€). It's a Perl module page, it's giving very "SMS gateway but make it pluggable", and I'm gonna walk you through every single line of it. no cap. 🫢


✨ NAME ✨

NetSDS::Feature::Kannel β€” the kannel application feature. that's it, that's the name, iconic. πŸ’…


✨ SYNOPSIS ✨

okay so here's how you actually use this thing. first up, the configuration file fragment β€” this is literally the block you drop into your config, </feture> typo and all, do NOT @ me, I'm copying it verbatim because that's the rule:

# *****************************************
# Configuration file fragment

<feature smsgw>
        class = NetSDS::Feature::Kannel
        sendsms_url = http://10.0.1.2:13013/cgi-bin/sendsms
        sendsms_user = netsds
        sendsms_passwd = topsecret
</feture>

(and yes bestie, the closing tag is spelled </feture> in the original, I am not fixing it, I am just reporting it 🫑)

then the Application part β€” this is your Perl doing the thing:

# *****************************************
# Application

SMSApp->run(
        auto_features => 1,
);

package SMSApp;

sub process {
        ...
        $self->sms->send(
                from => '1234',
                to => '380501234567',
        );
}

1;

like. it's so clean. auto_features => 1 and suddenly you have SMS powers. main character energy fr fr. ✨


✨ DESCRIPTION ✨

NetSDS::Feature::Kannel module provides pluggable API to Kannel from NetSDS application.

translation for the girlies: this module is the little bridge πŸŒ‰ that lets your NetSDS app plug straight into Kannel. it's pluggable, it's a feature, it's the moment. periodt.


✨ CLASS API ✨

new([...])

Constructor. the classic. the blueprint. the "let's build an object" ritual. πŸŽ€

my $object = NetSDS::SomeClass->new(%options);

that's the pattern, that's the vibe, that's literally how you make one of these. %options goes in, an object comes out. slay. πŸ’…


✨ SEE ALSO ✨

the besties, the mutuals, the ones you should also go read:

go follow them, they're all linked, it's giving very "found family" πŸ¦‹


✨ TODO ✨

None

that's it. nothing. zero. empty. the to-do list is flawless, not a single thing left undone. we LOVE a finished queen. πŸ‘‘βœ¨


✨ AUTHOR ✨

Michael Bochkaryov <misha@rattler.kiev.ua>

the icon, the legend, the one who wrote all this. give them their flowers. πŸŒΈπŸ’


✨ LICENSE ✨

Copyright (C) 2008-2009 Net Style Ltd.

okay so here comes the legal bit and we do NOT skip the legal bit, bestie, it's important, so read it all:

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.

⚠️ yes, that's the all-caps part, and it's all-caps because it MEANS it β€” no warranty, bestie, none, don't come for them if it breaks 😭

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


and that's the whole page! πŸŽ‰ every flag, every line, every </feture>, accounted for. this was perl v5.32.1, dated 2021-12-26, and it's still serving looks. mwah. πŸ’‹βœ¨ bye bestie! πŸ¦‹πŸ’–