AnyEven...:Account(3)

👑 AnyEvent::XMPP::IM::Account — the IM account class, bestie

So this is a page from the AnyEven...:Account(3) manpage (Perl's own docs, user-contributed section) and honestly? It's a little gem. Let's get into it 💅

---

✨ SYNOPSIS ✨

my $cl = AnyEvent::XMPP::IM::Client->new;
...
my $acc = $cl->get_account ($jid);

That's the whole vibe: make a client, then grab an account off it. Iconic, minimal, no notes 🎀

---

💖 DESCRIPTION 💖

Okay so real talk: this module is the class that represents IM accounts. It does what it says on the tin 🫶

And here's the thing you need to know — you can't just go AnyEvent::XMPP::IM::Account->new and start living your best life. Nope. The only way to get an instance of this class is by calling the get_account method on an AnyEvent::XMPP::Client object. That's the door. There is no other door. Fr fr 🚪✨

---

🌸 METHODS 🌸

• connection () — hands you the AnyEvent::XMPP::IM::Connection object, but only if this account already has one. If it doesn't? You get undef. Sorry bestie 😭
• is_connected () — returns true if this account is connected. That's it. That's the whole method. (And yes, the original page spells it "accunt" — we're keeping that typo alive because it's part of the lore 💀)
• jid () — if the account is connected you get the full JID; if it's not connected you get the bare JID. Situational, but slay 💅
• bare_jid () — always gives you the bare JID of this account, and it's already had stringprep applied ✨ which is exactly why you can safely compare the JIDs that come back from this function. Comparison-ready, no cap.
• nickname () — your nickname for this account. Cute, personal, yours 🎀
• nickname_for_jid ($jid) — this one transforms $jid into a nickname 👑 Here's how: it looks $jid up in the roster and hunts for a nickname there. And if no nickname could be found in the roster? It just returns the node part of the $jid. Fallback queen behavior, honestly.
• send_tracked_message ($msg) — sends the AnyEvent::XMPP::IM::Message object that lives in $msg 💌 But heads up: the "to" attribute of the message gets adjusted by the conversation tracking mechanism. Not you adjusting it — the mechanism. Let it cook 🔥

---

🦋 EVENTS 🦋

For these events you can register callbacks (using the Object::Event interface) — go off, set those listeners 🌈

• tracked_message_destination => $bare_jid, $full_jid — this event fires whenever the message tracking mechanism changes (or sets) its destination resource for $bare_jid to $full_jid. Lowkey the most important event on this page, iykyk 👀
• removed — whenever the account gets removed from the AnyEvent::XMPP::Client (like, say, when it's disconnected), this event is emitted. Timing detail that matters: it's emitted before the account is destroyed. Say your goodbyes first 🥲💔

---

⭐ AUTHOR ⭐

Robin Redeker, "<elmex at ta-sa.org>", JID: "<elmex at jabber.org>" — the icon, the legend 👑

---

🍓 COPYRIGHT & LICENSE 🍓

Copyright 2007, 2008 Robin Redeker, all rights reserved.

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

---

Heads up: the copyright covers 2007 and 2008, and the license terms are "same as Perl itself" — that's the actual legal vibe, not a summary. Keep it in mind 🧚

---

and that's the page!! 🦋 This was perl v5.42.2, dated 2026-02-15 — thanks for reading with me bestie, mwah 💖🎀✨