Bread::Board::Types(3pm)

NAME
Bread::Board::Types - types and coercions for Bread::Board

VERSION
version 0.37

DESCRIPTION
This package defines types and coercions for Bread::Board.

TYPES

  "Bread::Board::Container::SubContainerList"
A hashref mapping strings to instances of Bread::Board::Container or Bread::Board::Container::Parameterized.

Can be coerced from an arrayref of containers: the keys will be the containers' names.

  "Bread::Board::Container::ServiceList"
A hashref mapping strings to instances of Bread::Board::Service.

Can be coerced from an arrayref of services: the keys will be the services' names.

  "Bread::Board::Service::Dependencies"
Hashref mapping strings to instances of Bread::Board::Dependency.

The values of the hashref can be coerced in several different ways:

a string
    will be interpreted as the "service_path"

a hashref with a single key
    the key will be interpreted as a "service_path", and the value as a hashref for "service_params"

an arrayref
    each element will be interpreted as a dependency (possibly through all the coercions listed here); see below for an example

a service object
    will be interpreted as a dependency on that service

a dependency object
    will be taken as-is

Instead of a hashref of any of the above things, you can use an arrayref: it will be coerced to hashref, using the (coerced) dependencies' names as keys.

Examples

   service foo => (
     class => 'Foo',
     dependencies => {
       { bar => { attribute => 12 } },
     },
   );

The service "foo" depends on the parameterized service "bar", and "bar" will be instantiated passing the hashref "{ attribute => 12 }" to its "get" method.

   service foo => (
     class => 'Foo',
     dependencies => {
       things => [ 'bar', 'baz' ],
     },
   );

The service "foo" depends on the services "bar" and "baz", and when instantiating "foo", its constructor will receive something like "things => [ $instance_of_bar, $instance_of_baz ]".

   service foo => (
     class => 'Foo',
     dependencies => {
       things => [
         { bar => { attribute => 12 } },
         { bar => { attribute => 27 } },
       ],
     },
   );

You can mix&match the coercions! This "foo" will get two different instances of "bar" in its "things" attribute, each "bar" instantiated with a different value.

  "Bread::Board::Service::Parameters"
Hashref mapping strings to MooseX::Params::Validate specifications.

Can be coerced from an arrayref of strings:

  [qw(a b c)]

becomes:

  {
    a => { optional => 0 },
    b => { optional => 0 },
    c => { optional => 0 },
  }

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.