File: README

package info (click to toggle)
libwww-finger-perl 0.105-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, sid, stretch
  • size: 388 kB
  • ctags: 294
  • sloc: perl: 3,790; makefile: 15
file content (98 lines) | stat: -rw-r--r-- 2,834 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
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
    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:

    *       WebFinger

    *       Fingerpoint

    *       MetaCPAN API for cpan.org addresses

    *       Unnamed finger protocol described on bitworking.org

  Constructor
    *       "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.