NAME

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

VERSION

       version 0.37

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