| commit | ff44fb2ec12763b2bde50c8bea476b77c88a2976 | [log] [tgz] |
|---|---|---|
| author | Adam Kocoloski <kocolosk@apache.org> | Fri Nov 05 17:15:31 2021 -0400 |
| committer | Adam Kocoloski <kocolosk@apache.org> | Wed Nov 17 10:35:43 2021 -0500 |
| tree | ec53b74eb334071cd7223d55f793ffe432ba7b62 | |
| parent | 5b085c525f3f6dfa374fa05fad03fa5b1a4ef7c8 [diff] |
Add a matrix job to run binding tests This job uses the same container image as the .devcontainer. It runs each of the binding tests for every supported API version (currently 620 and 630), except for `scripted` which only works with the current API version. It relies on a service container for the underlying FDB server.
This project is a NIF wrapper for the FoundationDB C API. Documentation on the main API can be found here.
This project also provides a conforming implementation of the Tuple and Directory layers.
Assuming you have installed the FoundationDB C API library, building erlfdb is as simple as:
$ make
Alternatively, adding erlfdb as a rebar dependency should Just Work ®.
Documentation for installing FoundationDB can be found here for macOS or here for Linux.
A simple example showing how to open a database and read and write keys:
Eshell V9.3.3.6 (abort with ^G) 1> Db = erlfdb:open(<<"/usr/local/etc/foundationdb/fdb.cluster">>). {erlfdb_database,#Ref<0.2859661758.3941466120.85406>} 2> ok = erlfdb:set(Db, <<"foo">>, <<"bar">>). ok 3> erlfdb:get(Db, <<"foo">>). <<"bar">> 4> erlfdb:get(Db, <<"bar">>). not_found
FoundationDB has a custom binding tester that can be used to test whether changes have broken compatibility. See the BINDING_TESTER documentation for instructions on building and running that system.