tokyocabinet

TokyoCabinet client for Crystal.

• crystal: 0.27.0

Usage

require "tokyocabinet"

include Tokyocabinet
hdb = HDB.open("test.tch", mode: "w+")
# See `Tokyocabinet::HDB::Mode` for available modes

hdb.set("foo", "abc")
hdb.count       # => 1
hdb.get("foo")  # => "abc"
hdb.get?("foo") # => "abc"
hdb.get?("xxx") # => nil
hdb.get("xxx")  # raises RecordNotFound
hdb.del("foo")  # => true
hdb.del("foo")  # => false
hdb.get?("foo") # => nil

# binary
hdb.set("b1", Bytes[1,0,2])
hdb.get("b1")   # => "\u0001"
hdb.bget("b1")  # => Bytes[1,0,2]

hdb.close

locks

By default, TokyoCabinet locks db files that run on the same thread. The unlock method provides dynamic locking at command execution. Although this avoids deadlock, execution speed is slow and resource consumption is increased.

a = HDB.open("test.tch")      # locked by a
b = HDB.open("test.tch", "r") # raises ThreadingError (even if readonly)
a.unlock                      # free
b = HDB.open("test.tch")      # locked by b
b.unlock                      # free
a.set("foo", "1")             # locked and unlocked automatically
b.set("bar", "2")             # locked and unlocked automatically

Note that .new is same as .[] and .open.unlock. So all following codes work same.

HDB.new("test.tch")
HDB.new("test.tch", "w+")
HDB["test.tch"]
HDB["test.tch", "w+"]
HDB.open("test.tch").unlock

tuning

HDB.create("a.tch", bnum: 13)              # creates db with bnum=13
HDB.create("a.tch", bnum: 17)              # skips (already exists)
HDB.create("a.tch", bnum: 17, force: true) # recreates db with bnum=17

Supported API

• Tokyocabinet::HDB
  • Mode
• LibTokyocabinet

Benchmark

• Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHz

set 10_000_000 records

Prerequisites

libtokyocabinet

On ubuntu

$ apt install libtokyocabinet-dev

shard.yml

1. Add the dependency to your shard.yml:

dependencies:
  tokyocabinet:
    github: maiha/tokyocabinet.cr
    version: 0.3.2

2. Run shards install

Development

$ crystal spec -v

Run test in docker

$ make spec

Generate documents

$ make docs

Contributing

1. Fork it (https://github.com/maiha/tokyocabinet.cr/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• maiha - creator and maintainer