/usr/share/perl5/Log/Dispatch/Screen.pm is in liblog-dispatch-perl 2.54-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 | package Log::Dispatch::Screen;
use strict;
use warnings;
our $VERSION = '2.54';
use Log::Dispatch::Output;
use base qw( Log::Dispatch::Output );
use Encode qw( encode );
use IO::Handle;
use Params::Validate qw(validate BOOLEAN);
Params::Validate::validation_options( allow_extra => 1 );
sub new {
my $proto = shift;
my $class = ref $proto || $proto;
my %p = validate(
@_, {
stderr => {
type => BOOLEAN,
default => 1,
},
utf8 => {
type => BOOLEAN,
default => 0,
},
}
);
my $self = bless \%p, $class;
$self->_basic_init(%p);
return $self;
}
sub log_message {
my $self = shift;
my %p = @_;
# This is a bit gross but it's important that we print directly to the
# STDOUT or STDERR handle for backwards compatibility. Various modules
# have tests which rely on this, so we can't open a new filehandle to fd 1
# or 2 and use that.
my $message
= $self->{utf8} ? encode( 'UTF-8', $p{message} ) : $p{message};
if ( $self->{stderr} ) {
print STDERR $message;
}
else {
print STDOUT $message;
}
}
1;
# ABSTRACT: Object for logging to the screen
__END__
=pod
=head1 NAME
Log::Dispatch::Screen - Object for logging to the screen
=head1 VERSION
version 2.54
=head1 SYNOPSIS
use Log::Dispatch;
my $log = Log::Dispatch->new(
outputs => [
[
'Screen',
min_level => 'debug',
stderr => 1,
newline => 1
]
],
);
$log->alert("I'm searching the city for sci-fi wasabi");
=head1 DESCRIPTION
This module provides an object for logging to the screen (really
C<STDOUT> or C<STDERR>).
Note that a newline will I<not> be added automatically at the end of a
message by default. To do that, pass C<< newline => 1 >>.
The handle will be autoflushed, but this module opens it's own handle to fd 1
or 2 instead of using the global C<STDOUT> or C<STDERR>.
=for Pod::Coverage new log_message
=head1 CONSTRUCTOR
The constructor takes the following parameters in addition to the standard
parameters documented in L<Log::Dispatch::Output>:
=over 4
=item * stderr (0 or 1)
Indicates whether or not logging information should go to C<STDERR>. If
false, logging information is printed to C<STDOUT> instead.
This defaults to true.
=item * utf8 (0 or 1)
If this is true, then the output uses C<binmode> to apply the
C<:encoding(UTF-8)> layer to the relevant handle for output. This will not
affect C<STDOUT> or C<STDERR> in other parts of your code.
This defaults to false.
=back
=head1 AUTHOR
Dave Rolsky <autarch@urth.org>
=head1 COPYRIGHT AND LICENSE
This software is Copyright (c) 2016 by Dave Rolsky.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
=cut
|