NAME

       Bread::Board::LifeCycle::Singleton - service role for singleton lifecycle

VERSION

       version 0.37

DESCRIPTION

       Sub-role of Bread::Board::LifeCycle, this role defines the "singleton" lifecycle for a
       service. The "get" method will only do its work the first time it is invoked; subsequent
       invocations will return the same object.

ATTRIBUTES

   "instance"
       The object build by the last call to "get" to actually do any work, and returned by any
       subsequent call to "get".

METHODS

   "get"
       The first time this is called (or the first time after calling "flush_instance"), the
       actual "get" method will be invoked, and its return value cached in the "instance"
       attribute. The value of that attribute will always be returned, so you can call "get" as
       many time as you need, and always receive the same instance.

   "has_instance"
       Predicate for the "instance" attribute.

   "flush_instance"
       Clearer for the "instance" attribute. Clearing the attribute will cause the next call to
       "get" to instantiate a new object.

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.