NAME
Log::ger::Plugin::OptAway - Optimize away higher-level log statements
VERSION
version 0.004
SYNOPSIS
use Log::ger::Plugin->set('OptAway');
use Log::ger;
To demonstrate the effect of optimizing away:
% perl -MLog::ger -MO=Deparse -e'log_warn "foo\n"; log_debug "bar\n"'
log_warn("foo\n");
log_debug("bar\n");
-e syntax OK
% perl -MLog::ger::Plugin=OptAway -MLog::ger -MO=Deparse -e'log_warn "foo\n"; log_debug "bar\n"'
log_warn("foo\n");
'???';
-e syntax OK
DESCRIPTION
This plugin replaces logging statements that are higher than the current
level ($Log::ger::Current_Level) into a no-op statement using
B::CallChecker magic at compile-time. The logging statements will become
no-op and will have zero run-time overhead.
By default, since $Current_Level is pre-set at 3 (warn) then
"log_info()", "log_debug()", and "log_trace()" calls will be turned into
no-op.
Caveats:
* must be done at compile-time
* only works when you are using procedural style
* once optimized away, subsequent logger reinitialization at run-time
won't take effect
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2017 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.