perlancar

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.