12 use base qw<B::Deparse>;
16 B::RecDeparse - Deparse recursively into subroutines.
24 our $VERSION = '0.05';
28 perl -MO=RecDeparse,deparse,[@B__Deparse_opts],level,-1 [ -e '...' | bleh.pl ]
33 my $brd = B::RecDeparse->new(deparse => [ @b__deparse_opts ], level => $level);
34 my $code = $brd->coderef2text(sub { ... });
38 This module extends L<B::Deparse> by making it recursively replace subroutine calls encountered when deparsing.
40 Please refer to L<B::Deparse> documentation for what to do and how to do it.
41 Besides the constructor syntax, everything should work the same for the two modules.
45 =head2 C<< new < deparse => [ @B__Deparse_opts ], level => $level > >>
47 The L<B::RecDeparse> object constructor.
48 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.
49 The C<level> option expects an integer that specifies how many levels of recursions are allowed : C<-1> means infinite while C<0> means none and match L<B::Deparse> behaviour.
54 # p31268 made pp_entersub call single_delim
57 || ($^V lt v5.9.0 and $^V ge v5.8.9)
58 || ($Config{perl_patchlevel} && $Config{perl_patchlevel} >= 31268)
64 Carp::croak('Optional arguments must be passed as key/value pairs');
68 my $deparse = $args{deparse};
69 if (defined $deparse) {
71 $deparse = [ $deparse ];
72 } elsif (ref $deparse ne 'ARRAY') {
79 my $level = $args{level};
80 $level = -1 unless defined $level;
83 return $deparse, $level;
88 $class = ref($class) || $class || __PACKAGE__;
90 my ($deparse, $level) = _parse_args(@_);
92 my $self = bless $class->SUPER::new(@$deparse), $class;
94 $self->{brd_level} = $level;
100 return $_[0]->{brd_level} < 0 || $_[0]->{brd_cur} < $_[0]->{brd_level}
106 my $bd = B::Deparse->new();
107 my ($deparse, $level) = _parse_args(@args);
109 my $compiler = $bd->coderef2text(B::Deparse::compile(@$deparse));
111 ['"]? B::Deparse ['"]? \s* -> \s* (new) \s* \( ([^\)]*) \)
112 /B::RecDeparse->$1(deparse => [ $2 ], level => $level)/gx;
113 $compiler = eval 'sub ' . $compiler;
122 $self->{brd_cur} = 0;
123 $self->{brd_sub} = 0;
124 $self->{brd_seen} = { };
126 $self->SUPER::init(@_);
129 my $key = $; . __PACKAGE__ . $;;
131 if (FOOL_SINGLE_DELIM) {
132 my $oldsd = *B::Deparse::single_delim{CODE};
134 no warnings 'redefine';
135 *B::Deparse::single_delim = sub {
138 if ((caller 1)[0] eq __PACKAGE__ and $body =~ s/^$key//) {
151 unless ($cv->CvFLAGS & B::CVf_ANON()) {
152 $name = $cv->GV->SAFENAME;
155 local $self->{brd_seen}->{$name} = 1 if defined $name;
156 return $self->SUPER::deparse_sub(@_);
163 local $self->{brd_sub} = 1;
164 $self->SUPER::pp_entersub(@_);
167 $body =~ s/^&\s*(\w)/$1/ if $self->_recurse;
176 local $self->{brd_sub} = 0;
177 $self->SUPER::pp_refgen(@_);
184 my $gv = $self->gv_or_padgv($_[0]);
185 my $name = $gv->NAME;
187 my $seen = $self->{brd_seen};
190 if (!$self->{brd_sub} or !$self->_recurse or $seen->{$name} or !$$cv
191 or !$cv->isa('B::CV') or $cv->ROOT->isa('B::NULL')) {
192 $body = $self->SUPER::pp_gv(@_);
195 local @{$self}{qw<brd_sub brd_cur>} = (0, $self->{brd_cur} + 1);
196 local $seen->{$name} = 1;
197 'sub ' . $self->indent($self->deparse_sub($gv->CV));
200 if (FOOL_SINGLE_DELIM) {
201 $body = $key . $body;
214 =head2 C<deparse_sub>
216 =head2 C<pp_entersub>
222 Functions and methods from L<B::Deparse> reimplemented by this module.
223 Never call them directly.
225 Otherwise, L<B::RecDeparse> inherits all methods from L<B::Deparse>.
229 An object-oriented module shouldn't export any function, and so does this one.
235 L<Carp> (standard since perl 5), L<Config> (since perl 5.00307) and L<B::Deparse> (since perl 5.005).
239 Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.
241 You can contact me by mail or on C<irc.perl.org> (vincent).
245 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>.
246 I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
250 You can find documentation for this module with the perldoc command.
252 perldoc B::RecDeparse
254 Tests code coverage report is available at L<http://www.profvince.com/perl/cover/B-RecDeparse>.
256 =head1 COPYRIGHT & LICENSE
258 Copyright 2008,2009,2010,2011,2013 Vincent Pit, all rights reserved.
260 This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
264 1; # End of B::RecDeparse