NAME
RDF::vCard::Importer - import RDF data from vCard format
SYNOPSIS
use RDF::vCard;
use RDF::TrineShortcuts qw':all';
my $importer = RDF::vCard::Importer->new;
print $_
foreach $importer->import_file('contacts.vcf');
print rdf_string($importer->model => 'RDFXML');
DESCRIPTION
This module reads vCards and writes RDF.
Constructor
new(%options)
Returns a new RDF::vCard::Importer object and initialises it.
The only valid option currently is ua which can be set to an LWP::UserAgent for those rare occasions that the Importer needs to fetch stuff from the Web.
Methods
init
Reinitialise the importer. Forgets any cards that have already been imported.
model
Return an RDF::Trine::Model containing data for all cards that have been imported since the importer was last initialised.
import_file($filename)
Imports vCard data from a file on the file system.
The data is added to the importer's model (and can be retrieved using the
model
method).This function returns a list of RDF::vCard::Entity objects, so it's also possible to access the data that way.
import_fh($filehandle)
As per
import_file
, but operates on a file handle.import_string($string)
As per
import_file
, but operates on vCard data in a string.import_url($url)
As per
import_file
, but fetches vCard data from a Web address.Send an HTTP Accept header of:
text/directory;profile=vCard, text/vcard, text/x-vcard;q=0.5, text/directory;q=0.1
vCard Input
vCard 3.0 should be supported fairly completely. Some vCard 4.0 constructs will also work.
Much of the heavy lifting is performed by Text::vFile::asData, so this module may be affected by bugs in that distribution.
RDF Output
Output uses the newer of the 2010 revision of the W3C's vCard vocabulary http://www.w3.org/Submission/vcard-rdf/. (Note that even though this was revised in 2010, the term URIs include "2006" in them.)
Some extensions from the namespace http://buzzword.org.uk/rdf/vcardx# are also output.
The AGENT property is currently omitted from output. This will be added in a later version.
SEE ALSO
http://www.w3.org/Submission/vcard-rdf/.
AUTHOR
Toby Inkster <tobyink@cpan.org>.
COPYRIGHT
Copyright 2011 Toby Inkster
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.