Test2::...in::UTF8(3)

📦 version 1.302214, in opensuse-leap 16.0

🌈 NAME 🌈

Test2::Plugin::UTF8 — a Test2 plugin to test with utf8. 💖

Also hi bestie, the manual name up top is Test2::...in::UTF8(3) and it’s filed under User Contributed Perl Documentation. Don’t let the ellipsis jumpscare you. 🫶

💖 DESCRIPTION 💖

When you use this plugin, it makes tests work with utf8. That includes turning on the utf8 pragma and updating the Test2 output formatter to use utf8. No cap. ✨

✨ SYNOPSIS ✨

use Test2::Plugin::UTF8;

This is similar to:

use utf8;
BEGIN {
    require Test2::Tools::Encoding;
    Test2::Tools::Encoding::set_encoding('utf8');
}

You can also disable the utf8 import by using 'encoding_only' to only enable utf8 encoding on the output format. Like:

use Test2::Plugin::UTF8 qw(encoding_only);

🌸 import options 🌸

  • encoding_only — does not import utf8 in your test and only enables the encoding mode on the output. 🎀

🫶 NOTES 🫶

This module currently sets output handles to have the ':utf8' output layer. Some might prefer ':encoding(utf-8)', which is more strict about verifying characters. There is a debate about whether or not encoding to utf8 from perl internals can ever fail, so it may not matter. This was also chosen because the alternative causes threads to segfault — see perlbug 31923 at https://rt.perl.org/Public/Bug/Display.html?id=31923. 😭💀

🔥 SOURCE 🔥

The source code repository for Test2-Suite can be found at https://github.com/Test-More/test-more/. 👑

👑 MAINTAINERS 👑

Chad Granum <exodist@cpan.org> 🦋

🦋 AUTHORS 🦋

Chad Granum <exodist@cpan.org> 💜

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/.

Signed off with perl v5.42.0 energy, dated 2025-07-28, on the Test2::...in::UTF8(3) page — catch you later, bestie 💅✨

📦 where this page comes from