NAME

XML::FOAF - Parse FOAF (Friend of a Friend) data

SYNOPSIS

    use XML::FOAF;
    use URI;
    my $foaf = XML::FOAF->new(URI->new('http://foo.com/my.foaf'));
    print $foaf->person->mbox, "\n";

DESCRIPTION

XML::FOAF provides an object-oriented interface to FOAF (Friend of a Friend) data.

USAGE

XML::FOAF->new($data [, $base_uri ])

Reads in FOAF data from $data and parses it. Returns a XML::FOAF object on success, "undef" on error. If an error occurs, you can call

    XML::FOAF->errstr

to get the text of the error.

$base_uri is the base URI to be used in constructing absolute URLs from resources defined in your FOAF data, and is required unless $data is a URI object, in which case the $base_uri can be obtained from that URI.

$data can be any of the following:

A URI object
An object blessed into any URI subclass. For example:
```
    my $uri = URI->new('http://foo.com/my.foaf');
    my $foaf = XML::FOAF->new($uri);
    
```
The URI can be either for a FOAF file (for example, the above), or an HTML page containing a "<link>" tag for FOAF auto-discovery:
```
    <link rel="meta" type="application/rdf+xml" title="FOAF" href="http://foo.com/my.foaf" />
    
```
If the URI points to an HTML page with FOAF auto-discovery enabled, XML::FOAF will parse the HTML to find the FOAF file automatically.

A scalar reference

This indicates a reference to a string containing the FOAF data. For example:

    my $foaf_data = <<FOAF;
    ...
    FOAF
    my $foaf = XML::FOAF->new(\$foaf_data, 'http://foo.com');

A filehandle

An open filehandle from which the FOAF data can be read. For example:

    open my $fh, 'my.foaf' or die $!;
    my $foaf = XML::FOAF->new($fh, 'http://foo.com');

A file name
A simple scalar containing the name of a file containing the FOAF data. For example:
```
    my $foaf = XML::FOAF->new('my.foaf', 'http://foo.com');
    
```

$foaf->person

Returns a XML::FOAF::Person object representing the main identity in the FOAF file.

$foaf->assurance

If the FOAF file indicates a PGP signature in wot:assurance, the URL for the detatched signature file will be returned, "undef" otherwise.

$foaf->verify

Attempts to verify the FOAF file using the PGP signature returned from assurance. verify will fetch the public key associated with the signature from a keyserver. If no PGP signature is noted in the FOAF file, or if an error occurs, "undef" is returned. If the signature is invalid, 0 is returned. If the signature is valid, the PGP identity (name and email address, generally) of the signer is returned.

Requires Crypt::OpenPGP to be installed.

REFERENCES

http://xmlns.com/foaf/0.1/

http://rdfweb.org/foaf/

LICENSE

XML::FOAF is free software; you may redistribute it and/or modify it under the same terms as Perl itself.