NAME

       Attean::TripleModel - RDF model backed by a set of triple-stores

VERSION

       This document describes Attean::TripleModel version 0.033

SYNOPSIS

         use v5.14;
         use Attean;
         my $model = Attean::TripleModel->new( stores => {
           'http://example.org/graph1' => $store1,
           'http://example.org/graph2' => $store2,
         } );

DESCRIPTION

       The Attean::TripleModel class represents a model that is backed by a set of
       Attean::API::TripleStore objects, identified by an IRI string. It conforms to the
       Attean::API::Model role.

       The Attean::TripleModel constructor requires one named argument:

       stores
           A hash mapping graph IRI values to Attean::API::TripleStore objects representing the
           backing triple-store for that graph.

METHODS

       "size"
       "count_quads"
       "count_quads_estimate"
       "holds"
       "get_graphs"
       "get_quads ( $subject, $predicate, $object, $graph )"
           Returns an Attean::API::Iterator for quads in the model that match the supplied
           $subject, $predicate, $object, and $graph.  Any of these terms may be undefined or a
           Attean::API::Variable object, in which case that term will be considered as a wildcard
           for the purposes of matching.

           The returned iterator conforms to both Attean::API::Iterator and
           Attean::API::QuadIterator.

       "plans_for_algebra( $algebra, $planner, $active_graphs, $default_graphs )"
           Delegates to an underlying store if the active graph is bound to the store, and the
           store consumes Attean::API::CostPlanner.

       "cost_for_plan( $plan )"
           Attempts to delegate to all the underlying stores if that store consumes
           Attean::API::CostPlanner.

       "add_store( $graph => $store )"
           Add the Attean::TripleStore $store object to the model using the IRI string value
           $graph as the graph name.

       "create_graph( $graph )"
           Create a new Attean::TripleStore and add it to the model using the Attean::API::IRI
           $graph as the graph name.

           The store is constructed by using this object's "store_constructor" attribute:

             my $store = $self->store_constructor->($graph);

       "drop_graph( $graph )"
           Removes the store associated with the given $graph.

       "add_quad ( $quad )"
           Adds the specified $quad to the underlying model.

       "remove_quad ( $quad )"
           Removes the specified $quad from the underlying store.

       "drop_graph( $graph )"
           Removes the store associated with the given $graph.

       "clear_graph( $graph )"
           Removes all quads with the given $graph.

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.