NAME

MasonX::LeakGuard::Object - report memory leaks (objects) per request

SYNOPSIS

    use MasonX::LeakGuard::Object;
    %MasonX::LeakGuard::Object::OPTIONS = (
        exclude => [
            'utf8',
            'HTML::Mason::*',
            'Devel::StackTrace',
        ],
    );
    my @MasonParameters = (
        ...
        plugins => [qw(MasonX::LeakGuard::Object)],
    );

DESCRIPTION

This is plugin for HTML::Mason applications that helps you find memory leaks in OO applications. It uses Devel::LeakGuard::Object framework for that.

Leaks are reported using perl's warn function. Report is very simple, shows request path, arguments (using Data::Dumper) and counts of objects that leaked with groupping by class.

It's possible that false positives to be reported, for example if a compontent has ONCE block where you cache some values. Most caches will generate false positive reports, but it's possible to use options of function leakguard in Devel::LeakGuard::Object. Look at "SYNOPSIS" for details.

To avoid many false positives the module as well ignores first request to a path.

AUTHOR

Ruslan Zakirov <ruz@bestpractical.com>

LICENSE

Under the same terms as perl itself.

-cut