/ljffi-mongo

No description or website provided.
  1. C 78.1%
  2. Lua 18.1%
  3. Shell 1.8%
  4. Python 1.8%
  5. C++ 0.2%
C Lua Shell Python C++
Find file
Latest commit f317e47 Jul 18, 2013 @Miroff test/cases/0020-mongo: Tests for disconnect method
Permalink
Failed to load latest commit information.
etc/git/hooks Initial commit Jul 16, 2013
lib/mongo-c-driver Store mongo-c-driver 0.7.1 in the repository Jul 16, 2013
rockspec Created rockspec Jul 23, 2013
src/lua/ljffi-mongo mongo: Implemented disconnect method Jul 23, 2013
test/cases test/cases/0020-mongo: Tests for disconnect method Jul 23, 2013
.gitignore Initial commit Jul 16, 2013
AUTHORS Initial commit Jul 16, 2013
COPYRIGHT Initial commit Jul 16, 2013
README.md Initial commit Jul 16, 2013
TODO.md Created TODO file Jul 16, 2013

README.md

ljffi-mongo: LuaJIT FFI MongoDB Driver

Installation

  1. Download mongo-c-driver from https://github.com/mongodb/mongo-c-driver/
  2. Follow instructions from mongo-c-driver/README to build and install mongo-c-driver
  3. Don't forget to run sudo ldconfig after mongo-c-driver was installed

Usage

--import ljffi-mongo driver
local mongo = import 'ljffi-mongo/mongo' ()

--Connect to server
local con = mongo.connect("localhost", 27017)

local id = con:insert("ljffi-mongo.mycoll", {foo='bar'})

For more examples see test/cases/0020-mongo.lua

Serialization

ljffi-mongo supports transparent serialization/deserialization of Lua tables to BSON and BSON to Lua tables. This serialization is possible with certain restrictions:

A table could be serialized to MongoDB document iff:

  • All table keys must be either string, number, or boolean. Using other types as table key will cause an error.
  • All table values must be either string, number, boolean, nil, or table. Using other types of values will cause an error.
  • All nested tables should match to restrictions #1 and #2
  • Recursive tables are not supported.

Serialization rules are:

  • Empty tables will be serialized to empty documents
  • nil will be serialized to null

Deserialization restrictions

A MongoDB document could be deserialized using following rules:

  • Numbers of any type, integer, long, or double, will be deserialized to Lua number. Type information will be lost for this values.
  • Boolean values will be deserialized to Lua boolean
  • String values will be deserialized to Lua string
  • Null values will be deserialized to Lua nil
  • Arrays will be deserialized to Lua table
  • Objects will be deserialized to Lua table
  • Dates and timestamps will be deserialized to Lua number
  • ObjectID will be Arrays will be deserialized to Lua string

Copyright

Copyright (c) 2013, ljffi-mongo authors

See the copyright information in the file named COPYRIGHT.

This project is sponsored by LogicEditor (http://logiceditor.com/)