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, %options)"

           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.

           There is currently only one supported option: "lang" which takes an ISO language code indicating  the
           default language of text within the vCard data.

       •   "import_fh($filehandle, %options)"

           As per "import_file", but operates on a file handle.

       •   "import_string($string, %options)"

           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.

           Sends an HTTP Accept header of:

             text/directory;profile=vCard,
             text/vcard,
             text/x-vcard,
             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.

perl v5.20.2                                       2014-09-17                          RDF::vCard::Importer(3pm)