Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

filecache

package

Go to main page

Versions in this module

v0

v0.153.0

Oct 12, 2026

Changes in this version

+ const CacheKeyAssets

+ const CacheKeyGetCSV

+ const CacheKeyGetJSON

+ const CacheKeyGetResource

+ const CacheKeyImages

+ const CacheKeyMisc

+ const CacheKeyModules

+ const FilecacheRootDirname

+ var ErrFatal = errors.New("fatal filecache error")

+ type Cache struct

+ Fs afero.Fs

+ func NewCache(fs afero.Fs, maxAge time.Duration, pruneAllRootDir string) *Cache

+ func (c *Cache) AsHTTPCache() httpcache.Cache

+ func (c *Cache) Get(id string) (ItemInfo, io.ReadCloser, error)

+ func (c *Cache) GetBytes(id string) (ItemInfo, []byte, error)

+ func (c *Cache) GetOrCreate(id string, create func() (io.ReadCloser, error)) (ItemInfo, io.ReadCloser, error)

+ func (c *Cache) GetOrCreateBytes(id string, create func() ([]byte, error)) (ItemInfo, []byte, error)

+ func (c *Cache) GetString(id string) string

+ func (c *Cache) NamedLock(id string) func()

+ func (c *Cache) Prune(force bool) (int, error)

+ func (c *Cache) ReadOrCreate(id string, read func(info ItemInfo, r io.ReadSeeker) error, ...) (info ItemInfo, err error)

+ func (c *Cache) WriteCloser(id string) (ItemInfo, io.WriteCloser, error)

+ type Caches map[string]*Cache

+ func NewCaches(p *helpers.PathSpec) (Caches, error)

+ func (c Caches) Prune() (int, error)

+ func (f Caches) AssetsCache() *Cache

+ func (f Caches) Get(name string) *Cache

+ func (f Caches) GetCSVCache() *Cache

+ func (f Caches) GetJSONCache() *Cache

+ func (f Caches) GetResourceCache() *Cache

+ func (f Caches) ImageCache() *Cache

+ func (f Caches) MiscCache() *Cache

+ func (f Caches) ModulesCache() *Cache

+ type Configs map[string]FileCacheConfig

+ func DecodeConfig(fs afero.Fs, bcfg config.BaseConfig, m map[string]any) (Configs, error)

+ func (c Configs) CacheDirModules() string

+ type FileCacheConfig struct

+ Dir string

+ DirCompiled string

+ IsResourceDir bool

+ MaxAge time.Duration

+ type ItemInfo struct

+ Name string