/ Hex Artifact Content
Login
Home Timeline Branches Tags Tickets Wiki More...
Download
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact 280a819542c2a001c342e4bfe829974a76cb449e:

0000: 23 21 2f 75 73 72 2f 62 69 6e 2f 74 63 6c 73 68  #!/usr/bin/tclsh
0010: 0a 23 0a 23 20 54 68 69 73 20 73 63 72 69 70 74  .#.# This script
0020: 20 63 6f 6e 73 74 72 75 63 74 73 20 74 68 65 20   constructs the 
0030: 22 73 71 6c 69 74 65 33 2e 68 22 20 68 65 61 64  "sqlite3.h" head
0040: 65 72 20 66 69 6c 65 20 66 72 6f 6d 20 74 68 65  er file from the
0050: 20 66 6f 6c 6c 6f 77 69 6e 67 0a 23 20 73 6f 75   following.# sou
0060: 72 63 65 73 3a 0a 23 0a 23 20 20 20 31 29 20 54  rces:.#.#   1) T
0070: 68 65 20 73 72 63 2f 73 71 6c 69 74 65 2e 68 2e  he src/sqlite.h.
0080: 69 6e 20 73 6f 75 72 63 65 20 66 69 6c 65 2e 20  in source file. 
0090: 20 54 68 69 73 20 69 73 20 74 68 65 20 74 65 6d   This is the tem
00a0: 70 6c 61 74 65 20 66 6f 72 20 73 71 6c 69 74 65  plate for sqlite
00b0: 33 2e 68 2e 0a 23 20 20 20 32 29 20 54 68 65 20  3.h..#   2) The 
00c0: 56 45 52 53 49 4f 4e 20 66 69 6c 65 20 63 6f 6e  VERSION file con
00d0: 74 61 69 6e 69 6e 67 20 74 68 65 20 63 75 72 72  taining the curr
00e0: 65 6e 74 20 53 51 4c 69 74 65 20 76 65 72 73 69  ent SQLite versi
00f0: 6f 6e 20 6e 75 6d 62 65 72 2e 0a 23 20 20 20 33  on number..#   3
0100: 29 20 54 68 65 20 6d 61 6e 69 66 65 73 74 20 66  ) The manifest f
0110: 69 6c 65 20 66 72 6f 6d 20 74 68 65 20 66 6f 73  ile from the fos
0120: 73 69 6c 20 53 43 4d 2e 20 20 54 68 69 73 20 67  sil SCM.  This g
0130: 69 76 65 73 20 75 73 65 20 74 68 65 20 64 61 74  ives use the dat
0140: 65 2e 0a 23 20 20 20 34 29 20 54 68 65 20 6d 61  e..#   4) The ma
0150: 6e 69 66 65 73 74 2e 75 75 69 64 20 66 69 6c 65  nifest.uuid file
0160: 20 66 72 6f 6d 20 74 68 65 20 66 6f 73 73 69 6c   from the fossil
0170: 20 53 43 4d 2e 20 20 54 68 69 73 20 67 69 76 65   SCM.  This give
0180: 73 20 74 68 65 20 53 48 41 31 20 68 61 73 68 2e  s the SHA1 hash.
0190: 0a 23 0a 23 20 52 75 6e 20 74 68 69 73 20 73 63  .#.# Run this sc
01a0: 72 69 70 74 20 62 79 20 73 70 65 63 69 66 79 69  ript by specifyi
01b0: 6e 67 20 74 68 65 20 72 6f 6f 74 20 64 69 72 65  ng the root dire
01c0: 63 74 6f 72 79 20 6f 66 20 74 68 65 20 73 6f 75  ctory of the sou
01d0: 72 63 65 20 74 72 65 65 0a 23 20 6f 6e 20 74 68  rce tree.# on th
01e0: 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 0a  e command-line..
01f0: 23 20 0a 23 20 54 68 69 73 20 73 63 72 69 70 74  # .# This script
0200: 20 70 65 72 66 6f 72 6d 73 20 70 72 6f 63 65 73   performs proces
0210: 73 69 6e 67 20 6f 6e 20 73 72 63 2f 73 71 6c 69  sing on src/sqli
0220: 74 65 2e 68 2e 69 6e 2e 20 49 74 3a 0a 23 0a 23  te.h.in. It:.#.#
0230: 20 20 20 31 29 20 41 64 64 73 20 53 51 4c 49 54     1) Adds SQLIT
0240: 45 5f 45 58 54 45 52 4e 20 69 6e 20 66 72 6f 6e  E_EXTERN in fron
0250: 74 20 6f 66 20 74 68 65 20 64 65 63 6c 61 72 61  t of the declara
0260: 74 69 6f 6e 20 6f 66 20 67 6c 6f 62 61 6c 20 76  tion of global v
0270: 61 72 69 61 62 6c 65 73 2c 0a 23 20 20 20 32 29  ariables,.#   2)
0280: 20 41 64 64 73 20 53 51 4c 49 54 45 5f 41 50 49   Adds SQLITE_API
0290: 20 69 6e 20 66 72 6f 6e 74 20 6f 66 20 74 68 65   in front of the
02a0: 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 6f 66 20   declaration of 
02b0: 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 2c 0a 23  API functions,.#
02c0: 20 20 20 33 29 20 52 65 70 6c 61 63 65 73 20 74     3) Replaces t
02d0: 68 65 20 73 74 72 69 6e 67 20 2d 2d 56 45 52 53  he string --VERS
02e0: 2d 2d 20 77 69 74 68 20 74 68 65 20 63 75 72 72  -- with the curr
02f0: 65 6e 74 20 6c 69 62 72 61 72 79 20 76 65 72 73  ent library vers
0300: 69 6f 6e 2c 20 0a 23 20 20 20 20 20 20 66 6f 72  ion, .#      for
0310: 6d 61 74 74 65 64 20 61 73 20 61 20 73 74 72 69  matted as a stri
0320: 6e 67 20 28 65 2e 67 2e 20 22 33 2e 36 2e 31 37  ng (e.g. "3.6.17
0330: 22 29 2c 20 61 6e 64 0a 23 20 20 20 34 29 20 52  "), and.#   4) R
0340: 65 70 6c 61 63 65 73 20 74 68 65 20 73 74 72 69  eplaces the stri
0350: 6e 67 20 2d 2d 56 45 52 53 49 4f 4e 2d 4e 55 4d  ng --VERSION-NUM
0360: 42 45 52 2d 2d 20 77 69 74 68 20 63 75 72 72 65  BER-- with curre
0370: 6e 74 20 6c 69 62 72 61 72 79 20 76 65 72 73 69  nt library versi
0380: 6f 6e 2c 0a 23 20 20 20 20 20 20 66 6f 72 6d 61  on,.#      forma
0390: 74 74 65 64 20 61 73 20 61 6e 20 69 6e 74 65 67  tted as an integ
03a0: 65 72 20 28 65 2e 67 2e 20 22 33 30 30 36 30 31  er (e.g. "300601
03b0: 37 22 29 2e 0a 23 20 20 20 35 29 20 52 65 70 6c  7")..#   5) Repl
03c0: 61 63 65 73 20 74 68 65 20 73 74 72 69 6e 67 20  aces the string 
03d0: 2d 2d 53 4f 55 52 43 45 2d 49 44 2d 2d 20 77 69  --SOURCE-ID-- wi
03e0: 74 68 20 74 68 65 20 64 61 74 65 20 61 6e 64 20  th the date and 
03f0: 74 69 6d 65 20 61 6e 64 20 73 68 61 31 20 0a 23  time and sha1 .#
0400: 20 20 20 20 20 20 68 61 73 68 20 6f 66 20 74 68        hash of th
0410: 65 20 66 6f 73 73 69 6c 2d 73 63 6d 20 6d 61 6e  e fossil-scm man
0420: 69 66 65 73 74 20 66 6f 72 20 74 68 65 20 73 6f  ifest for the so
0430: 75 72 63 65 20 74 72 65 65 2e 0a 23 0a 23 20 54  urce tree..#.# T
0440: 68 69 73 20 73 63 72 69 70 74 20 6f 75 74 70 75  his script outpu
0450: 74 73 20 74 6f 20 73 74 64 6f 75 74 2e 0a 23 0a  ts to stdout..#.
0460: 23 20 45 78 61 6d 70 6c 65 20 75 73 61 67 65 3a  # Example usage:
0470: 0a 23 0a 23 20 20 20 74 63 6c 73 68 20 6d 6b 73  .#.#   tclsh mks
0480: 71 6c 69 74 65 33 68 2e 74 63 6c 20 2e 2e 2f 73  qlite3h.tcl ../s
0490: 71 6c 69 74 65 20 3e 73 71 6c 69 74 65 33 2e 68  qlite >sqlite3.h
04a0: 0a 23 0a 0a 0a 23 20 47 65 74 20 74 68 65 20 73  .#...# Get the s
04b0: 6f 75 72 63 65 20 74 72 65 65 20 72 6f 6f 74 20  ource tree root 
04c0: 64 69 72 65 63 74 6f 72 79 20 66 72 6f 6d 20 74  directory from t
04d0: 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 0a  he command-line.
04e0: 23 0a 73 65 74 20 54 4f 50 20 5b 6c 69 6e 64 65  #.set TOP [linde
04f0: 78 20 24 61 72 67 76 20 30 5d 0a 0a 23 20 47 65  x $argv 0]..# Ge
0500: 74 20 74 68 65 20 53 51 4c 69 74 65 20 76 65 72  t the SQLite ver
0510: 73 69 6f 6e 20 6e 75 6d 62 65 72 20 28 65 78 3a  sion number (ex:
0520: 20 33 2e 36 2e 31 38 29 20 66 72 6f 6d 20 74 68   3.6.18) from th
0530: 65 20 24 54 4f 50 2f 56 45 52 53 49 4f 4e 20 66  e $TOP/VERSION f
0540: 69 6c 65 2e 0a 23 0a 73 65 74 20 69 6e 20 5b 6f  ile..#.set in [o
0550: 70 65 6e 20 24 54 4f 50 2f 56 45 52 53 49 4f 4e  pen $TOP/VERSION
0560: 5d 0a 73 65 74 20 7a 56 65 72 73 69 6f 6e 20 5b  ].set zVersion [
0570: 73 74 72 69 6e 67 20 74 72 69 6d 20 5b 72 65 61  string trim [rea
0580: 64 20 24 69 6e 5d 5d 0a 63 6c 6f 73 65 20 24 69  d $in]].close $i
0590: 6e 0a 73 65 74 20 6e 56 65 72 73 69 6f 6e 20 5b  n.set nVersion [
05a0: 65 76 61 6c 20 66 6f 72 6d 61 74 20 22 25 64 25  eval format "%d%
05b0: 30 33 64 25 30 33 64 22 20 5b 73 70 6c 69 74 20  03d%03d" [split 
05c0: 24 7a 56 65 72 73 69 6f 6e 20 2e 5d 5d 0a 0a 23  $zVersion .]]..#
05d0: 20 47 65 74 20 74 68 65 20 66 6f 73 73 69 6c 2d   Get the fossil-
05e0: 73 63 6d 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62  scm version numb
05f0: 65 72 20 66 72 6f 6d 20 24 54 4f 50 2f 6d 61 6e  er from $TOP/man
0600: 69 66 65 73 74 2e 75 75 69 64 2e 0a 23 0a 73 65  ifest.uuid..#.se
0610: 74 20 69 6e 20 5b 6f 70 65 6e 20 24 54 4f 50 2f  t in [open $TOP/
0620: 6d 61 6e 69 66 65 73 74 2e 75 75 69 64 5d 0a 73  manifest.uuid].s
0630: 65 74 20 7a 55 75 69 64 20 5b 73 74 72 69 6e 67  et zUuid [string
0640: 20 74 72 69 6d 20 5b 72 65 61 64 20 24 69 6e 5d   trim [read $in]
0650: 5d 0a 63 6c 6f 73 65 20 24 69 6e 0a 0a 23 20 47  ].close $in..# G
0660: 65 74 20 74 68 65 20 66 6f 73 73 69 6c 2d 73 63  et the fossil-sc
0670: 6d 20 63 68 65 63 6b 2d 69 6e 20 64 61 74 65 20  m check-in date 
0680: 66 72 6f 6d 20 74 68 65 20 22 44 22 20 63 61 72  from the "D" car
0690: 64 20 6f 66 20 24 54 4f 50 2f 6d 61 6e 69 66 65  d of $TOP/manife
06a0: 73 74 2e 0a 23 0a 73 65 74 20 69 6e 20 5b 6f 70  st..#.set in [op
06b0: 65 6e 20 24 54 4f 50 2f 6d 61 6e 69 66 65 73 74  en $TOP/manifest
06c0: 5d 0a 73 65 74 20 7a 44 61 74 65 20 7b 7d 0a 77  ].set zDate {}.w
06d0: 68 69 6c 65 20 7b 21 5b 65 6f 66 20 24 69 6e 5d  hile {![eof $in]
06e0: 7d 20 7b 0a 20 20 73 65 74 20 6c 69 6e 65 20 5b  } {.  set line [
06f0: 67 65 74 73 20 24 69 6e 5d 0a 20 20 69 66 20 7b  gets $in].  if {
0700: 5b 72 65 67 65 78 70 20 7b 5e 44 20 28 32 5b 2d  [regexp {^D (2[-
0710: 30 2d 39 54 3a 5d 2b 29 7d 20 24 6c 69 6e 65 20  0-9T:]+)} $line 
0720: 61 6c 6c 20 64 61 74 65 5d 7d 20 7b 0a 20 20 20  all date]} {.   
0730: 20 73 65 74 20 7a 44 61 74 65 20 5b 73 74 72 69   set zDate [stri
0740: 6e 67 20 6d 61 70 20 7b 54 20 7b 20 7d 7d 20 24  ng map {T { }} $
0750: 64 61 74 65 5d 0a 20 20 20 20 62 72 65 61 6b 0a  date].    break.
0760: 20 20 7d 0a 7d 0a 63 6c 6f 73 65 20 24 69 6e 0a    }.}.close $in.
0770: 0a 23 20 53 65 74 20 75 70 20 70 61 74 74 65 72  .# Set up patter
0780: 6e 73 20 66 6f 72 20 72 65 63 6f 67 6e 69 7a 69  ns for recognizi
0790: 6e 67 20 41 50 49 20 64 65 63 6c 61 72 61 74 69  ng API declarati
07a0: 6f 6e 73 2e 0a 23 0a 73 65 74 20 76 61 72 70 61  ons..#.set varpa
07b0: 74 74 65 72 6e 20 7b 5e 5b 61 2d 7a 41 2d 5a 5d  ttern {^[a-zA-Z]
07c0: 5b 61 2d 7a 41 2d 5a 5f 30 2d 39 20 2a 5d 2b 73  [a-zA-Z_0-9 *]+s
07d0: 71 6c 69 74 65 33 5f 5b 5f 61 2d 7a 41 2d 5a 30  qlite3_[_a-zA-Z0
07e0: 2d 39 5d 2b 28 5c 5b 7c 3b 7c 20 3d 29 7d 0a 73  -9]+(\[|;| =)}.s
07f0: 65 74 20 64 65 63 6c 70 61 74 74 65 72 6e 20 7b  et declpattern {
0800: 5e 20 2a 5b 61 2d 7a 41 2d 5a 5d 5b 61 2d 7a 41  ^ *[a-zA-Z][a-zA
0810: 2d 5a 5f 30 2d 39 20 5d 2b 20 5c 2a 2a 73 71 6c  -Z_0-9 ]+ \**sql
0820: 69 74 65 33 5f 5b 5f 61 2d 7a 41 2d 5a 30 2d 39  ite3_[_a-zA-Z0-9
0830: 5d 2b 5c 28 7d 0a 0a 23 20 46 6f 72 63 65 20 74  ]+\(}..# Force t
0840: 68 65 20 6f 75 74 70 75 74 20 74 6f 20 75 73 65  he output to use
0850: 20 75 6e 69 78 20 6c 69 6e 65 20 65 6e 64 69 6e   unix line endin
0860: 67 73 2c 20 65 76 65 6e 20 6f 6e 20 57 69 6e 64  gs, even on Wind
0870: 6f 77 73 2e 0a 66 63 6f 6e 66 69 67 75 72 65 20  ows..fconfigure 
0880: 73 74 64 6f 75 74 20 2d 74 72 61 6e 73 6c 61 74  stdout -translat
0890: 69 6f 6e 20 6c 66 0a 0a 73 65 74 20 66 69 6c 65  ion lf..set file
08a0: 6c 69 73 74 20 5b 73 75 62 73 74 20 7b 0a 20 20  list [subst {.  
08b0: 24 54 4f 50 2f 73 72 63 2f 73 71 6c 69 74 65 2e  $TOP/src/sqlite.
08c0: 68 2e 69 6e 0a 20 20 24 54 4f 50 2f 65 78 74 2f  h.in.  $TOP/ext/
08d0: 72 74 72 65 65 2f 73 71 6c 69 74 65 33 72 74 72  rtree/sqlite3rtr
08e0: 65 65 2e 68 0a 20 20 24 54 4f 50 2f 65 78 74 2f  ee.h.  $TOP/ext/
08f0: 73 65 73 73 69 6f 6e 2f 73 71 6c 69 74 65 33 73  session/sqlite3s
0900: 65 73 73 69 6f 6e 2e 68 0a 7d 5d 0a 0a 23 20 50  ession.h.}]..# P
0910: 72 6f 63 65 73 73 20 74 68 65 20 73 6f 75 72 63  rocess the sourc
0920: 65 20 66 69 6c 65 73 2e 0a 23 0a 66 6f 72 65 61  e files..#.forea
0930: 63 68 20 66 69 6c 65 20 24 66 69 6c 65 6c 69 73  ch file $filelis
0940: 74 20 7b 0a 20 20 73 65 74 20 69 6e 20 5b 6f 70  t {.  set in [op
0950: 65 6e 20 24 66 69 6c 65 5d 0a 20 20 77 68 69 6c  en $file].  whil
0960: 65 20 7b 21 5b 65 6f 66 20 24 69 6e 5d 7d 20 7b  e {![eof $in]} {
0970: 0a 20 20 0a 20 20 20 20 73 65 74 20 6c 69 6e 65  .  .    set line
0980: 20 5b 67 65 74 73 20 24 69 6e 5d 0a 0a 20 20 20   [gets $in]..   
0990: 20 23 20 46 69 6c 65 20 73 71 6c 69 74 65 33 72   # File sqlite3r
09a0: 74 72 65 65 2e 68 20 63 6f 6e 74 61 69 6e 73 20  tree.h contains 
09b0: 61 20 6c 69 6e 65 20 22 23 69 6e 63 6c 75 64 65  a line "#include
09c0: 20 3c 73 71 6c 69 74 65 33 2e 68 3e 22 2e 20 4f   <sqlite3.h>". O
09d0: 6d 69 74 20 74 68 69 73 0a 20 20 20 20 23 20 6c  mit this.    # l
09e0: 69 6e 65 20 77 68 65 6e 20 63 6f 70 79 69 6e 67  ine when copying
09f0: 20 73 71 6c 69 74 65 33 72 74 72 65 65 2e 68 20   sqlite3rtree.h 
0a00: 69 6e 74 6f 20 73 71 6c 69 74 65 33 2e 68 2e 0a  into sqlite3.h..
0a10: 20 20 20 20 23 0a 20 20 20 20 69 66 20 7b 5b 73      #.    if {[s
0a20: 74 72 69 6e 67 20 6d 61 74 63 68 20 7b 2a 23 69  tring match {*#i
0a30: 6e 63 6c 75 64 65 2a 3c 73 71 6c 69 74 65 33 2e  nclude*<sqlite3.
0a40: 68 3e 2a 7d 20 24 6c 69 6e 65 5d 7d 20 63 6f 6e  h>*} $line]} con
0a50: 74 69 6e 75 65 0a 20 20 0a 20 20 20 20 72 65 67  tinue.  .    reg
0a60: 73 75 62 20 2d 2d 20 2d 2d 56 45 52 53 2d 2d 20  sub -- --VERS-- 
0a70: 20 20 20 20 20 20 20 20 20 20 24 6c 69 6e 65 20            $line 
0a80: 24 7a 56 65 72 73 69 6f 6e 20 6c 69 6e 65 0a 20  $zVersion line. 
0a90: 20 20 20 72 65 67 73 75 62 20 2d 2d 20 2d 2d 56     regsub -- --V
0aa0: 45 52 53 49 4f 4e 2d 4e 55 4d 42 45 52 2d 2d 20  ERSION-NUMBER-- 
0ab0: 24 6c 69 6e 65 20 24 6e 56 65 72 73 69 6f 6e 20  $line $nVersion 
0ac0: 6c 69 6e 65 0a 20 20 20 20 72 65 67 73 75 62 20  line.    regsub 
0ad0: 2d 2d 20 2d 2d 53 4f 55 52 43 45 2d 49 44 2d 2d  -- --SOURCE-ID--
0ae0: 20 20 20 20 20 20 24 6c 69 6e 65 20 22 24 7a 44        $line "$zD
0af0: 61 74 65 20 24 7a 55 75 69 64 22 20 6c 69 6e 65  ate $zUuid" line
0b00: 0a 20 20 0a 20 20 20 20 69 66 20 7b 5b 72 65 67  .  .    if {[reg
0b10: 65 78 70 20 7b 64 65 66 69 6e 65 20 53 51 4c 49  exp {define SQLI
0b20: 54 45 5f 45 58 54 45 52 4e 20 65 78 74 65 72 6e  TE_EXTERN extern
0b30: 7d 20 24 6c 69 6e 65 5d 7d 20 7b 0a 20 20 20 20  } $line]} {.    
0b40: 20 20 70 75 74 73 20 24 6c 69 6e 65 0a 20 20 20    puts $line.   
0b50: 20 20 20 70 75 74 73 20 5b 67 65 74 73 20 24 69     puts [gets $i
0b60: 6e 5d 0a 20 20 20 20 20 20 70 75 74 73 20 22 22  n].      puts ""
0b70: 0a 20 20 20 20 20 20 70 75 74 73 20 22 23 69 66  .      puts "#if
0b80: 6e 64 65 66 20 53 51 4c 49 54 45 5f 41 50 49 22  ndef SQLITE_API"
0b90: 0a 20 20 20 20 20 20 70 75 74 73 20 22 23 20 64  .      puts "# d
0ba0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 50 49  efine SQLITE_API
0bb0: 22 0a 20 20 20 20 20 20 70 75 74 73 20 22 23 65  ".      puts "#e
0bc0: 6e 64 69 66 22 0a 20 20 20 20 20 20 73 65 74 20  ndif".      set 
0bd0: 6c 69 6e 65 20 22 22 0a 20 20 20 20 7d 0a 20 20  line "".    }.  
0be0: 0a 20 20 20 20 69 66 20 7b 28 5b 72 65 67 65 78  .    if {([regex
0bf0: 70 20 24 76 61 72 70 61 74 74 65 72 6e 20 24 6c  p $varpattern $l
0c00: 69 6e 65 5d 20 26 26 20 21 5b 72 65 67 65 78 70  ine] && ![regexp
0c10: 20 7b 5e 20 2a 74 79 70 65 64 65 66 7d 20 24 6c   {^ *typedef} $l
0c20: 69 6e 65 5d 29 0a 20 20 20 20 20 7c 7c 20 28 5b  ine]).     || ([
0c30: 72 65 67 65 78 70 20 24 64 65 63 6c 70 61 74 74  regexp $declpatt
0c40: 65 72 6e 20 24 6c 69 6e 65 5d 29 0a 20 20 20 20  ern $line]).    
0c50: 7d 20 7b 0a 20 20 20 20 20 20 73 65 74 20 6c 69  } {.      set li
0c60: 6e 65 20 22 53 51 4c 49 54 45 5f 41 50 49 20 24  ne "SQLITE_API $
0c70: 6c 69 6e 65 22 0a 20 20 20 20 7d 0a 20 20 20 20  line".    }.    
0c80: 70 75 74 73 20 24 6c 69 6e 65 0a 20 20 7d 0a 20  puts $line.  }. 
0c90: 20 63 6c 6f 73 65 20 24 69 6e 0a 7d 0a            close $in.}.
This page was generated in about 0.005s by Fossil 2.10 [9d9ef82234] 2019-10-04 21:41:13