NAME

Carp::Parse - Parse a Carp stack trace into an array of caller information with parsed arguments.

DESCRIPTION

Carp produces a stacktrace that includes caller arguments; this module parses each line of the stack trace to extract its arguments, which allows rewriting the stack trace (for example, to redact sensitive information).

VERSION

Version 1.0.1

SYNOPSIS

# Retrieve a Carp stack trace with longmess(). This is tedious, but you will
# normally be using this module in a context where the stacktrace is already
# generated for you and you want to parse it, so you won't have to go through
# this step.
sub test3 { return Carp::longmess("Test"); }
sub test2 { return test3(); }
sub test1 { return test2(); }
my $stack_trace = test1();

# Parse the Carp stack trace.
use Carp::Parse;
my $parsed_stack_trace = Carp::Parse::parse_stack_trace( $stack_trace );

use Data::Dump qw( dump );
foreach my $caller_information ( @$parsed_stack_trace )
{
	# Print the arguments for each caller.
	say dump( $caller->get_arguments_list() );
}

FUNCTIONS

parse_stack_trace()

Parse a stack trace produced by Carp into an arrayref of Carp::Parse::CallerInformation objects.

my $parsed_stack_trace = Carp::Parse::parse_stack_trace( $stack_trace );

AUTHOR

Kate Kirby, <kate at cpan.org>.

Guillaume Aubert, <aubertg at cpan.org>.

BUGS

Please report any bugs or feature requests to bug-carp-parse at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Carp-Parse. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Carp::Parse

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Carp-Parse

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Carp-Parse

• CPAN Ratings

  http://cpanratings.perl.org/d/Carp-Parse

• Search CPAN

  http://search.cpan.org/dist/Carp-Parse/

ACKNOWLEDGEMENTS

Thanks to ThinkGeek (http://www.thinkgeek.com/) and its corporate overlords at Geeknet (http://www.geek.net/), for footing the bill while we eat pizza and write code for them!

COPYRIGHT & LICENSE

Copyright 2012 Kate Kirby & Guillaume Aubert.

This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License.

See http://dev.perl.org/licenses/ for more information.