cache

Documentation

Index

• Constants
• func All(basedir string) (dirs []os.FileInfo, err error)
• func DefaultDir() (cachedir string, err error)
• func EnvDir() string
• func IsOld(t time.Time, maxAge time.Duration) bool
• func Old(basedir string) ([]os.FileInfo, error)
• func OlderThan(basedir string, max time.Duration) ([]os.FileInfo, error)
• type Backend
  • func (b *Backend) IsNotExist(err error) bool
  • func (b *Backend) Load(ctx context.Context, h restic.Handle, length int, offset int64, ...) error
  • func (b *Backend) Remove(ctx context.Context, h restic.Handle) error
  • func (b *Backend) Save(ctx context.Context, h restic.Handle, rd restic.RewindReader) error
  • func (b *Backend) Stat(ctx context.Context, h restic.Handle) (restic.FileInfo, error)
• type Cache
  • func New(id string, basedir string) (c *Cache, err error)
  • func TestNewCache(t testing.TB) *Cache
  • func (c *Cache) BaseDir() string
  • func (c *Cache) Clear(t restic.FileType, valid restic.IDSet) error
  • func (c *Cache) Has(h restic.Handle) bool
  • func (c *Cache) Save(h restic.Handle, rd io.Reader) error
  • func (c *Cache) Wrap(be restic.Backend) restic.Backend

Constants

const MaxCacheAge = 30 * 24 * time.Hour

MaxCacheAge is the default age (30 days) after which cache directories are considered old.

Functions

func All

func All(basedir string) (dirs []os.FileInfo, err error)

All returns a list of cache directories.

func DefaultDir

func DefaultDir() (cachedir string, err error)

DefaultDir returns $RESTIC_CACHE_DIR, or the default cache directory for the current OS if that variable is not set.

func EnvDir

func EnvDir() string

EnvDir return $RESTIC_CACHE_DIR env

func IsOld

func IsOld(t time.Time, maxAge time.Duration) bool

IsOld returns true if the timestamp is considered old.

func Old

func Old(basedir string) ([]os.FileInfo, error)

Old returns a list of cache directories with a modification time of more than 30 days ago.

func OlderThan

func OlderThan(basedir string, max time.Duration) ([]os.FileInfo, error)

OlderThan returns the list of cache directories older than max.

Types

type Backend

type Backend struct {
	restic.Backend
	*Cache
	// contains filtered or unexported fields
}

Backend wraps a restic.Backend and adds a cache.

func (*Backend) IsNotExist

func (b *Backend) IsNotExist(err error) bool

IsNotExist returns true if the error is caused by a non-existing file.

func (*Backend) Load

func (b *Backend) Load(ctx context.Context, h restic.Handle, length int, offset int64, consumer func(rd io.Reader) error) error

Load loads a file from the cache or the backend.

func (*Backend) Remove

func (b *Backend) Remove(ctx context.Context, h restic.Handle) error

Remove deletes a file from the backend and the cache if it has been cached.

func (*Backend) Save

func (b *Backend) Save(ctx context.Context, h restic.Handle, rd restic.RewindReader) error

Save stores a new file in the backend and the cache.

func (*Backend) Stat

func (b *Backend) Stat(ctx context.Context, h restic.Handle) (restic.FileInfo, error)

Stat tests whether the backend has a file. If it does not exist but still exists in the cache, it is removed from the cache.

type Cache

type Cache struct {
	Base    string
	Created bool
	// contains filtered or unexported fields
}

Cache manages a local cache.

func New

func New(id string, basedir string) (c *Cache, err error)

New returns a new cache for the repo ID at basedir. If basedir is the empty string, the default cache location (according to the XDG standard) is used.

For partial files, the complete file is loaded and stored in the cache when performReadahead returns true.

func TestNewCache

func TestNewCache(t testing.TB) *Cache

TestNewCache returns a cache in a temporary directory which is removed when cleanup is called.

func (*Cache) BaseDir

func (c *Cache) BaseDir() string

BaseDir returns the base directory.

func (*Cache) Clear

func (c *Cache) Clear(t restic.FileType, valid restic.IDSet) error

Clear removes all files of type t from the cache that are not contained in the set valid.

func (*Cache) Has

func (c *Cache) Has(h restic.Handle) bool

Has returns true if the file is cached.

func (*Cache) Save

func (c *Cache) Save(h restic.Handle, rd io.Reader) error

Save saves a file in the cache.

func (*Cache) Wrap

func (c *Cache) Wrap(be restic.Backend) restic.Backend

Wrap returns a backend with a cache.