NAME

       Log::Dispatch::FileWriteRotate - Log to files that archive/rotate themselves, w/ File::Write::Rotate

VERSION

       This document describes version 0.062 of Log::Dispatch::FileWriteRotate (from Perl distribution Log-
       Dispatch-FileWriteRotate), released on 2021-07-21.

SYNOPSIS

        use Log::Dispatch::FileWriteRotate;

        my $file = Log::Dispatch::FileWriteRotate(
            min_level => 'info',

            # will be passed to File::Write::Rotate
            dir       => '/var/log',
            prefix    => 'myapp',
            suffix    => '.log',
            period    => 'monthly',
            size      => 25*1024*1024,
            histories => 12,
        );

        $file->log(level => 'info', message => "Your comment\n");

DESCRIPTION

       This module functions similarly to Log::Dispatch::FileRotate, but uses File::Write::Rotate as backend,
       thus interoperates more easily with other modules which use File::Write::Rotate as backend, e.g.
       Tie::Handle::FileWriteRotate or Process::Govern.

CONTRIBUTOR

       Steven Haryanto <sharyanto@cpan.org>

METHODS

   new(%args)
       Constructor. This method takes a hash of parameters. The following options are valid: "min_level" and
       "max_level" (see Log::Dispatch documentation); "dir", "prefix", "suffix", "period", "size", and
       "histories" (see File::Write::Rotate).

   log_message(message => STR)
       Send a message to the appropriate output. Generally this shouldn't be called directly but should be
       called through the "log()" method (in LLog::Dispatch::Output>).

   fwr
       Expose File::Write::Rotate object. You can do access this object e.g. to compress logfiles:

        $file->fwd->compress;

HOMEPAGE

       Please visit the project's homepage at <https://metacpan.org/release/Log-Dispatch-FileWriteRotate>.

SOURCE

       Source repository is at <https://github.com/perlancar/perl-Log-Dispatch-FileWriteRotate>.

BUGS

       Please report any bugs or feature requests on the bugtracker website
       <https://rt.cpan.org/Public/Dist/Display.html?Name=Log-Dispatch-FileWriteRotate>

       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.

SEE ALSO

       Log::Dispatch

       File::Write::Rotate

       Log::Dispatch::FileRotate

AUTHOR

       perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2021, 2019, 2015, 2013, 2012 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.

perl v5.32.1                                       2021-09-27                Log::Dispatch::FileWriteRotate(3pm)