NAME

Bread::Board::Literal - service providing a literal value

VERSION

version 0.36

SYNOPSIS

my $c = container PrettyBoring => as {

    # These are Bread::Board::Literal services
    service connect_string => 'dbi:mysql:boring_db';
    service service_url => 'http://api.example.com/v0/boring';

    # And some other services depending on them...

    service dbconn => (
        class => 'DBI',
        block => sub {
            my $s = shift;
            DBI->new($s->param('connect_string');
        },
        dependencies => wire_names(qw( connect_string )),
    );

    service service_request => (
        class => 'HTTP::Request',
        block => sub {
            my $s = shift;
            HTTP::Request->new(POST => $s->param('service_url'));
        },
        dependencies => wire_names(qw( service_url ));
    };
};

# OR to use directly:
my $literal = Bread::Board::Literal->new(
    name  => 'the_answer_to_life_the_universe_and_everything',
    value => 42,
);
$c->add_service($literal);

DESCRIPTION

A literal service is one that stores a literal scalar or reference for use in your Bread::Board.

Beware of using references in your literals as they may cause your Bread::Board to leak memory. If this is a concern, you may want to weaken your references.

See "weaken" in Scalar::Util.

ATTRIBUTES

value

Required attribute with read/write accessor. This is the value that "get" will return.

METHODS

get

Returns the "value", unaltered.

clone_and_inherit_params

Dies: a literal service is (essentially) a constant, it does not make sense to inherit from it.

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.