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.