cpan/Test-Simple - Update to version 1.302207

1.302207 2024-12-27 18:13:18-08:00 America/Los_Angeles - Fix debugging info when JSON::MaybeXS is missing (Thanks James E Keenan) - Fix typos (Thanks sobrado8086) - Add TEST2_ENABLE_PLUGINS env var - Add Test2::Env docs
Perl · Jan 5, 2025 · d7e5e27 · d7e5e27
1 parent a08b8bd
commit d7e5e27
Show file tree

Hide file tree

Showing 198 changed files with 379 additions and 200 deletions.
diff --git a/MANIFEST b/MANIFEST
@@ -2586,6 +2586,7 @@ cpan/Test-Simple/lib/Test2/Compare/Set.pm					Test-Simple
 cpan/Test-Simple/lib/Test2/Compare/String.pm					Test-Simple
 cpan/Test-Simple/lib/Test2/Compare/Undef.pm					Test-Simple
 cpan/Test-Simple/lib/Test2/Compare/Wildcard.pm					Test-Simple
+cpan/Test-Simple/lib/Test2/Env.pm						Test-Simple
 cpan/Test-Simple/lib/Test2/Event.pm						Module related to Test::Simple
 cpan/Test-Simple/lib/Test2/Event/Bail.pm					Module related to Test::Simple
 cpan/Test-Simple/lib/Test2/Event/Diag.pm					Module related to Test::Simple

