/usr/share/perl5/Bread/Board/Traversable.pm is in libbread-board-perl 0.32-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 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 | package Bread::Board::Traversable;
BEGIN {
$Bread::Board::Traversable::AUTHORITY = 'cpan:STEVAN';
}
$Bread::Board::Traversable::VERSION = '0.32';
use Moose::Role;
with 'MooseX::Clone' => { -version => 0.05 };
has 'parent' => (
is => 'rw',
isa => 'Bread::Board::Traversable',
weak_ref => 1,
clearer => 'detach_from_parent',
predicate => 'has_parent',
);
sub get_root_container {
my $c = shift;
while ($c->has_parent) {
$c = $c->parent;
}
return $c;
}
sub fetch {
my ($self, $path) = @_;
my $root;
if ($path =~ /^\//) {
$root = $self->get_root_container;
}
else {
$root = $self;
while (!$root->isa('Bread::Board::Container')) {
$root = $root->parent;
}
}
my @path = grep { $_ } split /\// => $path;
if ($path[0] eq '..') {
my $c = $root;
do {
shift @path;
$c = $c->parent
|| confess "Expected parent for " . $c->name . " but found none";
} while (defined $path[0] && $path[0] eq '..' && $c->has_parent);
$root = $c;
}
return $root unless @path;
my $c = $root;
while (my $h = shift @path) {
$c = _get_container_or_service($c, $h);
}
if (!$self->isa('Bread::Board::Service::Alias')) {
my %seen;
while ($c->isa('Bread::Board::Service::Alias')) {
$c = $c->aliased_from;
confess "Cycle detected in aliases" if exists $seen{$c};
$seen{$c}++;
}
}
return $c;
}
sub _get_container_or_service {
my ($c, $name) = @_;
(blessed $c)
|| confess "Expected object, got $c";
if ($c->isa('Bread::Board::Dependency')) {
# make sure to evaluate this from the parent
return _get_container_or_service($c->parent->parent, $name);
}
if ($c->does('Bread::Board::Service::WithDependencies')) {
return $c->get_dependency($name) if $c->has_dependency($name);
confess "Could not find dependency ($name) from service " . $c->name;
}
# name() is implemented in Service and Container
# get_sub_container and get_service is implemented in Container
# there must be a better way to do this
if ($c->does('Bread::Board::Service')) {
if ($c->name eq $name) {
warn "Traversing into the current service ($name) is deprecated."
. " You should remove the $name component from the path.";
return $c;
}
}
elsif ($c->isa('Bread::Board::Container')) {
if ($c->name eq $name) {
warn "Traversing into the current container ($name) is deprecated;"
. " you should remove the $name component from the path";
return $c;
}
return $c->get_sub_container($name) if $c->has_sub_container($name);
return $c->get_service($name) if $c->has_service($name);
}
confess "Could not find container or service for $name in " . $c->name;
}
no Moose::Role; 1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Bread::Board::Traversable
=head1 VERSION
version 0.32
=head1 SYNOPSIS
=head1 DESCRIPTION
=head1 METHODS
=over 4
=item B<parent>
=item B<has_parent>
=item B<detach_from_parent>
=item B<get_root_container>
=item B<fetch>
=back
=head1 BUGS
All complex software has bugs lurking in it, and this module is no
exception. If you find a bug please either email me, or add the bug
to cpan-RT.
=head1 AUTHOR
Stevan Little <stevan@iinteractive.com>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by 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
|