This software has been deprecated by Delwink Software in favor of its replacement library, libsqon.
Do NOT use this library in a production environment; it has been abandoned.
Below is the original text from this README.
A wrapper for the MySQL API with dynamic data structures.
When developing libpatts, we noticed that the functionality going into the query API could be put to good use in future projects as well, so we decided to make a wrapper for it with the name cquel.
cquel is designed to be useful when trying to do complicated tasks with data from a database that would be easier to do in the programming language than in SQL.
For running simple queries, you are probably better off just using the MySQL API. There will be fewer opportunities to forget about allocated memory, and the setup is much simpler.
cquel is designed for a situation where a table of data is pulled in from the database and the user wants to be able to arbitrarily modify the data in that table and then commit it to the database. The data are held in memory for editing, and then the entire structure is parsed in order to construct an update query to the database.
After following the steps in doc/build.md, you can install the shared library with
# make install
Alternatively, all the compiled libraries are placed in .libs
on success,
including the static one.
You can read a basic tutorial in doc/api.md, you can read the official API outline on Delwink's website, or you can generate it yourself with
$ doxygen Doxyfile
if you have doxygen installed. The files are placed in doc/api
.
cquel is free software: you are free to copy, modify, share, sell, and redistribute under the terms of version 3 of the GNU Affero General Public License. See COPYING for more details.