diff --git a/Porting/Maintainers.pl b/Porting/Maintainers.pl
@@ -1110,8 +1110,8 @@ package Maintainers;
     },
 
     'Test::Simple' => {
-        'DISTRIBUTION' => 'EXODIST/Test-Simple-1.302206.tar.gz',
-        'SYNCINFO'     => 'jkeenan on Mon Dec 23 16:57:46 2024',
+        'DISTRIBUTION' => 'EXODIST/Test-Simple-1.302207.tar.gz',
+        'SYNCINFO'     => 'jkeenan on Sun Jan  5 06:26:14 2025',
         'FILES'        => q[cpan/Test-Simple],
         'EXCLUDED'     => [
             qr{^examples/},

diff --git a/cpan/Test-Simple/lib/Test/Builder.pm b/cpan/Test-Simple/lib/Test/Builder.pm
@@ -4,7 +4,7 @@ use 5.006;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use Scalar::Util qw/blessed reftype weaken/;
 

diff --git a/cpan/Test-Simple/lib/Test/Builder/Formatter.pm b/cpan/Test-Simple/lib/Test/Builder/Formatter.pm
@@ -2,7 +2,7 @@ package Test::Builder::Formatter;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 BEGIN { require Test2::Formatter::TAP; our @ISA = qw(Test2::Formatter::TAP) }
 

diff --git a/cpan/Test-Simple/lib/Test/Builder/Module.pm b/cpan/Test-Simple/lib/Test/Builder/Module.pm
@@ -7,7 +7,7 @@ use Test::Builder;
 require Exporter;
 our @ISA = qw(Exporter);
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 =head1 NAME

diff --git a/cpan/Test-Simple/lib/Test/Builder/Tester.pm b/cpan/Test-Simple/lib/Test/Builder/Tester.pm
@@ -1,7 +1,7 @@
 package Test::Builder::Tester;
 
 use strict;
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use Test::Builder;
 use Symbol;

diff --git a/cpan/Test-Simple/lib/Test/Builder/Tester/Color.pm b/cpan/Test-Simple/lib/Test/Builder/Tester/Color.pm
@@ -1,7 +1,7 @@
 package Test::Builder::Tester::Color;
 
 use strict;
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 require Test::Builder::Tester;
 

diff --git a/cpan/Test-Simple/lib/Test/Builder/TodoDiag.pm b/cpan/Test-Simple/lib/Test/Builder/TodoDiag.pm
@@ -2,7 +2,7 @@ package Test::Builder::TodoDiag;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 BEGIN { require Test2::Event::Diag; our @ISA = qw(Test2::Event::Diag) }
 

diff --git a/cpan/Test-Simple/lib/Test/More.pm b/cpan/Test-Simple/lib/Test/More.pm
@@ -17,7 +17,7 @@ sub _carp {
     return warn @_, " at $file line $line\n";
 }
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use Test::Builder::Module;
 our @ISA    = qw(Test::Builder::Module);
@@ -395,7 +395,7 @@ different from some other value:
   isnt $obj, $clone, "clone() produces a different object";
 
 Historically we supported an C<isn't()> function as an alias of
-C<isnt()>, however in Perl 5.37.9 support for the use of aprostrophe as
+C<isnt()>, however in Perl 5.37.9 support for the use of apostrophe as
 a package separator was deprecated and by Perl 5.42.0 support for it
 will have been removed completely. Accordingly use of C<isn't()> is also
 deprecated, and will produce warnings when used unless 'deprecated'
@@ -2002,6 +2002,10 @@ comes from.
 
 L<Test::Most> Most commonly needed test functions and features.
 
+=head1 ENVIRONMENT VARIABLES
+
+See L<Test2::Env> for a list of meaningul environment variables.
+
 =head1 AUTHORS
 
 Michael G Schwern E<lt>[email protected]E<gt> with much inspiration

diff --git a/cpan/Test-Simple/lib/Test/Simple.pm b/cpan/Test-Simple/lib/Test/Simple.pm
@@ -4,7 +4,7 @@ use 5.006;
 
 use strict;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use Test::Builder::Module;
 our @ISA    = qw(Test::Builder::Module);

diff --git a/cpan/Test-Simple/lib/Test/Tester.pm b/cpan/Test-Simple/lib/Test/Tester.pm
@@ -16,7 +16,7 @@ use Test::Tester::Delegate;
 
 require Exporter;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 our @EXPORT = qw( run_tests check_tests check_test cmp_results show_space );
 our @ISA = qw( Exporter );

diff --git a/cpan/Test-Simple/lib/Test/Tester/Capture.pm b/cpan/Test-Simple/lib/Test/Tester/Capture.pm
@@ -2,7 +2,7 @@ use strict;
 
 package Test::Tester::Capture;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 use Test::Builder;

diff --git a/cpan/Test-Simple/lib/Test/Tester/CaptureRunner.pm b/cpan/Test-Simple/lib/Test/Tester/CaptureRunner.pm
@@ -3,7 +3,7 @@ use strict;
 
 package Test::Tester::CaptureRunner;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 use Test::Tester::Capture;

diff --git a/cpan/Test-Simple/lib/Test/Tester/Delegate.pm b/cpan/Test-Simple/lib/Test/Tester/Delegate.pm
@@ -3,7 +3,7 @@ use warnings;
 
 package Test::Tester::Delegate;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use Scalar::Util();
 

diff --git a/cpan/Test-Simple/lib/Test/use/ok.pm b/cpan/Test-Simple/lib/Test/use/ok.pm
@@ -1,7 +1,7 @@
 package Test::use::ok;
 use 5.005;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 __END__

diff --git a/cpan/Test-Simple/lib/Test2.pm b/cpan/Test-Simple/lib/Test2.pm
@@ -2,7 +2,7 @@ package Test2;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 1;

diff --git a/cpan/Test-Simple/lib/Test2/API.pm b/cpan/Test-Simple/lib/Test2/API.pm
@@ -10,7 +10,7 @@ BEGIN {
     $ENV{TEST2_ACTIVE} = 1;
 }
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 my $INST;
@@ -808,6 +808,39 @@ sub run_subtest {
 # called.
 require Test2::API::Context;
 
+# If the env var was set to load plugins, load them now, this is the earliest
+# safe point to do so.
+if (my $plugins = $ENV{TEST2_ENABLE_PLUGINS}) {
+    for my $p (split /\s*,\s*/, $plugins) {
+        $p = "Test2::Plugin::$p" unless $p =~ s/^\+//;
+        my $mod = "$p.pm";
+        $mod =~ s{::}{/}g;
+
+        if ($ENV{HARNESS_IS_VERBOSE} || !$ENV{HARNESS_ACTIVE}) {
+            # If the harness is verbose then just display the message for all to
+            # see. It is nice info and they already asked for noisy output.
+
+            test2_add_callback_post_load(sub {
+                test2_stack()->top; # Ensure we have at least 1 hub.
+                my ($hub) = test2_stack()->all;
+                $hub->send(
+                    Test2::Event::Note->new(
+                        trace => Test2::Util::Trace->new(frame => [__PACKAGE__, __FILE__, __LINE__, $p]),
+                        message => "Loaded plugin '$p' as specified in the TEST2_ENABLE_PLUGINS env var.",
+                    ),
+                );
+            });
+        }
+
+        eval {
+            package main;
+            require $mod;
+            $p->import;
+            1
+        } or die "Could not load plugin '$p', which was specified in the TEST2_ENABLE_PLUGINS env var ($plugins): $@";
+    }
+}
+
 1;
 
 __END__
@@ -911,6 +944,10 @@ documentation for details on how to best use it.
 
     ... And others ...
 
+=head1 ENVIRONMENT VARIABLES
+
+See L<Test2::Env> for a list of meaningul environment variables.
+
 =head1 MAIN API EXPORTS
 
 All exports are optional. You must specify subs to import.

diff --git a/cpan/Test-Simple/lib/Test2/API/Breakage.pm b/cpan/Test-Simple/lib/Test2/API/Breakage.pm
@@ -2,7 +2,7 @@ package Test2::API::Breakage;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 use Test2::Util qw/pkg_to_file/;

diff --git a/cpan/Test-Simple/lib/Test2/API/Context.pm b/cpan/Test-Simple/lib/Test2/API/Context.pm
@@ -2,7 +2,7 @@ package Test2::API::Context;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 use Carp qw/confess croak/;

diff --git a/cpan/Test-Simple/lib/Test2/API/Instance.pm b/cpan/Test-Simple/lib/Test2/API/Instance.pm
@@ -2,7 +2,7 @@ package Test2::API::Instance;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 our @CARP_NOT = qw/Test2::API Test2::API::Instance Test2::IPC::Driver Test2::Formatter/;
 use Carp qw/confess carp/;

diff --git a/cpan/Test-Simple/lib/Test2/API/InterceptResult.pm b/cpan/Test-Simple/lib/Test2/API/InterceptResult.pm
@@ -2,7 +2,7 @@ package Test2::API::InterceptResult;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use Scalar::Util qw/blessed/;
 use Test2::Util  qw/pkg_to_file/;

diff --git a/cpan/Test-Simple/lib/Test2/API/InterceptResult/Event.pm b/cpan/Test-Simple/lib/Test2/API/InterceptResult/Event.pm
@@ -2,7 +2,7 @@ package Test2::API::InterceptResult::Event;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use List::Util   qw/first/;
 use Test2::Util  qw/pkg_to_file/;
@@ -650,7 +650,7 @@ Possible briefs:
     "SKIP ALL"
     "SKIP ALL: $why"
 
-Note that only the first applicable brief is returned. This is essnetially a
+Note that only the first applicable brief is returned. This is essentially a
 poor-mans TAP that only includes facets that could (but not necessarily do)
 cause a failure.
 
@@ -944,7 +944,7 @@ bail-out was requested.
 
 =item EMPTY_LIST_OR_STRING = $event->bailout_brief
 
-Get the brief of the balout if present.
+Get the brief of the bailout if present.
 
 =item EMPTY_LIST_OR_STRING = $event->bailout_reason
 

diff --git a/cpan/Test-Simple/lib/Test2/API/InterceptResult/Facet.pm b/cpan/Test-Simple/lib/Test2/API/InterceptResult/Facet.pm
@@ -2,7 +2,7 @@ package Test2::API::InterceptResult::Facet;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 BEGIN {
     require Test2::EventFacet;

diff --git a/cpan/Test-Simple/lib/Test2/API/InterceptResult/Hub.pm b/cpan/Test-Simple/lib/Test2/API/InterceptResult/Hub.pm
@@ -2,7 +2,7 @@ package Test2::API::InterceptResult::Hub;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 BEGIN { require Test2::Hub; our @ISA = qw(Test2::Hub) }
 use Test2::Util::HashBase;

diff --git a/cpan/Test-Simple/lib/Test2/API/InterceptResult/Squasher.pm b/cpan/Test-Simple/lib/Test2/API/InterceptResult/Squasher.pm
@@ -2,7 +2,7 @@ package Test2::API::InterceptResult::Squasher;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use Carp qw/croak/;
 use List::Util qw/first/;

diff --git a/cpan/Test-Simple/lib/Test2/API/Stack.pm b/cpan/Test-Simple/lib/Test2/API/Stack.pm
@@ -2,7 +2,7 @@ package Test2::API::Stack;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 
 use Test2::Hub();

diff --git a/cpan/Test-Simple/lib/Test2/AsyncSubtest.pm b/cpan/Test-Simple/lib/Test2/AsyncSubtest.pm
@@ -4,7 +4,7 @@ use warnings;
 
 use Test2::IPC;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 our @CARP_NOT = qw/Test2::Util::HashBase/;
 

diff --git a/cpan/Test-Simple/lib/Test2/AsyncSubtest/Event/Attach.pm b/cpan/Test-Simple/lib/Test2/AsyncSubtest/Event/Attach.pm
@@ -2,7 +2,7 @@ package Test2::AsyncSubtest::Event::Attach;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use base 'Test2::Event';
 use Test2::Util::HashBase qw/id/;

diff --git a/cpan/Test-Simple/lib/Test2/AsyncSubtest/Event/Detach.pm b/cpan/Test-Simple/lib/Test2/AsyncSubtest/Event/Detach.pm
@@ -2,7 +2,7 @@ package Test2::AsyncSubtest::Event::Detach;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use base 'Test2::Event';
 use Test2::Util::HashBase qw/id/;

diff --git a/cpan/Test-Simple/lib/Test2/AsyncSubtest/Formatter.pm b/cpan/Test-Simple/lib/Test2/AsyncSubtest/Formatter.pm
@@ -2,7 +2,7 @@ package Test2::AsyncSubtest::Formatter;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 die "Should not load this anymore";
 

diff --git a/cpan/Test-Simple/lib/Test2/AsyncSubtest/Hub.pm b/cpan/Test-Simple/lib/Test2/AsyncSubtest/Hub.pm
@@ -2,7 +2,7 @@ package Test2::AsyncSubtest::Hub;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use base 'Test2::Hub::Subtest';
 use Test2::Util::HashBase qw/ast_ids ast/;

diff --git a/cpan/Test-Simple/lib/Test2/Bundle.pm b/cpan/Test-Simple/lib/Test2/Bundle.pm
@@ -2,7 +2,7 @@ package Test2::Bundle;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 1;
 

diff --git a/cpan/Test-Simple/lib/Test2/Bundle/Extended.pm b/cpan/Test-Simple/lib/Test2/Bundle/Extended.pm
@@ -4,7 +4,7 @@ use warnings;
 
 use Test2::V0;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 BEGIN {
     push @Test2::Bundle::Extended::ISA => 'Test2::V0';

diff --git a/cpan/Test-Simple/lib/Test2/Bundle/More.pm b/cpan/Test-Simple/lib/Test2/Bundle/More.pm
@@ -2,7 +2,7 @@ package Test2::Bundle::More;
 use strict;
 use warnings;
 
-our $VERSION = '1.302206';
+our $VERSION = '1.302207';
 
 use Test2::Plugin::ExitSummary;