cache

README

cache

I got tired of rewriting HTTP response caching logic for all my microservices so I hacked together this library that saves HTTP responses as local .txt files. cache is smart enough to return the contents of the cache file if it's only been a bit since the last call to that endpoint (cache filenames are generated as a hash of the HTTP method, URL, and headers). If the cache is expired, it remakes the call, saves the response to a file, and returns the contents either as a string or a struct. See usage examples below.

Installation

go get github.com/jessemillar/cache

Usage

import "github.com/jessemillar/cache"

See cache_test.go for usage examples.

Documentation

Index

• func GetCacheAndStaleness(cacheFilename string, cacheTTLOverride time.Duration, allowCacheUpdate bool) (string, bool, error)
• func GetCacheAndStalenessReturnStruct(cacheFilename string, cacheTTLOverride time.Duration, allowCacheUpdate bool, ...) (string, bool, error)
• func WriteStringToCacheFile(filename string, value string) error
• func WriteStructToCacheFile(filename string, rawStruct interface{}) error
• type Response
  • func BasicHttpRequest(httpMethod string, url string) (Response, error)
  • func BasicHttpRequestReturnStruct(httpMethod string, url string, target interface{}) (Response, error)
  • func HttpRequest(httpMethod string, url string, headers map[string][]string, ...) (Response, error)
  • func HttpRequestReturnStruct(httpMethod string, url string, headers map[string][]string, ...) (Response, error)

Functions

func GetCacheAndStaleness

func GetCacheAndStaleness(cacheFilename string, cacheTTLOverride time.Duration, allowCacheUpdate bool) (string, bool, error)

GetCacheAndStaleness returns the contents of the cache file and whether or not the cache is stale (this does not make an HTTP request)

func GetCacheAndStalenessReturnStruct

func GetCacheAndStalenessReturnStruct(cacheFilename string, cacheTTLOverride time.Duration, allowCacheUpdate bool, target interface{}) (string, bool, error)

GetCacheAndStalenessReturnStruct is the same as GetCacheAndStaleness but it returns the result as a specified struct. GetCacheAndStalenessReturnStruct returns the contents of the cache file as a struct and whether or not the cache is stale (this does not make an HTTP request)

func WriteStringToCacheFile

func WriteStringToCacheFile(filename string, value string) error

func WriteStructToCacheFile

func WriteStructToCacheFile(filename string, rawStruct interface{}) error

Types

type Response

type Response struct {
	StatusCode int    `json:"status"`
	Body       string `json:"body"`
}

func BasicHttpRequest

func BasicHttpRequest(httpMethod string, url string) (Response, error)

BasicHttpRequest makes a request with default parameters

func BasicHttpRequestReturnStruct

func BasicHttpRequestReturnStruct(httpMethod string, url string, target interface{}) (Response, error)

BasicHttpRequestReturnStruct makes a request with default parameters

func HttpRequest

func HttpRequest(httpMethod string, url string, headers map[string][]string, cacheTTLOverride time.Duration, allowCacheUpdate bool) (Response, error)

HttpRequest sends an HTTP request to the specified URL and returns the HTTP response. The response is cached for a duration specified by cacheTTL. If cacheTTLOverride is zero, the default cache TTL value is used.

func HttpRequestReturnStruct

func HttpRequestReturnStruct(httpMethod string, url string, headers map[string][]string, cacheTTLOverride time.Duration, allowCacheUpdate bool, target interface{}) (Response, error)

HttpRequestReturnStruct is the same as HttpRequest but it returns the result as a specified struct. HttpRequest sends an HTTP request to the specified URL and returns the HTTP response. The response is cached for a duration specified by cacheTTL. If cacheTTLOverride is zero, the default cache TTL value is used.