mirror of
https://git.savannah.gnu.org/git/guile.git
synced 2025-05-01 04:10:18 +02:00
* module/system/repl/debug.scm: New file, defines a data type to hold state for a debugger stack, and some helper procedures to print the stack or print a frame. Most pieces are from (system vm debug). * module/system/repl/error-handling.scm: New file, implements call-with-error-handling and with-error-handling, and instead of going into a debugger, we go into a recursive repl that happens to have debugging information. Will be removing the old debugger from (system vm debug) shortly. * module/Makefile.am (SYSTEM_SOURCES): Add error-handling and debug scm files. * module/system/repl/repl.scm (prompting-meta-read): Better error handling -- we don't want to go into a debugger when reading a command. (start-repl): Add #:debug keyword argument, and just dispatch to run-repl. (run-repl): New function, with the guts of the old start-repl. Added a prompt, to which a throw to 'quit will abort. * module/system/repl/common.scm (repl-prepare-eval-thunk): New helper. In the future we will use this to not enter the debugger on errors that happen at compile time. (repl-eval): Use repl-prepare-eval-thunk. (repl-print): Run the before-print-hook when printing a value. * module/system/repl/command.scm (*command-table*): Move `option' to the `system' group. Move `trace' to the `profile' group. Add `debug' and `inspect' groups. (command-abbrevs): Rename from command-abbrev, and allow multiple abbreviations. (display-group): Fix the case where abbrev? was #f. (display-summary): Fix alignment of the command and abbreviations. Allow multiple abbreviations. (read-command): Rename from read-datum, and have better error handling. (meta-command): Better error handling. (define-meta-command): Better error handling. (help, show, import, compile, disassemble, time, profile, trace): Fix docstrings and error messages. (define-stack-command): New helper, for commands that operate on a saved stack. (backtrace, up, down, frame, procedure, locals): New debugger commands, in the REPL now. (inspect, pretty-print): New "inspect" commands.
151 lines
5.1 KiB
Scheme
151 lines
5.1 KiB
Scheme
;;; Read-Eval-Print Loop
|
||
|
||
;; Copyright (C) 2001, 2009, 2010 Free Software Foundation, Inc.
|
||
|
||
;; This library is free software; you can redistribute it and/or
|
||
;; modify it under the terms of the GNU Lesser General Public
|
||
;; License as published by the Free Software Foundation; either
|
||
;; version 3 of the License, or (at your option) any later version.
|
||
;;
|
||
;; This library is distributed in the hope that it will be useful,
|
||
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
;; Lesser General Public License for more details.
|
||
;;
|
||
;; You should have received a copy of the GNU Lesser General Public
|
||
;; License along with this library; if not, write to the Free Software
|
||
;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
||
;; 02110-1301 USA
|
||
|
||
;;; Code:
|
||
|
||
(define-module (system repl repl)
|
||
#:use-module (system base syntax)
|
||
#:use-module (system base pmatch)
|
||
#:use-module (system base compile)
|
||
#:use-module (system base language)
|
||
#:use-module (system vm vm)
|
||
#:use-module (system repl error-handling)
|
||
#:use-module (system repl common)
|
||
#:use-module (system repl command)
|
||
#:export (start-repl))
|
||
|
||
|
||
|
||
;;;
|
||
;;; Meta commands
|
||
;;;
|
||
|
||
(define meta-command-token (cons 'meta 'command))
|
||
|
||
(define (meta-reader read env)
|
||
(lambda read-args
|
||
(let ((port (if (pair? read-args) (car read-args) (current-input-port))))
|
||
(with-input-from-port port
|
||
(lambda ()
|
||
(let ((ch (next-char #t)))
|
||
(cond ((eof-object? ch)
|
||
;; apparently sometimes even if this is eof, read will
|
||
;; wait on somethingorother. strange.
|
||
ch)
|
||
((eqv? ch #\,)
|
||
(read-char port)
|
||
meta-command-token)
|
||
(else (read port env)))))))))
|
||
|
||
;; repl-reader is a function defined in boot-9.scm, and is replaced by
|
||
;; something else if readline has been activated. much of this hoopla is
|
||
;; to be able to re-use the existing readline machinery.
|
||
;;
|
||
;; Catches read errors, returning *unspecified* in that case.
|
||
(define (prompting-meta-read repl)
|
||
(catch #t
|
||
(lambda ()
|
||
(repl-reader (lambda () (repl-prompt repl))
|
||
(meta-reader (language-reader (repl-language repl))
|
||
(current-module))))
|
||
(lambda (key . args)
|
||
(case key
|
||
((quit)
|
||
(apply throw key args))
|
||
(else
|
||
(pmatch args
|
||
((,subr ,msg ,args . ,rest)
|
||
(format #t "Throw to key `~a' while reading expression:\n" key)
|
||
(display-error #f (current-output-port) subr msg args rest))
|
||
(else
|
||
(format #t "Throw to key `~a' with args `~s' while reading expression.\n"
|
||
key args)))
|
||
(force-output)
|
||
*unspecified*)))))
|
||
|
||
|
||
|
||
;;;
|
||
;;; The repl
|
||
;;;
|
||
|
||
(define* (start-repl #:optional (lang (current-language)) #:key debug)
|
||
(run-repl (make-repl lang debug)))
|
||
|
||
(define (run-repl repl)
|
||
(let ((tag (make-prompt-tag "repl ")))
|
||
(call-with-prompt
|
||
tag
|
||
(lambda ()
|
||
(with-fluids ((*repl-stack*
|
||
(cons repl (or (fluid-ref *repl-stack*) '()))))
|
||
(if (null? (cdr (fluid-ref *repl-stack*)))
|
||
(repl-welcome repl))
|
||
(let prompt-loop ()
|
||
(let ((exp (prompting-meta-read repl)))
|
||
(cond
|
||
((eqv? exp *unspecified*)) ; read error, pass
|
||
((eq? exp meta-command-token)
|
||
(catch 'quit
|
||
(lambda () (meta-command repl))
|
||
(lambda (k . args)
|
||
(abort-to-prompt tag args))))
|
||
((eof-object? exp)
|
||
(newline)
|
||
(abort-to-prompt tag '()))
|
||
(else
|
||
;; since the input port is line-buffered, consume up to the
|
||
;; newline
|
||
(flush-to-newline)
|
||
(call-with-error-handling
|
||
(lambda ()
|
||
(catch 'quit
|
||
(lambda ()
|
||
(call-with-values
|
||
(lambda ()
|
||
(run-hook before-eval-hook exp)
|
||
(start-stack #t
|
||
(repl-eval repl (repl-parse repl exp))))
|
||
(lambda l
|
||
(for-each (lambda (v)
|
||
(repl-print repl v))
|
||
l))))
|
||
(lambda (k . args)
|
||
(abort-to-prompt tag args)))))))
|
||
(next-char #f) ;; consume trailing whitespace
|
||
(prompt-loop)))))
|
||
(lambda (k status)
|
||
status))))
|
||
|
||
(define (next-char wait)
|
||
(if (or wait (char-ready?))
|
||
(let ((ch (peek-char)))
|
||
(cond ((eof-object? ch) ch)
|
||
((char-whitespace? ch) (read-char) (next-char wait))
|
||
(else ch)))
|
||
#f))
|
||
|
||
(define (flush-to-newline)
|
||
(if (char-ready?)
|
||
(let ((ch (peek-char)))
|
||
(if (and (not (eof-object? ch)) (char-whitespace? ch))
|
||
(begin
|
||
(read-char)
|
||
(if (not (char=? ch #\newline))
|
||
(flush-to-newline)))))))
|