www::finger(3pm) [debian man page]
WWW::Finger(3pm) User Contributed Perl Documentation WWW::Finger(3pm) 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 . " "; } DESCRIPTION
This module is not an implementation of the finger protocol (RFC 1288). Use Net::Finger for that. Instead it is a set of implementations of other methods for getting information from an e-mail address, or e-mail like identifier. This package includes four such implementations, and it's pretty easy to create your own additional implementations: o WebFinger o Fingerpoint o MetaCPAN API for cpan.org addresses o Unnamed finger protocol described on bitworking.org Constructor o "new" $finger = WWW::Finger->new($identifier); Creates a WWW::Finger object for a particular identifier. Will return undef if no implemetation is able to handle the identifier Object Methods Any of these methods can return undef if the appropriate information is not available. The "name", "mbox", "homepage", "weblog", "image" and "key" methods work in both scalar and list context. Depending on which implementation was used by "WWW::Finger->new", the object may also have additional methods. Consult the documentation of the various implementations for details. "name" The person's name (or handle/nickname). "mbox" The person's e-mail address (including "mailto:"). "homepage" The person's personal homepage. "weblog" The person's blog. (There may be some overlap with "homepage".) "image" An avatar, photo or other image depicting the person. "key" The URL of the person's GPG/PGP public key. "webid" A URI uniquely identifying the person. See <http://esw.w3.org/topic/WebID>. "endpoint" A SPARQL Protocol endpoint which may provide additional data about the person. (See RDF::Query::Client.) "graph" An RDF::Trine::Model object holding data about the person. (See RDF::Trine.) SEE ALSO
Net::Finger. <http://code.google.com/p/webfinger/>. <http://buzzword.org.uk/2009/fingerpoint/spec>. <http://www.perlrdf.org/>. fingerw. AUTHOR
Toby Inkster, <tobyink@cpan.org> COPYRIGHT AND LICENCE
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. perl v5.14.2 2012-02-23 WWW::Finger(3pm)
Check Out this Related Man Page
WWW::Finger::Webfinger(3pm) User Contributed Perl Documentation WWW::Finger::Webfinger(3pm) NAME
WWW::Finger::Webfinger - WWW::Finger module for Webfinger DESCRIPTION
Webfinger is currently a very unstable specification, with implementation details changing all the time. Given this instability, it seems prudent to describe the protocol, as implemented by this package. Given an e-mail-like identifier, the package will prepend "acct:" to it, assuming that the identifier doesn't already have a URI scheme. This identifier will now be called [ident]. The package looks up the host-meta file associated with the host for [ident]. It is assumed to be formatted according to the draft-hammer-hostmeta-05 Internet Draft http://tools.ietf.org/html/draft-hammer-hostmeta-05 <http://tools.ietf.org/html/draft-hammer- hostmeta-05> and XRD Working Draft 10 <http://www.oasis-open.org/committees/download.php/35274/xrd-1.0-wd10.html>. Both these drafts are dated 19 November 2009. A link template will be extracted from the host-meta for the host using either of the following two relationships: <http://lrdd.net/rel/descriptor>, <http://www.iana.org/assignments/relation/lrdd>. (Neither is prioritised, so if both exist and have different templates, hilarity will ensue.) The token "{uri}" in the link template will be replaced with the URL-encoded version of [ident] to create an account descriptor URI. The account descriptor URI is fetched via HTTP GET with an Accept header asking for RDF/XML, Turtle, RDF/JSON or XRD. The result is parsed for account description data if it has status code 200 (OK). The following relationships/properties are understood in the account description: o http://xmlns.com/foaf/0.1/name o http://xmlns.com/foaf/0.1/homepage o http://webfinger.net/rel/profile-page o http://xmlns.com/foaf/0.1/weblog o http://xmlns.com/foaf/0.1/mbox o http://webfinger.net/rel/avatar o http://xmlns.com/foaf/0.1/img o http://xmlns.com/foaf/0.1/depiction o http://ontologi.es/sparql#endpoint As well as the standard WWW::Finger methods, WWW::Finger::Webfinger provides this additional method: "get($p1, $p2, ...)" $p1, $p2 and are RDF predicate URIs, XRD Link@rel values, or XRD Property@type values # Returns phone numbers... $finger->get('http://xmlns.com/foaf/0.1/phone', 'http://rdf.data-vocabulary.org/#tel'); # Salmon-style magic keys $finger->get('magic-public-key'); SEE ALSO
WWW::Finger, XRD::Parser, HTTP::LRDD. <http://code.google.com/p/webfinger/>. AUTHOR
Toby Inkster, <tobyink@cpan.org> COPYRIGHT AND LICENCE
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. perl v5.14.2 2012-02-23 WWW::Finger::Webfinger(3pm)