The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

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

RDF::vCard.

http://www.w3.org/Submission/vcard-rdf/.

http://www.perlrdf.org/.

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.