Log::Any::Adapter::ScreenColoredLevel - Send logs to screen with colorized messages according to level
This document describes version 0.08 of Log::Any::Adapter::ScreenColoredLevel (from Perl distribution Log-Any-Adapter-ScreenColoredLevel), released on 2015-06-18.
use Log::Any::Adapter; Log::Any::Adapter->set('ScreenColoredLevel', # min_level => 'debug', # default is 'warning' # colors => { trace => 'bold yellow on_gray', ... }, # customize colors # use_color => 1, # force color even when not interactive # stderr => 0, # print to STDOUT instead of STDERR # formatter => sub { "LOG: $_[1]" }, # default none );
This Log::Any adapter prints log messages to screen (STDERR/STDOUT) colored according to level. It is just like Log::Log4perl::Appender::ScreenColoredLevel, even down to the default colors (with a tiny difference), except that you don't have to use Log::Log4perl. Of course, unlike Log4perl, it only logs to screen and has minimal features.
Parameters:
min_level => STRING
Set logging level. Default is warning. If LOG_LEVEL environment variable is set, it will be used instead. If TRACE environment variable is set to true, level will be set to 'trace'. If DEBUG environment variable is set to true, level will be set to 'debug'. If VERBOSE environment variable is set to true, level will be set to 'info'.If QUIET environment variable is set to true, level will be set to 'error'.
use_color => BOOL
Whether to use color or not. Default is true only when running interactively (-t STDOUT returns true).
colors => HASH
Customize colors. Hash keys are the logging methods, hash values are colors supported by Term::ANSIColor.
The default colors are:
method/level color ------------ ----- trace yellow debug (none, terminal default) info, notice green warning bold blue error magenta critical, alert, emergency red
stderr => BOOL
Whether to print to STDERR, default is true. If set to 0, will print to STDOUT instead.
formatter => CODEREF
Allow formatting message. If defined, message will be passed before being colorized. Coderef will be passed:
($self, $message)
and is expected to return the formatted message.
The default formatter can optionally prefix the message with extra stuffs, depending on the content of LOG_PREFIX environment variable, such as: elapsed time (e.g. [0.023ms]) if LOG_PREFIX is elapsed.
[0.023ms]
elapsed
NOTE: Log::Any 1.00+ now has a proxy object which allows formatting/customization of message before it is sent to adapter(s), so formatting does not have to be done on a per-adapter basis. As an alternative to this attribute, you can also consider using the proxy object or the (upcoming?) global proxy object.
LOG_LEVEL, QUIET, VERBOSE, DEBUG, TRACE. These environment variables can set the default for min_level. See documentation about min_level for more details.
min_level
LOG_PREFIX. The default formatter groks these variables. See documentation about formatter about more details.
formatter
Log::Any
Log::Log4perl::Appender::ScreenColoredLevel
Term::ANSIColor
Please visit the project's homepage at https://metacpan.org/release/Log-Any-Adapter-ScreenColoredLevel.
Source repository is at https://github.com/perlancar/perl-Log-Any-Adapter-ScreenColoredLevel.
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Log-Any-Adapter-ScreenColoredLevel
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
perlancar <perlancar@cpan.org>
This software is copyright (c) 2015 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Log::Any::Adapter::ScreenColoredLevel, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Log::Any::Adapter::ScreenColoredLevel
CPAN shell
perl -MCPAN -e shell install Log::Any::Adapter::ScreenColoredLevel
For more information on module installation, please visit the detailed CPAN module installation guide.