The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Test::Stream::IOSets - Manage sets of IO Handles in specific encodings.

DESCRIPTION

The module does 2 things, first it emulates the old behavior of Test::Builder which clones and modifies the STDOUT and STDERR handles. This legacy behavior can be referenced as 'legacy' in place of an encoding. It also manages multiple clones of the standard file handles which are set to specific encodings.

METHODS

In general you should not use this module yourself. If you must use it directly then there is really only 1 method you should use:

$ar = $ioset->init_encoding($ENCODING)
$ar = $ioset->init_encoding('legacy')
$ar = $ioset->init_encoding($NAME, $STDOUT, $STDERR)

init_encoding() will return an arrayref of 3 filehandles, STDOUT, STDERR, and TODO. TODO is typically just STDOUT again. If the encoding specified has not yet been initialized it will initialize it. If you provide filehandles they will be used, but only during initializatin. Typically a filehandle set is created by cloning STDER and STDOUT and modifying them to use the correct encoding.

CONSTANTS

These can all be imported, but none are exported by default.

OUT_STD
OUT_ERR
OUT_TODO

These are indexes of specific IO handles inside an IO set (each encoding has an IO set).

SOURCE

The source code repository for Test::More can be found at http://github.com/Test-More/test-more/.

MAINTAINER

Chad Granum <exodist@cpan.org>

AUTHORS

The following people have all contributed to the Test-More dist (sorted using VIM's sort function).

Chad Granum <exodist@cpan.org>
Fergal Daly <fergal@esatclear.ie>>
Mark Fowler <mark@twoshortplanks.com>
Michael G Schwern <schwern@pobox.com>
唐鳳

COPYRIGHT

There has been a lot of code migration between modules, here are all the original copyrights together:

Test::Stream
Test::Stream::Tester

Copyright 2015 Chad Granum <exodist7@gmail.com>.

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

See http://www.perl.com/perl/misc/Artistic.html

Test::Simple
Test::More
Test::Builder

Originally authored by Michael G Schwern <schwern@pobox.com> with much inspiration from Joshua Pritikin's Test module and lots of help from Barrie Slaymaker, Tony Bowden, blackstar.co.uk, chromatic, Fergal Daly and the perl-qa gang.

Idea by Tony Bowden and Paul Johnson, code by Michael G Schwern <schwern@pobox.com>, wardrobe by Calvin Klein.

Copyright 2001-2008 by Michael G Schwern <schwern@pobox.com>.

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

See http://www.perl.com/perl/misc/Artistic.html

Test::use::ok

To the extent possible under law, 唐鳳 has waived all copyright and related or neighboring rights to Test-use-ok.

This work is published from Taiwan.

http://creativecommons.org/publicdomain/zero/1.0

Test::Tester

This module is copyright 2005 Fergal Daly <fergal@esatclear.ie>, some parts are based on other people's work.

Under the same license as Perl itself

See http://www.perl.com/perl/misc/Artistic.html

Test::Builder::Tester

Copyright Mark Fowler <mark@twoshortplanks.com> 2002, 2004.

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