commit | 44a9bffa0786579f1e798a0bc6610aa11dfb9ba9 | [log] [tgz] |
---|---|---|
author | Adam Kocoloski <kocolosk@apache.org> | Fri Jun 11 14:50:00 2021 -0400 |
committer | GitHub <noreply@github.com> | Fri Jun 11 14:50:00 2021 -0400 |
tree | e4e8af3f0980497f132ef592b31620e4da543cdf | |
parent | 1e5f2385818b132b7798cf832fe719fdd01b6783 [diff] |
Ensure application environment is loaded (#26) erlfdb is a library application, but starting the app is still required to make the application environment variables accessible. Without this hack the `test_cluster_file` setting has no effect during eunit test executions.
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.