NAME
Log::Any::IfLOG - Load Log::Any only if LOG environment variable is true
VERSION
This document describes version 0.02 of Log::Any::IfLOG (from Perl distribution Log-Any-IfLOG), released on 2015-03-24.
SYNOPSIS
use Log::Any::IfLOG '$log';
DESCRIPTION
This module will load Log::Any only when LOG
environment variable is true. Otherwise, the module is not loaded and if user imports $log
, a dumb object will be returned instead that will accept any method but return false.
This is a quick-hack solution to avoid the cost of loading Log::Any under "normal condition" (when LOG
is not set to true). Since Log::Any 1.00, startup overhead increases to about 7ms on my PC (from under 1ms for the previous version). Since I want to keep startup overhead of CLI apps under 50ms (see Perinci::CmdLine::Lite) to keep tab completion from getting a noticeable lag, every millisecond counts.
ENVIRONMENT
LOG => bool
If set to true, will load Log::Any as usual. Otherwise, won't load Log::Any and will return a dumb object in $log
instead.
SEE ALSO
http://github.com/dagolden/Log-Any/issues/24
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/Log-Any-IfLOG.
SOURCE
Source repository is at https://github.com/perlancar/perl-Log-Any-IfLOG.
BUGS
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Log-Any-IfLOG
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.
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
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.