Official Crystal bindings for TrailDB, an efficient tool for storing and querying series of events. This library is heavily inspired by the official Python bindings. Crystal is an excellent language for TrailDB due to its simplicity and blazing fast performance. Crystal + TrailDB = ❤️.
- Install
traildbto your system. You can install the binaries for your system or compile it from source. Detailed instructions here. - Add this to your
shard.yml
dependencies:
traildb:
github: traildb/traildb-crystal- Install using
crystal deps
require "traildb"
cons = TrailDBConstructor.new("testtrail.tdb", ["field1", "field2"])
uuid = "12345678123456781234567812345678"
cons.add(uuid, Time.new(2017, 11, 12, 1, 1), ["a", "1"])
cons.add(uuid, Time.new(2017, 11, 13, 1, 1), ["b", "2"])
cons.add(uuid, Time.new(2017, 11, 14, 1, 1), ["c", "3"])
cons.closerequire "traildb"
traildb = TrailDB.new("testtrail.tdb")
puts "Number of trails: #{traildb.num_trails}"
puts "Number of fields: #{traildb.num_fields}"
traildb.trails.each do |(uuid, trail)|
puts "Events for trail #{uuid}"
trail.each do |event|
# Access event items by key
puts event["field1"]
# Or get the full hash
puts event.to_h
end
endNumber of trails: 1
Number of fields: 3
Events for trail 12345678123456781234567812345678
a
{"field1" => "a", "field2" => "1", "time" => 2017-11-12 06:01:00 UTC}
b
{"field1" => "b", "field2" => "2", "time" => 2017-11-13 06:01:00 UTC}
c
{"field1" => "c", "field2" => "3", "time" => 2017-11-14 06:01:00 UTC}
events = traildb[0].to_a
# or
events = traildb["12345678123456781234567812345678"].to_arequire "traildb"
event_filter = traildb.create_filter([[{"field1", "a"}]])
traildb.event_filter = event_filter
traildb.trails.each do |(uuid, trail)|
puts "Events for trail #{uuid}"
trail.each do |event|
puts event.to_h
end
endEvents for trail 12345678123456781234567812345678
{"field1" => "a", "field2" => "1", "time" => 2017-11-12 06:01:00 UTC}
For more examples, check out the specs for the library at spec/traildb_spec.cr.
These bindings are licensed under the MIT license.