forks/erlang-sqlite3
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Changed the type of table names to include binaries and strings.

Browse Source 
Table names get converted into iolists anyway, and in some applications,
it is undesireable to have to create atoms for dynamic table names.
This commit is contained in:
Ulf Wiger
2012-02-22 20:44:07 +01:00
parent 9297d7268e
commit 6986d0bbde
4 changed files with 121 additions and 152 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
README.md
View File

@@ -1,57 +1,12 @@
# Erlang wrapper for SQLite3
This library allows you to work with SQLite3 databases from Erlang.
It is compatible with Windows and Linux, and should probably work on other OSes as well.
#The sqlite3 application#
## Compiling
### Linux
##Modules##
1. Install SQLite3 by running `sudo apt-get install sqlite3` or the equivalent for your package manager, or by [compiling from the source](http://source.online.free.fr/Linux_HowToCompileSQLite.html).
2. `make`.
<table width="100%" border="0" summary="list of modules">
<tr><td><a href="http://github.com/Feuerlabs/kvdb/blob/master/doc/sqlite3.md" class="module">sqlite3</a></td></tr>
<tr><td><a href="http://github.com/Feuerlabs/kvdb/blob/master/doc/sqlite3_lib.md" class="module">sqlite3_lib</a></td></tr></table>
### Cross-compiling
If you want to use erlang-sqlite3 on an embedded device, it can be cross-compiled.
1. Cross-compile [SQLite3](http://www.sqlite.org/cvstrac/wiki?p=HowToCompile) and [Erlang](http://www.erlang.org/doc/installation_guide/INSTALL-CROSS.html).
2. Change variables and paths in `rebar.cross_compile.config.sample` to the desired values and rename it to `rebar.cross_compile.config`.
3. `make cross_compile`.
### Windows with MS Visual C++
1. Download both the source amalgamation and the precompiled binary from http://www.sqlite.org/download.html. Extract files `sqlite3.h` from the amalgamation and `sqlite3.def` from the binary. Run this command from Visual Studio command prompt:
lib /def:sqlite3.def
to create the import library `sqlite3.lib`. In `rebar.config`, set the correct paths in tuples `{"win32", "CFLAGS", "/Idirectory/containing/sqlite3.h/ /Ic_src /W4 /wd4100 /wd4204"}` and `{"win32", "LDFLAGS", "/path/to/sqlite3.lib"}`.
2. `nmake`.
## DLL search path
Note that on Windows, `sqlite3.dll` usually won't be installed in the system-wide DLL search path. In this case, it should be placed in the working directory of your application.
## Running the test suite
### Linux
`make test`
### Windows
1. `nmake tests`
2. If you get the error `"Error loading sqlite3_drv: The specified module could not be found"`, this is because `sqlite3.dll` isn't in the search path. Copy it to the `.eunit` directory.
## Example usage
See tests `src/sqlite3_test.erl` for a starting point.
## Authors
See ./AUTHORS