Test2::Plugin::UUID - Use REAL UUIDs in Test2

       Chad Granum <exodist@cpan.org>

       One of the following modules will be used under the hood, they are listed here in order of preference.

       UUID >= 0.35
           When  possible  this  module will use the UUID cpan module, but it must be version 0.35 or greater to
           avoid a fork related bug. It will generate version 7 UUIDs as they are  most  suitible  for  database
           entry.

       Data::UUID::MT
           Data::UUID::MT  is  the  second  choice  for  UUID  generation.  With this module version 4 UUIDs are
           generated as they are fairly usable in databases.

       UUID::Tiny - slow
           UUID::Tiny is used if the previous 2 are not available. This module is pure perl and  thus  could  be
           slower than the others. Version 4 UUIDs are generated when this module is used.

           A  warning  will  be  issued  with  this  module.  You  can  surpress  the  warning  with  either the
           $TEST2_UUID_NO_WARN environment variable or the "warn => 0" import argument.

       Data::UUID - Not Suitible for Databases
           This is the last resort module. This generates UUIDs fast, but they are of a type/version that is not
           suitible for database keys.

           A warning  will  be  issued  with  this  module.  You  can  surpress  the  warning  with  either  the
           $TEST2_UUID_NO_WARN environment variable or the "warn => 0" import argument.

       You can turn off backend warnings, and choose your own backend order preference:

           use Test2::Plugin::UUID warn => 0, backends => ['UUID', ...];

       Or at the command line:

           perl -MTest2::Plugin::UUID=warn,0 path/to/test.t

       Or via env vars:

           TEST2_UUID_BACKEND="UUID,Data::UUID::MT" TEST2_UUID_WARN=0 perl path/to/test.t

       Normally warnings will be issued if UUID::Tiny or Data::UUID are used as the first is slow and the second
       is not suitible for database keys.

       Copyright Chad Granum <exodist@cpan.org>.

       This program is free software; you can redistribute it and/or modify it under  the  same  terms  as  Perl
       itself.

       See http://dev.perl.org/licenses/

perl v5.40.1                                       2025-03-31                           Test2::Plugin::UUID(3pm)

       Test2 normally uses unique IDs generated by appending pid, thread-id, and an incrementing integer. These
       work fine most of the time, but are not sufficient if you want to keep a database of events, in that case
       a real UUID is much more useful.

       Chad Granum <exodist@cpan.org>

       Test2::Plugin::UUID - Use REAL UUIDs in Test2

       The      source      code      repository      for      Test2-Plugin-UUID     can     be     found     at
       https://github.com/Test-More/Test2-Plugin-UUID/.

           use Test2::Plugin::UUID;

       This is also useful at the command line for 1-time use:

           $ perl -MTest2::Plugin::UUID path/to/test.t