---
name: "Bread::Board::Types"
section: "3pm"
platform: "linux"
package: "libbread-board-perl"
version: "0.37-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Bread::Board::Types"
---

# Bread::Board::Types(3pm)

types and coercions for Bread::Board

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