Git Product home page Git Product logo

go-ttlcache's Introduction

go-ttlcache

go-ttlcache is a GoLang in-memory key => value store/cache that is suitable for applications running on a single machine. Its major advantage is that, being essentially a thread-safe and generically typed map[K]Item[V] with expiration times, it doesn't need to serialize or transmit its contents over the network.

Comparable key with any value can be stored, for a given duration or forever, and the cache can be safely used by multiple goroutines.

Although go-ttlcache isn't meant to be used as a persistent datastore, the entire cache can be saved to and loaded from a file (using c.Items() to retrieve the items map to serialize, and NewFrom[K, V]() to create a cache from a deserialized one) to recover from downtime quickly. (See the docs for NewFrom[K, V]() for caveats.)

Requirements

GoLang >=1.18

Installation

go get github.com/begmaroman/go-ttlcache

Usage

import (
	"fmt"
	"time"
	
    "github.com/begmaroman/go-ttlcache"
)

func main() {
	// Create a cache with a default expiration time of 5 minutes, and which
	// purges expired items every 10 minutes. Both key and value should be "string" type.
	c := ttlcache.New[string, string](5*time.Minute, 10*time.Minute)
	
	// There could be any comparable key type, and any value. For instance:
	// c := ttlcache.New[string, MyType](5*time.Minute, 10*time.Minute)

	// Set the value of the key "foo" to "bar", with the default expiration time
	c.Set("foo", "bar", ttlcache.DefaultExpiration)

	// Set the value of the key "baz" to "vaz", with no expiration time
	// (the item won't be removed until it is re-set, or removed using
	// c.Delete("baz")
	c.Set("baz", "vaz", ttlcache.NoExpiration)

	// Get the string associated with the key "foo" from the cache
	foo, found := c.Get("foo")
	if found {
		fmt.Println(foo)
	}

	// Since Go is statically typed, and cache values can be anything, type
	// assertion is needed when values are being passed to functions that don't
	// take arbitrary types, (i.e. interface{}). The simplest way to do this for
	// values which will only be used once--e.g. for passing to another
	// function--is:
	foo, found := c.Get("foo")
	if found {
		MyFunction(foo)
	}

	// This gets tedious if the value is used several times in the same function.
	// You might do either of the following instead:
	if foo, found := c.Get("foo"); found {
		// ...
	}
}

Reference

godoc or http://godoc.org/github.com/begmaroman/go-ttlcache

Inspired by:

go-ttlcache's People

Contributors

begmaroman avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.