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
|
package Log::Dispatch::Handle;
use strict;
use warnings;
our $VERSION = '2.71';
use Log::Dispatch::Types;
use Params::ValidationCompiler qw( validation_for );
use base qw( Log::Dispatch::Output );
{
my $validator = validation_for(
params => { handle => { type => t('CanPrint') } },
slurpy => 1,
);
sub new {
my $class = shift;
my %p = $validator->(@_);
my $self = bless { handle => delete $p{handle} }, $class;
$self->_basic_init(%p);
return $self;
}
}
sub log_message {
my $self = shift;
my %p = @_;
$self->{handle}->print( $p{message} )
or die "Cannot write to handle: $!";
}
1;
# ABSTRACT: Object for logging to IO::Handle classes
__END__
=pod
=encoding UTF-8
=head1 NAME
Log::Dispatch::Handle - Object for logging to IO::Handle classes
=head1 VERSION
version 2.71
=head1 SYNOPSIS
use Log::Dispatch;
my $log = Log::Dispatch->new(
outputs => [
[
'Handle',
min_level => 'emerg',
handle => $io_socket_object,
],
]
);
$log->emerg('I am the Lizard King!');
=head1 DESCRIPTION
This module supplies a very simple object for logging to some sort of handle
object. Basically, anything that implements a C<print()> method can be passed
the object constructor and it should work.
=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 * handle ($)
The handle object. This object must implement a C<print()> method.
=back
=head1 SUPPORT
Bugs may be submitted at L<https://github.com/houseabsolute/Log-Dispatch/issues>.
=head1 SOURCE
The source code repository for Log-Dispatch can be found at L<https://github.com/houseabsolute/Log-Dispatch>.
=head1 AUTHOR
Dave Rolsky <autarch@urth.org>
=head1 COPYRIGHT AND LICENSE
This software is Copyright (c) 2023 by Dave Rolsky.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
The full text of the license can be found in the
F<LICENSE> file included with this distribution.
=cut
|
