X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDevel%2FGlobalDestruction.pm;h=dc7be3ff8a8765d06814d32c2f89ab78da460ea9;hb=9d5ad1437b7ce54305830df01e1ce0d8bcbfed35;hp=901f1adc2eebe7881ed087b9585ae506f11aa3b8;hpb=e7a04eb90d3a3b6593a0b61c2e21d7331304927e;p=p5sagit%2FDevel-GlobalDestruction.git diff --git a/lib/Devel/GlobalDestruction.pm b/lib/Devel/GlobalDestruction.pm index 901f1ad..dc7be3f 100644 --- a/lib/Devel/GlobalDestruction.pm +++ b/lib/Devel/GlobalDestruction.pm @@ -1,56 +1,97 @@ -#!/usr/bin/perl - package Devel::GlobalDestruction; use strict; use warnings; -use vars qw($VERSION @ISA); +our $VERSION = '0.05'; + +use Sub::Exporter -setup => { + exports => [ qw(in_global_destruction) ], + groups => { default => [ -all ] }, +}; + +if (defined ${^GLOBAL_PHASE}) { + eval 'sub in_global_destruction () { ${^GLOBAL_PHASE} eq q[DESTRUCT] }'; +} +elsif (eval { + require XSLoader; + XSLoader::load(__PACKAGE__, $VERSION); + 1; +}) { + # the eval already installed everything, nothing to do +} +else { -BEGIN { - $VERSION = '0.02'; + # 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; - local $@; + eval <<'PP_IGD' or die $@; - eval { - require XSLoader; - __PACKAGE__->XSLoader::load($VERSION); - 1; - } or do { - require DynaLoader; - push @ISA, 'DynaLoader'; - __PACKAGE__->bootstrap($VERSION); - }; +my ($in_global_destruction, $before_is_installed); + +sub in_global_destruction { $in_global_destruction } + +END { + $in_global_destruction = 1; } -use Sub::Exporter -setup => { - exports => [ qw(in_global_destruction) ], - groups => { default => [ -all ] }, -}; +# threads do not execute the global ENDs (it would be stupid). However +# one can register a new END via simple string eval 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 evaled in a CLONE is ignored :( +# Hence blatantly hooking threads::create + +if ($INC{'threads.pm'}) { + my $orig_create = threads->can('create'); + no warnings 'redefine'; + *threads::create = sub { + { local $@; eval 'END { $in_global_destruction = 1 }' }; + 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__ ]}"); + } +} + +1; # keep eval happy + +PP_IGD + +} + +1; # keep require happy -__END__ -=pod +__END__ =head1 NAME -Devel::GlobalDestruction - Expose PL_dirty, the flag which marks global +Devel::GlobalDestruction - Expose the flag which marks global 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 @@ -72,26 +113,26 @@ This module uses L so the exports may be renamed, aliased, etc. =item in_global_destruction -Returns the current value of C. +Returns true if the interpreter is in global destruction. In perl 5.14+, this +returns C<${^GLOBAL_PHASE} eq 'DESTRUCT'>, and on earlier perls, it returns the +current value of C. =back -=head1 VERSION CONTROL +=head1 AUTHORS -This module is maintained using Darcs. You can get the latest version from -L, and use C to commit -changes. +Yuval Kogman Enothingmuch@woobling.orgE -=head1 AUTHOR +Florian Ragwitz Erafl@debian.orgE -Yuval Kogman Enothingmuch@woobling.orgE +Jesse Luehrs Edoy@tozt.netE + +Peter Rabbitson Eribasushi@cpan.orgE =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. + 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 - -