/usr/share/perl5/KiokuDB/Backend/Role/Scan.pm is in libkiokudb-perl 0.56-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 | package KiokuDB::Backend::Role::Scan;
BEGIN {
$KiokuDB::Backend::Role::Scan::AUTHORITY = 'cpan:NUFFIN';
}
{
$KiokuDB::Backend::Role::Scan::VERSION = '0.56';
}
use Moose::Role;
# ABSTRACT: Root set iteration
sub entries_to_ids {
my $stream = shift;
$stream->filter(sub {[ map { $_->id } @$_ ]});
}
use namespace::clean -except => 'meta';
requires "all_entries";
sub root_entries {
my $self = shift;
return $self->all_entries->filter(sub {[ grep { $_->root } @$_ ]});
}
sub child_entries {
my $self = shift;
return $self->all_entries->filter(sub {[ grep { not $_->root } @$_ ]});
}
sub all_entry_ids {
my $self = shift;
entries_to_ids($self->all_entries);
}
sub root_entry_ids {
my $self = shift;
entries_to_ids($self->root_entries);
}
sub child_entry_ids {
my $self = shift;
entries_to_ids($self->child_entries);
}
__PACKAGE__
__END__
=pod
=head1 NAME
KiokuDB::Backend::Role::Scan - Root set iteration
=head1 VERSION
version 0.56
=head1 SYNOPSIS
with qw(KiokuDB::Backend::Role::Scan);
sub all_entries {
my $self = shift;
# return all root set entries
return Data::Stream::Bulk::Foo->new(...);
}
=head1 DESCRIPTION
This is a role for iterative scanning of all entries in a backend.
It is used for database backups, and various other tasks.
=head1 REQUIRED METHODS
=over 4
=item all_entries
Should return a L<Data::Stream::Bulk> stream enumerating all entries in the
database.
=back
=head1 OPTIONAL METHODS
These method have default implementations defined in terms of C<all_entries>
but maybe overridden if there is a more optimal solution than just filtering
that stream.
=over 4
=item root_entries
Should return a L<Data::Stream::Bulk> of just the root entries.
=item child_entries
Should return a L<Data::Stream::Bulk> of everything but the root entries.
=back
=head1 AUTHOR
Yuval Kogman <nothingmuch@woobling.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Yuval Kogman, Infinity Interactive.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|