Brobbot's brain is pretty cool. It implements a pretty generic key->value store interface, modeled after the redis api. When a script is loaded, it's given a brain-segment which helps each script operate in a separete key-space. It also provides hooks for serializing and deserializing data. Most methods should return a promise.
- dumb (the default)
- Redis
- PostgreSQL
- SQLite
If you want to write a brain module for brobbot, there are some tests you can run to verify functionality.
A promise to be resolved when the brain is ready for use.
Reset the datastore. Destroys all data.
Returns promise.
Get the length of the list stored at key.
Returns promise for int.
Set the list value at the specified index.
Returns promise.
Insert a list value before/after pivot value.
Returns promise.
Push a value onto the left-side of the list.
Returns promise.
Push a value onto the right-side of the list.
Returns promise.
Pop a value off of the left-side of the list.
Returns promise for the list value.
Pop a value off of the right-side of the list.
Returns promise for the list value.
Get the value at the specified index in the list.
Returns promise for the list value.
Get the values between the start and end indeces.
Returns promise for array of list values.
Get all the values in a list.
Returns promise for array of list values.
Remove all instances of value in the list.
Returns promise.
Add a member to the set specified by key.
Returns promise.
Test whether the member is in the set.
Returns promise for boolean.
Remove a member from the set.
Returns promise.
Get the size of the set.
Returns promise for int.
Get and remove a random member from the set.
Returns promise for a set member.
Get a random member from the set.
Returns promise for a set member.
Get all the members of the set.
Returns promise for array.
Get all the keys, optionally restricted to keys prefixed with searchKey.
Returns promise for array.
Transform the given key for internal use.
Returns string.
Transform the given key from internal use key to user-facing key.
Returns string.
Store key-value pair.
Returns promise.
Get value by key.
Returns promise.
Check whether the key has been set.
Returns promise for boolean.
Check the type of the value set for key.
Returns promise for string ('object'|'list'|'set'|'hash')
increment the value by num atomically.
Returns promise.
Get all the keys for the given hash table name.
Returns promise for array.
Get all the values for the given hash table name.
Returns promise for array.
Get the size of the hash table.
Returns promise for int.
Set a value in the specified hash table.
Returns promise for the value.
Get a value from the specified hash table.
Returns promise for the value.
Remove a value from the specified hash table.
Returns promise.
Get the whole hash table as a Map.
Returns promise for Map.
increment the hash value by num atomically.
Returns promise.
Alias: del
Remove value by key.
Returns promise.
Override this in your brain module to perform any necessary cleanup (e.g. closing connections).
Returns promise.
Perform any necessary pre-set serialization on a value.
Returns serialized value.
Perform any necessary post-get deserialization on a value.
Returns deserialized value.
Get an Array of User objects stored in the brain.
Returns promise for an Array of User objects.
Add a user to the data-store.
Returns promise for user.
Get or create a User object given a unique identifier.
Returns promise for a User instance of the specified user.
Get a User object given a name.
Returns promise for a User instance for the user with the specified name.
Get all users whose names start with fuzzyName (case-insensitive).
Returns promise an Array of User instances matching the fuzzy name.
If fuzzyName is an exact match for a user, returns an array with
just that user. Otherwise, returns an array of all users for which
fuzzyName is a raw fuzzy match (see usersForRawFuzzyName).
Returns promise an Array of User instances matching the fuzzy name.
Return a brain segment using segmentName as a key prefix.
Returns BrainSegment.