Mnemonix v0.10.0 Mnemonix.Stores.DETS View Source
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
.
Link to this section 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 store using the Mnemonix.Stores.DETS
module with options
Starts a new store using Mnemonix.Stores.DETS
with store
and server
options
Link to this section 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
.
setup(Mnemonix.Store.options()) :: {:ok, state :: term()} | {:stop, reason :: any()}
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
.
start_link(Mnemonix.Supervisor.options()) :: GenServer.on_start()
Starts a new store using the Mnemonix.Stores.DETS
module with options
.
The options
are the same as described in Mnemonix.Features.Supervision.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.Supervisor.options(), GenServer.options()) :: GenServer.on_start()
Starts a new store using Mnemonix.Stores.DETS
with store
and server
options.
The options are the same as described in Mnemonix.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([], [name: My.Mnemonix.Stores.DETS])
iex> Mnemonix.put(My.Mnemonix.Stores.DETS, "foo", "bar")
iex> Mnemonix.get(My.Mnemonix.Stores.DETS, "foo")
"bar"