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.