Tarantool16
This is adapter for tarantool version 1.6.
(adapter for version <=1.5 is called tarantool)
Installation
Add this line to your application's Gemfile:
gem 'tarantool16'
And then execute:
$ bundle
Or install it yourself as:
$ gem install tarantool16
Usage
Currently only simple single threaded one-request-at-time connection implemented.
require 'tarantool16'
db = Tarantool16.new host:'localhost:33013'
#db = Tarantool16.new host:'localhost:33013', user:'tester', password:'testpass'
# select from '_space' space info about 'test' table
# returns array of tuples as an array
tar.get(272, ['test'], index: 2)
# same, but return tuples as a hashes
tar.get(272, ['test'], index: 2, hash: true)
# same with names
# Names and index descriptions are fetched from tarantool.
# Index is autodetected by key names
tar.get(:_space, {name: 'test'})
# get all spaces
tar.select(:_space, nil, iterator: :all)
tar.select(:_space, nil, iterator: :all, hash: true)
tar.select(:_space, [512], index: 0, iterator: :>=, hash: true)
# override tuple field definition
tar.define_fields(:test, [:id, :name, :value])
tar.insert(:test, [1, 'buddy', [1,2,3]])
tar.replace(:test, [1, 'buddy!', [2,3,4]])
tar.update(:test, [1], [[':', 1, 6, 6, '?']])
#tar.update(:test, [1], [[':', 1, 6, 6, '?']], index: 0)
tar.delete(:test, [1])
#tar.delete(:test, [1], index: 0)
tar.insert(:test, {id: 1, name: 'buddy', value: [1,2,3]})
tar.replace(:test, {id: 1, name: 'buddy!', value: [2,3,4]})
tar.update(:test, {id: 1}, {name: [':', 6,6,'?']})
tar.delete(:test, {id: 1})
# note: currenlty there is no documented way to store field definition in an tarantool
# but actually you can do it with this
tar.update(:_space, {name: 'test'}, {format: [:=, [{name: :id, type: :num}, {name: :name, type: :str}, {name: :value, type: '*'}]]})
Changelog
0.0.7 - Implement EVAL, fix REPLACE 0.0.6 - DumbConnection supports timeouts
Contributing
- Fork it ( https://github.com/funny-falcon/tarantool16/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Or simply fill an issue