1 package Eval::WithLexicals;
7 our $VERSION = '1.002000'; # 1.2.0
8 $VERSION = eval $VERSION;
10 has lexicals => (is => 'rw', default => quote_sub q{ {} });
13 my %valid_contexts = map +($_ => 1), qw(list scalar void);
16 is => 'rw', default => quote_sub(q{ 'list' }),
19 die "Invalid context type $val - should be list, scalar or void"
20 unless $valid_contexts{$val};
26 is => 'rw', default => quote_sub q{ 'Eval::WithLexicals::Scratchpad' }
30 is => 'rw', default => quote_sub q{ 'use strictures 1;' }
34 my($class, @names) = @_;
36 Moo::Role->create_class_with_roles($class,
37 map "Eval::WithLexicals::With$_", @names);
46 ( qq{ BEGIN { Eval::WithLexicals::Util::capture_list() } } )
50 my ($self, $to_eval) = @_;
51 local *Eval::WithLexicals::Cage::current_line;
52 local *Eval::WithLexicals::Cage::pad_capture;
53 local *Eval::WithLexicals::Cage::grab_captures;
55 my $package = $self->in_package;
56 my $setup_code = join '', $self->setup_code,
57 # $_[2] being what is passed to _eval_do below
58 Sub::Quote::capture_unroll('$_[2]', $self->lexicals, 2);
60 my $capture_code = join '', $self->capture_code;
62 local our $current_code = qq!
64 sub Eval::WithLexicals::Cage::current_line {
68 ;sub Eval::WithLexicals::Cage::pad_capture { }
70 sub Eval::WithLexicals::Cage::grab_captures {
71 no warnings 'closure'; no strict 'vars';
72 package Eval::WithLexicals::VarScope;!;
73 # rest is appended by Eval::WithLexicals::Util::capture_list, called
74 # during parsing by the BEGIN block from capture_code.
76 $self->_eval_do(\$current_code, $self->lexicals, $to_eval);
77 $self->_run(\&Eval::WithLexicals::Cage::current_line);
81 my($self, $code) = @_;
84 my $ctx = $self->context;
87 } elsif ($ctx eq 'scalar') {
94 %{$self->_grab_captures},
101 my $cap = Eval::WithLexicals::Cage::grab_captures();
102 foreach my $key (keys %$cap) {
103 my ($sigil, $name) = $key =~ /^(.)(.+)$/;
104 my $var_scope_name = $sigil.'Eval::WithLexicals::VarScope::'.$name;
105 if ($cap->{$key} eq eval "\\${var_scope_name}") {
113 my ($self, $text_ref, $lexical, $original) = @_;
115 if ($_[1] eq '/eval_do') {
116 open my $fh, '<', $text_ref;
122 do '/eval_do' or die $@;
126 package Eval::WithLexicals::Util;
128 use B qw(svref_2object);
131 my $pad_capture = \&Eval::WithLexicals::Cage::pad_capture;
132 my @names = grep $_ ne '&', map $_->PV, grep $_->isa('B::PV'),
133 svref_2object($pad_capture)->OUTSIDE->PADLIST->ARRAYelt(0)->ARRAY;
134 $Eval::WithLexicals::current_code .=
135 '+{ '.join(', ', map "'$_' => \\$_", @names).' };'
142 Eval::WithLexicals - pure perl eval with persistent lexical variables
151 use Eval::WithLexicals;
157 "plugin=s" => \my @plugins
160 $SIG{INT} = sub { warn "SIGINT\n" };
162 { package Data::Dumper; no strict 'vars';
163 $Terse = $Indent = $Useqq = $Deparse = $Sortkeys = 1;
168 ? Eval::WithLexicals->with_plugins(@plugins)->new
169 : Eval::WithLexicals->new;
171 my $read = Term::ReadLine->new('Perl REPL');
173 my $line = $read->readline('re.pl$ ');
174 exit unless defined $line;
176 local $SIG{INT} = sub { die "Caught SIGINT" };
177 @ret = $eval->eval($line); 1;
178 } or @ret = ("Error!", $@);
184 $ perl -Ilib bin/tinyrepl
198 my $eval = Eval::WithLexicals->new(
199 lexicals => { '$x' => \1 }, # default {}
200 in_package => 'PackageToEvalIn', # default Eval::WithLexicals::Scratchpad
201 context => 'scalar', # default 'list'
202 prelude => 'use warnings', # default 'use strictures 1'
207 my @return_value = $eval->eval($code_to_eval);
211 my $current_lexicals = $eval->lexicals;
213 $eval->lexicals(\%new_lexicals);
217 my $current_package = $eval->in_package;
219 $eval->in_package($new_package);
223 my $current_context = $eval->context;
225 $eval->context($new_context); # 'list', 'scalar' or 'void'
229 Code to run before evaling code. Loads L<strictures> by default.
231 my $current_prelude = $eval->prelude;
233 $eval->prelude(q{use warnings}); # only warnings, not strict.
237 my $eval = Eval::WithLexicals->with_plugins("HintPersistence")->new;
239 Construct a class with the given plugins. Plugins are roles located under
240 a package name like C<Eval::WithLexicals::With*>.
246 =item * HintPersistence
248 When enabled this will persist pragams and other compile hints between evals
249 (for example the L<strict> and L<warnings> flags in effect). See
250 L<Eval::WithLexicals::WithHintPersistence> for further details.
256 Matt S. Trout <mst@shadowcat.co.uk>
260 David Leadbeater <dgl@dgl.cx>
264 Copyright (c) 2010 the Eval::WithLexicals L</AUTHOR> and L</CONTRIBUTORS>
269 This library is free software and may be distributed under the same terms