# README
Joe Bot - Redis Memory
Integrating Joe with Redis. https://github.com/go-joe/joe
This repository contains a module for the Joe Bot library.
Getting Started
This library is packaged as Go module. You can get it via:
go get github.com/go-joe/redis-memory
Example usage
In order to connect your bot to Redis you can simply pass it as module when creating a new bot:
package main
import (
"github.com/go-joe/joe"
"github.com/go-joe/redis-memory"
"github.com/pkg/errors"
)
type ExampleBot struct {
*joe.Bot
}
func main() {
b := &ExampleBot{
Bot: joe.New("example",
redis.Memory("localhost:6379"),
),
}
b.Respond("remember (.+) is (.+)", b.Remember)
b.Respond("what is (.+)", b.WhatIs)
b.Respond("show keys", b.ShowKeys)
err := b.Run()
if err != nil {
b.Logger.Fatal(err.Error())
}
}
func (b *ExampleBot) Remember(msg joe.Message) error {
key, value := msg.Matches[0], msg.Matches[1]
msg.Respond("OK, I'll remember %s is %s", key, value)
return b.Store.Set(key, value)
}
func (b *ExampleBot) WhatIs(msg joe.Message) error {
key := msg.Matches[0]
var value string
ok, err := b.Store.Get(key, &value)
if err != nil {
return errors.Wrapf(err, "failed to retrieve key %q from brain", key)
}
if ok {
msg.Respond("%s is %s", key, value)
} else {
msg.Respond("I do not remember %q", key)
}
return nil
}
func (b *ExampleBot) ShowKeys(msg joe.Message) error {
keys, err := b.Store.Keys()
if err != nil {
return err
}
msg.Respond("I got %d keys:", len(keys))
for i, k := range keys {
msg.Respond("%d) %q", i+1, k)
}
return nil
}
Built With
- go-redis - redis client in Go
- redimock - redis mock library in tcp level
- testify - A simple unit test library
- zap - Blazing fast, structured, leveled logging in Go
Contributing
If you want to hack on this repository, please read the short CONTRIBUTING.md guide first.
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
Authors
- Friedrich Große - Initial work - fgrosse
See also the list of contributors who participated in this project.
License
This project is licensed under the BSD-3-Clause License - see the LICENSE file for details.
Acknowledgments
- embedmd for a cool tool to embed source code in markdown files
# Functions
Memory returns a jos Module that configures the bot to use Redis as key-value store.
NewMemory creates a Redis implementation of a joe.Memory.
WithConfig is an Option to have full control over all redis connection options.
WithKey is an Option to use a different redis key to store the memories of the bot (default is "joe-bot").
WithLogger is an Option to let the Redis memory use a specific logger.
# Type aliases
An Option can be passed to the Memory function for opt-in functionality.