Mnemonix v0.8.0 Mnemonix.Stores.DETS
A Mnemonix.Store
that uses a DETS table to store state.
iex> {:ok, store} = Mnemonix.Stores.DETS.start_link
iex> Mnemonix.put(store, "foo", "bar")
iex> Mnemonix.get(store, "foo")
"bar"
iex> Mnemonix.delete(store, "foo")
iex> Mnemonix.get(store, "foo")
nil
This store throws errors on the functions in Mnemonix.Features.Enumerable
.
Summary
Functions
Callback implementation for c:Mnemonix.Store.Behaviours.Map.delete/2
Callback implementation for c:Mnemonix.Store.Behaviours.Map.fetch/2
Callback implementation for c:Mnemonix.Store.Behaviours.Map.put/3
Creates a new DETS table to store state using provided opts
Starts a new Mnemonix.Store.Server
using the Mnemonix.Stores.DETS
module with options
Starts a new Mnemonix.Store.Server
using Mnemonix.Stores.DETS
with store
and server
options
Functions
delete(Mnemonix.Store.t, Mnemonix.key) :: {:ok, Mnemonix.Store.t} | Mnemonix.Store.Behaviour.exception
Callback implementation for c:Mnemonix.Store.Behaviours.Map.delete/2
.
fetch(Mnemonix.Store.t, Mnemonix.key) :: {:ok, Mnemonix.Store.t, {:ok, Mnemonix.value} | :error} | Mnemonix.Store.Behaviour.exception
Callback implementation for c:Mnemonix.Store.Behaviours.Map.fetch/2
.
put(Mnemonix.Store.t, Mnemonix.key, Mnemonix.Store.value) :: {:ok, Mnemonix.Store.t} | Mnemonix.Store.Behaviour.exception
Callback implementation for c:Mnemonix.Store.Behaviours.Map.put/3
.
Creates a new DETS table to store state using provided opts
.
If the DETS file already exists, will use the contents of that table.
Options
table:
Name of the table to connect to.- Default:
Mnemonix.Stores.DETS.Table
- Default:
initial:
A map of key/value pairs to ensure are set on the ETS table at boot.- Default:
%{}
- Default:
The rest of the options are passed into :dets.open_file/2
verbaitm, except
for type:
, which will always be :set
.
Starts a new Mnemonix.Store.Server
using the Mnemonix.Stores.DETS
module with options
.
The options
are the same as described in Mnemonix.Store.Server.start_link/2
.
The :store
options are used in config/1
to start the store;
the :server
options are passed directly to GenServer.start_link/2
.
The returned GenServer.server/0
reference can be used as the primary
argument to the Mnemonix
API.
Examples
iex> {:ok, store} = Mnemonix.Stores.DETS.start_link()
iex> Mnemonix.put(store, "foo", "bar")
iex> Mnemonix.get(store, "foo")
"bar"
iex> {:ok, _store} = Mnemonix.Stores.DETS.start_link(server: [name: My.Mnemonix.Stores.DETS])
iex> Mnemonix.put(My.Mnemonix.Stores.DETS, "foo", "bar")
iex> Mnemonix.get(My.Mnemonix.Stores.DETS, "foo")
"bar"
start_link(Mnemonix.Store.Server.options, GenServer.options) :: GenServer.on_start
Starts a new Mnemonix.Store.Server
using Mnemonix.Stores.DETS
with store
and server
options.
The options are the same as described in Mnemonix.Store.Server.start_link/3
.
The store
options are used in config/1
to start the store;
the server
options are passed directly to GenServer.start_link/2
.
The returned GenServer.server/0
reference can be used as the primary
argument to the Mnemonix
API.
Examples
iex> {:ok, store} = Mnemonix.Stores.DETS.start_link([], [])
iex> Mnemonix.put(store, "foo", "bar")
iex> Mnemonix.get(store, "foo")
"bar"
iex> {:ok, _store} = Mnemonix.Stores.DETS.start_link([], [name: My.Mnemonix.Stores.DETS])
iex> Mnemonix.put(My.Mnemonix.Stores.DETS, "foo", "bar")
iex> Mnemonix.get(My.Mnemonix.Stores.DETS, "foo")
"bar"