The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Plack::Debugger::Storage - The storage manager for debugging data

VERSION

version 0.03

DESCRIPTION

This module handles the loading and storing of the debugging data that is generated by the Plack::Debugger during a web request.

METHODS

new (%args)

This expects to find a data_dir key in the %args which is basically a writable directory that exists. It also expects a pair of callbacks under the serializer and deserializer keys to handle the serialization needs for the data. It optionally can take a filename_fmt argument which allows you to specify how the debugger data files names are generated.

data_dir

This is an acccessor for the data_dir key specified in the constructor.

serializer

This is an acccessor for the serializer key specified in the constructor.

deserializer

This is an acccessor for the deserializer key specified in the constructor.

filename_fmt

This is an acccessor for the filename_fmt key which was optionally specified in the constructor.

store_request_results ($request_uid, $results)

Given a $request_uid this will write the $results to a file into the data_dir.

store_subrequest_results ($request_uid, $subrequest_uid, $results)

Given a $request_uid and $subrequest_uid this will write the $results to a file in the appropriate sub-folder in the data_dir.

load_request_results ($request_uid)

Given a $request_uid this will load the corresponding set of results from a file in the data_dir.

load_subrequest_results ($request_uid, $subrequest_uid)

Given a $request_uid and $subrequest_uid this will load a specific set of results from the appropriate sub-folder in the data_dir.

load_all_subrequest_results ($request_uid)

Given a $request_uid this will load all the associated sub-request results from the appropriate sub-folder in the data_dir.

load_all_subrequest_results_modified_since ($request_uid, $epoch)

Given a $request_uid this will load all the associated sub-request results from the appropriate sub-folder in the data_dir that have been created since the $epoch.

ACKNOWLEDGMENT

This module was originally developed for Booking.com. With approval from Booking.com, this module was generalized and published on CPAN, for which the authors would like to express their gratitude.

AUTHOR

Stevan Little <stevan@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Stevan Little.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.