NAME

       Bread::Board::Traversable - role for traversing a container service tree

VERSION

       version 0.37

SYNOPSIS

         my $service = $container->fetch('/some/service/path');

         my $root = $service->get_root_container;

DESCRIPTION

       This role provides the basic functionality to traverse a container / service tree. Instances of classes
       consuming this role will get a parent-child relationship between them.

ATTRIBUTES

   "parent"
       Weak ref to another Bread::Board::Traversable object, read/write accessor (although you should probably
       not change this value directly in normal code).

METHODS

   "has_parent"
       Predicate for the "parent" attribute, true if a parent has been set.

   "detach_from_parent"
       Clearer for the "parent" attribute, you should probably not call this method in normal code.

   "get_root_container"
       Returns the farthest ancestor of the invocant, i.e. the top-most container this object is a part of.

   "fetch"
         my $service = $this->fetch('/absolute/path');
         my $service = $this->fetch('relative/path');
         my $service = $this->fetch('../relative/path');

       Given a (relative or absolute) path to a service or container, this method walks the tree and returns the
       Bread::Board::Service or Bread::Board::Container instance for that path. Dies if no object can be found
       for the given path.

       Aliases are resolved in this call, by calling "aliased_from" until we get an actual service.

AUTHOR

       Stevan Little <stevan@iinteractive.com>

BUGS

       Please report any bugs or feature requests on the bugtracker website
       https://github.com/stevan/BreadBoard/issues

       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.

COPYRIGHT AND LICENSE

       This software is copyright (c) 2019, 2017, 2016, 2015, 2014, 2013, 2011, 2009 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.

perl v5.36.0                                       2022-12-12                     Bread::Board::Traversable(3pm)