Luvit-mongodb NPM

#Luvit MongoDB Driver

This is a pure luvit Mongodb driver with async Api.

What is Luvit?

Luvit is a Node.js like, with Asynchronous I/O support language for Lua.

See more at: Luvit

Install

With lit:
```
Run 
```bash
lit install cyrilis/luvit-mongodb
``` 
```
in terminal under your project path, then require("luvit-mongodb") in your project.

Or copy source files:

	Just put source file in your project, then require it with `./path/to/luvit-mongodb`

Or with NPM: (Not recommended)

	~~If you would like to install with NPM, you can just run `npm install luvit-mongodb` in terminal under your project path. then require `module/luvit-mongodb` in your project.~~

Getting started

local Mongo = require("luvit-mongodb")
local db = Mongo:new({db = "DATABASE_NAME"}) 
-- replace `DATABASE_NAME` above with a DB name.
db:on("connect", function()
	-- Do stuff here.
    local Post = db:collection("post")
    local page = 1
    Post:insert({
		    title = "Hello word!", 
		    content = "Here is the first blog post ....",
		    author = "Cyril Hou"
		},function(err, res)
		    p(res)
	    end)
	local posts = Post:find({author = "Cyril Hou"})
	posts:limit(10):skip(page * 10):update({authorAge = 25}):exec(function(err, res)
		p(err, res)
	end)
	
	Post:distinct("category", function(err, res)
		p("All distinct value of `category` in post collections: ", res)
	end)
end)

Cursor

update
cursor:update(doc[, callback])
doc: table, required, The modifications to apply.

callback: optional, callback function

post:update({abc = 123}, function(err, res)
		 p(err, res)
end)
-- same as bellow ⬇️
 post:update({abc = 123}):exec(function(err, res)
		 p(err, res)
end)

find
cursor:find(query[, callback])
query: table, optional , Specifies selection criteria using query operators. To return all documents in a collection, omit this parameter or pass an empty document ({}).

callback: optional， callback function

post:find({abc = 123}, function(err, res)
		 p(err, res)
end)
-- same as bellow ⬇️
post:find({abc = 123}):exec(function(err, res)
		 p(err, res)
end)

remove
cursor:remove([callback])

callback: optional, callback function

post:remove(function(err, res)
		 p(err, res)
end)
-- same as bellow ⬇️
post:remove():exec(function(err, res)
		 p(err, res)
end)

skip
cursor:skip(skip[, callback])
skip: number, docs to skip in query.
callback: optional, callback function
limit
cursor:limit(limit[, callback])
limit: number, limit return docs count.
callback: optional, callback function
count
cursor:count([callback])

callback: optional, callback function

post:count(function(err, res)
		 p(err, res)
end)
-- same as bellow ⬇️
post:remove():exec(function(err, res)
		 p(err, res)
end)

exec
cursor:exec(callback)
callback: required, callback function Execute callback function after set query and limit skip params.

Collection

initialize
A collection should initialize with db instance. db:collection(collectionName)
collectionName: string, name for collection in name.
```
		local coll = db:collection("post")
```
find
coll:find(query[, callback])
query: table, optional, Specifies selection criteria using query operators. To return all documents in a collection, omit this parameter or pass an empty document ({}).

callback: function, optional, callback function.

		 coll:find({id = 1}):exec(function(err, res)
			 p(err, res)
		 end)
    -- same as bellow ⬇️
		 coll:find({id = 1}, function(err, res)
			 p(err, res)
		 end)