/ 
Bread-Board-0.36
River stage two • 12 direct dependents • 18 total dependents
/ Bread::Board::Types

NAME

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

VERSION

version 0.36

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) 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.