OILS / core / shell.py View on Github | oils.pub

1229 lines, 789 significant
1"""
2core/shell.py -- Entry point for the shell interpreter.
3"""
4from __future__ import print_function
5
6from errno import ENOENT
7import time as time_
8
9from _devbuild.gen import arg_types
10from _devbuild.gen.option_asdl import option_i, builtin_i
11from _devbuild.gen.syntax_asdl import (loc, source, source_t, IntParamBox,
12 debug_frame, debug_frame_t)
13from _devbuild.gen.value_asdl import (value, value_e, value_t, value_str, Obj)
14from core import alloc
15from core import comp_ui
16from core import dev
17from core import error
18from core import executor
19from core import completion
20from core import main_loop
21from core import optview
22from core import process
23from core import pyutil
24from core import sh_init
25from core import state
26from display import ui
27from core import util
28from core import vm
29
30from frontend import args
31from frontend import flag_def # side effect: flags are defined!
32
33unused1 = flag_def
34from frontend import flag_util
35from frontend import reader
36from frontend import parse_lib
37
38from builtin import assign_osh
39from builtin import bracket_osh
40from builtin import completion_osh
41from builtin import completion_ysh
42from builtin import dirs_osh
43from builtin import error_ysh
44from builtin import hay_ysh
45from builtin import io_osh
46from builtin import io_ysh
47from builtin import json_ysh
48from builtin import meta_oils
49from builtin import misc_osh
50from builtin import module_ysh
51from builtin import printf_osh
52from builtin import process_osh
53from builtin import pure_osh
54from builtin import pure_ysh
55from builtin import readline_osh
56from builtin import read_osh
57from builtin import trap_osh
58
59from builtin import func_eggex
60from builtin import func_hay
61from builtin import func_misc
62from builtin import func_reflect
63
64from builtin import method_dict
65from builtin import method_io
66from builtin import method_list
67from builtin import method_other
68from builtin import method_str
69from builtin import method_type
70
71from osh import cmd_eval
72from osh import glob_
73from osh import history
74from osh import prompt
75from osh import sh_expr_eval
76from osh import split
77from osh import word_eval
78
79from mycpp import iolib
80from mycpp import mops
81from mycpp import mylib
82from mycpp.mylib import NewDict, print_stderr, log
83from pylib import os_path
84from tools import deps
85from tools import fmt
86from tools import ysh_ify
87from ysh import expr_eval
88
89unused2 = log
90
91import libc
92import posix_ as posix
93
94from typing import List, Dict, Optional, TYPE_CHECKING
95if TYPE_CHECKING:
96 from frontend.py_readline import Readline
97
98if mylib.PYTHON:
99 try:
100 from _devbuild.gen import help_meta # type: ignore
101 except ImportError:
102 help_meta = None
103
104
105def _InitDefaultCompletions(cmd_ev, complete_builtin, comp_lookup):
106 # type: (cmd_eval.CommandEvaluator, completion_osh.Complete, completion.Lookup) -> None
107
108 # register builtins and words
109 complete_builtin.Run(cmd_eval.MakeBuiltinArgv(['-E', '-A', 'command']))
110 # register path completion
111 # Add -o filenames? Or should that be automatic?
112 complete_builtin.Run(cmd_eval.MakeBuiltinArgv(['-D', '-A', 'file']))
113
114
115def _CompletionDemo(comp_lookup):
116 # type: (completion.Lookup) -> None
117
118 # Something for fun, to show off. Also: test that you don't repeatedly hit
119 # the file system / network / coprocess.
120 A1 = completion.TestAction(['foo.py', 'foo', 'bar.py'], 0.0)
121 l = [] # type: List[str]
122 for i in xrange(0, 5):
123 l.append('m%d' % i)
124
125 A2 = completion.TestAction(l, 0.1)
126 C1 = completion.UserSpec([A1, A2], [], [], completion.DefaultPredicate(),
127 '', '')
128 comp_lookup.RegisterName('slowc', {}, C1)
129
130
131def SourceStartupFile(
132 fd_state, # type: process.FdState
133 rc_path, # type: str
134 lang, # type: str
135 parse_ctx, # type: parse_lib.ParseContext
136 cmd_ev, # type: cmd_eval.CommandEvaluator
137 errfmt, # type: ui.ErrorFormatter
138):
139 # type: (...) -> None
140
141 # Right now this is called when the shell is interactive. (Maybe it should
142 # be called on login_shel too.)
143 #
144 # Terms:
145 # - interactive shell: Roughly speaking, no args or -c, and isatty() is true
146 # for stdin and stdout.
147 # - login shell: Started from the top level, e.g. from init or ssh.
148 #
149 # We're not going to copy everything bash does because it's too complex, but
150 # for reference:
151 # https://www.gnu.org/software/bash/manual/bash.html#Bash-Startup-Files
152 # Bash also has --login.
153
154 try:
155 f = fd_state.Open(rc_path)
156 except (IOError, OSError) as e:
157 # TODO: Could warn about nonexistent explicit --rcfile?
158 if e.errno != ENOENT:
159 raise # Goes to top level. Handle this better?
160 return
161
162 arena = parse_ctx.arena
163 rc_line_reader = reader.FileLineReader(f, arena)
164 rc_c_parser = parse_ctx.MakeOshParser(rc_line_reader)
165
166 with alloc.ctx_SourceCode(arena, source.MainFile(rc_path)):
167 # TODO: handle status, e.g. 2 for ParseError
168 unused = main_loop.Batch(cmd_ev, rc_c_parser, errfmt)
169
170 f.close()
171
172
173class ShellOptHook(state.OptHook):
174
175 def __init__(self, readline):
176 # type: (Optional[Readline]) -> None
177 self.readline = readline
178
179 def OnChange(self, opt0_array, opt_name, b):
180 # type: (List[bool], str, bool) -> bool
181 """This method is called whenever an option is changed.
182
183 Returns success or failure.
184 """
185 if opt_name == 'vi' or opt_name == 'emacs':
186 # TODO: Replace with a hook? Just like setting LANG= can have a hook.
187 if self.readline:
188 self.readline.parse_and_bind("set editing-mode " + opt_name)
189 else:
190 print_stderr(
191 "Warning: Can't set option %r because shell wasn't compiled with GNU readline"
192 % opt_name)
193 return False
194
195 # Invert: they are mutually exclusive!
196 if opt_name == 'vi':
197 opt0_array[option_i.emacs] = not b
198 elif opt_name == 'emacs':
199 opt0_array[option_i.vi] = not b
200
201 return True
202
203
204def _AddBuiltinFunc(mem, name, func):
205 # type: (state.Mem, str, vm._Callable) -> None
206 assert isinstance(func, vm._Callable), func
207 mem.AddBuiltin(name, value.BuiltinFunc(func))
208
209
210def InitAssignmentBuiltins(
211 mem, # type: state.Mem
212 procs, # type: state.Procs
213 exec_opts, # type: optview.Exec
214 errfmt, # type: ui.ErrorFormatter
215):
216 # type: (...) -> Dict[int, vm._AssignBuiltin]
217
218 assign_b = {} # type: Dict[int, vm._AssignBuiltin]
219
220 new_var = assign_osh.NewVar(mem, procs, exec_opts, errfmt)
221 assign_b[builtin_i.declare] = new_var
222 assign_b[builtin_i.typeset] = new_var
223 assign_b[builtin_i.local] = new_var
224
225 assign_b[builtin_i.export_] = assign_osh.Export(mem, errfmt)
226 assign_b[builtin_i.readonly] = assign_osh.Readonly(mem, errfmt)
227
228 return assign_b
229
230
231def Main(
232 lang, # type: str
233 arg_r, # type: args.Reader
234 environ, # type: Dict[str, str]
235 login_shell, # type: bool
236 loader, # type: pyutil._ResourceLoader
237 readline, # type: Optional[Readline]
238):
239 # type: (...) -> int
240 """The full shell lifecycle. Used by bin/osh and bin/ysh.
241
242 Args:
243 lang: 'osh' or 'ysh'
244 login_shell: Was - on argv[0]?
245 loader: to get help, version, grammar, etc.
246 readline: optional GNU readline
247 """
248 # Differences between osh and ysh:
249 # - oshrc vs yshrc
250 # - shopt -s ysh:all
251 # - Prompt
252 # - --help
253
254 argv0 = arg_r.Peek()
255 assert argv0 is not None
256 arg_r.Next()
257
258 assert lang in ('osh', 'ysh'), lang
259
260 try:
261 attrs = flag_util.ParseMore('main', arg_r)
262 except error.Usage as e:
263 print_stderr('%s usage error: %s' % (lang, e.msg))
264 return 2
265 flag = arg_types.main(attrs.attrs)
266
267 arena = alloc.Arena()
268 errfmt = ui.ErrorFormatter()
269
270 if flag.help:
271 util.HelpFlag(loader, '%s-usage' % lang, mylib.Stdout())
272 return 0
273 if flag.version:
274 util.VersionFlag(loader, mylib.Stdout())
275 return 0
276
277 if flag.tool == 'cat-em':
278 paths = arg_r.Rest()
279
280 status = 0
281 for p in paths:
282 try:
283 contents = loader.Get(p)
284 print(contents)
285 except (OSError, IOError):
286 print_stderr("cat-em: %r not found" % p)
287 status = 1
288 return status
289
290 script_name = arg_r.Peek() # type: Optional[str]
291 arg_r.Next()
292
293 if script_name is None:
294 dollar0 = argv0
295 # placeholder for -c or stdin (depending on flag.c)
296 frame0 = debug_frame.Dummy # type: debug_frame_t
297 else:
298 dollar0 = script_name
299 frame0 = debug_frame.MainFile(script_name)
300
301 debug_stack = [frame0]
302
303 env_dict = NewDict() # type: Dict[str, value_t]
304 defaults = NewDict() # type: Dict[str, value_t]
305 mem = state.Mem(dollar0,
306 arg_r.Rest(),
307 arena,
308 debug_stack,
309 env_dict,
310 defaults=defaults)
311
312 opt_hook = ShellOptHook(readline)
313 # Note: only MutableOpts needs mem, so it's not a true circular dep.
314 parse_opts, exec_opts, mutable_opts = state.MakeOpts(
315 mem, environ, opt_hook)
316 mem.exec_opts = exec_opts # circular dep
317 mutable_opts.Init()
318
319 # Set these BEFORE processing flags, so they can be overridden.
320 if lang == 'ysh':
321 mutable_opts.SetAnyOption('ysh:all', True)
322
323 pure_osh.SetOptionsFromFlags(mutable_opts, attrs.opt_changes,
324 attrs.shopt_changes)
325
326 version_str = pyutil.GetVersion(loader)
327 sh_init.InitBuiltins(mem, version_str, defaults)
328 sh_init.InitDefaultVars(mem)
329
330 sh_init.CopyVarsFromEnv(exec_opts, environ, mem)
331
332 # PATH PWD SHELLOPTS, etc. must be set after CopyVarsFromEnv()
333 sh_init.InitVarsAfterEnv(mem)
334
335 if attrs.show_options: # special case: sh -o
336 pure_osh.ShowOptions(mutable_opts, [])
337 return 0
338
339 # feedback between runtime and parser
340 aliases = NewDict() # type: Dict[str, str]
341
342 ysh_grammar = pyutil.LoadYshGrammar(loader)
343
344 if flag.do_lossless and not exec_opts.noexec():
345 raise error.Usage('--one-pass-parse requires noexec (-n)', loc.Missing)
346
347 # Tools always use one pass parse
348 # Note: osh --tool syntax-tree is like osh -n --one-pass-parse
349 do_lossless = True if len(flag.tool) else flag.do_lossless
350
351 parse_ctx = parse_lib.ParseContext(arena,
352 parse_opts,
353 aliases,
354 ysh_grammar,
355 do_lossless=do_lossless)
356
357 # Three ParseContext instances SHARE aliases.
358 comp_arena = alloc.Arena()
359 comp_arena.PushSource(source.Unused('completion'))
360 trail1 = parse_lib.Trail()
361 # do_lossless needs to be turned on to complete inside backticks. TODO:
362 # fix the issue where ` gets erased because it's not part of
363 # set_completer_delims().
364 comp_ctx = parse_lib.ParseContext(comp_arena,
365 parse_opts,
366 aliases,
367 ysh_grammar,
368 do_lossless=True)
369 comp_ctx.Init_Trail(trail1)
370
371 hist_arena = alloc.Arena()
372 hist_arena.PushSource(source.Unused('history'))
373 trail2 = parse_lib.Trail()
374 hist_ctx = parse_lib.ParseContext(hist_arena, parse_opts, aliases,
375 ysh_grammar)
376 hist_ctx.Init_Trail(trail2)
377
378 # Deps helps manages dependencies. These dependencies are circular:
379 # - cmd_ev and word_ev, arith_ev -- for command sub, arith sub
380 # - arith_ev and word_ev -- for $(( ${a} )) and $x$(( 1 ))
381 # - cmd_ev and builtins (which execute code, like eval)
382 # - prompt_ev needs word_ev for $PS1, which needs prompt_ev for @P
383 cmd_deps = cmd_eval.Deps()
384 cmd_deps.mutable_opts = mutable_opts
385
386 job_control = process.JobControl()
387 job_list = process.JobList()
388 fd_state = process.FdState(errfmt, job_control, job_list, mem, None, None,
389 exec_opts)
390
391 my_pid = posix.getpid()
392
393 debug_path = ''
394 debug_dir = environ.get('OILS_DEBUG_DIR')
395 if flag.debug_file is not None:
396 # --debug-file takes precedence over OSH_DEBUG_DIR
397 debug_path = flag.debug_file
398 elif debug_dir is not None:
399 debug_path = os_path.join(debug_dir, '%d-osh.log' % my_pid)
400
401 if len(debug_path):
402 # This will be created as an empty file if it doesn't exist, or it could be
403 # a pipe.
404 try:
405 debug_f = util.DebugFile(
406 fd_state.OpenForWrite(debug_path)) # type: util._DebugFile
407 except (IOError, OSError) as e:
408 print_stderr("%s: Couldn't open %r: %s" %
409 (lang, debug_path, posix.strerror(e.errno)))
410 return 2
411 else:
412 debug_f = util.NullDebugFile()
413
414 if flag.xtrace_to_debug_file:
415 trace_f = debug_f
416 else:
417 trace_f = util.DebugFile(mylib.Stderr())
418
419 trace_dir = environ.get('OILS_TRACE_DIR', '')
420 dumps = environ.get('OILS_TRACE_DUMPS', '')
421 streams = environ.get('OILS_TRACE_STREAMS', '')
422 multi_trace = dev.MultiTracer(my_pid, trace_dir, dumps, streams, fd_state)
423
424 tracer = dev.Tracer(parse_ctx, exec_opts, mutable_opts, mem, trace_f,
425 multi_trace)
426 fd_state.tracer = tracer # circular dep
427
428 signal_safe = iolib.InitSignalSafe()
429 trap_state = trap_osh.TrapState(signal_safe)
430
431 waiter = process.Waiter(job_list, exec_opts, signal_safe, tracer)
432 fd_state.waiter = waiter
433
434 cmd_deps.debug_f = debug_f
435
436 now = time_.time()
437 iso_stamp = time_.strftime("%Y-%m-%d %H:%M:%S", time_.localtime(now))
438
439 argv_buf = mylib.BufWriter()
440 dev.PrintShellArgv(arg_r.argv, argv_buf)
441
442 debug_f.writeln('%s [%d] Oils started with argv %s' %
443 (iso_stamp, my_pid, argv_buf.getvalue()))
444 if len(debug_path):
445 debug_f.writeln('Writing logs to %r' % debug_path)
446
447 interp = environ.get('OILS_HIJACK_SHEBANG', '')
448 search_path = executor.SearchPath(mem, exec_opts)
449 ext_prog = process.ExternalProgram(interp, fd_state, errfmt, debug_f)
450
451 splitter = split.SplitContext(mem)
452 # TODO: This is instantiation is duplicated in osh/word_eval.py
453 globber = glob_.Globber(exec_opts)
454
455 # This could just be OILS_TRACE_DUMPS='crash:argv0'
456 crash_dump_dir = environ.get('OILS_CRASH_DUMP_DIR', '')
457 cmd_deps.dumper = dev.CrashDumper(crash_dump_dir, fd_state)
458
459 comp_lookup = completion.Lookup()
460
461 # Various Global State objects to work around readline interfaces
462 compopt_state = completion.OptionState()
463
464 comp_ui_state = comp_ui.State()
465 prompt_state = comp_ui.PromptState()
466
467 # The login program is supposed to set $HOME
468 # https://superuser.com/questions/271925/where-is-the-home-environment-variable-set
469 # state.InitMem(mem) must happen first
470 tilde_ev = word_eval.TildeEvaluator(mem, exec_opts)
471 home_dir = tilde_ev.GetMyHomeDir()
472 if home_dir is None:
473 # TODO: print errno from getpwuid()
474 print_stderr("%s: Failed to get home dir from $HOME or getpwuid()" %
475 lang)
476 return 1
477
478 sh_files = sh_init.ShellFiles(lang, home_dir, mem, flag)
479
480 #
481 # Executor and Evaluators (are circularly dependent)
482 #
483
484 # Global proc namespace. Funcs are defined in the common variable
485 # namespace.
486 procs = state.Procs(mem) # type: state.Procs
487
488 builtins = {} # type: Dict[int, vm._Builtin]
489
490 # e.g. s.startswith()
491 methods = {} # type: Dict[int, Dict[str, vm._Callable]]
492
493 hay_state = hay_ysh.HayState()
494
495 shell_ex = executor.ShellExecutor(mem, exec_opts, mutable_opts, procs,
496 hay_state, builtins, search_path,
497 ext_prog, waiter, tracer, job_control,
498 job_list, fd_state, trap_state, errfmt)
499
500 arith_ev = sh_expr_eval.ArithEvaluator(mem, exec_opts, mutable_opts,
501 parse_ctx, errfmt)
502 bool_ev = sh_expr_eval.BoolEvaluator(mem, exec_opts, mutable_opts,
503 parse_ctx, errfmt)
504 expr_ev = expr_eval.ExprEvaluator(mem, mutable_opts, methods, splitter,
505 errfmt)
506 word_ev = word_eval.NormalWordEvaluator(mem, exec_opts, mutable_opts,
507 tilde_ev, splitter, errfmt)
508
509 assign_b = InitAssignmentBuiltins(mem, procs, exec_opts, errfmt)
510 cmd_ev = cmd_eval.CommandEvaluator(mem, exec_opts, errfmt, procs, assign_b,
511 arena, cmd_deps, trap_state,
512 signal_safe)
513
514 # PromptEvaluator rendering is needed in non-interactive shells for @P.
515 prompt_ev = prompt.Evaluator(lang, version_str, parse_ctx, mem)
516
517 io_methods = NewDict() # type: Dict[str, value_t]
518 io_methods['promptVal'] = value.BuiltinFunc(method_io.PromptVal(prompt_ev))
519
520 # The M/ prefix means it's io->eval()
521 io_methods['M/eval'] = value.BuiltinFunc(
522 method_io.Eval(mem, cmd_ev, method_io.EVAL_NULL))
523 io_methods['M/evalToDict'] = value.BuiltinFunc(
524 method_io.Eval(mem, cmd_ev, method_io.EVAL_DICT))
525 io_methods['M/evalInFrame'] = value.BuiltinFunc(
526 method_io.EvalInFrame(mem, cmd_ev))
527 io_methods['M/evalExpr'] = value.BuiltinFunc(method_io.EvalExpr(expr_ev))
528
529 # Identical to command sub
530 io_methods['captureStdout'] = value.BuiltinFunc(
531 method_io.CaptureStdout(mem, shell_ex))
532
533 # TODO:
534 io_methods['time'] = value.BuiltinFunc(method_io.Time())
535 io_methods['strftime'] = value.BuiltinFunc(method_io.Strftime())
536 io_methods['glob'] = value.BuiltinFunc(method_io.Glob())
537
538 io_props = {'stdin': value.Stdin} # type: Dict[str, value_t]
539 io_obj = Obj(Obj(None, io_methods), io_props)
540
541 vm_methods = NewDict() # type: Dict[str, value_t]
542 # These are methods, not free functions, because they reflect VM state
543 vm_methods['getFrame'] = value.BuiltinFunc(func_reflect.GetFrame(mem))
544 vm_methods['getDebugStack'] = value.BuiltinFunc(
545 func_reflect.GetDebugStack(mem))
546 vm_methods['id'] = value.BuiltinFunc(func_reflect.Id())
547
548 vm_props = NewDict() # type: Dict[str, value_t]
549 vm_obj = Obj(Obj(None, vm_methods), vm_props)
550
551 # Add basic type objects for flag parser
552 # flag -v --verbose (Bool, help='foo')
553 #
554 # TODO:
555 # - Add other types like Dict, CommandFlag
556 # - Obj(first, rest)
557 # - List() Dict() Obj() can do shallow copy with __call__
558
559 # - type(x) should return these Obj, or perhaps typeObj(x)
560 # - __str__ method for echo $[type(x)] ?
561
562 # TODO: List and Dict could be the only ones with __index__?
563 i_func = method_type.Index__()
564 type_m = NewDict() # type: Dict[str, value_t]
565 type_m['__index__'] = value.BuiltinFunc(i_func)
566 type_obj_methods = Obj(None, type_m)
567
568 # Note: Func[Int -> Int] is something we should do?
569 for tag in [
570 value_e.Bool,
571 value_e.Int,
572 value_e.Float,
573 value_e.Str,
574 value_e.List,
575 value_e.Dict,
576 ]:
577 type_name = value_str(tag, dot=False)
578 #log('%s %s' , type_name, tag)
579 type_obj = Obj(type_obj_methods, {'name': value.Str(type_name)})
580 mem.AddBuiltin(type_name, type_obj)
581
582 # Initialize Obj
583 tag = value_e.Obj
584 type_name = value_str(tag, dot=False)
585
586 # TODO: change Obj.new to __call__
587 type_props = NewDict() # type: Dict[str, value_t]
588 type_props['name'] = value.Str(type_name)
589 type_props['new'] = value.BuiltinFunc(func_misc.Obj_call())
590 type_obj = Obj(type_obj_methods, type_props)
591
592 mem.AddBuiltin(type_name, type_obj)
593
594 # Wire up circular dependencies.
595 vm.InitCircularDeps(arith_ev, bool_ev, expr_ev, word_ev, cmd_ev, shell_ex,
596 prompt_ev, io_obj, tracer)
597
598 unsafe_arith = sh_expr_eval.UnsafeArith(mem, exec_opts, mutable_opts,
599 parse_ctx, arith_ev, errfmt)
600 vm.InitUnsafeArith(mem, word_ev, unsafe_arith)
601
602 #
603 # Initialize Built-in Procs
604 #
605
606 b = builtins # short alias for initialization
607
608 if mylib.PYTHON:
609 if help_meta:
610 help_data = help_meta.TopicMetadata()
611 else:
612 help_data = NewDict() # minimal build
613 else:
614 help_data = help_meta.TopicMetadata()
615 b[builtin_i.help] = misc_osh.Help(lang, loader, help_data, errfmt)
616
617 # Interpreter state
618 b[builtin_i.set] = pure_osh.Set(mutable_opts, mem)
619 b[builtin_i.shopt] = pure_osh.Shopt(exec_opts, mutable_opts, cmd_ev, mem,
620 environ)
621
622 b[builtin_i.hash] = pure_osh.Hash(search_path) # not really pure
623 b[builtin_i.trap] = trap_osh.Trap(trap_state, parse_ctx, tracer, errfmt)
624
625 b[builtin_i.shvar] = pure_ysh.Shvar(mem, search_path, cmd_ev)
626 b[builtin_i.ctx] = pure_ysh.Ctx(mem, cmd_ev)
627 b[builtin_i.push_registers] = pure_ysh.PushRegisters(mem, cmd_ev)
628
629 # Hay
630 b[builtin_i.hay] = hay_ysh.Hay(hay_state, mutable_opts, mem, cmd_ev)
631 b[builtin_i.haynode] = hay_ysh.HayNode_(hay_state, mem, cmd_ev)
632
633 # Interpreter introspection
634 b[builtin_i.type] = meta_oils.Type(procs, aliases, search_path, errfmt)
635 b[builtin_i.builtin] = meta_oils.Builtin(shell_ex, errfmt)
636 b[builtin_i.command] = meta_oils.Command(shell_ex, procs, aliases,
637 search_path)
638 # Part of YSH, but similar to builtin/command
639 b[builtin_i.runproc] = meta_oils.RunProc(shell_ex, procs, errfmt)
640 b[builtin_i.invoke] = meta_oils.Invoke(shell_ex, procs, errfmt)
641 b[builtin_i.extern_] = meta_oils.Extern(shell_ex, procs, errfmt)
642
643 # Meta builtins
644 module_invoke = module_ysh.ModuleInvoke(cmd_ev, tracer, errfmt)
645 b[builtin_i.use] = meta_oils.ShellFile(parse_ctx,
646 search_path,
647 cmd_ev,
648 fd_state,
649 tracer,
650 errfmt,
651 loader,
652 module_invoke=module_invoke)
653 source_builtin = meta_oils.ShellFile(parse_ctx, search_path, cmd_ev,
654 fd_state, tracer, errfmt, loader)
655 b[builtin_i.source] = source_builtin
656 b[builtin_i.dot] = source_builtin
657 b[builtin_i.eval] = meta_oils.Eval(parse_ctx, exec_opts, cmd_ev, tracer,
658 errfmt, mem)
659
660 # Module builtins
661 guards = NewDict() # type: Dict[str, bool]
662 b[builtin_i.source_guard] = module_ysh.SourceGuard(guards, exec_opts,
663 errfmt)
664 b[builtin_i.is_main] = module_ysh.IsMain(mem)
665
666 # Errors
667 b[builtin_i.error] = error_ysh.Error()
668 b[builtin_i.failed] = error_ysh.Failed(mem)
669 b[builtin_i.boolstatus] = error_ysh.BoolStatus(shell_ex, errfmt)
670 b[builtin_i.try_] = error_ysh.Try(mutable_opts, mem, cmd_ev, shell_ex,
671 errfmt)
672 b[builtin_i.assert_] = error_ysh.Assert(expr_ev, errfmt)
673
674 # Pure builtins
675 true_ = pure_osh.Boolean(0)
676 b[builtin_i.colon] = true_ # a "special" builtin
677 b[builtin_i.true_] = true_
678 b[builtin_i.false_] = pure_osh.Boolean(1)
679
680 b[builtin_i.alias] = pure_osh.Alias(aliases, errfmt)
681 b[builtin_i.unalias] = pure_osh.UnAlias(aliases, errfmt)
682
683 b[builtin_i.getopts] = pure_osh.GetOpts(mem, errfmt)
684
685 b[builtin_i.shift] = assign_osh.Shift(mem)
686 b[builtin_i.unset] = assign_osh.Unset(mem, procs, unsafe_arith, errfmt)
687
688 b[builtin_i.append] = pure_ysh.Append(mem, errfmt)
689
690 # test / [ differ by need_right_bracket
691 b[builtin_i.test] = bracket_osh.Test(False, exec_opts, mem, errfmt)
692 b[builtin_i.bracket] = bracket_osh.Test(True, exec_opts, mem, errfmt)
693
694 # Output
695 b[builtin_i.echo] = io_osh.Echo(exec_opts)
696 b[builtin_i.printf] = printf_osh.Printf(mem, parse_ctx, unsafe_arith,
697 errfmt)
698 b[builtin_i.write] = io_ysh.Write(mem, errfmt)
699 redir_builtin = io_ysh.RunBlock(mem, cmd_ev) # used only for redirects
700 b[builtin_i.redir] = redir_builtin
701 b[builtin_i.fopen] = redir_builtin # alias for backward compatibility
702
703 # (pp output format isn't stable)
704 b[builtin_i.pp] = io_ysh.Pp(expr_ev, mem, errfmt, procs, arena)
705
706 # Input
707 b[builtin_i.cat] = io_osh.Cat() # for $(<file)
708 b[builtin_i.read] = read_osh.Read(splitter, mem, parse_ctx, cmd_ev, errfmt)
709
710 mapfile = io_osh.MapFile(mem, errfmt, cmd_ev)
711 b[builtin_i.mapfile] = mapfile
712 b[builtin_i.readarray] = mapfile
713
714 # Dirs
715 dir_stack = dirs_osh.DirStack()
716 b[builtin_i.cd] = dirs_osh.Cd(mem, dir_stack, cmd_ev, errfmt)
717 b[builtin_i.pushd] = dirs_osh.Pushd(mem, dir_stack, errfmt)
718 b[builtin_i.popd] = dirs_osh.Popd(mem, dir_stack, errfmt)
719 b[builtin_i.dirs] = dirs_osh.Dirs(mem, dir_stack, errfmt)
720 b[builtin_i.pwd] = dirs_osh.Pwd(mem, errfmt)
721
722 b[builtin_i.times] = misc_osh.Times()
723
724 b[builtin_i.json] = json_ysh.Json(mem, errfmt, False)
725 b[builtin_i.json8] = json_ysh.Json(mem, errfmt, True)
726
727 ### Process builtins
728 b[builtin_i.exec_] = process_osh.Exec(mem, ext_prog, fd_state, search_path,
729 errfmt)
730 b[builtin_i.umask] = process_osh.Umask()
731 b[builtin_i.ulimit] = process_osh.Ulimit()
732 b[builtin_i.wait] = process_osh.Wait(waiter, job_list, mem, tracer, errfmt)
733
734 b[builtin_i.jobs] = process_osh.Jobs(job_list)
735 b[builtin_i.fg] = process_osh.Fg(job_control, job_list, waiter)
736 b[builtin_i.bg] = process_osh.Bg(job_list)
737
738 # Could be in process_ysh
739 b[builtin_i.fork] = process_osh.Fork(shell_ex)
740 b[builtin_i.forkwait] = process_osh.ForkWait(shell_ex)
741
742 # Interactive builtins depend on readline
743 b[builtin_i.bind] = readline_osh.Bind(readline, errfmt)
744 b[builtin_i.history] = readline_osh.History(readline, sh_files, errfmt,
745 mylib.Stdout())
746
747 # Completion
748 spec_builder = completion_osh.SpecBuilder(cmd_ev, parse_ctx, word_ev,
749 splitter, comp_lookup, help_data,
750 errfmt)
751 complete_builtin = completion_osh.Complete(spec_builder, comp_lookup)
752 b[builtin_i.complete] = complete_builtin
753 b[builtin_i.compgen] = completion_osh.CompGen(spec_builder)
754 b[builtin_i.compopt] = completion_osh.CompOpt(compopt_state, errfmt)
755 b[builtin_i.compadjust] = completion_osh.CompAdjust(mem)
756
757 comp_ev = word_eval.CompletionWordEvaluator(mem, exec_opts, mutable_opts,
758 tilde_ev, splitter, errfmt)
759
760 comp_ev.arith_ev = arith_ev
761 comp_ev.expr_ev = expr_ev
762 comp_ev.prompt_ev = prompt_ev
763 comp_ev.CheckCircularDeps()
764
765 root_comp = completion.RootCompleter(comp_ev, mem, comp_lookup,
766 compopt_state, comp_ui_state,
767 comp_ctx, debug_f)
768 b[builtin_i.compexport] = completion_ysh.CompExport(root_comp)
769
770 #
771 # Initialize Builtin-in Methods
772 #
773
774 methods[value_e.Str] = {
775 'startsWith': method_str.HasAffix(method_str.START),
776 'endsWith': method_str.HasAffix(method_str.END),
777 'trim': method_str.Trim(method_str.START | method_str.END),
778 'trimStart': method_str.Trim(method_str.START),
779 'trimEnd': method_str.Trim(method_str.END),
780 'upper': method_str.Upper(),
781 'lower': method_str.Lower(),
782 'split': method_str.Split(),
783 'lines': method_str.Lines(),
784
785 # finds a substring, optional position to start at
786 'find': None,
787
788 # replace substring, OR an eggex
789 # takes count=3, the max number of replacements to do.
790 'replace': method_str.Replace(mem, expr_ev),
791
792 # Like Python's re.search, except we put it on the string object
793 # It's more consistent with Str->find(substring, pos=0)
794 # It returns value.Match() rather than an integer
795 'search': method_str.SearchMatch(method_str.SEARCH),
796
797 # like Python's re.match()
798 'leftMatch': method_str.SearchMatch(method_str.LEFT_MATCH),
799
800 # like Python's re.fullmatch(), not sure if we really need it
801 'fullMatch': None,
802 }
803 methods[value_e.Dict] = {
804 # keys() values() get() are FREE functions, not methods
805 # I think items() isn't as necessary because dicts are ordered? YSH
806 # code shouldn't use the List of Lists representation.
807 'M/erase': method_dict.Erase(),
808 # could be d->tally() or d->increment(), but inc() is short
809 #
810 # call d->inc('mycounter')
811 # call d->inc('mycounter', 3)
812 'M/inc': None,
813
814 # call d->accum('mygroup', 'value')
815 'M/accum': None,
816
817 # DEPRECATED - use free functions
818 'get': method_dict.Get(),
819 'keys': method_dict.Keys(),
820 'values': method_dict.Values(),
821 }
822 methods[value_e.List] = {
823 'M/reverse': method_list.Reverse(),
824 'M/append': method_list.Append(),
825 'M/clear': method_list.Clear(),
826 'M/extend': method_list.Extend(),
827 'M/pop': method_list.Pop(),
828 'M/insert': None, # insert object before index
829 'M/remove': None, # insert object before index
830 'indexOf': method_list.IndexOf(), # return first index of value, or -1
831 # Python list() has index(), which raises ValueError
832 # But this is consistent with Str->find(), and doesn't
833 # use exceptions
834 'lastIndexOf': method_list.LastIndexOf(),
835 'join': func_misc.Join(), # both a method and a func
836 }
837
838 methods[value_e.Match] = {
839 'group': func_eggex.MatchMethod(func_eggex.G, expr_ev),
840 'start': func_eggex.MatchMethod(func_eggex.S, None),
841 'end': func_eggex.MatchMethod(func_eggex.E, None),
842 }
843
844 methods[value_e.Place] = {
845 # __mut_setValue()
846
847 # instead of setplace keyword
848 'M/setValue': method_other.SetValue(mem),
849 }
850
851 methods[value_e.CommandFrag] = {
852 # var x = ^(echo hi)
853 # Export source code and line number
854 # Useful for test frameworks and so forth
855 'export': None,
856 }
857
858 methods[value_e.DebugFrame] = {
859 'toString': func_reflect.DebugFrameToString(),
860 }
861
862 #
863 # Initialize Built-in Funcs
864 #
865
866 parse_hay = func_hay.ParseHay(fd_state, parse_ctx, mem, errfmt)
867 eval_hay = func_hay.EvalHay(hay_state, mutable_opts, mem, cmd_ev)
868 hay_func = func_hay.HayFunc(hay_state)
869
870 _AddBuiltinFunc(mem, 'parseHay', parse_hay)
871 _AddBuiltinFunc(mem, 'evalHay', eval_hay)
872 _AddBuiltinFunc(mem, '_hay', hay_func)
873
874 _AddBuiltinFunc(mem, 'len', func_misc.Len())
875 _AddBuiltinFunc(mem, 'type', func_misc.Type())
876
877 g = func_eggex.MatchFunc(func_eggex.G, expr_ev, mem)
878 _AddBuiltinFunc(mem, '_group', g)
879 _AddBuiltinFunc(mem, '_match',
880 g) # TODO: remove this backward compat alias
881 _AddBuiltinFunc(mem, '_start',
882 func_eggex.MatchFunc(func_eggex.S, None, mem))
883 _AddBuiltinFunc(mem, '_end', func_eggex.MatchFunc(func_eggex.E, None, mem))
884
885 # TODO: should this be parseCommandStr() vs. parseFile() for Hay?
886 _AddBuiltinFunc(mem, 'parseCommand',
887 func_reflect.ParseCommand(parse_ctx, mem, errfmt))
888 _AddBuiltinFunc(mem, 'parseExpr',
889 func_reflect.ParseExpr(parse_ctx, errfmt))
890
891 _AddBuiltinFunc(mem, 'shvarGet', func_reflect.Shvar_get(mem))
892 _AddBuiltinFunc(mem, 'getVar', func_reflect.GetVar(mem))
893 _AddBuiltinFunc(mem, 'setVar', func_reflect.SetVar(mem))
894
895 # TODO: implement bindFrame() to turn CommandFrag -> Command
896 # Then parseCommand() and parseHay() will not depend on mem; they will not
897 # bind a frame yet
898 #
899 # what about newFrame() and globalFrame()?
900 _AddBuiltinFunc(mem, 'bindFrame', func_reflect.BindFrame())
901
902 _AddBuiltinFunc(mem, 'Object', func_misc.Object())
903
904 _AddBuiltinFunc(mem, 'rest', func_misc.Prototype())
905 _AddBuiltinFunc(mem, 'first', func_misc.PropView())
906
907 # TODO: remove these aliases
908 _AddBuiltinFunc(mem, 'prototype', func_misc.Prototype())
909 _AddBuiltinFunc(mem, 'propView', func_misc.PropView())
910
911 # type conversions
912 _AddBuiltinFunc(mem, 'bool', func_misc.Bool())
913 _AddBuiltinFunc(mem, 'int', func_misc.Int())
914 _AddBuiltinFunc(mem, 'float', func_misc.Float())
915 _AddBuiltinFunc(mem, 'str', func_misc.Str_())
916 _AddBuiltinFunc(mem, 'list', func_misc.List_())
917 _AddBuiltinFunc(mem, 'dict', func_misc.DictFunc())
918
919 # Dict functions
920 _AddBuiltinFunc(mem, 'get', method_dict.Get())
921 _AddBuiltinFunc(mem, 'keys', method_dict.Keys())
922 _AddBuiltinFunc(mem, 'values', method_dict.Values())
923
924 _AddBuiltinFunc(mem, 'runes', func_misc.Runes())
925 _AddBuiltinFunc(mem, 'encodeRunes', func_misc.EncodeRunes())
926 _AddBuiltinFunc(mem, 'bytes', func_misc.Bytes())
927 _AddBuiltinFunc(mem, 'encodeBytes', func_misc.EncodeBytes())
928
929 # Str
930 #_AddBuiltinFunc(mem, 'strcmp', None)
931 # TODO: This should be Python style splitting
932 _AddBuiltinFunc(mem, 'split', func_misc.Split(splitter))
933 _AddBuiltinFunc(mem, 'shSplit', func_misc.Split(splitter))
934
935 # Float
936 _AddBuiltinFunc(mem, 'floatsEqual', func_misc.FloatsEqual())
937
938 # List
939 _AddBuiltinFunc(mem, 'join', func_misc.Join())
940 _AddBuiltinFunc(mem, 'maybe', func_misc.Maybe())
941 _AddBuiltinFunc(mem, 'glob', func_misc.Glob(globber))
942
943 # Serialize
944 _AddBuiltinFunc(mem, 'toJson8', func_misc.ToJson8(True))
945 _AddBuiltinFunc(mem, 'toJson', func_misc.ToJson8(False))
946
947 _AddBuiltinFunc(mem, 'fromJson8', func_misc.FromJson8(True))
948 _AddBuiltinFunc(mem, 'fromJson', func_misc.FromJson8(False))
949
950 # Demos
951 _AddBuiltinFunc(mem, '_a2sp', func_misc.BashArrayToSparse())
952 _AddBuiltinFunc(mem, '_opsp', func_misc.SparseOp())
953
954 mem.AddBuiltin('io', io_obj)
955 mem.AddBuiltin('vm', vm_obj)
956
957 # Special case for testing
958 mem.AddBuiltin('module-invoke', value.BuiltinProc(module_invoke))
959
960 #
961 # Is the shell interactive?
962 #
963
964 # History evaluation is a no-op if readline is None.
965 hist_ev = history.Evaluator(readline, hist_ctx, debug_f)
966
967 if flag.c is not None:
968 src = source.CFlag # type: source_t
969 line_reader = reader.StringLineReader(flag.c,
970 arena) # type: reader._Reader
971 if flag.i: # -c and -i can be combined
972 mutable_opts.set_interactive()
973
974 elif flag.i: # force interactive
975 src = source.Stdin(' -i')
976 line_reader = reader.InteractiveLineReader(arena, prompt_ev, hist_ev,
977 readline, prompt_state)
978 mutable_opts.set_interactive()
979
980 else:
981 if script_name is None:
982 if flag.headless:
983 src = source.Headless
984 line_reader = None # unused!
985 # Not setting '-i' flag for now. Some people's bashrc may want it?
986 else:
987 stdin_ = mylib.Stdin()
988 # --tool never starts a prompt
989 if len(flag.tool) == 0 and stdin_.isatty():
990 src = source.Interactive
991 line_reader = reader.InteractiveLineReader(
992 arena, prompt_ev, hist_ev, readline, prompt_state)
993 mutable_opts.set_interactive()
994 else:
995 src = source.Stdin('')
996 line_reader = reader.FileLineReader(stdin_, arena)
997 else:
998 src = source.MainFile(script_name)
999 try:
1000 f = fd_state.Open(script_name)
1001 except (IOError, OSError) as e:
1002 print_stderr("%s: Couldn't open %r: %s" %
1003 (lang, script_name, posix.strerror(e.errno)))
1004 return 1
1005 line_reader = reader.FileLineReader(f, arena)
1006
1007 # Pretend it came from somewhere else
1008 if flag.location_str is not None:
1009 src = source.Synthetic(flag.location_str)
1010 assert line_reader is not None
1011 location_start_line = mops.BigTruncate(flag.location_start_line)
1012 if location_start_line != -1:
1013 line_reader.SetLineOffset(location_start_line)
1014
1015 arena.PushSource(src)
1016
1017 # Calculate ~/.config/oils/oshrc or yshrc. Used for both -i and --headless
1018 # We avoid cluttering the user's home directory. Some users may want to ln
1019 # -s ~/.config/oils/oshrc ~/oshrc or ~/.oshrc.
1020
1021 # https://unix.stackexchange.com/questions/24347/why-do-some-applications-use-config-appname-for-their-config-data-while-other
1022
1023 config_dir = '.config/oils'
1024 rc_paths = [] # type: List[str]
1025 if flag.headless or exec_opts.interactive():
1026 if flag.norc:
1027 # bash doesn't have this warning, but it's useful
1028 if flag.rcfile is not None:
1029 print_stderr('%s warning: --rcfile ignored with --norc' % lang)
1030 if flag.rcdir is not None:
1031 print_stderr('%s warning: --rcdir ignored with --norc' % lang)
1032 else:
1033 # User's rcfile comes FIRST. Later we can add an 'after-rcdir' hook
1034 rc_path = flag.rcfile
1035 if rc_path is None:
1036 rc_paths.append(
1037 os_path.join(home_dir, '%s/%src' % (config_dir, lang)))
1038 else:
1039 rc_paths.append(rc_path)
1040
1041 # Load all files in ~/.config/oils/oshrc.d or oilrc.d
1042 # This way "installers" can avoid mutating oshrc directly
1043
1044 rc_dir = flag.rcdir
1045 if rc_dir is None:
1046 rc_dir = os_path.join(home_dir,
1047 '%s/%src.d' % (config_dir, lang))
1048
1049 rc_paths.extend(libc.glob(os_path.join(rc_dir, '*'), 0))
1050
1051 # Initialize even in non-interactive shell, for 'compexport'
1052 _InitDefaultCompletions(cmd_ev, complete_builtin, comp_lookup)
1053
1054 if flag.headless:
1055 sh_init.InitInteractive(mem, sh_files, lang)
1056 mutable_opts.set_redefine_const()
1057 mutable_opts.set_redefine_source()
1058
1059 # NOTE: rc files loaded AFTER _InitDefaultCompletions.
1060 for rc_path in rc_paths:
1061 with state.ctx_ThisDir(mem, rc_path):
1062 try:
1063 SourceStartupFile(fd_state, rc_path, lang, parse_ctx,
1064 cmd_ev, errfmt)
1065 except util.UserExit as e:
1066 return e.status
1067
1068 loop = main_loop.Headless(cmd_ev, parse_ctx, errfmt)
1069 try:
1070 # TODO: What other exceptions happen here?
1071 status = loop.Loop()
1072 except util.UserExit as e:
1073 status = e.status
1074
1075 # Same logic as interactive shell
1076 mut_status = IntParamBox(status)
1077 cmd_ev.RunTrapsOnExit(mut_status)
1078 status = mut_status.i
1079
1080 return status
1081
1082 # Note: headless mode above doesn't use c_parser
1083 assert line_reader is not None
1084 c_parser = parse_ctx.MakeOshParser(line_reader)
1085
1086 if exec_opts.interactive():
1087 sh_init.InitInteractive(mem, sh_files, lang)
1088 # bash: 'set -o emacs' is the default only in the interactive shell
1089 mutable_opts.set_emacs()
1090 mutable_opts.set_redefine_const()
1091 mutable_opts.set_redefine_source()
1092
1093 # NOTE: rc files loaded AFTER _InitDefaultCompletions.
1094 for rc_path in rc_paths:
1095 with state.ctx_ThisDir(mem, rc_path):
1096 try:
1097 SourceStartupFile(fd_state, rc_path, lang, parse_ctx,
1098 cmd_ev, errfmt)
1099 except util.UserExit as e:
1100 return e.status
1101
1102 completion_display = state.MaybeString(mem, 'OILS_COMP_UI')
1103 if completion_display is None:
1104 completion_display = flag.completion_display
1105
1106 if readline:
1107 if completion_display == 'nice':
1108 display = comp_ui.NiceDisplay(
1109 comp_ui_state, prompt_state, debug_f, readline,
1110 signal_safe) # type: comp_ui._IDisplay
1111 else:
1112 display = comp_ui.MinimalDisplay(comp_ui_state, prompt_state,
1113 debug_f, signal_safe)
1114
1115 comp_ui.InitReadline(readline, sh_files.HistoryFile(), root_comp,
1116 display, debug_f)
1117
1118 if flag.completion_demo:
1119 _CompletionDemo(comp_lookup)
1120
1121 else: # Without readline module
1122 display = comp_ui.MinimalDisplay(comp_ui_state, prompt_state,
1123 debug_f, signal_safe)
1124
1125 process.InitInteractiveShell(signal_safe) # Set signal handlers
1126 # The interactive shell leads a process group which controls the terminal.
1127 # It MUST give up the terminal afterward, otherwise we get SIGTTIN /
1128 # SIGTTOU bugs.
1129 with process.ctx_TerminalControl(job_control, errfmt):
1130
1131 assert line_reader is not None
1132 line_reader.Reset() # After sourcing startup file, render $PS1
1133
1134 prompt_plugin = prompt.UserPlugin(mem, parse_ctx, cmd_ev, errfmt)
1135 try:
1136 status = main_loop.Interactive(flag, cmd_ev, c_parser, display,
1137 prompt_plugin, waiter, errfmt)
1138 except util.UserExit as e:
1139 status = e.status
1140
1141 mut_status = IntParamBox(status)
1142 cmd_ev.RunTrapsOnExit(mut_status)
1143 status = mut_status.i
1144
1145 if readline:
1146 hist_file = sh_files.HistoryFile()
1147 if hist_file is not None:
1148 try:
1149 readline.write_history_file(hist_file)
1150 except (IOError, OSError):
1151 pass
1152
1153 return status
1154
1155 if flag.rcfile is not None: # bash doesn't have this warning, but it's useful
1156 print_stderr('%s warning: --rcfile ignored in non-interactive shell' %
1157 lang)
1158 if flag.rcdir is not None:
1159 print_stderr('%s warning: --rcdir ignored in non-interactive shell' %
1160 lang)
1161
1162 #
1163 # Tools that use the OSH/YSH parsing mode, etc.
1164 #
1165
1166 # flag.tool is '' if nothing is passed
1167 # osh --tool syntax-tree is equivalent to osh -n --one-pass-parse
1168 tool_name = 'syntax-tree' if exec_opts.noexec() else flag.tool
1169
1170 if len(tool_name):
1171 # Don't save tokens becaues it's slow
1172 if tool_name != 'syntax-tree':
1173 arena.SaveTokens()
1174
1175 try:
1176 node = main_loop.ParseWholeFile(c_parser)
1177 except error.Parse as e:
1178 errfmt.PrettyPrintError(e)
1179 return 2
1180
1181 if tool_name == 'syntax-tree':
1182 ui.PrintAst(node, flag)
1183
1184 elif tool_name == 'tokens':
1185 ysh_ify.PrintTokens(arena)
1186
1187 elif tool_name == 'lossless-cat': # for test/lossless.sh
1188 ysh_ify.LosslessCat(arena)
1189
1190 elif tool_name == 'fmt':
1191 fmt.Format(arena, node)
1192
1193 elif tool_name == 'test':
1194 raise AssertionError('TODO')
1195
1196 elif tool_name == 'ysh-ify':
1197 ysh_ify.Ysh_ify(arena, node)
1198
1199 elif tool_name == 'deps':
1200 if mylib.PYTHON:
1201 deps.Deps(node)
1202
1203 else:
1204 raise AssertionError(tool_name) # flag parser validated it
1205
1206 return 0
1207
1208 #
1209 # Run a shell script
1210 #
1211
1212 with state.ctx_ThisDir(mem, script_name):
1213 try:
1214 status = main_loop.Batch(cmd_ev,
1215 c_parser,
1216 errfmt,
1217 cmd_flags=cmd_eval.IsMainProgram)
1218 except util.UserExit as e:
1219 status = e.status
1220 except KeyboardInterrupt:
1221 # The interactive shell handles this in main_loop.Interactive
1222 status = 130 # 128 + 2
1223 mut_status = IntParamBox(status)
1224 cmd_ev.RunTrapsOnExit(mut_status)
1225
1226 multi_trace.WriteDumps()
1227
1228 # NOTE: We haven't closed the file opened with fd_state.Open
1229 return mut_status.i