library/inspector.factor

   1 !:folding=indent:collapseFolds=1:
   2
   3 ! $Id$
   4 !
   5 ! Copyright (C) 2003, 2004 Slava Pestov.
   6 !
   7 ! Redistribution and use in source and binary forms, with or without
   8 ! modification, are permitted provided that the following conditions are met:
   9 !
  10 ! 1. Redistributions of source code must retain the above copyright notice,
  11 !    this list of conditions and the following disclaimer.
  12 !
  13 ! 2. Redistributions in binary form must reproduce the above copyright notice,
  14 !    this list of conditions and the following disclaimer in the documentation
  15 !    and/or other materials provided with the distribution.
  16 !
  17 ! THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
  18 ! INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  19 ! FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  20 ! DEVELOPERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  21 ! SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  22 ! PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  23 ! OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  24 ! WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  25 ! OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
  26 ! ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27
  28 IN: inspector
  29 USE: combinators
  30 USE: format
  31 USE: kernel
  32 USE: lists
  33 USE: namespaces
  34 USE: stack
  35 USE: stdio
  36 USE: strings
  37 USE: styles
  38 USE: words
  39 USE: prettyprint
  40 USE: unparser
  41 USE: vectors
  42 USE: vocabularies
  43
  44 : relative>absolute-object-path ( string -- string )
  45     "object-path" get [ "'" rot cat3 ] when* ;
  46
  47 : vars. ( -- )
  48     #! Print a list of defined variables.
  49     vars [ print ] each ;
  50
  51 : var. ( [ name | value ] -- )
  52     uncons unparse swap relative>absolute-object-path
  53     default-style clone [ "link" set write-attr ] bind ;
  54
  55 : value. ( max [ name | value ] -- )
  56     dup [ car tuck pad-string write write ] dip
  57     ": " write
  58     var. terpri ;
  59
  60 : describe-banner ( obj -- )
  61     "OBJECT: " write dup .
  62     "CLASS : " write class-of print
  63     "-------" print ;
  64
  65 : describe-namespace ( namespace -- )
  66     [ vars max-str-length vars-values ] bind
  67     [ dupd value. ] each drop ;
  68
  69 : describe ( obj -- )
  70     [
  71         [ word? ]
  72         [ see ]
  73
  74         [ string? ]
  75         [ print ]
  76
  77         [ has-namespace? ]
  78         [ dup describe-banner describe-namespace ]
  79
  80         [ drop t ]
  81         [ prettyprint ]
  82     ] cond ;
  83
  84 : describe-object-path ( string -- )
  85     <namespace> [
  86         dup "object-path" set
  87         global-object-path describe
  88     ] bind ;