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=6b8a84bd4d0ce1e7904ac87610cdfc48a9cafe22;hp=38f22ecf56956ec2065c871193f7fb5b2f688c20;hb=c77ec30d3f650b696438bc3dff1544f193efb54c;hpb=443f425372b86343ef8eb9815cfb58d359f727d0

diff --git a/lib/MooseX/Singleton.pm b/lib/MooseX/Singleton.pm
index 38f22ec..6b8a84b 100644
--- a/lib/MooseX/Singleton.pm
+++ b/lib/MooseX/Singleton.pm
@@ -1,28 +1,130 @@
 package MooseX::Singleton;
 
-use Moose::Role;
+use Moose 0.82 ();
+use Moose::Exporter;
+use MooseX::Singleton::Role::Object;
+use MooseX::Singleton::Role::Meta::Class;
+use MooseX::Singleton::Role::Meta::Instance;
 
-our $VERSION = 0.01;
+our $VERSION = '0.21';
+$VERSION = eval $VERSION;
 
-override new => sub {
-  my ($class) = @_;
+Moose::Exporter->setup_import_methods( also => 'Moose' );
 
-  no strict qw/refs/;
+sub init_meta {
+    shift;
+    my %p = @_;
 
-  my $instance = super;
+    Moose->init_meta(%p);
 
-  ${"$class\::singleton"} = $instance;
+    my $caller = $p{for_class};
 
-  return $instance;
-};
+    Moose::Util::MetaRole::apply_metaclass_roles(
+        for_class       => $caller,
+        metaclass_roles => ['MooseX::Singleton::Role::Meta::Class'],
+        instance_metaclass_roles =>
+            ['MooseX::Singleton::Role::Meta::Instance'],
+        constructor_class_roles =>
+            ['MooseX::Singleton::Role::Meta::Method::Constructor'],
+    );
 
-sub instance {
-  my ($class) = @_;
+    Moose::Util::MetaRole::apply_base_class_roles(
+        for_class => $caller,
+        roles =>
+            ['MooseX::Singleton::Role::Object'],
+    );
 
-  no strict qw/refs/;
-
-  return ${"$class\::singleton"};
+    return $caller->meta();
 }
 
+
 1;
 
+__END__
+
+=pod
+
+=head1 NAME
+
+MooseX::Singleton - turn your Moose class into a singleton
+
+=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<MooseX::Singleton> lets you easily upgrade (or downgrade, as it were) your
+L<Moose> class to a singleton.
+
+All you should need to do to transform your class is to change C<use Moose> to
+C<use MooseX::Singleton>. 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<MooseX::Singleton> gives your class an C<instance> method that can be used to
+get a handle on the singleton. It's actually just an alias for C<new>.
+
+Alternatively, C<< YourPackage->method >> should just work. This includes
+accessors.
+
+If you need to reset your class's singleton object for some reason (e.g.
+tests), you can call C<< YourPackage->_clear_instance >>.
+
+=head1 TODO
+
+=over
+
+=item Always more tests and doc
+
+=item Fix speed boost
+
+C<instance> invokes C<new> 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 E<lt>sartak@gmail.comE<gt>
+
+Dave Rolsky E<lt>autarch@urth.orgE<gt>
+
+=head1 SOME CODE STOLEN FROM
+
+Anders Nor Berle E<lt>debolaz@gmail.comE<gt>
+
+=head1 AND PATCHES FROM
+
+Ricardo SIGNES E<lt>rjbs@cpan.orgE<gt>
+
+=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
+