WWW::Finger(3pm)

📦 version 0.105, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

✨ WWW::Finger ✨

okay bestie so this is the WWW::Finger page from the User Contributed Perl Documentation — like, the perl 5.32.1 era, dated 2021-09-11 💖 — and it's literally your girl for pulling cute lil' facts out of an email address. let's go 🦋

🌸 NAME 🌸

WWW::Finger — get useful data from e-mail addresses 💌

⭐ SYNOPSIS ⭐

use WWW::Finger;
my $finger = WWW::Finger->new("joe@example.com");
if (defined $finger)
{
  print $finger->name . "\n";
}

💅 DESCRIPTION 💅

okay so first thing's first, bestie: this is NOT an implementation of the finger protocol (RFC 1288). nope. not that. if that's what you want, go use Net::Finger, she's right there 🫶.

what this actually is: a whole lil' collection of implementations of other methods for getting info out of an e-mail address — or, like, an e-mail-adjacent identifier. this package ships with four of those implementations, and ngl making your own extra ones is pretty easy 👑

  • WebFinger 🌐
  • Fingerpoint 👉
  • MetaCPAN API for cpan.org addresses 🐪
  • Unnamed finger protocol described on bitworking.org 🕵️

🎀 Constructor 🎀

  • new
$finger = WWW::Finger->new($identifier);

makes you a shiny new WWW::Finger object for one specific identifier. and if no implementation is able to handle that identifier? it just returns undef. sad but true 😭

🧚 Object Methods 🧚

heads up: any of these can return undef if the info you're asking for just... isn't available 🙈. and the name, mbox, homepage, weblog, image and key methods work in both scalar and list context (versatile icons ✨).

also — depending on which implementation WWW::Finger->new ended up using, your object may have additional methods on top of these. for the deets on those, go read the docs for the various implementations, iykyk 💜

  • name — the person's name (or their handle/nickname) 💫
  • mbox — the person's e-mail address, mailto: included 📧
  • homepage — the person's personal homepage 🏠
  • weblog — the person's blog. (fair warning, there may be some overlap with homepage 👀)
  • image — an avatar, photo, or whatever other image depicts the person 🖼️
  • key — the URL of the person's GPG/PGP public key 🔑
  • webid — a URI that uniquely identifies the person. see <http://esw.w3.org/topic/WebID> 🆔
  • endpoint — a SPARQL Protocol endpoint that might have extra data about the person. (see RDF::Query::Client) 🔍
  • graph — an RDF::Trine::Model object holding data about the person. (see RDF::Trine) 📊

🌈 SEE ALSO 🌈

👑 AUTHOR 👑

Toby Inkster, <tobyink@cpan.org> 💖

Copyright (C) 2009-2012 by Toby Inkster

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

💀 DISCLAIMER OF WARRANTIES 💀

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

no cap bestie, that one's in all caps for a reason — it means exactly what it says 🙈

and that's the whole page, periodt 💅 this was WWW::Finger from perl v5.32.1, dated 2021-09-11 — love that for us, mwah 🎀🦋✨

📦 where this page comes from