README
¶
Cachego
Simple interface for caching
Installation
Cachego requires Go 1.9 or later.
go get github.com/faabiosr/cachego
If you want to get an specific version, please use the example below:
go get gopkg.in/faabiosr/cachego.v0
Usage Examples
Memcached
package main
import (
"github.com/faabiosr/cachego"
"github.com/bradfitz/gomemcache/memcache"
)
var cache cachego.Cache
func init() {
cache = cachego.NewMemcached(memcached.New("localhost:11211"))
}
Redis
package main
import (
"github.com/faabiosr/cachego"
"gopkg.in/redis.v4"
)
var cache cachego.Cache
func init() {
cache = cachego.NewRedis(
redis.NewClient(&redis.Options{
Addr: ":6379",
}),
)
}
File
package main
import (
"github.com/faabiosr/cachego"
)
var cache cachego.Cache
func init() {
cache = cachego.NewFile(
"/cache-dir/",
)
}
Map
package main
import (
"github.com/faabiosr/cachego"
)
var cache cachego.Cache
func init() {
cache = NewMap()
}
MongoDB
package main
import (
"github.com/faabiosr/cachego"
"gopkg.in/mgo.v2"
)
var cache cachego.Cache
func init() {
session, _ := mgo.Dial(address)
cache = cachego.NewMongo(
session.DB("cache").C("cache"),
)
}
Sqlite3
package main
import (
"database/sql"
_ "github.com/mattn/go-sqlite3"
)
var cache cachego.Cache
func init() {
db, _ := sql.Open("sqlite3", "./cache.db")
cache, _ = NewSqlite3(db, "cache")
}
SyncMap
package main
import (
"github.com/faabiosr/cachego"
)
var cache cachego.Cache
func init() {
cache = NewSyncMap()
}
BoltDB
package main
import (
"github.com/faabiosr/cachego"
bolt "github.com/coreos/bbolt"
)
var cache cachego.Cache
func init() {
db, _ := bolt.Open("cache.db", 0600, nil)
cache = NewBolt(db)
}
Chain
package main
import (
"github.com/faabiosr/cachego"
)
var cache cachego.Cache
func init() {
memcached := cachego.NewMemcached(
memcached.New("localhost:11211"),
)
redis := cachego.NewRedis(
redis.NewClient(&redis.Options{
Addr: ":6379",
}),
)
file := cachego.NewFile(
"/cache-dir/"
)
cache = cachego.NewChain(
cachego.NewMap(),
memcached,
redis,
file,
)
}
Usage
package main
import (
"github.com/faabiosr/cachego"
"github.com/bradfitz/gomemcache/memcache"
)
func main() {
cache.Save("foo", "bar")
cache.Save("john", "doe")
value, err := cache.Fetch("foo")
multiple := cache.FetchMulti([]string{"foo", "john"})
if cache.Contains("foo") {
cache.Delete("foo")
}
cache.Flush()
}
Documentation
Read the full documentation at https://godoc.org/github.com/faabiosr/cachego.
Development
Requirements
- Install docker and docker-compose
- Install go dep
Makefile
// Clean up
$ make clean
//Run tests and generates html coverage file
make cover
// Up the docker containers for testing
make docker
// Format all go files
make fmt
//Run linters
make lint
// Run tests
make test
License
This project is released under the MIT licence. See LICENSE for more details.
Documentation
¶
Overview ¶
Package cachego provides a simple way to use cache drivers.
Example Usage ¶
The following is a simple example using memcached driver:
import (
"fmt"
"github.com/faabiosr/cachego"
"github.com/bradfitz/gomemcache/memcache"
)
func main() {
cache := cachego.NewMemcached(
memcached.New("localhost:11211"),
)
cache.Save("foo", "bar")
fmt.Println(cache.Fetch("foo"))
}
Index ¶
Constants ¶
View Source
const ( // ErrCacheExpired returns an error when the cache key was expired. ErrCacheExpired = err("cache expired") // ErrFlush returns an error when flush fails. ErrFlush = err("unable to flush") // ErrSave returns an error when save fails. ErrSave = err("unable to save") // ErrDelete returns an error when deletion fails. ErrDelete = err("unable to delete") // ErrDecode returns an errors when decode fails. ErrDecode = err("unable to decode") )
Variables ¶
This section is empty.
Functions ¶
Types ¶
type Cache ¶
type Cache interface {
// Contains check if a cached key exists
Contains(key string) bool
// Delete remove the cached key
Delete(key string) error
// Fetch retrieve the cached key value
Fetch(key string) (string, error)
// FetchMulti retrieve multiple cached keys value
FetchMulti(keys []string) map[string]string
// Flush remove all cached keys
Flush() error
// Save cache a value by key
Save(key string, value string, lifeTime time.Duration) error
}
Cache is the top-level cache interface
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.