cache

type Cache interface {
	// Load returns a Cacheable from memory or source.
	Load(id string, timeout time.Duration) (Cacheable, error)

	// Discard explicitly removes a Cacheable from Cache. Normally
	// done automatically.
	Discard(id string) error

	// Clear empties the Cache.
	Clear() error

	// Len returns the number of entries in the Cache.
	Len() int

	// Stop tells the Cache to stop working.
	Stop() error
}

type Cacheable interface {
	// ID returns the identifier of the information.
	ID() string

	// IsOutdated checks if their's a newer version of the Cacheable.
	IsOutdated() (bool, error)

	// Discard tells the Cacheable to clean up itself.
	Discard() error
}

type CacheableLoader func(id string) (Cacheable, error)

type FileCacheable interface {
	Cacheable

	// ReadCloser returns the io.ReadCloser for the
	// cached file or the file itself if it's too large.
	ReadCloser() (io.ReadCloser, error)
}

type Info struct {
	ID       string
	Interval time.Duration
	TTL      time.Duration
	Len      int
}

type Option func(c Cache) error