231 lines
6.9 KiB
HTML
231 lines
6.9 KiB
HTML
<html>
|
|
<head>
|
|
<! See Copyright Notice in license.html>
|
|
<title>LuaSQL: Database connectivity for the Lua programming language</title>
|
|
<style type="text/css">
|
|
ul { list-style-type: disc }
|
|
</style>
|
|
</head>
|
|
|
|
<body bgcolor="#FFFFFF">
|
|
|
|
<hr>
|
|
|
|
<center>
|
|
<table border=0 cellspacing=2 cellpadding=2>
|
|
<tr>
|
|
<td align=center>
|
|
<a href="http://www.keplerproject.org/luasql">
|
|
<img border=0 alt="LuaSQL logo" src="luasql.png">
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align=center>
|
|
<big><b>LuaSQL</b></big>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align=center valign=top>
|
|
Database connectivity for the
|
|
<a href="http://www.lua.org">Lua</a> programming language
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</center>
|
|
<p />
|
|
|
|
<center><small>
|
|
<a href=#over>overview</a> ·
|
|
<a href=#version>current version</a> ·
|
|
<a href=#download>download</a> ·
|
|
<a href=#new>news</a> ·
|
|
<a href=#installation>installation</a> ·
|
|
<a href="manual.html">manual</a> ·
|
|
<a href="license.html">license</a> ·
|
|
<a href="#credits">credits</a> ·
|
|
<a href="#contact">contact us</a>
|
|
</small></center>
|
|
<p />
|
|
|
|
<hr>
|
|
|
|
<h2>Contents</h2>
|
|
<ul>
|
|
<li> <a href=#over>Overview</a></li>
|
|
<li> <a href=#version>Current Version</a></li>
|
|
<li> <a href=#download>Download</a></li>
|
|
<li> <a href=#new>What's new</a></li>
|
|
<li> <a href=#installation>Installation</a></li>
|
|
<li> <a href="manual.html">User's manual</a></li>
|
|
<ul>
|
|
<li> <a href="manual.html#introduction">Introduction</a></li>
|
|
<li> <a href="manual.html#environment_object">Environment objects</a></li>
|
|
<li> <a href="manual.html#connection_object">Connection objects</a></li>
|
|
<li> <a href="manual.html#cursor_object">Cursor objects</a></li>
|
|
<li> <a href="manual.html#postgres_extensions">PostgreSQL extensions</a></li>
|
|
<li> <a href="manual.html#mysql_extensions">MySQL extensions</a></li>
|
|
<li> <a href="manual.html#oracle_extensions">Oracle extensions</a></li>
|
|
<li> <a href="manual.html#examples">Examples</a></li>
|
|
</ul>
|
|
<li> <a href="license.html">Copyright & License</a></li>
|
|
<li> <a href="#credits">Credits</a></li>
|
|
<li> <a href="#contact">Contact us</a></li>
|
|
</ul>
|
|
<p />
|
|
|
|
<a name=over></a>
|
|
<h2>Overview</h2>
|
|
<p>
|
|
LuaSQL is a simple interface from Lua to a DBMS. It enables a Lua program to:
|
|
<ul>
|
|
<li> Connect to ODBC, Oracle, MySQL, SQLite, JDBC and PostgreSQL databases;</li>
|
|
<li> Execute arbitrary SQL statements;</li>
|
|
<li> Retrieve results in a row-by-row cursor fashion.</li>
|
|
</ul>
|
|
|
|
LuaSQL is free software and uses the same <a href="license.html">license</a>
|
|
as Lua 5.0.
|
|
|
|
<a name=version></a>
|
|
<h2>Current Version</h2>
|
|
<p>
|
|
LuaSQL version 2.0 beta 3 (for Lua 5.0) is now available for
|
|
<a href="#download">download</a>.<br />
|
|
The PostgreSQL driver has been tested on Linux and MacOS X and is compatible
|
|
with PostgreSQL 7.x.
|
|
The ODBC driver has been tested on Windows (SQLServer and Microsoft Access
|
|
drivers).
|
|
The MySQL driver has been tested on Linux and is compatible with versions 4.0
|
|
and 4.1.
|
|
The Oracle driver has been tested on Windows and is compatible with OCI 8 API.
|
|
The SQLite driver had been tested on Linux and are compatible with versions 2.x.
|
|
The JDBC driver has been tested with LuaJava Beta 3 and JDK 1.4 (MySQL driver).
|
|
</p>
|
|
|
|
<a name=download></a>
|
|
<h2>Download</h2>
|
|
LuaSQL can be downloaded in source code from the <a href=
|
|
"http://luaforge.net/project/showfiles.php?group_id=12">Lua
|
|
Forge</a> page.
|
|
|
|
<a name=new></a>
|
|
<h2>What's New</h2>
|
|
|
|
<ul>
|
|
<li>[12/22/2004] Version 2.0 beta 3 released
|
|
<li>[11/26/2004] Version 2.0 beta 2 released
|
|
<li>[12/10/2003] Version 2.0 beta released
|
|
</ul>
|
|
|
|
<p>
|
|
Version 2.0 beta 3 has only minor bug fixes.
|
|
</p>
|
|
<p>
|
|
Version 2.0 beta 2 has some bug fixes and the new SQLite and JDBC drivers.
|
|
Also, it follows the
|
|
<a href="http://www.keplerproject.org/compat">package proposal</a>
|
|
for Lua 5.1
|
|
(see section <a href="#installation">Installation</a> for more details).
|
|
</p>
|
|
<p>
|
|
Version 2.0 has some design modifications and implementation improvements
|
|
</p>
|
|
<ul>
|
|
<li>New <tt>fetch</tt> method: more eficient and more flexible
|
|
<li>New <tt>setautocommit</tt> method
|
|
<li>Lua 5.0 and 5.1 compatible
|
|
<li>Dynamically loadable or statically linked
|
|
<li>New drivers for Oracle and MySQL databases
|
|
</ul>
|
|
|
|
<a name="installation"></a>
|
|
<h2>Installation</h2>
|
|
|
|
<p>
|
|
LuaSQL is distributed as a set of C source files:
|
|
a common source and header file (<tt>luasql.h</tt> and <tt>luasql.c</tt>);
|
|
and one source file for each driver.
|
|
Each driver should be compiled together with luasql.c file (it is so small
|
|
that we don't make another library of it) to generate a library.
|
|
This library could be linked to the application (the initialization
|
|
function is <tt>luaopen_luasql<i>drivername</i></tt> and it is a Lua
|
|
open-library compatible function)
|
|
or dynamically loaded.
|
|
</p>
|
|
<p>
|
|
All LuaSQL drivers follow the
|
|
<a href="http://www.keplerproject.org/compat">package proposal</a>
|
|
for Lua 5.1, therefore this package should be "installed".
|
|
In other words, if you are using Lua 5.0,
|
|
the files <tt>compat-5.1.c</tt> and <tt>compat-5.1.h</tt> must be used
|
|
in the compilation and the file <tt>compat-5.1.lua</tt> must be installed
|
|
in the <tt>LUA_PATH</tt>. If you are using Lua 5.1, nothing should be done.
|
|
</p>
|
|
|
|
In order to use LuaSQL over JDBC, make sure that:
|
|
<ul>
|
|
<li> Lua is running with <a href="http://www.keplerproject.org/luajava">LuaJava</a>
|
|
<li> LuaSQL jar is in the Java's virtual machine classpath
|
|
<li> JDBC driver of the desired database is also in the virtual machine classpath
|
|
</ul>
|
|
|
|
|
|
<a name="credits"></a>
|
|
|
|
<h2>Credits</h2>
|
|
|
|
<h4>LuaSQL 2.0</h4>
|
|
<p>
|
|
Version 2.0 was redesigned by Roberto Ierusalimschy, André Carregal
|
|
and Tomás Guisasola as part of the
|
|
<a href="http://www.keplerproject.org">Kepler Project</a>.
|
|
The implementation is compatible with Lua 5.0 and was coded by
|
|
Tomás Guisasola, Eduardo Quintão and Thiago Ponte,
|
|
with many invaluable contributions by Michael Roth, Tiago Dionisio,
|
|
Leonardo Godinho and Danilo Tuler.
|
|
|
|
<h4>LuaSQL 1.0</h4>
|
|
<p>
|
|
LuaSQL was designed by Pedro Miller Rabinovitch and Roberto
|
|
Ierusalimschy.
|
|
The first implementation was compatible with Lua 4.0a.
|
|
Many modifications were made but not distributed by Diego Nehab (ODBC),
|
|
Carlos Cassino, Tomás Guisasola and Eduardo Quintão (PostgreSQL).
|
|
<p>
|
|
LuaSQL development was sponsored by
|
|
<a href="http://www.fabricadigital.com.br">Fábrica Digital</a>.
|
|
|
|
|
|
<a name="contact"></a>
|
|
<h2>Contact us</h2>
|
|
|
|
<p>
|
|
For more information please
|
|
<a href="mailto:info-NO-SPAM-THANKS@keplerproject.org">contact us</a>.
|
|
Comments are welcome!
|
|
</p>
|
|
|
|
|
|
<p />
|
|
<center><small>
|
|
<a href=#over>overview</a> ·
|
|
<a href=#version>current version</a> ·
|
|
<a href=#download>download</a> ·
|
|
<a href=#new>what's new</a> ·
|
|
<a href=#installation>installation</a> ·
|
|
<a href="manual.html">manual</a> ·
|
|
<a href="license.html">license</a> ·
|
|
<a href="#credits">credits</a> ·
|
|
<a href="#contact">contact us</a>
|
|
</small></center>
|
|
<p />
|
|
|
|
<hr>
|
|
<small>
|
|
$Id: index.html,v 1.35 2004/12/22 14:21:50 tomas Exp $
|
|
</small>
|
|
|
|
</body>
|
|
</html>
|