X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDevel%2FGlobalDestruction.pm;h=0854e9e562f732428d22f7dd962976f81317a1d3;hb=b0a035507f914f06e89ef9ddbaafb3bd7a049777;hp=8cf559c61febd481f5dfa816bce4f3f4e64e14ea;hpb=aaa7f60fc32505c436095fb1e5a91b8bc11f3e3a;p=p5sagit%2FDevel-GlobalDestruction.git

diff --git a/lib/Devel/GlobalDestruction.pm b/lib/Devel/GlobalDestruction.pm
index 8cf559c..0854e9e 100644
--- a/lib/Devel/GlobalDestruction.pm
+++ b/lib/Devel/GlobalDestruction.pm
@@ -1,31 +1,113 @@
-#!/usr/bin/perl
-
 package Devel::GlobalDestruction;
 
 use strict;
 use warnings;
 
-use XSLoader;
-
-our $VERSION = '0.04';
+our $VERSION = '0.08';
 
-use Sub::Exporter -setup => {
-	exports => [ qw(in_global_destruction) ],
-	groups  => { default => [ -all ] },
+use Sub::Exporter::Progressive -setup => {
+  exports => [ qw(in_global_destruction) ],
+  groups  => { default => [ -all ] },
 };
 
+# we run 5.14+ - everything is in core
+#
 if (defined ${^GLOBAL_PHASE}) {
-    eval 'sub in_global_destruction () { ${^GLOBAL_PHASE} eq q[DESTRUCT] }';
+  eval 'sub in_global_destruction () { ${^GLOBAL_PHASE} eq q[DESTRUCT] }';
+}
+# try to load the xs version if it was compiled
+#
+elsif (eval {
+  require XSLoader;
+  XSLoader::load(__PACKAGE__, $VERSION);
+  1;
+}) {
+  # the eval already installed everything, nothing to do
 }
+# Not core nor XS
+# The whole thing is in an eval to prevent perl from parsing it in the
+# first place under perls where none of this is needed
+#
 else {
-    XSLoader::load(__PACKAGE__, $VERSION);
+  eval <<'PP_IGD' or die $@;
+
+# SpeedyCGI runs END blocks every cycle but somehow keeps object instances
+# hence DIAF
+die("The pure-perl version of @{[__PACKAGE__]} can not function correctly under CGI::SpeedyCGI. "
+  . "Please ensure you have a working compiler, and reinstall @{[__PACKAGE__]} to enable the XS "
+  . "codepath.\n"
+) if $CGI::SpeedyCGI::i_am_speedy;
+
+my ($in_global_destruction, $before_is_installed);
+
+sub in_global_destruction () { $in_global_destruction }
+
+# end_av trick suggested by liz++
+require B;
+my $add_endblock = sub {
+  push @{ B::end_av()->object_2svref }, sub { $in_global_destruction = 1 };
+};
+
+# This block will fire towards the end of the program execution
+# Use it to inject an END block which is guaranteed to run last
+# (as long as something else doesn't inject yet another block in
+# the same manner afterwards, at which point it hardly matters
+# anyway)
+#
+END { $add_endblock->() }
+
+# threads do not execute the global ENDs (it would be stupid). However
+# one can register a new thread-local END from within a thread, and
+# achieve the same result. A logical place to do this would be CLONE, which
+# is claimed to run in the context of the new thread. However this does
+# not really seem to be the case - any END inserted in a CLONE is ignored :(
+# Hence blatantly hooking threads::create
+#
+if ($INC{'threads.pm'}) {
+  require Scalar::Util;
+
+  my $orig_create = threads->can('create');
+  no warnings 'redefine';
+
+  *threads::create = sub {
+    my $class = shift;
+    my $target = shift;
+
+    unless ( (Scalar::Util::reftype($target)||'') eq 'CODE' ) {
+      no strict 'refs';
+      $target = \&{ caller() . "::$target" };
+    }
+
+    @_ = (
+      $class,
+      sub { $add_endblock->(); goto $target },
+      @_,
+    );
+
+    goto $orig_create;
+  };
+
+  $before_is_installed = 1;
 }
 
-__PACKAGE__
+# just in case threads got loaded after us (silly)
+sub CLONE {
+  unless ($before_is_installed) {
+    require Carp;
+    Carp::croak("You must load the 'threads' module before @{[ __PACKAGE__ ]}");
+  }
+}
 
-__END__
+1;  # keep eval happy
+
+PP_IGD
+
+}
+
+1;  # keep require happy
 
-=pod
+
+__END__
 
 =head1 NAME
 
@@ -34,16 +116,16 @@ destruction.
 
 =head1 SYNOPSIS
 
-	package Foo;
-	use Devel::GlobalDestruction;
+    package Foo;
+    use Devel::GlobalDestruction;
 
-	use namespace::clean; # to avoid having an "in_global_destruction" method
+    use namespace::clean; # to avoid having an "in_global_destruction" method
 
-	sub DESTROY {
-		return if in_global_destruction;
+    sub DESTROY {
+        return if in_global_destruction;
 
-		do_something_a_little_tricky();
-	}
+        do_something_a_little_tricky();
+    }
 
 =head1 DESCRIPTION
 
@@ -59,7 +141,8 @@ destruction is in effect.
 
 =head1 EXPORTS
 
-This module uses L<Sub::Exporter> so the exports may be renamed, aliased, etc.
+This module uses L<Sub::Exporter::Progressive> so the exports may be renamed,
+aliased, etc. if L<Sub::Exporter> is present.
 
 =over 4
 
@@ -71,12 +154,6 @@ current value of C<PL_dirty>.
 
 =back
 
-=head1 VERSION CONTROL
-
-This module is maintained using Darcs. You can get the latest version from
-L<http://nothingmuch.woobling.org/code>, and use C<darcs send> to commit
-changes.
-
 =head1 AUTHORS
 
 Yuval Kogman E<lt>nothingmuch@woobling.orgE<gt>
@@ -85,12 +162,16 @@ Florian Ragwitz E<lt>rafl@debian.orgE<gt>
 
 Jesse Luehrs E<lt>doy@tozt.netE<gt>
 
-=head1 COPYRIGHT
+Peter Rabbitson E<lt>ribasushi@cpan.orgE<gt>
 
-	Copyright (c) 2008 Yuval Kogman. All rights reserved
-	This program is free software; you can redistribute
-	it and/or modify it under the same terms as Perl itself.
+Arthur Axel 'fREW' Schmidt E<lt>frioux@gmail.comE<gt>
 
-=cut
+Elizabeth Mattijsen E<lt>liz@dijkmat.nlE<gt>
 
+=head1 COPYRIGHT
+
+    Copyright (c) 2008 Yuval Kogman. All rights reserved
+    This program is free software; you can redistribute
+    it and/or modify it under the same terms as Perl itself.
 
+=cut