3 # To build a single huge source file holding all of SQLite (or at
4 # least the core components - the test harness, shell, and TCL
5 # interface are omitted.) first do
9 # The make target above moves all of the source code files into
10 # a subdirectory named "tsrc". (This script expects to find the files
11 # there and will not work if they are not found.) There are a few
12 # generated C code files that are also added to the tsrc directory.
13 # For example, the "parse.c" and "parse.h" files to implement the
14 # the parser are derived from "parse.y" using lemon. And the
15 # "keywordhash.h" files is generated by a program named "mkkeywordhash".
17 # After the "tsrc" directory has been created and populated, run
20 # tclsh mksqlite3c.tcl
22 # The amalgamated SQLite code will be written into sqlite3.c
25 # Begin by reading the "sqlite3.h" header file. Extract the version number
26 # from in this file. The version number is needed to generate the header
27 # comment of the amalgamation.
29 if {[lsearch $argv --nostatic]>=0} {
34 if {[lsearch $argv --linemacros]>=0} {
39 set in
[open tsrc
/sqlite3.h
]
44 if {$line=="" && [eof $in]} break
46 regexp {#define\s+SQLITE_VERSION\s+"(.*)"} $line all VERSION
50 # Open the output file and write a header comment at the beginning
53 set out
[open sqlite3.c w
]
54 # Force the output to use unix line endings, even on Windows.
55 fconfigure $out -translation lf
56 set today
[clock format [clock seconds
] -format "%Y-%m-%d %H:%M:%S UTC" -gmt 1]
58 {/******************************************************************************
59 ** This
file is an amalgamation of many separate C
source files from SQLite
60 ** version
$VERSION. By combining all the individual C code files into this
61 ** single large
file, the entire code can be compiled as a single translation
62 ** unit. This allows many compilers to do optimizations that would not be
63 ** possible
if the files were compiled separately. Performance improvements
64 ** of
5% or more are commonly seen when SQLite is compiled as a single
67 ** This
file is all you need to compile SQLite. To use SQLite in other
68 ** programs
, you need this
file and the
"sqlite3.h" header
file that defines
69 ** the programming interface to the SQLite library.
(If you do not have
70 ** the
"sqlite3.h" header
file at hand
, you will find a copy embedded within
71 ** the
text of this
file. Search
for "Begin file sqlite3.h" to find the start
72 ** of the embedded sqlite3.h header
file.
) Additional code files may be needed
73 ** if you want a wrapper to interface SQLite with your choice of programming
74 ** language. The code
for the
"sqlite3" command-line shell is also in a
75 ** separate
file. This
file contains only code
for the core SQLite library.
78 #define SQLITE_AMALGAMATION 1}]
81 {#ifndef SQLITE_PRIVATE
82 # define SQLITE_PRIVATE static
89 # These are the header files used by SQLite. The first time any of these
90 # files are seen in a #include statement in the C code, include the complete
91 # text of the file in-line. The file only needs to be included once.
123 set available_hdr
($hdr) 1
125 set available_hdr
(sqliteInt.h
) 0
127 # 78 stars used for comment formatting.
129 {*****************************************************************************}
131 # Insert a comment into the code
133 proc section_comment
{text} {
135 set n
[string length
$text]
136 set nstar
[expr {60 - $n}]
137 set stars
[string range
$s78 0 $nstar]
138 puts $out "/************** $text $stars/"
141 # Read the source file named $filename and write it into the
142 # sqlite3.c output file. If any #include statements are seen,
143 # process them appropriately.
145 proc copy_file
{filename} {
146 global seen_hdr available_hdr out addstatic linemacros
148 set tail
[file tail
$filename]
149 section_comment
"Begin file $tail"
150 if {$linemacros} {puts $out "#line 1 \"$filename\""}
151 set in
[open $filename r
]
152 set varpattern
{^
[a-zA-Z
][a-zA-Z_0-9
*]+(sqlite3
[_a-zA-Z0-9
]+)(\[|
;|
=)}
153 set declpattern
{[a-zA-Z
][a-zA-Z_0-9
]+ \**(sqlite3
[_a-zA-Z0-9
]+)\(}
154 if {[file extension
$filename]==".h"} {
155 set declpattern
" *$declpattern"
157 set declpattern ^
$declpattern
161 if {[regexp {^
\s
*#\s*include\s+["<]([^">]+)[">]} $line all hdr]} {
162 if {[info exists available_hdr
($hdr)]} {
163 if {$available_hdr($hdr)} {
164 if {$hdr!="os_common.h" && $hdr!="hwtime.h"} {
165 set available_hdr
($hdr) 0
167 section_comment
"Include $hdr in the middle of $tail"
169 section_comment
"Continuing where we left off in $tail"
170 if {$linemacros} {puts $out "#line [expr {$ln+1}] \"$filename\""}
172 } elseif
{![info exists seen_hdr
($hdr)]} {
173 if {![regexp {/\*\s
+amalgamator
:\s
+dontcache
\s
+\*/} $line]} {
177 } elseif
{[regexp {/\*\s
+amalgamator
:\s
+keep
\s
+\*/} $line]} {
178 # This include file must be kept because there was a "keep"
179 # directive inside of a line comment.
182 # Comment out the entire line, replacing any nested comment
183 # begin/end markers with the harmless substring "**".
184 puts $out "/* [string map [list /* ** */ **] $line] */"
186 } elseif
{[regexp {^
#ifdef __cplusplus} $line]} {
188 } elseif
{!$linemacros && [regexp {^
#line} $line]} {
189 # Skip #line directives.
190 } elseif
{$addstatic && ![regexp {^
(static|typedef
)} $line]} {
191 regsub {^SQLITE_API
} $line {} line
192 if {[regexp $declpattern $line all funcname
]} {
193 # Add the SQLITE_PRIVATE or SQLITE_API keyword before functions.
194 # so that linkage can be modified at compile-time.
195 if {[regexp {^sqlite3_
} $funcname]} {
196 puts $out "SQLITE_API $line"
198 puts $out "SQLITE_PRIVATE $line"
200 } elseif
{[regexp $varpattern $line all varname
]} {
201 # Add the SQLITE_PRIVATE before variable declarations or
202 # definitions for internal use
203 if {![regexp {^sqlite3_
} $varname]} {
204 regsub {^extern
} $line {} line
205 puts $out "SQLITE_PRIVATE $line"
207 if {[regexp {const char sqlite3_version
\[\];} $line]} {
208 set line
{const char sqlite3_version
[] = SQLITE_VERSION
;}
210 regsub {^SQLITE_EXTERN
} $line {} line
211 puts $out "SQLITE_API $line"
213 } elseif
{[regexp {^
(SQLITE_EXTERN
)?void
\(\*sqlite3IoTrace
\)} $line]} {
214 regsub {^SQLITE_EXTERN
} $line {} line
215 puts $out "SQLITE_PRIVATE $line"
216 } elseif
{[regexp {^void
\(\*sqlite3Os
} $line]} {
217 puts $out "SQLITE_PRIVATE $line"
226 section_comment
"End of $tail"
230 # Process the source files. Process files containing commonly
231 # used subroutines first in order to help the compiler find
232 # inlining opportunities.