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).' };'
145 Eval::WithLexicals - pure perl eval with persistent lexical variables
154 use Eval::WithLexicals;
160 "plugin=s" => \my @plugins
163 $SIG{INT} = sub { warn "SIGINT\n" };
165 { package Data::Dumper; no strict 'vars';
166 $Terse = $Indent = $Useqq = $Deparse = $Sortkeys = 1;
171 ? Eval::WithLexicals->with_plugins(@plugins)->new
172 : Eval::WithLexicals->new;
174 my $read = Term::ReadLine->new('Perl REPL');
176 my $line = $read->readline('re.pl$ ');
177 exit unless defined $line;
179 local $SIG{INT} = sub { die "Caught SIGINT" };
180 @ret = $eval->eval($line); 1;
181 } or @ret = ("Error!", $@);
187 $ perl -Ilib bin/tinyrepl
201 my $eval = Eval::WithLexicals->new(
202 lexicals => { '$x' => \1 }, # default {}
203 in_package => 'PackageToEvalIn', # default Eval::WithLexicals::Scratchpad
204 context => 'scalar', # default 'list'
205 prelude => 'use warnings', # default 'use strictures 1'
210 my @return_value = $eval->eval($code_to_eval);
214 my $current_lexicals = $eval->lexicals;
216 $eval->lexicals(\%new_lexicals);
220 my $current_package = $eval->in_package;
222 $eval->in_package($new_package);
226 my $current_context = $eval->context;
228 $eval->context($new_context); # 'list', 'scalar' or 'void'
232 Code to run before evaling code. Loads L<strictures> by default.
234 my $current_prelude = $eval->prelude;
236 $eval->prelude(q{use warnings}); # only warnings, not strict.
240 my $eval = Eval::WithLexicals->with_plugins("HintPersistence")->new;
242 Construct a class with the given plugins. Plugins are roles located under
243 a package name like C<Eval::WithLexicals::With*>.
249 =item * HintPersistence
251 When enabled this will persist pragams and other compile hints between evals
252 (for example the L<strict> and L<warnings> flags in effect). See
253 L<Eval::WithLexicals::WithHintPersistence> for further details.
259 Matt S. Trout <mst@shadowcat.co.uk>
263 David Leadbeater <dgl@dgl.cx>
267 Copyright (c) 2010 the Eval::WithLexicals L</AUTHOR> and L</CONTRIBUTORS>
272 This library is free software and may be distributed under the same terms