fastango
supercharged arangodb poc client.
Fastango is up to 3x (save docs) and 4x (get docs) as fast as the official ArangoDB JavaScript client when it runs with TCP connection reusage and up to 6x (save docs) and 8x (get docs) as fast as the untouched version (3.3.0).
Collection functions
Document functions
Misc functions
impelentation status
drawbacks
- not the full http api is implemented
- all request go into the same queue. on socket error this queue will resubmited to the db -> split queue to pipelined an non pipelined requests
- no cursor iteration (possbile when async functions land in in ES7)
initialize client
parser = new (require 'fastango/parser') 'IP', PORT
require('fastango/fastango') parser, '_system', (status, fastango) ->
if status >= 400
'some error'
return
'now you can use fastango'
database
_use
fastango._use 'myDb', (status, fastango) ->
if status >= 400
'some error'
Change the database. Note: the old fastango object points to the old db. You have to use the newly returned fastango object.
collections
truncate
fastango.testCollection.truncate (status, heads, body) ->
if status >= 400
'some error'
drop
fastango.testCollection.drop (status, heads, body) ->
if status >= 400
'some error'
_createDocumentCollection
fastango._createDocumentCollection 'NAME', {options}, (status, heads, body) ->
if status >= 400
'some error'
for options see https://docs.arangodb.com/HttpCollection/Creating.html
documents
save
fastango.testCollection.save JSON.strinigfy({key:'value'}), (status, heads, body) ->
if status >= 400
'some error'
update
fastango.testCollection.update '_key', JSON.strinigfy({key:'value'}), {options}, (status, heads, body) ->
if status >= 400
'some error'
for options (optional) see https://docs.arangodb.com/HttpDocument/WorkingWithDocuments.html (Patch document)
document
fastango.testCollection.document '_key', (status, heads, body) ->
if status >= 400
'some error'
count
fastango.testCollection.count (status, heads, body) ->
if status >= 400
'some error'
misc
_query
fastango._query 'FOR doc IN docs RETURN doc._key', {bindVars}, {options}, (status, cursor) ->
if status >= 400
'some error'
return
cursor.all (status, results) ->
if status >= 400
'some error'
for options see https://docs.arangodb.com/HttpAqlQueryCursor/AccessingCursors.html example:
fastango._query 'FOR doc IN docs RETURN doc._key', {}, {fullCount:true, maxPlans:1}, (status, cursor) ->
for the moment only cursor.all
is supported.
_transaction
fastango._transaction {
params:
a: 4
collections: ['col1', 'col2'] | # optional
read: ['col1', 'col2']
write: ['col1', 'col2']
waitForSync: true|false # optional
lockTimeout: UNUMBER # optional
}, (params) -> # the action function
return params.a
, (status, headers, body) ->
if status >= 400
'some error'