File: IOEvents.pm

package info (click to toggle)
libtest2-plugin-ioevents-perl 0.001001-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 128 kB
  • sloc: perl: 177; makefile: 2
file content (84 lines) | stat: -rw-r--r-- 1,459 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
package Test2::Plugin::IOEvents;
use strict;
use warnings;

our $VERSION = '0.001001';

use Test2::Plugin::IOEvents::Tie;
use Test2::API qw/ test2_add_callback_post_load /;

my $LOADED = 0;

sub import {
    my $class = shift;

    return if $LOADED++; # do not add multiple hooks

    test2_add_callback_post_load(sub {
        tie(*STDOUT, 'Test2::Plugin::IOEvents::Tie', 'STDOUT');
        tie(*STDERR, 'Test2::Plugin::IOEvents::Tie', 'STDERR');
    });
}


1;

__END__

=pod

=encoding UTF-8

=head1 NAME

Test2::Plugin::IOEvents - Turn STDOUT and STDERR into Test2 events.

=head1 DESCRIPTION

This plugin turns prints to STDOUT and STDERR (including warnings) into proper
Test2 events.

=head1 SYNOPSIS

    use Test2::Plugin::IOEvents;

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

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

=head1 CAVEATS

The magic of this module is achieved via tied variables.

=head1 SOURCE

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

=head1 MAINTAINERS

=over 4

=item Chad Granum E<lt>exodist@cpan.orgE<gt>

=back

=head1 AUTHORS

=over 4

=item Chad Granum E<lt>exodist@cpan.orgE<gt>

=back

=head1 COPYRIGHT

Copyright 2020 Chad Granum E<lt>exodist@cpan.orgE<gt>.

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

See F<http://dev.perl.org/licenses/>

=cut
1;