Version 1 of tsql4mk

Updated 2005-04-18 08:57:13 by DDG

Tiny SQL for metakit databases.

This is an reliminary release! Author: Dr. Detlef Groth, MPIMG Berlin

Current homepage is at: http://goblet.molgen.mpg.de/tsql4mk/

From the readme: --- README

DESCRIPTION

tsql4mk is an experimental library and a console application for executing sql-statements against Metakit databases. It implements a subset of SQL92. tsql4mk uses Jean-Claude Wipplers Oomk and Will Duqette's "snit" (Snit Is Not Incrtcl), version 0.97. The api is modelled after R. Hipps great SQLite http://www.sqlite.org . This manuals were partially copied and adjusted for tsql4mk from the language reference of SQLite http://www.sqlite.org . Thanks fro D. Richard Hipp for this great piece of software.

LIMITS

The main limits of tsql4mk against SQLite are:

  • much lower speed, although not measured yet (layer on a layer ...)
  • only a small subset of the sql-language is implemented
  • limited join capabilites
  • no NULL is known

The advantages are:

  • no compilation required if you use the tclkit [L1 ] runtime
  • console, library and documentation are in one file -> easy installation and deployment

USAGE

  Examples:
 |   ----------------
 |   Usage: tsql4mk.kit ?-doc? ?-example? ?-run? ?-help?

 |     -doc            Show a bit of documentation
 |     -example        Display the example script
 |     -run            Run the example script
 |     -html           Show the html documentation

LIBRARY

To use tsql4mk, either unwrap tsql4mk.kit and source "tsql4mk.tcl", or if you use a new Tclkit with Metakit 2.4.9: simply source this starkit.

CONSOLE APPLICATION

tsql4mk.kit can be also as standalone console application in several ways:

 |   Usage: tsql4mk.kit <filename> <SQL STATEMENT>

or via pipes:

 |   echo <SQL STATEMENT> | tsql4mk.kit <filename>

Pipes can be used to execute several sql-statements at ones from a file and pipe this into the tsql4mk.kit application.

 |   cat <sqlfile> | tsql4mk.kit <filename>

This feature can be also used to convert a sqlite database into a metakit database:

 |   echo .dump | sqlite test.sqlite | tsql4mk.kit <filename>

The reverse way metakit -> sqlite is currently not yet implemented.

Documentation

 See [http::/goblet.molgen.mpg.de/tsql4mk/index.html]

Installation/Download

If you don't have already download tclkit suitable for your platform from www.equi4.com [L2 ]. Put it in your path. Download tsql4mk.kit from here [L3 ]. Done!