1 package Eval::WithLexicals;
7 our $VERSION = '1.001000'; # 1.1.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;
155 $SIG{INT} = sub { warn "SIGINT\n" };
157 { package Data::Dumper; no strict 'vars';
158 $Terse = $Indent = $Useqq = $Deparse = $Sortkeys = 1;
162 my $eval = Eval::WithLexicals->new;
163 my $read = Term::ReadLine->new('Perl REPL');
165 my $line = $read->readline('re.pl$ ');
166 exit unless defined $line;
168 local $SIG{INT} = sub { die "Caught SIGINT" };
169 @ret = $eval->eval($line); 1;
170 } or @ret = ("Error!", $@);
176 $ perl -Ilib bin/tinyrepl
190 my $eval = Eval::WithLexicals->new(
191 lexicals => { '$x' => \1 }, # default {}
192 in_package => 'PackageToEvalIn', # default Eval::WithLexicals::Scratchpad
193 context => 'scalar', # default 'list'
194 prelude => 'use warnings', # default 'use strictures 1'
199 my @return_value = $eval->eval($code_to_eval);
203 my $current_lexicals = $eval->lexicals;
205 $eval->lexicals(\%new_lexicals);
209 my $current_package = $eval->in_package;
211 $eval->in_package($new_package);
215 my $current_context = $eval->context;
217 $eval->context($new_context); # 'list', 'scalar' or 'void'
221 Code to run before evaling code. Loads L<strictures> by default.
223 my $current_prelude = $eval->prelude;
225 $eval->prelude(q{use warnings}); # only warnings, not strict.
229 my $eval = Eval::WithLexicals->with_plugins("HintPersistence")->new;
231 Construct a class with the given plugins. Plugins are roles located under
232 a package name like C<Eval::WithLexicals::With*>.
238 =item * HintPersistence
240 When enabled this will persist pragams and other compile hints between evals
241 (for example the L<strict> and L<warnings> flags in effect). See
242 L<Eval::WithLexicals::WithHintPersistence> for further details.
248 Matt S. Trout <mst@shadowcat.co.uk>
252 David Leadbeater <dgl@dgl.cx>
256 Copyright (c) 2010 the Eval::WithLexicals L</AUTHOR> and L</CONTRIBUTORS>
261 This library is free software and may be distributed under the same terms