Debian Codegraph @

README

raw
1 Log::Agent::Logger 0.2.00
2 Copyright (c) 2000, Raphael Manfredi
3 Copyright (c) 2015, Mark Rogaski
4
5 ------------------------------------------------------------------------
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the Artistic License, a copy of which can be
8 found with perl.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 Artistic License for more details.
14 ------------------------------------------------------------------------
15
16 *** This is alpha software -- use at your own risks ***
17
18 Name DSLI Description Info
19 ----------- ---- -------------------------------------------- -----
20 Log::Agent ---- A general logging framework RAM
21 ::Logger adpO Application-level logging interface RAM
22
23
24 The Log::Agent::Logger module is an extension of Log::Agent that brings
25 an application-level logging API.
26
27 It is separated from Log::Agent itself because it has dependencies
28 on other CPAN modules that Log::Agent cannot afford to have:
29 everyone with a plain stock Perl distribution must be able to simply
30 install Log::Agent and start using it.
31
32 SYNOPSIS
33 require Log::Agent::Logger;
34
35 my $log = Log::Agent::Logger->make(
36 -channel => $chan,
37 -max_prio => 'info',
38 -min_prio => 'emerg',
39 );
40 $log->error("can't open file %s: $!", $file);
41 $log->warning("can't open file $file: $!");
42
43 DESCRIPTION
44 The `Log::Agent::Logger' class defines a generic interface for
45 application logging. It must not be confused with the interface
46 provided by Log::Agent, which is meant to be used by re-usable
47 modules that do not wish to commit on a particular logging method,
48 so that they remain true building blocks.
49
50 By contrast, `Log::Agent::Logger' explicitely requests an object to
51 be used, and that object must commit upon the logging channel to be
52 used, at creation time.
53
54 Optionally, minimum and maximum priority levels may be defined
55 (and changed dynamically) to limit the messages to effectively
56 log, depending on the advertised priority. The standard syslog(3)
57 priorities are used.
58
59 -- Raphael Manfredi <[email protected]>