NAME

       Attean::API::MutableModel - Role representing mutable models

VERSION

       This document describes Attean::API::MutableModel version 0.033

SYNOPSIS

         use v5.14;
         use Attean;

DESCRIPTION

       This is a Moo role that mutable models consume. It defines the required methods for
       updating data, and provides default functionality.

ROLES

       This role consumes the Attean::API::Model role.

REQUIRED METHODS

       Classes consuming this role must provide the following methods:

       "add_quad( $quad )"
           Adds the Attean::API::Quad $quad to the model.

       "remove_quad( $quad )"
           Removes the Attean::API::Quad $quad from the model.

       "create_graph( $graph )"
           Creates a new, empty graph in the model with the Attean::API::BlankOrIRI identifier
           $graph. If the model does not support empty graphs, this operation may be a no-op.

       "drop_graph( $graph )"
           Removes the graph in the model with the Attean::API::BlankOrIRI identifier $graph.

       "clear_graph( $graph )"
           Removes all quads that belong to the graph in the model with the
           Attean::API::BlankOrIRI identifier $graph. If the model does not support empty graphs,
           this operation may be an alias for "drop_graph( $graph )".

METHODS

       This role provides default implementations of the following methods:

       "load_triples( $format, $graph => $data )"
           Parses the serialized triples contained in the string $data using the $format parser
           (see "get_parser" in Attean). Triples resulting from parsing are turned into quads
           using the $graph identifier, and added to the model.

       "load_triples_from_io( $format, $graph => $data )"
           Parses the serialized triples read from the filehandle $io using the $format parser
           (see "get_parser" in Attean). Triples resulting from parsing are turned into quads
           using the $graph identifier, and added to the model.

       "add_iter( $iter )"
           Adds all the quads from the Attean::API::QuadIterator $iter to the model.

       "add_list( $graph, @elements )"
           Adds an rdf:List encoded list of @elements to the model in the $graph.  Returns the
           Attean::API::Blank head of the list.

BUGS

       Please report any bugs or feature requests to through the GitHub web interface at
       <https://github.com/kasei/attean/issues>.

SEE ALSO

AUTHOR

       Gregory Todd Williams  "<gwilliams@cpan.org>"

COPYRIGHT

       Copyright (c) 2014--2022 Gregory Todd Williams.  This program is free software; you can
       redistribute it and/or modify it under the same terms as Perl itself.