This folder contains the same Lemon version of the parent folder, but the "lemon.c" file has been split into separate modules, to simplify studying and editing its code.
The "lempar.c" file is left untouched (it's not an amalgamated source), and you can build Lemon by compiling "lemon.c", as usual.
The de-amalgamated source files in this folder were derived from:
- SQLite
tool/lemon.c, check-inf2f279b2(2021-10-04) - SQLite
tool/lempar.c, check-inba4fb518(2021-11-09)
Table of Contents
The Lemon source file lemon.c, like most tools from the SQLite project, was created by merging multiple C sources into a single file via a technique called "amalgamation", in order to reduce the number of file dependencies and improve performance (5-10% speed gain).
Except that today only the single source file of Lemon survives in the SQLite project — and code maintainance and updates are done directly in the amalgamated single source file.
I wanted to include in the Lemon Grove project a version of the Lemon source split into modules, to simplify studying its code and working on derivative versions and ports. Reversing the amalgamation is not a hard task in itself, for the amalgamator adds some comment lines indicating the name of the original file from which the code was taken:
void Configlist_reset(void);
/********* From the file "error.h" ***************************************/
void ErrorMsg(const char *, int,const char *, ...);
/****** From the file "option.h" ******************************************/
enum option_type { OPT_FLAG=1, OPT_INT, OPT_DBL, OPT_STR,
OPT_FFLAG, OPT_FINT, OPT_FDBL, OPT_FSTR};So, splitting the "lemon.c" file manually is neither a huge nor hard task.
But keeping the split sources always up to date with the latest upstream sources from the SQLite repository (which are updated quite often) is another matter altogether, and definitely a daunting task.
Therefore, I've created Lemon Slicer, a small tool to automate the de-amalgamation process, so that whenever I update the Lemon sources in the parent folder I can update with a single click their de-amalgamated counterparts in this folder.
Besides automating the task of splitting "lemon.c" into its original modules, Lemon Slicer also injects at the end of the left-over contents of the "lemon.c" file all the required #include directives to ensure that the split contents are loaded back in the correct order, so that the Lemon parser remains buildable by compiling "lemon.c".
If you need to de-amalgamated the Lemon sources in this project yourself, it can be easily done on Windows OS x64 with the following steps.
To download (or update) the Lemon Slicer de-amalgamator tool, open the CMD in the parent folder and type:
curl -LJO https://github.com/tajmone/lemon-slicer/raw/master/lemon-slicer.exe
You'll then find in the parent lemon/ folder the lemon-slicer.exe executable tool.
Just invoke it from the CMD (or double click on it) and in a few seconds it will update/recreate the de-amalgamated contents in lemon/sliced/.
If you're working on Linux, macOS or 32-bits Windows, you'll need to obtain a precompiled binary of Lemon Slicer matching your OS. Lemon Slicer is a cross-platform tool, so visit its repository for more info on how to obtain or compile it:
Of course, you can use Lemon Slicer to de-amalgamate any version of Lemon outside this project, as long as you execute it in a folder containing the "lemon.c" and "lempar.c" files (and on the condition that "lemon.c" still contains the original comment lines created by the SQLite amalgamator).
- Lemon Slicer — GitHub repository.
- The SQLite Amalgamation — for more info about amalgamation.
The following changelog lists which versions of the Lemon sources were used to create the de-amalgamated files found in this folder — where "upstream" refers to the SQLite project hosting the original Lemon sources.
- 2021-12-16
- 2021-02-10
- 2020-09-12
- 2020-01-05
- 2019-08-13