factor/library/interpreter.factor

!:folding=indent:collapseFolds=1:

! $Id$
!
! Copyright (C) 2003, 2004 Slava Pestov.
! 
! Redistribution and use in source and binary forms, with or without
! modification, are permitted provided that the following conditions are met:
! 
! 1. Redistributions of source code must retain the above copyright notice,
!    this list of conditions and the following disclaimer.
! 
! 2. Redistributions in binary form must reproduce the above copyright notice,
!    this list of conditions and the following disclaimer in the documentation
!    and/or other materials provided with the distribution.
! 
! THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
! INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
! FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
! DEVELOPERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
! SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
! PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
! OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
! WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
! OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
! ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

IN: interpreter
USE: arithmetic
USE: combinators
USE: continuations
USE: kernel
USE: lists
USE: logic
USE: namespaces
USE: parser
USE: stack
USE: stdio
USE: strings
USE: styles
USE: words
USE: unparser

: exit ( -- )
    t "quit-flag" set ;

: print-banner ( -- )
    "Factor " version cat2 print
    "Copyright (C) 2003, 2004 Slava Pestov" print
    "Enter ``help'' for help." print
    "Enter ``exit'' to exit." print ;

: history+ ( cmd -- )
    global [ "history" cons@ ] bind ;

: history# ( -- number )
    global [ "history" get length ] bind ;

: print-numbered-list* ( number list -- )
    #! Print each element of the list with a number.
    dup [
        uncons [ over pred ] dip print-numbered-list*
        swap fixnum>str swap ": " swap cat3 print
    ] [
        2drop
    ] ifte ;

: print-numbered-list ( list -- )
    dup length pred swap print-numbered-list* ;

: history ( -- )
    "X redo    -- evaluate the expression with number X." print
    "X re-edit -- edit the expression with number X." print
    "history" get print-numbered-list ;

: get-history ( index -- )
    "history" get reverse nth ;

: redo ( index -- )
    get-history dup print eval ;

: re-edit ( index -- )
    get-history edit ;

: print-prompt ( prompt -- )
    history# fixnum>str "] " cat3 [ "prompt" ] get-style
    [ write-attr ] bind
    flush ;

: interpret ( prompt -- )
    print-prompt read dup [
        dup history+ eval
    ] [
        drop t "quit-flag" set
    ] ifte ;

: interpreter-loop ( prompt -- )
    [ "quit-flag" get not ] [ dup >r interpret r> ] while
    drop f "quit-flag" set ;

: initial-interpreter-loop ( -- )
    #! Run the stand-alone interpreter
    ! Used by :r
    [ "initial-interpreter-continuation" set ] callcc0
    ! Used by :s
    ! We use the slightly redundant 'call' to push the current
    ! callframe.
    [ callstack "initial-interpreter-callstack" set ] call
    "    " interpreter-loop ;

: help
    "clear              -- clear datastack." print
    ".s                 -- print datastack." print
    ".                  -- print top of datastack." print
    "" print
    "global describe    -- list all global variables." print
    "describe           -- describe object at top of stack." print
    "" print
    "words.             -- list all words." print
    "\"word\" see         -- show definition of \"word\"." print
    "\"str\" apropos      -- list all words whose name contains \"str\"." print
    "\"word\" usages.     -- list all words that call \"word\"." print
    "" print
    "[ expr ] balance . -- show stack effect of expression." print
    "" print
    "history            -- list previously entered expressions." print
    "X redo             -- redo expression number X from history list." print
    "" print
    "exit               -- exit the interpreter." print
    "" print ;