# Copyright (c) 2008 by Ricardo Signes. All rights reserved.
# Licensed under terms of Perl itself (the "License").
# You may not use this file except in compliance with the License.
# A copy of the License was distributed with this file or you may obtain a
# copy of the License from http://dev.perl.org/licenses/
package Metabase::Index;
use Moose::Role;
our $VERSION = '0.001';
$VERSION = eval $VERSION;
requires 'add';
requires 'search';
sub exists {
my ($self, $guid) = @_;
return scalar @{ $self->search( guid => $guid ) };
}
1;
__END__
=pod
=head1 NAME
Metabase::Index - Interface for Metabase indexing
=head1 SYNOPSIS
package Metabase::Index::Bar;
use Metabase::Fact;
use Moose;
with 'Metabase::Index';
# define Moose attributes
sub add {
my ( $self, $fact ) = @_;
# index a fact
}
sub search {
my ( $self, %spec ) = @_;
# conduct search
return \@matches;
}
=head1 DESCRIPTION
This describes the interface for indexing and searching facts. Implementations
must provide the C<add> and C<search> methods.
=head1 USAGE
=head2 C<exists>
if ( $index->exists( $guid ) ) { do_stuff() }
This interface provides an C<exists> method that calls C<search()> and
returns a boolean value.
=head1 BUGS
Please report any bugs or feature using the CPAN Request Tracker.
Bugs can be submitted through the web interface at
L<http://rt.cpan.org/Dist/Display.html?Queue=Metabase>
When submitting a bug or request, please include a test-file or a patch to an
existing test-file that illustrates the bug or desired feature.
=head1 AUTHOR
=over
=item *
David A. Golden (DAGOLDEN)
=item *
Ricardo J. B. Signes (RJBS)
=back
=head1 COPYRIGHT AND LICENSE
Portions Copyright (c) 2008-2009 by David A. Golden
Portions Copyright (c) 2008-2009 by Ricardo J. B. Signes
Licensed under terms of Perl itself (the "License").
You may not use this file except in compliance with the License.
A copy of the License was distributed with this file or you may obtain a
copy of the License from http://dev.perl.org/licenses/
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.
=cut