NAME
   RDF::KV - Embed RDF linked data in plain old HTML forms

VERSION
   Version 0.07

SYNOPSIS
       my $kv = RDF::KV->new(
           subject    => $uri,      # ordinarily the Request-URI
           graph      => $graphuri, # URI for the default graph
           namespaces => $ns,       # default namespace prefix map
           callback   => \&rewrite, # form-results-rewriting callback
       );

       # Processes a hashref-of-parameters, like found in Catalyst or
       # Plack::Request. This call will ignore obviously non-matching
       # keys, but will croak on botched attempts to use the protocol.

       my $patch = eval { $kv->process($params) };
       if ($@) {
           # return 409 Conflict ...
       }

       # add/remove statements from the graph
       $patch->apply($model);

DESCRIPTION
   This module provides a reference implementation for the RDF-KV protocol
   <http://doriantaylor.com/rdf-kv>. The objective of this protocol is to
   convey RDF linked data from a web browser to a web server using no
   mechanism beyond conventional "application/x-www-form-urlencoded" HTML
   forms. The overarching purpose is to facilitate the development of
   linked data applications by making the apparatus of JavaScript an
   *optional*, rather than a *mandatory*, consideration.

   This protocol implementation works by culling key-value pairs denoted in
   a prescribed syntax from POSTed form input (parsed by something like
   CGI, Plack::Request or Catalyst), and then stitching them together to
   create a patch object which is then applied to an RDF::Trine::Model
   graph.

METHODS
 new
   Instantiate the object. The following parameters are also (read-only)
   accessors.

   subject
       This is the default subject URI (or blank node).

   graph
       This is the default graph URI.

   namespaces
       This URI::NamespaceMap object will enable URI abbreviation through
       the use of CURIEs in form input.

   callback
       Supply a callback function that will be applied to subject and
       object values, for instance to rewrite a URI. The return value of
       this function must be understood by "add_this" in RDF::KV::Patch.

 process \%CONTENT
   Process form content and return an RDF::KV::Patch object. This is the
   only significant method.

CAVEATS
   BYOS == Bring Your Own Security.

AUTHOR
   Dorian Taylor, "<dorian at cpan.org>"

BUGS
   Please report any bugs or feature requests to "bug-rdf-kv at
   rt.cpan.org", or through the web interface at
   <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=RDF-KV>. I will be
   notified, and then you'll automatically be notified of progress on your
   bug as I make changes.

SUPPORT
   You can find documentation for this module with the perldoc command.

       perldoc RDF::KV

   You can also look for information at:

   *   RT: CPAN's request tracker (report bugs here)

       <http://rt.cpan.org/NoAuth/Bugs.html?Dist=RDF-KV>

   *   AnnoCPAN: Annotated CPAN documentation

       <http://annocpan.org/dist/RDF-KV>

   *   CPAN Ratings

       <http://cpanratings.perl.org/d/RDF-KV>

   *   Search CPAN

       <http://search.cpan.org/dist/RDF-KV/>

SEE ALSO
   RDF::KV::Patch
   URI::BNode
   RDF::Trine

LICENSE AND COPYRIGHT
   Copyright 2013 Dorian Taylor.

   Licensed under the Apache License, Version 2.0 (the "License"); you may
   not use this file except in compliance with the License. You may obtain
   a copy of the License at <http://www.apache.org/licenses/LICENSE-2.0>.

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.