.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Bread::Board::LifeCycle::Singleton 3pm"
.TH Bread::Board::LifeCycle::Singleton 3pm "2020-04-01" "perl v5.30.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Bread::Board::LifeCycle::Singleton \- service role for singleton lifecycle
.SH "VERSION"
.IX Header "VERSION"
version 0.37
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Sub-role of Bread::Board::LifeCycle, this role defines the
\&\*(L"singleton\*(R" lifecycle for a service. The \f(CW\*(C`get\*(C'\fR method will only do
its work the first time it is invoked; subsequent invocations will
return the same object.
.SH "ATTRIBUTES"
.IX Header "ATTRIBUTES"
.ie n .SS """instance"""
.el .SS "\f(CWinstance\fP"
.IX Subsection "instance"
The object build by the last call to \f(CW\*(C`get\*(C'\fR to actually do any work,
and returned by any subsequent call to \f(CW\*(C`get\*(C'\fR.
.SH "METHODS"
.IX Header "METHODS"
.ie n .SS """get"""
.el .SS "\f(CWget\fP"
.IX Subsection "get"
The first time this is called (or the first time after calling
\&\*(L"flush_instance\*(R"), the actual \f(CW\*(C`get\*(C'\fR method will be invoked, and its
return value cached in the \*(L"instance\*(R" attribute. The value of that
attribute will always be returned, so you can call \f(CW\*(C`get\*(C'\fR as many time
as you need, and always receive the same instance.
.ie n .SS """has_instance"""
.el .SS "\f(CWhas_instance\fP"
.IX Subsection "has_instance"
Predicate for the \*(L"instance\*(R" attribute.
.ie n .SS """flush_instance"""
.el .SS "\f(CWflush_instance\fP"
.IX Subsection "flush_instance"
Clearer for the \*(L"instance\*(R" attribute. Clearing the attribute will
cause the next call to \f(CW\*(C`get\*(C'\fR to instantiate a new object.
.SH "AUTHOR"
.IX Header "AUTHOR"
Stevan Little <stevan@iinteractive.com>
.SH "BUGS"
.IX Header "BUGS"
Please report any bugs or feature requests on the bugtracker website
https://github.com/stevan/BreadBoard/issues
.PP
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.
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
This software is copyright (c) 2019, 2017, 2016, 2015, 2014, 2013, 2011, 2009 by Infinity Interactive.
.PP
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.