+package B::RecDeparse;
+
+use strict;
+use warnings;
+
+use Carp qw/croak/;
+
+use base qw/B::Deparse/;
+
+=head1 NAME
+
+B::RecDeparse - Deparse recursively into subroutines.
+
+=head1 VERSION
+
+Version 0.01
+
+=cut
+
+our $VERSION = '0.01';
+
+=head1 SYNOPSIS
+
+ perl -MO=RecDeparse,deparse,[@B__Deparse_opts],level,-1 [ -e '...' | bleh.pl ]
+
+ # Or as a module :
+ use B::RecDeparse;
+
+ my $brd = B::RecDeparse->new(deparse => [ @b__deparse_opts ], level => $level);
+ my $code = $brd->coderef2text(sub { ... });
+
+=head1 DESCRIPTION
+
+This module extends L<B::Deparse> by making you recursively replace subroutine calls encountered when deparsing.
+
+Please refer to L<B::Deparse> documentation for what to do and how to do it. Besides the constructor syntax, everything should work the same for the two modules.
+
+=head1 METHODS
+
+=head2 C<< new < deparse => [ @B__Deparse_opts ], level => $level > >>
+
+The L<B::RecDeparse> object constructor. You can specify the underlying L<B::Deparse> constructor arguments by passing a string or an array reference as the value of the C<deparse> key. The C<level> option expects an integer that specifies how many levels of recursions are allowed : L<-1> means infinite while L<0> means none and match L<B::Deparse> behaviour.
+
+=cut
+
+sub _parse_args {
+ croak 'Optional arguments must be passed as key/value pairs' if @_ % 2;
+ my %args = @_;
+ my $deparse = $args{deparse};
+ if (defined $deparse) {
+ if (!ref $deparse) {
+ $deparse = [ $deparse ];
+ } elsif (ref $deparse ne 'ARRAY') {
+ $deparse = [ ];
+ }
+ } else {
+ $deparse = [ ];
+ }
+ my $level = $args{level};
+ $level = -1 unless defined $level;
+ $level = int $level;
+ return $deparse, $level;
+}
+
+sub new {
+ my $class = shift;
+ $class = ref($class) || $class || __PACKAGE__;
+ my ($deparse, $level) = _parse_args(@_);
+ my $self = bless $class->SUPER::new(@$deparse), $class;
+ $self->{brd_level} = $level;
+ return $self;
+}
+
+sub _recurse {
+ return $_[0]->{brd_level} >= 0 && $_[0]->{brd_cur} >= $_[0]->{brd_level}
+}
+
+sub compile {
+ my $bd = B::Deparse->new();
+ my @args = @_;
+ my ($deparse, $level) = _parse_args(@args);
+ my $compiler = $bd->coderef2text(B::Deparse::compile(@$deparse));
+ $compiler =~ s/
+ ['"]? B::Deparse ['"]? \s* -> \s* (new) \s* \( ([^\)]*) \)
+ /B::RecDeparse->$1(deparse => [ $2 ], level => $level)/gx;
+ $compiler = eval 'sub ' . $compiler;
+ die if $@;
+ return $compiler;
+}
+
+sub init {
+ my $self = shift;
+ $self->{brd_cur} = 0;
+ $self->{brd_sub} = 0;
+ $self->SUPER::init(@_);
+}
+
+my $key = $; . __PACKAGE__ . $;;
+
+# p31268 made pp_entersub call single_delim
+if ($^V ge v5.9.5) {
+ my $oldsd = *B::Deparse::single_delim{CODE};
+ no warnings 'redefine';
+ *B::Deparse::single_delim = sub {
+ my $body = $_[2];
+ if ($body =~ s/^$key//) {
+ return $body;
+ } else {
+ $oldsd->(@_);
+ }
+ }
+}
+
+sub pp_entersub {
+ my $self = shift;
+ $self->{brd_sub} = 1;
+ my $body = $self->SUPER::pp_entersub(@_);
+ $self->{brd_sub} = 0;
+ $body =~ s/^&\s*(\w)/$1/ if not $self->_recurse;
+ return $body;
+}
+
+sub pp_refgen {
+ my $self = shift;
+ $self->{brd_sub} = 0;
+ my $body = $self->SUPER::pp_refgen(@_);
+ $self->{brd_sub} = 1;
+ return $body;
+}
+
+sub pp_gv {
+ my $self = shift;
+ my $body;
+ if ($self->{brd_sub} <= 0 || $self->_recurse) {
+ $body = $self->SUPER::pp_gv(@_);
+ } else {
+ my $gv = $self->gv_or_padgv($_[0]);
+ ++$self->{brd_cur};
+ $body = 'sub ' . $self->indent($self->deparse_sub($gv->CV));
+ --$self->{brd_cur};
+ if ($^V lt v5.9.5) {
+ $body .= '->';
+ } else {
+ $body = $key . $body;
+ }
+ }
+ return $body;
+}
+
+=head2 C<compile>
+
+=head2 C<init>
+
+=head2 C<pp_entersub>
+
+=head2 C<pp_refgen>
+
+=head2 C<pp_gv>
+
+Functions and methods from L<B::Deparse> overriden by this module. Never call them directly.
+
+Otherwise, L<B::RecDeparse> inherits all methods from L<B::Deparse>.
+
+=head1 EXPORT
+
+An object-oriented module shouldn't export any function, and so does this one.
+
+=head1 DEPENDENCIES
+
+L<Carp> (standard since perl 5), L<B::Deparse> (since perl 5.005).
+
+=head1 AUTHOR
+
+Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.
+
+You can contact me by mail or on #perl @ FreeNode (vincent or Prof_Vince).
+
+=head1 BUGS
+
+Please report any bugs or feature requests to C<bug-b-recdeparse at rt.cpan.org>, or through the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=B-RecDeparse>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
+
+=head1 SUPPORT
+
+You can find documentation for this module with the perldoc command.
+
+ perldoc B::RecDeparse
+
+Tests code coverage report is available at L<http://www.profvince.com/perl/cover/B-RecDeparse>.
+
+=head1 COPYRIGHT & LICENSE
+
+Copyright 2008 Vincent Pit, all rights reserved.
+
+This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
+
+=cut
+
+1; # End of B::RecDeparse