Artifact a68dbe32df715397f6eb7251b6d03740cb8621a3:
File
tools/lib/log.tcl
part of check-in
[86a7f249c1]
- Started to restructure the namespace hierarchy, beginning at the bottom, with the log module.
by
aku on
2007-09-09 00:58:18.
0000: 23 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d # --------------
0010: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0020: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0030: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0050: 23 20 54 6f 6f 6c 20 70 61 63 6b 61 67 65 73 2e # Tool packages.
0060: 20 4c 6f 67 67 69 6e 67 20 28 61 6b 61 20 55 73 Logging (aka Us
0070: 65 72 20 66 65 65 64 62 61 63 6b 29 2e 0a 0a 23 er feedback)...#
0080: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ---------------
0090: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
00a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
00b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
00c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 --------------.#
00d0: 20 52 65 71 75 69 72 65 6d 65 6e 74 73 0a 0a 70 Requirements..p
00e0: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 54 ackage require T
00f0: 63 6c 20 38 2e 34 0a 6e 61 6d 65 73 70 61 63 65 cl 8.4.namespace
0100: 20 65 76 61 6c 20 3a 3a 76 63 3a 3a 74 6f 6f 6c eval ::vc::tool
0110: 73 3a 3a 6c 6f 67 20 7b 7d 0a 0a 23 20 2d 2d 2d s::log {}..# ---
0120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0130: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0140: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0150: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0160: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 41 50 49 ----------.# API
0170: 0a 0a 23 20 46 65 65 64 62 61 63 6b 20 67 65 6e ..# Feedback gen
0180: 65 72 61 74 69 6f 6e 2e 0a 23 0a 23 09 76 63 3a eration..#.#.vc:
0190: 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67 3a 3a 77 72 69 :tools::log::wri
01a0: 74 65 20 20 20 20 76 65 72 62 6f 73 69 74 79 20 te verbosity
01b0: 73 79 73 74 65 6d 20 74 65 78 74 20 20 2d 20 57 system text - W
01c0: 72 69 74 65 20 6d 65 73 73 61 67 65 20 74 6f 20 rite message to
01d0: 74 68 65 20 6c 6f 67 2e 0a 23 09 76 63 3a 3a 74 the log..#.vc::t
01e0: 6f 6f 6c 73 3a 3a 6c 6f 67 3a 3a 70 72 6f 67 72 ools::log::progr
01f0: 65 73 73 20 76 65 72 62 6f 73 69 74 79 20 73 79 ess verbosity sy
0200: 73 74 65 6d 20 6e 20 6d 61 78 20 2d 20 44 72 69 stem n max - Dri
0210: 76 65 20 61 20 70 72 6f 67 72 65 73 73 20 64 69 ve a progress di
0220: 73 70 6c 61 79 2e 0a 0a 23 20 41 64 6d 69 6e 69 splay...# Admini
0230: 73 74 72 61 74 69 76 65 20 6f 70 65 72 61 74 69 strative operati
0240: 6f 6e 73 2e 0a 23 0a 23 09 76 63 3a 3a 74 6f 6f ons..#.#.vc::too
0250: 6c 73 3a 3a 6c 6f 67 3a 3a 76 65 72 62 6f 73 69 ls::log::verbosi
0260: 74 79 20 6c 65 76 65 6c 20 20 2d 20 53 65 74 20 ty level - Set
0270: 74 68 65 20 76 65 72 62 6f 73 69 74 79 20 6c 65 the verbosity le
0280: 76 65 6c 20 6f 66 20 74 68 65 20 61 70 70 6c 69 vel of the appli
0290: 63 61 74 69 6f 6e 2e 0a 23 09 76 63 3a 3a 74 6f cation..#.vc::to
02a0: 6f 6c 73 3a 3a 6c 6f 67 3a 3a 76 65 72 62 6f 73 ols::log::verbos
02b0: 69 74 79 3f 20 20 20 20 20 20 20 2d 20 51 75 65 ity? - Que
02c0: 72 79 20 74 68 65 20 76 65 72 62 6f 73 69 74 79 ry the verbosity
02d0: 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 61 70 level of the ap
02e0: 70 6c 69 63 61 74 69 6f 6e 2e 0a 23 09 76 63 3a plication..#.vc:
02f0: 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67 3a 3a 73 65 74 :tools::log::set
0300: 43 6d 64 20 63 6d 64 70 72 65 66 69 78 20 2d 20 Cmd cmdprefix -
0310: 53 65 74 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 Set callback for
0320: 20 6f 75 74 70 75 74 0a 23 09 76 63 3a 3a 74 6f output.#.vc::to
0330: 6f 6c 73 3a 3a 6c 6f 67 3a 3a 73 79 73 74 65 6d ols::log::system
0340: 20 6e 61 6d 65 20 20 20 20 20 20 2d 20 52 65 67 name - Reg
0350: 69 73 74 65 72 20 61 20 73 79 73 74 65 6d 20 28 ister a system (
0360: 65 6e 61 62 6c 65 73 20 74 61 62 75 6c 61 72 20 enables tabular
0370: 6c 6f 67 20 66 6f 72 6d 61 74 74 69 6e 67 29 2e log formatting).
0380: 0a 0a 23 20 43 61 6c 6c 62 61 63 6b 20 41 50 49 ..# Callback API
0390: 20 28 20 45 78 65 63 75 74 65 64 20 61 74 20 74 ( Executed at t
03a0: 68 65 20 67 6c 6f 62 61 6c 20 6c 65 76 65 6c 29 he global level)
03b0: 2e 0a 23 0a 23 09 63 6d 64 70 72 65 66 69 78 20 ..#.#.cmdprefix
03c0: 27 77 72 69 74 65 27 20 20 20 20 73 79 73 74 65 'write' syste
03d0: 6d 20 74 65 78 74 0a 23 09 63 6d 64 70 72 65 66 m text.#.cmdpref
03e0: 69 78 20 27 70 72 6f 67 72 65 73 73 27 20 73 79 ix 'progress' sy
03f0: 73 74 65 6d 20 6e 20 6d 61 78 0a 0a 23 20 53 74 stem n max..# St
0400: 61 6e 64 61 72 64 20 63 61 6c 6c 62 61 63 6b 73 andard callbacks
0410: 20 64 65 66 69 6e 65 64 20 62 79 20 74 68 65 20 defined by the
0420: 70 61 63 6b 61 67 65 20 69 74 73 65 6c 66 20 77 package itself w
0430: 72 69 74 65 20 74 6f 20 73 74 64 6f 75 74 2e 0a rite to stdout..
0440: 0a 23 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .# -------------
0450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0460: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0470: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0480: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0490: 0a 23 20 41 50 49 20 49 6d 70 6c 65 6d 65 6e 74 .# API Implement
04a0: 61 74 69 6f 6e 20 2d 20 46 65 65 64 62 61 63 6b ation - Feedback
04b0: 20 67 65 6e 65 72 61 74 69 6f 6e 2e 0a 0a 23 20 generation...#
04c0: 57 72 69 74 65 20 74 68 65 20 6d 65 73 73 61 67 Write the messag
04d0: 65 20 27 74 65 78 74 27 20 74 6f 20 6c 6f 67 2c e 'text' to log,
04e0: 20 66 6f 72 20 74 68 65 20 6e 61 6d 65 64 20 27 for the named '
04f0: 73 79 73 74 65 6d 27 2e 20 54 68 65 20 6d 65 73 system'. The mes
0500: 73 61 67 65 0a 23 20 69 73 20 77 72 69 74 74 65 sage.# is writte
0510: 6e 20 69 66 20 61 6e 64 20 6f 6e 6c 79 20 69 66 n if and only if
0520: 20 74 68 65 20 6d 65 73 73 61 67 65 20 76 65 72 the message ver
0530: 62 6f 73 69 74 79 20 69 73 20 6c 65 73 73 20 6f bosity is less o
0540: 72 20 65 71 75 61 6c 20 74 68 65 0a 23 20 63 68 r equal the.# ch
0550: 6f 73 65 6e 20 76 65 72 62 6f 73 69 74 79 2e 20 osen verbosity.
0560: 41 20 6d 65 73 73 61 67 65 20 6f 66 20 76 65 72 A message of ver
0570: 62 6f 73 69 74 79 20 30 20 63 61 6e 6e 6f 74 20 bosity 0 cannot
0580: 62 65 20 62 6c 6f 63 6b 65 64 2e 0a 0a 70 72 6f be blocked...pro
0590: 63 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c c ::vc::tools::l
05a0: 6f 67 3a 3a 77 72 69 74 65 20 7b 76 65 72 62 6f og::write {verbo
05b0: 73 69 74 79 20 73 79 73 74 65 6d 20 74 65 78 74 sity system text
05c0: 7d 20 7b 0a 20 20 20 20 76 61 72 69 61 62 6c 65 } {. variable
05d0: 20 6c 6f 67 6c 65 76 65 6c 0a 20 20 20 20 76 61 loglevel. va
05e0: 72 69 61 62 6c 65 20 6c 6f 67 63 6d 64 0a 20 20 riable logcmd.
05f0: 20 20 76 61 72 69 61 62 6c 65 20 73 79 73 66 6d variable sysfm
0600: 74 0a 20 20 20 20 69 66 20 7b 24 76 65 72 62 6f t. if {$verbo
0610: 73 69 74 79 20 3e 20 24 6c 6f 67 6c 65 76 65 6c sity > $loglevel
0620: 7d 20 72 65 74 75 72 6e 0a 20 20 20 20 75 70 6c } return. upl
0630: 65 76 65 6c 20 23 30 20 5b 6c 69 6e 73 65 72 74 evel #0 [linsert
0640: 20 24 6c 6f 67 63 6d 64 20 65 6e 64 20 77 72 69 $logcmd end wri
0650: 74 65 20 5b 66 6f 72 6d 61 74 20 24 73 79 73 66 te [format $sysf
0660: 6d 74 20 24 73 79 73 74 65 6d 5d 20 24 74 65 78 mt $system] $tex
0670: 74 5d 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a t]. return.}.
0680: 0a 23 20 53 69 6d 69 6c 61 72 20 74 6f 20 77 72 .# Similar to wr
0690: 69 74 65 2c 20 65 73 70 65 63 69 61 6c 6c 79 20 ite, especially
06a0: 69 6e 20 74 68 65 20 68 61 6e 64 6c 69 6e 67 20 in the handling
06b0: 6f 66 20 74 68 65 20 76 65 72 62 6f 73 69 74 79 of the verbosity
06c0: 2c 20 74 6f 0a 23 20 64 72 69 76 65 20 70 72 6f , to.# drive pro
06d0: 67 72 65 73 73 20 64 69 73 70 6c 61 79 73 2e 20 gress displays.
06e0: 49 74 20 73 69 67 6e 61 6c 73 20 74 68 61 74 20 It signals that
06f0: 66 6f 72 20 73 6f 6d 65 20 6c 6f 6e 67 20 72 75 for some long ru
0700: 6e 6e 69 6e 67 0a 23 20 6f 70 65 72 61 74 69 6f nning.# operatio
0710: 6e 20 77 65 20 61 72 65 20 61 74 20 74 69 63 6b n we are at tick
0720: 20 27 6e 27 20 6f 66 20 61 74 20 6d 6f 73 74 20 'n' of at most
0730: 27 6d 61 78 27 20 74 69 63 6b 73 2e 0a 0a 70 72 'max' ticks...pr
0740: 6f 63 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a oc ::vc::tools::
0750: 6c 6f 67 3a 3a 70 72 6f 67 72 65 73 73 20 7b 76 log::progress {v
0760: 65 72 62 6f 73 69 74 79 20 73 79 73 74 65 6d 20 erbosity system
0770: 6e 20 6d 61 78 7d 20 7b 0a 20 20 20 20 76 61 72 n max} {. var
0780: 69 61 62 6c 65 20 6c 6f 67 6c 65 76 65 6c 0a 20 iable loglevel.
0790: 20 20 20 76 61 72 69 61 62 6c 65 20 6c 6f 67 63 variable logc
07a0: 6d 64 0a 20 20 20 20 76 61 72 69 61 62 6c 65 20 md. variable
07b0: 73 79 73 66 6d 74 0a 20 20 20 20 69 66 20 7b 24 sysfmt. if {$
07c0: 76 65 72 62 6f 73 69 74 79 20 3e 20 24 6c 6f 67 verbosity > $log
07d0: 6c 65 76 65 6c 7d 20 72 65 74 75 72 6e 0a 20 20 level} return.
07e0: 20 20 75 70 6c 65 76 65 6c 20 23 30 20 5b 6c 69 uplevel #0 [li
07f0: 6e 73 65 72 74 20 24 6c 6f 67 63 6d 64 20 65 6e nsert $logcmd en
0800: 64 20 70 72 6f 67 72 65 73 73 20 5b 66 6f 72 6d d progress [form
0810: 61 74 20 24 73 79 73 66 6d 74 20 24 73 79 73 74 at $sysfmt $syst
0820: 65 6d 5d 20 24 6e 20 24 6d 61 78 5d 0a 20 20 20 em] $n $max].
0830: 20 72 65 74 75 72 6e 0a 7d 0a 0a 23 20 2d 2d 2d return.}..# ---
0840: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0850: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0860: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0870: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0880: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 41 50 49 ----------.# API
0890: 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 Implementation
08a0: 2d 20 41 64 6d 69 6e 69 73 74 72 61 74 69 76 65 - Administrative
08b0: 20 6f 70 65 72 61 74 69 6f 6e 73 2e 0a 0a 23 20 operations...#
08c0: 53 65 74 20 76 65 72 62 6f 73 69 74 79 20 74 6f Set verbosity to
08d0: 20 74 68 65 20 63 68 6f 73 65 6e 20 27 6c 65 76 the chosen 'lev
08e0: 65 6c 27 2e 20 4f 6e 6c 79 20 6d 65 73 73 61 67 el'. Only messag
08f0: 65 73 20 77 69 74 68 20 61 20 6c 65 76 65 6c 20 es with a level
0900: 6c 65 73 73 0a 23 20 6f 72 20 65 71 75 61 6c 20 less.# or equal
0910: 74 6f 20 74 68 69 73 20 6f 6e 65 20 77 69 6c 6c to this one will
0920: 20 62 65 20 73 68 6f 77 6e 2e 0a 0a 70 72 6f 63 be shown...proc
0930: 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f ::vc::tools::lo
0940: 67 3a 3a 76 65 72 62 6f 73 69 74 79 20 7b 6c 65 g::verbosity {le
0950: 76 65 6c 7d 20 7b 0a 20 20 20 20 76 61 72 69 61 vel} {. varia
0960: 62 6c 65 20 6c 6f 67 6c 65 76 65 6c 0a 20 20 20 ble loglevel.
0970: 20 69 66 20 7b 24 6c 65 76 65 6c 20 3c 20 31 7d if {$level < 1}
0980: 20 7b 73 65 74 20 6c 65 76 65 6c 20 30 7d 0a 20 {set level 0}.
0990: 20 20 20 73 65 74 20 6c 6f 67 6c 65 76 65 6c 20 set loglevel
09a0: 24 6c 65 76 65 6c 0a 20 20 20 20 72 65 74 75 72 $level. retur
09b0: 6e 0a 7d 0a 0a 23 20 51 75 65 72 79 20 74 68 65 n.}..# Query the
09c0: 20 63 75 72 72 65 6e 74 6c 79 20 73 65 74 20 76 currently set v
09d0: 65 72 62 6f 73 69 74 79 2e 0a 0a 70 72 6f 63 20 erbosity...proc
09e0: 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67 ::vc::tools::log
09f0: 3a 3a 76 65 72 62 6f 73 69 74 79 3f 20 7b 7d 20 ::verbosity? {}
0a00: 7b 0a 20 20 20 20 76 61 72 69 61 62 6c 65 20 6c {. variable l
0a10: 6f 67 6c 65 76 65 6c 0a 20 20 20 20 72 65 74 75 oglevel. retu
0a20: 72 6e 20 20 24 6c 6f 67 6c 65 76 65 6c 0a 7d 0a rn $loglevel.}.
0a30: 0a 23 20 53 65 74 20 74 68 65 20 6c 6f 67 20 63 .# Set the log c
0a40: 61 6c 6c 62 61 63 6b 20 68 61 6e 64 6c 69 6e 67 allback handling
0a50: 20 74 68 65 20 61 63 74 75 61 6c 20 6f 75 74 70 the actual outp
0a60: 75 74 20 6f 66 20 6d 65 73 73 61 67 65 73 20 67 ut of messages g
0a70: 6f 69 6e 67 0a 23 20 74 68 72 6f 75 67 68 20 74 oing.# through t
0a80: 68 65 20 70 61 63 6b 61 67 65 2e 0a 0a 70 72 6f he package...pro
0a90: 63 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c c ::vc::tools::l
0aa0: 6f 67 3a 3a 73 65 74 43 6d 64 20 7b 63 6d 64 70 og::setCmd {cmdp
0ab0: 72 65 66 69 78 7d 20 7b 0a 20 20 20 20 76 61 72 refix} {. var
0ac0: 69 61 62 6c 65 20 6c 6f 67 63 6d 64 20 24 63 6d iable logcmd $cm
0ad0: 64 70 72 65 66 69 78 0a 20 20 20 20 72 65 74 75 dprefix. retu
0ae0: 72 6e 0a 7d 0a 0a 23 20 52 65 67 69 73 74 65 72 rn.}..# Register
0af0: 20 61 20 73 79 73 74 65 6d 20 6e 61 6d 65 2c 20 a system name,
0b00: 74 6f 20 65 6e 61 62 6c 65 20 74 61 62 75 6c 61 to enable tabula
0b10: 72 20 66 6f 72 6d 61 74 74 69 6e 67 2e 20 54 68 r formatting. Th
0b20: 69 73 20 69 73 20 64 6f 6e 65 0a 23 20 62 79 20 is is done.# by
0b30: 73 65 74 74 69 6e 67 20 75 70 20 61 20 66 6f 72 setting up a for
0b40: 6d 61 74 20 73 70 65 63 69 66 69 65 72 20 77 69 mat specifier wi
0b50: 74 68 20 61 20 70 72 6f 70 65 72 20 77 69 64 74 th a proper widt
0b60: 68 2e 20 54 68 69 73 20 69 73 0a 23 20 68 61 6e h. This is.# han
0b70: 64 6c 65 64 20 69 6e 20 74 68 65 20 67 65 6e 65 dled in the gene
0b80: 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 2c 20 ration command,
0b90: 62 65 66 6f 72 65 20 74 68 65 20 6f 75 74 70 75 before the outpu
0ba0: 74 20 63 61 6c 6c 62 61 63 6b 20 69 73 0a 23 20 t callback is.#
0bb0: 69 6e 76 6f 6b 65 64 2e 0a 0a 70 72 6f 63 20 3a invoked...proc :
0bc0: 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67 3a :vc::tools::log:
0bd0: 3a 73 79 73 74 65 6d 20 7b 6e 61 6d 65 7d 20 7b :system {name} {
0be0: 0a 20 20 20 20 76 61 72 69 61 62 6c 65 20 73 79 . variable sy
0bf0: 73 66 6d 74 0a 20 20 20 20 76 61 72 69 61 62 6c sfmt. variabl
0c00: 65 20 73 79 73 6c 65 6e 0a 0a 20 20 20 20 73 65 e syslen.. se
0c10: 74 20 6e 6c 65 6e 20 5b 73 74 72 69 6e 67 20 6c t nlen [string l
0c20: 65 6e 67 74 68 20 24 6e 61 6d 65 5d 0a 20 20 20 ength $name].
0c30: 20 69 66 20 7b 24 6e 6c 65 6e 20 3c 20 24 73 79 if {$nlen < $sy
0c40: 73 6c 65 6e 7d 20 72 65 74 75 72 6e 0a 0a 20 20 slen} return..
0c50: 20 20 73 65 74 20 73 79 73 6c 65 6e 20 24 6e 6c set syslen $nl
0c60: 65 6e 0a 20 20 20 20 73 65 74 20 73 79 73 66 6d en. set sysfm
0c70: 74 20 25 2d 24 7b 73 79 73 6c 65 6e 7d 73 0a 20 t %-${syslen}s.
0c80: 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 23 20 2d return.}..# -
0c90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0ca0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0cb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0cc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0cd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 49 ------------.# I
0ce0: 6e 74 65 72 6e 61 6c 20 6f 70 65 72 61 74 69 6f nternal operatio
0cf0: 6e 73 20 2d 20 53 74 61 6e 64 61 72 64 20 6f 75 ns - Standard ou
0d00: 74 70 75 74 20 6f 70 65 72 61 74 69 6f 6e 0a 0a tput operation..
0d10: 23 20 44 69 73 70 61 74 63 68 20 74 6f 20 74 68 # Dispatch to th
0d20: 65 20 68 61 6e 64 6c 65 72 73 20 6f 66 20 74 68 e handlers of th
0d30: 65 20 70 6f 73 73 69 62 6c 65 20 6f 70 65 72 61 e possible opera
0d40: 74 69 6f 6e 73 2e 0a 0a 70 72 6f 63 20 3a 3a 76 tions...proc ::v
0d50: 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67 3a 3a 4f c::tools::log::O
0d60: 55 54 20 7b 6f 70 20 61 72 67 73 7d 20 7b 0a 20 UT {op args} {.
0d70: 20 20 20 65 76 61 6c 20 5b 6c 69 6e 73 65 72 74 eval [linsert
0d80: 20 24 61 72 67 73 20 30 20 3a 3a 76 63 3a 3a 74 $args 0 ::vc::t
0d90: 6f 6f 6c 73 3a 3a 6c 6f 67 3a 3a 4f 55 54 2f 24 ools::log::OUT/$
0da0: 6f 70 5d 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d op]. return.}
0db0: 0a 0a 23 20 57 72 69 74 65 20 68 61 6e 64 6c 65 ..# Write handle
0dc0: 72 2e 20 45 61 63 68 20 6d 65 73 73 61 67 65 20 r. Each message
0dd0: 69 73 20 61 20 6c 69 6e 65 2e 0a 0a 70 72 6f 63 is a line...proc
0de0: 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f ::vc::tools::lo
0df0: 67 3a 3a 4f 55 54 2f 77 72 69 74 65 20 7b 73 79 g::OUT/write {sy
0e00: 73 74 65 6d 20 74 65 78 74 7d 20 7b 0a 20 20 20 stem text} {.
0e10: 20 70 75 74 73 20 22 24 73 79 73 74 65 6d 20 24 puts "$system $
0e20: 74 65 78 74 22 0a 20 20 20 20 72 65 74 75 72 6e text". return
0e30: 0a 7d 0a 0a 23 20 50 72 6f 67 72 65 73 73 20 68 .}..# Progress h
0e40: 61 6e 64 6c 65 72 2e 20 55 73 65 73 20 5c 72 20 andler. Uses \r
0e50: 74 6f 20 72 65 74 75 72 6e 20 74 6f 20 74 68 65 to return to the
0e60: 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 beginning of th
0e70: 65 20 63 75 72 72 65 6e 74 0a 23 20 6c 69 6e 65 e current.# line
0e80: 20 77 69 74 68 6f 75 74 20 61 64 76 61 6e 63 69 without advanci
0e90: 6e 67 2e 0a 0a 70 72 6f 63 20 3a 3a 76 63 3a 3a ng...proc ::vc::
0ea0: 74 6f 6f 6c 73 3a 3a 6c 6f 67 3a 3a 4f 55 54 2f tools::log::OUT/
0eb0: 70 72 6f 67 72 65 73 73 20 7b 73 79 73 74 65 6d progress {system
0ec0: 20 6e 20 6d 61 78 7d 20 7b 0a 20 20 20 20 70 75 n max} {. pu
0ed0: 74 73 20 2d 6e 6f 6e 65 77 6c 69 6e 65 20 22 24 ts -nonewline "$
0ee0: 73 79 73 74 65 6d 20 5b 66 6f 72 6d 61 74 20 25 system [format %
0ef0: 5b 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 20 24 [string length $
0f00: 6d 61 78 5d 73 20 24 6e 5d 2f 24 6d 61 78 5c 72 max]s $n]/$max\r
0f10: 22 0a 20 20 20 20 66 6c 75 73 68 20 73 74 64 6f ". flush stdo
0f20: 75 74 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a ut. return.}.
0f30: 0a 23 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .# -------------
0f40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f80: 0a 0a 6e 61 6d 65 73 70 61 63 65 20 65 76 61 6c ..namespace eval
0f90: 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f ::vc::tools::lo
0fa0: 67 20 7b 0a 20 20 20 20 76 61 72 69 61 62 6c 65 g {. variable
0fb0: 20 6c 6f 67 6c 65 76 65 6c 20 30 20 20 20 20 20 loglevel 0
0fc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0fd0: 3b 20 23 20 41 6c 6c 6f 77 20 6f 6e 6c 79 20 75 ; # Allow only u
0fe0: 6e 69 6e 74 65 72 75 70 74 69 62 6c 65 20 6d 65 ninteruptible me
0ff0: 73 73 61 67 65 73 2e 0a 20 20 20 20 76 61 72 69 ssages.. vari
1000: 61 62 6c 65 20 6c 6f 67 63 6d 64 20 20 20 3a 3a able logcmd ::
1010: 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67 3a 3a vc::tools::log::
1020: 4f 55 54 20 3b 20 23 20 53 74 61 6e 64 61 72 64 OUT ; # Standard
1030: 20 6f 75 74 70 75 74 20 74 6f 20 73 74 64 6f 75 output to stdou
1040: 74 2e 0a 20 20 20 20 76 61 72 69 61 62 6c 65 20 t.. variable
1050: 73 79 73 66 6d 74 20 25 73 20 20 20 20 20 20 20 sysfmt %s
1060: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b ;
1070: 20 23 20 4e 6f 6e 2d 74 61 62 75 6c 61 72 20 66 # Non-tabular f
1080: 6f 72 6d 61 74 74 69 6e 67 2e 0a 20 20 20 20 76 ormatting.. v
1090: 61 72 69 61 62 6c 65 20 73 79 73 6c 65 6e 20 30 ariable syslen 0
10a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10b0: 20 20 20 20 20 20 20 3b 20 23 20 44 69 74 74 6f ; # Ditto
10c0: 2e 0a 0a 20 20 20 20 6e 61 6d 65 73 70 61 63 65 ... namespace
10d0: 20 65 78 70 6f 72 74 20 77 72 69 74 65 20 70 72 export write pr
10e0: 6f 67 72 65 73 73 0a 7d 0a 0a 23 20 2d 2d 2d 2d ogress.}..# ----
10f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1130: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 52 65 61 64 ---------.# Read
1140: 79 0a 0a 70 61 63 6b 61 67 65 20 70 72 6f 76 69 y..package provi
1150: 64 65 20 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f de vc::tools::lo
1160: 67 20 31 2e 30 0a 72 65 74 75 72 6e 0a g 1.0.return.