X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMooseX-Singleton.git;a=blobdiff_plain;f=lib%2FMooseX%2FSingleton.pm;h=bc2b7ec1b1ab6077c8460faf07de1cbe687e0c56;hp=c0bb14d966bceb0cff12f28214366aa992b920f8;hb=283bf6e6d41ced93a6082f77c3f87addf88da4e7;hpb=1467693305140ae67c90d332344ef89d02d91fa4 diff --git a/lib/MooseX/Singleton.pm b/lib/MooseX/Singleton.pm index c0bb14d..bc2b7ec 100644 --- a/lib/MooseX/Singleton.pm +++ b/lib/MooseX/Singleton.pm @@ -1,25 +1,111 @@ package MooseX::Singleton; -use Moose::Role; -our $VERSION = 0.02; +use Moose 0.74 (); +use Moose::Exporter; +use MooseX::Singleton::Object; +use MooseX::Singleton::Meta::Class; -override new => sub { - my ($class) = @_; +our $VERSION = '0.16'; +$VERSION = eval $VERSION; - no strict 'refs'; +Moose::Exporter->setup_import_methods( also => 'Moose' ); - # create our instance if we don't already have one - if (!defined ${"$class\::singleton"}) { - ${"$class\::singleton"} = super; - } - - return ${"$class\::singleton"}; -}; - -# instance really is the same as new. any ideas for a better implementation? -sub instance { - shift->new(@_); +sub init_meta { + shift; + Moose->init_meta( + @_, + base_class => 'MooseX::Singleton::Object', + metaclass => 'MooseX::Singleton::Meta::Class', + ); } 1; +__END__ + +=pod + +=head1 NAME + +MooseX::Singleton - turn your Moose class into a singleton + +=head1 VERSION + +Version 0.16, released 24 May 08 + +=head1 SYNOPSIS + + package MyApp; + use MooseX::Singleton; + + has env => ( + is => 'rw', + isa => 'HashRef[Str]', + default => sub { \%ENV }, + ); + + package main; + + delete MyApp->env->{PATH}; + my $instance = MyApp->instance; + my $same = MyApp->instance; + +=head1 DESCRIPTION + +A singleton is a class that has only one instance in an application. +C lets you easily upgrade (or downgrade, as it were) your +L class to a singleton. + +All you should need to do to transform your class is to change C to +C. This module uses a new class metaclass and instance +metaclass, so if you're doing metamagic you may not be able to use this. + +C gives your class an C method that can be used to get a handle on the singleton. It's actually just an alias for C. + +Alternatively, C<< YourPackage->method >> should just work. This includes +accessors. + +=head1 TODO + +=over + +=item Always more tests and doc + +=item Fix speed boost + +C invokes C every time C<< Package->method >> is called, which +incurs a nontrivial runtime cost. I've implemented a short-circuit for this +case, which does eliminate nearly all of the runtime cost. However, it's ugly +and should be fixed in a more elegant way. + +=back + +=head1 BUGS + +All complex software has bugs lurking in it, and this module is no +exception. If you find a bug please either email me, or add the bug +to cpan-RT. + +=head1 AUTHORS + +Shawn M Moore Esartak@gmail.comE + +Dave Rolsky Eautarch@urth.orgE + +=head1 SOME CODE STOLEN FROM + +Anders Nor Berle Edebolaz@gmail.comE + +=head1 AND PATCHES FROM + +Ricardo SIGNES Erjbs@cpan.orgE + +=head1 COPYRIGHT AND LICENSE + +Copyright 2007, 2008 Infinity Interactive + +This program is free software; you can redistribute it and/or modify it under +the same terms as Perl itself. + +=cut +