Artifact 6d7e82940621f9e9bbe77cf929469fc35329fbf0:

File tools/cvs2fossil/lib/c2f_state.tcl part of check-in [e288af3995] - Fluff: Renamed state methods use/reading/writing to usedb/use/extend for clarity. Updated all callers. Extended state module with code to dump the SQL statements it receives to a file for analysis. Extended the 'use' declarations of several passes. by aku on 2007-12-02 23:47:45.

0000: 23 23 20 2d 2a 2d 20 74 63 6c 20 2d 2a 2d 0a 23  ## -*- tcl -*-.#
0010: 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20   # ## ### ##### 
0020: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
0030: 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23  ###### #########
0040: 23 23 23 23 23 23 23 23 23 23 23 23 0a 23 23 20  ############.## 
0050: 43 6f 70 79 72 69 67 68 74 20 28 63 29 20 32 30  Copyright (c) 20
0060: 30 37 20 41 6e 64 72 65 61 73 20 4b 75 70 72 69  07 Andreas Kupri
0070: 65 73 2e 0a 23 0a 23 20 54 68 69 73 20 73 6f 66  es..#.# This sof
0080: 74 77 61 72 65 20 69 73 20 6c 69 63 65 6e 73 65  tware is license
0090: 64 20 61 73 20 64 65 73 63 72 69 62 65 64 20 69  d as described i
00a0: 6e 20 74 68 65 20 66 69 6c 65 20 4c 49 43 45 4e  n the file LICEN
00b0: 53 45 2c 20 77 68 69 63 68 0a 23 20 79 6f 75 20  SE, which.# you 
00c0: 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65 63 65  should have rece
00d0: 69 76 65 64 20 61 73 20 70 61 72 74 20 6f 66 20  ived as part of 
00e0: 74 68 69 73 20 64 69 73 74 72 69 62 75 74 69 6f  this distributio
00f0: 6e 2e 0a 23 0a 23 20 54 68 69 73 20 73 6f 66 74  n..#.# This soft
0100: 77 61 72 65 20 63 6f 6e 73 69 73 74 73 20 6f 66  ware consists of
0110: 20 76 6f 6c 75 6e 74 61 72 79 20 63 6f 6e 74 72   voluntary contr
0120: 69 62 75 74 69 6f 6e 73 20 6d 61 64 65 20 62 79  ibutions made by
0130: 20 6d 61 6e 79 0a 23 20 69 6e 64 69 76 69 64 75   many.# individu
0140: 61 6c 73 2e 20 20 46 6f 72 20 65 78 61 63 74 20  als.  For exact 
0150: 63 6f 6e 74 72 69 62 75 74 69 6f 6e 20 68 69 73  contribution his
0160: 74 6f 72 79 2c 20 73 65 65 20 74 68 65 20 72 65  tory, see the re
0170: 76 69 73 69 6f 6e 0a 23 20 68 69 73 74 6f 72 79  vision.# history
0180: 20 61 6e 64 20 6c 6f 67 73 2c 20 61 76 61 69 6c   and logs, avail
0190: 61 62 6c 65 20 61 74 20 68 74 74 70 3a 2f 2f 66  able at http://f
01a0: 6f 73 73 69 6c 2d 73 63 6d 2e 68 77 61 63 69 2e  ossil-scm.hwaci.
01b0: 63 6f 6d 2f 66 6f 73 73 69 6c 0a 23 20 23 20 23  com/fossil.# # #
01c0: 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23  # ### ##### ####
01d0: 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23  #### ###########
01e0: 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23  ## #############
01f0: 23 23 23 23 23 23 23 23 0a 0a 23 23 20 53 74 61  ########..## Sta
0200: 74 65 20 6d 61 6e 61 67 65 72 2e 20 4d 61 69 6e  te manager. Main
0210: 74 61 69 6e 73 20 74 68 65 20 73 71 6c 69 74 65  tains the sqlite
0220: 20 64 61 74 61 62 61 73 65 20 75 73 65 64 20 62   database used b
0230: 79 20 61 6c 6c 20 74 68 65 20 6f 74 68 65 72 0a  y all the other.
0240: 23 23 20 70 61 72 74 73 20 6f 66 20 74 68 65 20  ## parts of the 
0250: 73 79 73 74 65 6d 2c 20 65 73 70 65 63 69 61 6c  system, especial
0260: 6c 79 20 74 68 65 20 70 61 73 73 65 73 20 61 6e  ly the passes an
0270: 64 20 74 68 65 69 72 20 73 75 70 70 6f 72 74 20  d their support 
0280: 63 6f 64 65 2c 0a 23 23 20 74 6f 20 70 65 72 73  code,.## to pers
0290: 69 73 74 20 61 6e 64 20 72 65 73 74 6f 72 65 20  ist and restore 
02a0: 74 68 65 69 72 20 73 74 61 74 65 20 61 63 72 6f  their state acro
02b0: 73 73 20 69 6e 76 6f 6b 61 74 69 6f 6e 73 2e 0a  ss invokations..
02c0: 0a 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23  .# # ## ### ####
02d0: 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23  # ######## #####
02e0: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
02f0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a 23  ##############.#
0300: 23 20 52 65 71 75 69 72 65 6d 65 6e 74 73 0a 0a  # Requirements..
0310: 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20  package require 
0320: 54 63 6c 20 38 2e 34 20 20 20 20 20 20 20 20 20  Tcl 8.4         
0330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0340: 20 3b 20 23 20 52 65 71 75 69 72 65 64 20 72 75   ; # Required ru
0350: 6e 74 69 6d 65 2e 0a 70 61 63 6b 61 67 65 20 72  ntime..package r
0360: 65 71 75 69 72 65 20 73 6e 69 74 20 20 20 20 20  equire snit     
0370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0380: 20 20 20 20 20 20 20 20 3b 20 23 20 4f 4f 20 73          ; # OO s
0390: 79 73 74 65 6d 2e 0a 70 61 63 6b 61 67 65 20 72  ystem..package r
03a0: 65 71 75 69 72 65 20 66 69 6c 65 75 74 69 6c 20  equire fileutil 
03b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
03c0: 20 20 20 20 20 20 20 20 3b 20 23 20 46 69 6c 65          ; # File
03d0: 20 6f 70 65 72 61 74 69 6f 6e 73 2e 0a 70 61 63   operations..pac
03e0: 6b 61 67 65 20 72 65 71 75 69 72 65 20 73 71 6c  kage require sql
03f0: 69 74 65 33 20 20 20 20 20 20 20 20 20 20 20 20  ite3            
0400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 20                ; 
0410: 23 20 44 61 74 61 62 61 73 65 20 61 63 63 65 73  # Database acces
0420: 73 2e 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69  s..package requi
0430: 72 65 20 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 74 72  re vc::tools::tr
0440: 6f 75 62 6c 65 20 20 20 20 20 20 20 20 20 20 20  ouble           
0450: 20 20 20 20 3b 20 23 20 45 72 72 6f 72 20 72 65      ; # Error re
0460: 70 6f 72 74 69 6e 67 2e 0a 70 61 63 6b 61 67 65  porting..package
0470: 20 72 65 71 75 69 72 65 20 76 63 3a 3a 74 6f 6f   require vc::too
0480: 6c 73 3a 3a 6c 6f 67 20 20 20 20 20 20 20 20 20  ls::log         
0490: 20 20 20 20 20 20 20 20 20 20 3b 20 23 20 55 73            ; # Us
04a0: 65 72 20 66 65 65 64 62 61 63 6b 2e 0a 0a 23 20  er feedback...# 
04b0: 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20 23  # ## ### ##### #
04c0: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
04d0: 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23  ##### ##########
04e0: 23 23 23 23 23 23 23 23 23 23 23 0a 23 23 0a 0a  ###########.##..
04f0: 73 6e 69 74 3a 3a 74 79 70 65 20 3a 3a 76 63 3a  snit::type ::vc:
0500: 3a 66 6f 73 73 69 6c 3a 3a 69 6d 70 6f 72 74 3a  :fossil::import:
0510: 3a 63 76 73 3a 3a 73 74 61 74 65 20 7b 0a 20 20  :cvs::state {.  
0520: 20 20 23 20 23 20 23 23 20 23 23 23 20 23 23 23    # # ## ### ###
0530: 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23  ## ######## ####
0540: 23 23 23 23 23 23 23 23 23 0a 20 20 20 20 23 23  #########.    ##
0550: 20 50 75 62 6c 69 63 20 41 50 49 0a 0a 20 20 20   Public API..   
0560: 20 74 79 70 65 6d 65 74 68 6f 64 20 75 73 65 64   typemethod used
0570: 62 20 7b 70 61 74 68 7d 20 7b 0a 09 23 20 49 6d  b {path} {..# Im
0580: 6d 65 64 69 61 74 65 20 76 61 6c 69 64 61 74 69  mediate validati
0590: 6f 6e 2e 20 54 68 65 72 65 20 61 72 65 20 61 72  on. There are ar
05a0: 65 20 74 77 6f 20 70 6f 73 73 69 62 69 6c 69 74  e two possibilit
05b0: 69 65 73 20 74 6f 0a 09 23 20 63 6f 6e 73 69 64  ies to..# consid
05c0: 65 72 2e 20 54 68 65 20 70 61 74 68 20 65 78 69  er. The path exi
05d0: 73 74 73 20 6f 72 20 69 74 20 64 6f 65 73 6e 27  sts or it doesn'
05e0: 74 2e 0a 0a 09 23 20 49 6e 20 74 68 65 20 66 69  t....# In the fi
05f0: 72 73 74 20 63 61 73 65 20 69 74 20 68 61 73 20  rst case it has 
0600: 74 6f 20 62 65 20 61 20 72 65 61 64 61 62 6c 65  to be a readable
0610: 20 61 6e 64 20 77 72 69 74 61 62 6c 65 20 66 69   and writable fi
0620: 6c 65 2c 0a 09 23 20 61 6e 64 20 69 74 20 68 61  le,..# and it ha
0630: 73 20 74 6f 20 62 65 20 61 20 70 72 6f 70 65 72  s to be a proper
0640: 20 73 71 6c 69 74 65 20 64 61 74 61 62 61 73 65   sqlite database
0650: 2e 20 46 75 72 74 68 65 72 20 63 68 65 63 6b 73  . Further checks
0660: 0a 09 23 20 72 65 67 61 72 64 69 6e 67 20 74 68  ..# regarding th
0670: 65 20 72 65 71 75 69 72 65 64 20 74 61 62 6c 65  e required table
0680: 73 20 77 69 6c 6c 20 62 65 20 64 6f 6e 65 20 6c  s will be done l
0690: 61 74 65 72 2c 20 62 79 20 74 68 65 0a 09 23 20  ater, by the..# 
06a0: 70 61 73 73 65 73 2c 20 64 75 72 69 6e 67 20 74  passes, during t
06b0: 68 65 69 72 20 73 65 74 75 70 2e 0a 0a 09 23 20  heir setup....# 
06c0: 49 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 63 61  In the second ca
06d0: 73 65 20 77 65 20 68 61 76 65 20 74 6f 20 62 65  se we have to be
06e0: 20 61 62 6c 65 20 74 6f 20 63 72 65 61 74 65 20   able to create 
06f0: 74 68 65 20 66 69 6c 65 2c 0a 09 23 20 61 6e 64  the file,..# and
0700: 20 63 68 65 63 6b 20 74 68 61 74 2e 20 54 68 69   check that. Thi
0710: 73 20 69 73 20 64 6f 6e 65 20 62 79 20 6f 70 65  s is done by ope
0720: 6e 69 6e 67 20 69 74 2c 20 73 71 6c 69 74 65 20  ning it, sqlite 
0730: 77 69 6c 6c 20 74 68 65 6e 0a 09 23 20 74 72 79  will then..# try
0740: 20 74 6f 20 63 72 65 61 74 65 20 69 74 2c 20 61   to create it, a
0750: 6e 64 20 6d 61 79 20 66 61 69 6c 2e 0a 0a 09 69  nd may fail....i
0760: 66 20 7b 5b 66 69 6c 65 20 65 78 69 73 74 73 20  f {[file exists 
0770: 24 70 61 74 68 5d 7d 20 7b 0a 09 20 20 20 20 69  $path]} {..    i
0780: 66 20 7b 21 5b 66 69 6c 65 75 74 69 6c 3a 3a 74  f {![fileutil::t
0790: 65 73 74 20 24 70 61 74 68 20 66 72 77 20 6d 73  est $path frw ms
07a0: 67 20 7b 63 76 73 32 66 6f 73 73 69 6c 20 73 74  g {cvs2fossil st
07b0: 61 74 65 7d 5d 7d 20 7b 0a 09 09 74 72 6f 75 62  ate}]} {...troub
07c0: 6c 65 20 66 61 74 61 6c 20 24 6d 73 67 0a 09 09  le fatal $msg...
07d0: 72 65 74 75 72 6e 0a 09 20 20 20 20 7d 0a 09 7d  return..    }..}
07e0: 0a 0a 09 69 66 20 7b 5b 63 61 74 63 68 20 7b 0a  ...if {[catch {.
07f0: 09 20 20 20 20 73 71 6c 69 74 65 33 20 24 7b 74  .    sqlite3 ${t
0800: 79 70 65 7d 3a 3a 54 45 4d 50 20 24 70 61 74 68  ype}::TEMP $path
0810: 0a 09 7d 20 72 65 73 5d 7d 20 7b 0a 09 20 20 20  ..} res]} {..   
0820: 20 74 72 6f 75 62 6c 65 20 66 61 74 61 6c 20 24   trouble fatal $
0830: 72 65 73 0a 09 20 20 20 20 72 65 74 75 72 6e 0a  res..    return.
0840: 09 7d 0a 0a 09 23 20 41 20 70 72 65 76 69 6f 75  .}...# A previou
0850: 73 6c 79 20 64 65 66 69 6e 65 64 20 73 74 61 74  sly defined stat
0860: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6c  e database is cl
0870: 6f 73 65 64 20 62 65 66 6f 72 65 0a 09 23 20 63  osed before..# c
0880: 6f 6d 6d 69 74 74 69 6e 67 20 74 6f 20 74 68 65  ommitting to the
0890: 20 6e 65 77 20 64 65 66 69 6e 69 74 69 6f 6e 2e   new definition.
08a0: 20 57 65 20 64 6f 20 6e 6f 74 20 73 74 6f 72 65   We do not store
08b0: 20 74 68 65 20 70 61 74 68 0a 09 23 20 69 74 73   the path..# its
08c0: 65 6c 66 2c 20 74 68 69 73 20 65 6e 73 75 72 65  elf, this ensure
08d0: 73 20 74 68 61 74 20 74 68 65 20 66 69 6c 65 20  s that the file 
08e0: 69 73 20 5f 6e 6f 74 5f 20 63 6c 65 61 6e 65 64  is _not_ cleaned
08f0: 20 75 70 20 61 66 74 65 72 0a 09 23 20 61 20 72   up after..# a r
0900: 75 6e 2e 0a 0a 09 73 65 74 20 6d 79 73 74 61 74  un....set mystat
0910: 65 20 24 7b 74 79 70 65 7d 3a 3a 53 54 41 54 45  e ${type}::STATE
0920: 0a 09 73 65 74 20 6d 79 70 61 74 68 20 20 7b 7d  ..set mypath  {}
0930: 0a 0a 09 63 61 74 63 68 20 7b 20 24 6d 79 73 74  ...catch { $myst
0940: 61 74 65 20 63 6c 6f 73 65 20 7d 0a 09 72 65 6e  ate close }..ren
0950: 61 6d 65 20 20 24 7b 74 79 70 65 7d 3a 3a 54 45  ame  ${type}::TE
0960: 4d 50 20 24 6d 79 73 74 61 74 65 0a 0a 09 6c 6f  MP $mystate...lo
0970: 67 20 77 72 69 74 65 20 32 20 73 74 61 74 65 20  g write 2 state 
0980: 22 69 73 20 24 70 61 74 68 22 0a 09 72 65 74 75  "is $path"..retu
0990: 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 74 79  rn.    }..    ty
09a0: 70 65 6d 65 74 68 6f 64 20 73 65 74 75 70 20 7b  pemethod setup {
09b0: 7d 20 7b 0a 09 23 20 49 66 2c 20 61 6e 64 20 6f  } {..# If, and o
09c0: 6e 6c 79 20 69 66 20 6e 6f 20 73 74 61 74 65 20  nly if no state 
09d0: 64 61 74 61 62 61 73 65 20 77 61 73 20 64 65 66  database was def
09e0: 69 6e 65 64 20 62 79 20 74 68 65 20 75 73 65 72  ined by the user
09f0: 0a 09 23 20 74 68 65 6e 20 69 74 20 69 73 20 6e  ..# then it is n
0a00: 6f 77 20 74 68 65 20 74 69 6d 65 20 74 6f 20 63  ow the time to c
0a10: 72 65 61 74 65 20 6f 75 72 20 6f 77 6e 20 75 73  reate our own us
0a20: 69 6e 67 20 61 20 74 65 6d 70 66 69 6c 65 2e 0a  ing a tempfile..
0a30: 0a 09 69 66 20 7b 24 6d 79 73 74 61 74 65 20 6e  ..if {$mystate n
0a40: 65 20 22 22 7d 20 72 65 74 75 72 6e 0a 0a 09 73  e ""} return...s
0a50: 65 74 20 6d 79 70 61 74 68 20 20 5b 66 69 6c 65  et mypath  [file
0a60: 75 74 69 6c 3a 3a 74 65 6d 70 66 69 6c 65 20 63  util::tempfile c
0a70: 76 73 32 66 6f 73 73 69 6c 5f 73 74 61 74 65 5f  vs2fossil_state_
0a80: 5d 0a 09 73 65 74 20 6d 79 73 74 61 74 65 20 24  ]..set mystate $
0a90: 7b 74 79 70 65 7d 3a 3a 53 54 41 54 45 0a 09 73  {type}::STATE..s
0aa0: 71 6c 69 74 65 33 20 24 6d 79 73 74 61 74 65 20  qlite3 $mystate 
0ab0: 24 6d 79 70 61 74 68 0a 0a 09 6c 6f 67 20 77 72  $mypath...log wr
0ac0: 69 74 65 20 32 20 73 74 61 74 65 20 22 75 73 69  ite 2 state "usi
0ad0: 6e 67 20 24 6d 79 70 61 74 68 22 0a 09 72 65 74  ng $mypath"..ret
0ae0: 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 74  urn.    }..    t
0af0: 79 70 65 6d 65 74 68 6f 64 20 72 65 6c 65 61 73  ypemethod releas
0b00: 65 20 7b 7d 20 7b 0a 09 6c 6f 67 20 77 72 69 74  e {} {..log writ
0b10: 65 20 32 20 73 74 61 74 65 20 72 65 6c 65 61 73  e 2 state releas
0b20: 65 0a 09 24 7b 74 79 70 65 7d 3a 3a 53 54 41 54  e..${type}::STAT
0b30: 45 20 63 6c 6f 73 65 0a 09 69 66 20 7b 24 6d 79  E close..if {$my
0b40: 70 61 74 68 20 65 71 20 22 22 7d 20 72 65 74 75  path eq ""} retu
0b50: 72 6e 0a 09 66 69 6c 65 20 64 65 6c 65 74 65 20  rn..file delete 
0b60: 24 6d 79 70 61 74 68 0a 09 72 65 74 75 72 6e 0a  $mypath..return.
0b70: 20 20 20 20 7d 0a 0a 20 20 20 20 23 20 44 65 63      }..    # Dec
0b80: 6c 61 72 65 20 61 20 74 61 62 6c 65 20 6e 65 65  lare a table nee
0b90: 64 65 64 20 66 6f 72 20 74 68 65 20 73 74 6f 72  ded for the stor
0ba0: 69 6e 67 20 6f 66 20 70 65 72 73 69 73 74 65 6e  ing of persisten
0bb0: 74 20 73 74 61 74 65 2c 20 61 6e 64 0a 20 20 20  t state, and.   
0bc0: 20 23 20 69 74 73 20 73 74 72 75 63 74 75 72 65   # its structure
0bd0: 2e 20 41 20 70 6f 73 73 69 62 6c 79 20 70 72 65  . A possibly pre
0be0: 76 69 6f 75 73 6c 79 20 65 78 69 73 74 69 6e 67  viously existing
0bf0: 20 64 65 66 69 6e 69 74 69 6f 6e 20 69 73 0a 20   definition is. 
0c00: 20 20 20 23 20 64 72 6f 70 70 65 64 2e 20 54 6f     # dropped. To
0c10: 20 62 65 20 75 73 65 64 20 77 68 65 6e 20 61 20   be used when a 
0c20: 74 61 62 6c 65 20 69 73 20 6e 65 65 64 65 64 20  table is needed 
0c30: 61 6e 64 20 6e 6f 74 20 61 73 73 75 6d 65 64 20  and not assumed 
0c40: 74 6f 0a 20 20 20 20 23 20 65 78 69 73 74 20 66  to.    # exist f
0c50: 72 6f 6d 20 70 72 65 76 69 6f 75 73 20 70 61 73  rom previous pas
0c60: 73 65 73 2e 0a 0a 20 20 20 20 74 79 70 65 6d 65  ses...    typeme
0c70: 74 68 6f 64 20 65 78 74 65 6e 64 20 7b 6e 61 6d  thod extend {nam
0c80: 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 7b 69 6e  e definition {in
0c90: 64 69 63 65 73 20 7b 7d 7d 7d 20 7b 0a 09 6c 6f  dices {}}} {..lo
0ca0: 67 20 77 72 69 74 65 20 35 20 73 74 61 74 65 20  g write 5 state 
0cb0: 22 65 78 74 65 6e 64 20 24 6e 61 6d 65 22 0a 09  "extend $name"..
0cc0: 53 61 76 65 20 22 65 78 74 65 6e 64 20 24 6e 61  Save "extend $na
0cd0: 6d 65 20 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  me =============
0ce0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
0cf0: 3d 3d 3d 22 0a 0a 09 24 6d 79 73 74 61 74 65 20  ==="...$mystate 
0d00: 74 72 61 6e 73 61 63 74 69 6f 6e 20 7b 0a 09 20  transaction {.. 
0d10: 20 20 20 63 61 74 63 68 20 7b 20 24 6d 79 73 74     catch { $myst
0d20: 61 74 65 20 65 76 61 6c 20 22 44 52 4f 50 20 54  ate eval "DROP T
0d30: 41 42 4c 45 20 24 6e 61 6d 65 22 20 7d 0a 09 20  ABLE $name" }.. 
0d40: 20 20 20 24 6d 79 73 74 61 74 65 20 65 76 61 6c     $mystate eval
0d50: 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20 24   "CREATE TABLE $
0d60: 6e 61 6d 65 20 28 20 24 64 65 66 69 6e 69 74 69  name ( $definiti
0d70: 6f 6e 20 29 22 0a 0a 09 20 20 20 20 73 65 74 20  on )"...    set 
0d80: 69 64 20 30 0a 09 20 20 20 20 66 6f 72 65 61 63  id 0..    foreac
0d90: 68 20 63 6f 6c 75 6d 6e 73 20 24 69 6e 64 69 63  h columns $indic
0da0: 65 73 20 7b 0a 09 09 6c 6f 67 20 77 72 69 74 65  es {...log write
0db0: 20 35 20 73 74 61 74 65 20 22 69 6e 64 65 78 20   5 state "index 
0dc0: 20 24 6e 61 6d 65 24 69 64 22 0a 0a 09 09 24 6d   $name$id"....$m
0dd0: 79 73 74 61 74 65 20 65 76 61 6c 20 22 43 52 45  ystate eval "CRE
0de0: 41 54 45 20 49 4e 44 45 58 20 24 7b 6e 61 6d 65  ATE INDEX ${name
0df0: 7d 24 69 64 20 4f 4e 20 24 7b 6e 61 6d 65 7d 20  }$id ON ${name} 
0e00: 28 20 5b 6a 6f 69 6e 20 24 63 6f 6c 75 6d 6e 73  ( [join $columns
0e10: 20 2c 5d 20 29 22 0a 09 09 69 6e 63 72 20 69 64   ,] )"...incr id
0e20: 0a 09 20 20 20 20 7d 0a 09 7d 0a 09 72 65 74 75  ..    }..}..retu
0e30: 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23 20  rn.    }..    # 
0e40: 44 65 63 6c 61 72 65 20 74 68 61 74 20 61 20 74  Declare that a t
0e50: 61 62 6c 65 20 69 73 20 6e 65 65 64 65 64 20 66  able is needed f
0e60: 6f 72 20 72 65 61 64 69 6e 67 20 66 72 6f 6d 20  or reading from 
0e70: 61 6e 64 2f 6f 72 20 73 74 6f 72 69 6e 67 0a 20  and/or storing. 
0e80: 20 20 20 23 20 74 6f 20 70 65 72 73 69 73 74 65     # to persiste
0e90: 6e 74 20 73 74 61 74 65 2c 20 61 6e 64 20 69 73  nt state, and is
0ea0: 20 61 73 73 75 6d 65 64 20 74 6f 20 61 6c 72 65   assumed to alre
0eb0: 61 64 79 20 65 78 69 73 74 2e 20 41 20 6d 69 73  ady exist. A mis
0ec0: 73 69 6e 67 0a 20 20 20 20 23 20 74 61 62 6c 65  sing.    # table
0ed0: 20 69 73 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20   is an internal 
0ee0: 65 72 72 6f 72 20 63 61 75 73 69 6e 67 20 61 6e  error causing an
0ef0: 20 69 6d 6d 65 64 69 61 74 65 20 65 78 69 74 2e   immediate exit.
0f00: 0a 0a 20 20 20 20 74 79 70 65 6d 65 74 68 6f 64  ..    typemethod
0f10: 20 75 73 65 20 7b 6e 61 6d 65 7d 20 7b 0a 09 6c   use {name} {..l
0f20: 6f 67 20 77 72 69 74 65 20 35 20 73 74 61 74 65  og write 5 state
0f30: 20 22 75 73 65 20 20 20 20 24 6e 61 6d 65 22 0a   "use    $name".
0f40: 09 53 61 76 65 20 22 75 73 65 20 24 6e 61 6d 65  .Save "use $name
0f50: 20 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d   ===============
0f60: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
0f70: 3d 3d 3d 3d 22 0a 0a 09 73 65 74 20 66 6f 75 6e  ===="...set foun
0f80: 64 20 5b 6c 6c 65 6e 67 74 68 20 5b 24 6d 79 73  d [llength [$mys
0f90: 74 61 74 65 20 65 76 61 6c 20 7b 0a 09 20 20 20  tate eval {..   
0fa0: 20 53 45 4c 45 43 54 20 6e 61 6d 65 0a 09 20 20   SELECT name..  
0fb0: 20 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d 61    FROM sqlite_ma
0fc0: 73 74 65 72 0a 09 20 20 20 20 57 48 45 52 45 20  ster..    WHERE 
0fd0: 74 79 70 65 20 3d 20 27 74 61 62 6c 65 27 0a 09  type = 'table'..
0fe0: 20 20 20 20 41 4e 44 20 20 20 6e 61 6d 65 20 3d      AND   name =
0ff0: 20 24 6e 61 6d 65 0a 09 20 20 20 20 3b 0a 09 7d   $name..    ;..}
1000: 5d 5d 0a 0a 09 23 20 4e 6f 20 61 73 73 65 72 74  ]]...# No assert
1010: 2c 20 77 6f 75 6c 64 20 63 61 75 73 65 20 63 79  , would cause cy
1020: 63 6c 65 20 69 6e 20 70 61 63 6b 61 67 65 20 64  cle in package d
1030: 65 70 65 6e 64 65 6e 63 69 65 73 0a 09 69 66 20  ependencies..if 
1040: 7b 24 66 6f 75 6e 64 7d 20 72 65 74 75 72 6e 0a  {$found} return.
1050: 09 74 72 6f 75 62 6c 65 20 69 6e 74 65 72 6e 61  .trouble interna
1060: 6c 20 22 54 68 65 20 72 65 71 75 69 72 65 64 20  l "The required 
1070: 74 61 62 6c 65 20 5c 22 24 6e 61 6d 65 5c 22 20  table \"$name\" 
1080: 69 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 2e 22  is not defined."
1090: 0a 09 23 20 4e 6f 74 20 72 65 61 63 68 65 64 0a  ..# Not reached.
10a0: 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20  .return.    }.. 
10b0: 20 20 20 74 79 70 65 6d 65 74 68 6f 64 20 64 69     typemethod di
10c0: 73 63 61 72 64 20 7b 6e 61 6d 65 7d 20 7b 0a 09  scard {name} {..
10d0: 23 20 4d 65 74 68 6f 64 20 66 6f 72 20 61 20 75  # Method for a u
10e0: 73 65 72 20 74 6f 20 72 65 6d 6f 76 65 20 6f 75  ser to remove ou
10f0: 74 64 61 74 65 64 20 69 6e 66 6f 72 6d 61 74 69  tdated informati
1100: 6f 6e 20 66 72 6f 6d 20 74 68 65 0a 09 23 20 70  on from the..# p
1110: 65 72 73 69 73 74 65 6e 74 20 73 74 61 74 65 2c  ersistent state,
1120: 20 74 61 62 6c 65 20 62 79 20 74 61 62 6c 65 2e   table by table.
1130: 0a 0a 09 6c 6f 67 20 77 72 69 74 65 20 35 20 73  ...log write 5 s
1140: 74 61 74 65 20 22 64 69 73 63 61 72 64 20 24 6e  tate "discard $n
1150: 61 6d 65 22 0a 0a 09 24 6d 79 73 74 61 74 65 20  ame"...$mystate 
1160: 74 72 61 6e 73 61 63 74 69 6f 6e 20 7b 0a 09 20  transaction {.. 
1170: 20 20 20 63 61 74 63 68 20 7b 20 24 6d 79 73 74     catch { $myst
1180: 61 74 65 20 65 76 61 6c 20 22 44 52 4f 50 20 54  ate eval "DROP T
1190: 41 42 4c 45 20 24 6e 61 6d 65 22 20 7d 0a 09 7d  ABLE $name" }..}
11a0: 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a  ..return.    }..
11b0: 20 20 20 20 74 79 70 65 6d 65 74 68 6f 64 20 72      typemethod r
11c0: 75 6e 20 7b 61 72 67 73 7d 20 7b 0a 09 53 61 76  un {args} {..Sav
11d0: 65 20 24 61 72 67 73 0a 09 72 65 74 75 72 6e 20  e $args..return 
11e0: 5b 75 70 6c 65 76 65 6c 20 31 20 5b 6c 69 6e 73  [uplevel 1 [lins
11f0: 65 72 74 20 24 61 72 67 73 20 30 20 24 6d 79 73  ert $args 0 $mys
1200: 74 61 74 65 20 65 76 61 6c 5d 5d 0a 20 20 20 20  tate eval]].    
1210: 7d 0a 0a 20 20 20 20 74 79 70 65 6d 65 74 68 6f  }..    typemetho
1220: 64 20 6f 6e 65 20 7b 61 72 67 73 7d 20 7b 0a 09  d one {args} {..
1230: 53 61 76 65 20 24 61 72 67 73 0a 09 72 65 74 75  Save $args..retu
1240: 72 6e 20 5b 75 70 6c 65 76 65 6c 20 31 20 5b 6c  rn [uplevel 1 [l
1250: 69 6e 73 65 72 74 20 24 61 72 67 73 20 30 20 24  insert $args 0 $
1260: 6d 79 73 74 61 74 65 20 6f 6e 65 63 6f 6c 75 6d  mystate onecolum
1270: 6e 5d 5d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 74  n]].    }..    t
1280: 79 70 65 6d 65 74 68 6f 64 20 74 72 61 6e 73 61  ypemethod transa
1290: 63 74 69 6f 6e 20 7b 73 63 72 69 70 74 7d 20 7b  ction {script} {
12a0: 0a 09 72 65 74 75 72 6e 20 5b 75 70 6c 65 76 65  ..return [upleve
12b0: 6c 20 31 20 5b 6c 69 73 74 20 24 6d 79 73 74 61  l 1 [list $mysta
12c0: 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 24  te transaction $
12d0: 73 63 72 69 70 74 5d 5d 0a 20 20 20 20 7d 0a 0a  script]].    }..
12e0: 20 20 20 20 74 79 70 65 6d 65 74 68 6f 64 20 69      typemethod i
12f0: 64 20 7b 7d 20 7b 0a 09 72 65 74 75 72 6e 20 5b  d {} {..return [
1300: 24 6d 79 73 74 61 74 65 20 6c 61 73 74 5f 69 6e  $mystate last_in
1310: 73 65 72 74 5f 72 6f 77 69 64 5d 0a 20 20 20 20  sert_rowid].    
1320: 7d 0a 0a 20 20 20 20 74 79 70 65 6d 65 74 68 6f  }..    typemetho
1330: 64 20 73 61 76 65 71 75 65 72 69 65 73 74 6f 20  d savequeriesto 
1340: 7b 70 61 74 68 7d 20 7b 0a 09 73 65 74 20 6d 79  {path} {..set my
1350: 73 61 76 65 70 61 74 68 20 24 70 61 74 68 0a 09  savepath $path..
1360: 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20  return.    }..  
1370: 20 20 23 20 23 20 23 23 20 23 23 23 20 23 23 23    # # ## ### ###
1380: 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23  ## ######## ####
1390: 23 23 23 23 23 23 23 23 23 0a 0a 20 20 20 20 70  #########..    p
13a0: 72 6f 63 20 53 61 76 65 20 7b 74 65 78 74 7d 20  roc Save {text} 
13b0: 7b 0a 09 3a 3a 76 61 72 69 61 62 6c 65 20 6d 79  {..::variable my
13c0: 73 61 76 65 70 61 74 68 0a 09 69 66 20 7b 24 6d  savepath..if {$m
13d0: 79 73 61 76 65 70 61 74 68 20 65 71 20 22 22 7d  ysavepath eq ""}
13e0: 20 72 65 74 75 72 6e 0a 09 66 69 6c 65 75 74 69   return..fileuti
13f0: 6c 3a 3a 61 70 70 65 6e 64 54 6f 46 69 6c 65 20  l::appendToFile 
1400: 24 6d 79 73 61 76 65 70 61 74 68 20 24 74 65 78  $mysavepath $tex
1410: 74 5c 6e 5c 6e 0a 09 72 65 74 75 72 6e 0a 20 20  t\n\n..return.  
1420: 20 20 7d 0a 0a 20 20 20 20 23 20 23 20 23 23 20    }..    # # ## 
1430: 23 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23  ### ##### ######
1440: 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23  ## #############
1450: 0a 20 20 20 20 23 23 20 53 74 61 74 65 0a 0a 20  .    ## State.. 
1460: 20 20 20 74 79 70 65 76 61 72 69 61 62 6c 65 20     typevariable 
1470: 6d 79 73 74 61 74 65 20 20 20 20 7b 7d 20 3b 20  mystate    {} ; 
1480: 23 20 53 71 6c 69 74 65 20 64 61 74 61 62 61 73  # Sqlite databas
1490: 65 20 28 63 6f 6d 6d 61 6e 64 29 20 68 6f 6c 64  e (command) hold
14a0: 69 6e 67 20 74 68 65 20 63 6f 6e 76 65 72 74 65  ing the converte
14b0: 72 20 73 74 61 74 65 2e 0a 20 20 20 20 74 79 70  r state..    typ
14c0: 65 76 61 72 69 61 62 6c 65 20 6d 79 70 61 74 68  evariable mypath
14d0: 20 20 20 20 20 7b 7d 20 3b 20 23 20 50 61 74 68       {} ; # Path
14e0: 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65   to the database
14f0: 2c 20 66 6f 72 20 63 6c 65 61 6e 75 70 20 6f 66  , for cleanup of
1500: 20 61 20 74 65 6d 70 20 64 61 74 61 62 61 73 65   a temp database
1510: 2e 0a 20 20 20 20 74 79 70 65 76 61 72 69 61 62  ..    typevariab
1520: 6c 65 20 6d 79 73 61 76 65 70 61 74 68 20 7b 7d  le mysavepath {}
1530: 20 3b 20 23 20 50 61 74 68 20 77 68 65 72 65 20   ; # Path where 
1540: 74 6f 20 73 61 76 65 20 71 75 65 72 69 65 73 20  to save queries 
1550: 66 6f 72 20 69 6e 74 72 6f 73 70 65 63 74 69 6f  for introspectio
1560: 6e 2e 0a 0a 20 20 20 20 23 20 23 20 23 23 20 23  n...    # # ## #
1570: 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23 23  ## ##### #######
1580: 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  # #############.
1590: 20 20 20 20 23 23 20 49 6e 74 65 72 6e 61 6c 20      ## Internal 
15a0: 6d 65 74 68 6f 64 73 0a 0a 0a 20 20 20 20 23 20  methods...    # 
15b0: 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20 23  # ## ### ##### #
15c0: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
15d0: 23 23 23 23 23 0a 20 20 20 20 23 23 20 43 6f 6e  #####.    ## Con
15e0: 66 69 67 75 72 61 74 69 6f 6e 0a 0a 20 20 20 20  figuration..    
15f0: 70 72 61 67 6d 61 20 2d 68 61 73 69 6e 73 74 61  pragma -hasinsta
1600: 6e 63 65 73 20 20 20 6e 6f 20 3b 20 23 20 73 69  nces   no ; # si
1610: 6e 67 6c 65 74 6f 6e 0a 20 20 20 20 70 72 61 67  ngleton.    prag
1620: 6d 61 20 2d 68 61 73 74 79 70 65 69 6e 66 6f 20  ma -hastypeinfo 
1630: 20 20 20 6e 6f 20 3b 20 23 20 6e 6f 20 69 6e 74     no ; # no int
1640: 72 6f 73 70 65 63 74 69 6f 6e 0a 20 20 20 20 70  rospection.    p
1650: 72 61 67 6d 61 20 2d 68 61 73 74 79 70 65 64 65  ragma -hastypede
1660: 73 74 72 6f 79 20 6e 6f 20 3b 20 23 20 69 6d 6d  stroy no ; # imm
1670: 6f 72 74 61 6c 0a 0a 20 20 20 20 23 20 23 20 23  ortal..    # # #
1680: 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23  # ### ##### ####
1690: 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23  #### ###########
16a0: 23 23 0a 7d 0a 0a 6e 61 6d 65 73 70 61 63 65 20  ##.}..namespace 
16b0: 65 76 61 6c 20 3a 3a 76 63 3a 3a 66 6f 73 73 69  eval ::vc::fossi
16c0: 6c 3a 3a 69 6d 70 6f 72 74 3a 3a 63 76 73 20 7b  l::import::cvs {
16d0: 0a 20 20 20 20 6e 61 6d 65 73 70 61 63 65 20 65  .    namespace e
16e0: 78 70 6f 72 74 20 73 74 61 74 65 0a 20 20 20 20  xport state.    
16f0: 6e 61 6d 65 73 70 61 63 65 20 65 76 61 6c 20 73  namespace eval s
1700: 74 61 74 65 20 7b 0a 09 6e 61 6d 65 73 70 61 63  tate {..namespac
1710: 65 20 69 6d 70 6f 72 74 20 3a 3a 76 63 3a 3a 74  e import ::vc::t
1720: 6f 6f 6c 73 3a 3a 74 72 6f 75 62 6c 65 0a 09 6e  ools::trouble..n
1730: 61 6d 65 73 70 61 63 65 20 69 6d 70 6f 72 74 20  amespace import 
1740: 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67  ::vc::tools::log
1750: 0a 09 6c 6f 67 20 72 65 67 69 73 74 65 72 20 73  ..log register s
1760: 74 61 74 65 0a 20 20 20 20 7d 0a 7d 0a 0a 23 20  tate.    }.}..# 
1770: 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20 23  # ## ### ##### #
1780: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
1790: 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23  ##### ##########
17a0: 23 23 23 23 23 23 23 23 23 23 23 0a 23 23 20 52  ###########.## R
17b0: 65 61 64 79 0a 0a 70 61 63 6b 61 67 65 20 70 72  eady..package pr
17c0: 6f 76 69 64 65 20 76 63 3a 3a 66 6f 73 73 69 6c  ovide vc::fossil
17d0: 3a 3a 69 6d 70 6f 72 74 3a 3a 63 76 73 3a 3a 73  ::import::cvs::s
17e0: 74 61 74 65 20 31 2e 30 0a 72 65 74 75 72 6e 0a  tate 1.0.return.