cache

Documentation

Index

• func BasePath(checksum, uri string) string
• func Download(client *http.Client, header http.Header, uri, file string) (w *os.File, response *http.Response, err error)
• type Cache
  • func Open(root string, ghClient *github.Client, client *http.Client, ...) (*Cache, error)
  • func (c *Cache) Clean() error
  • func (c *Cache) Create(checksum, uri string) (*os.File, error)
  • func (c *Cache) Download(b *ui.Task, checksum, uri string, mirrors ...string) (path string, etag string, err error)
  • func (c *Cache) ETag(b *ui.Task, uri string, mirrors ...string) (etag string, err error)
  • func (c *Cache) Evict(b *ui.Task, checksum, uri string) error
  • func (c *Cache) IsCached(checksum, uri string) bool
  • func (c *Cache) Mkdir(uri string) (string, error)
  • func (c *Cache) Open(b *ui.Task, checksum, uri string, mirrors ...string) (*os.File, error)
  • func (c *Cache) OpenLocal(checksum, uri string) (*os.File, error)
  • func (c *Cache) Path(checksum, uri string) string
  • func (c *Cache) Root() string
• type PackageSource
  • func GetSource(uri string) (PackageSource, error)

Functions

func BasePath

func BasePath(checksum, uri string) string

BasePath returns the subfolder in the cache path for the given file

func Download

func Download(client *http.Client, header http.Header, uri, file string) (w *os.File, response *http.Response, err error)

Download a file with resumption.

On return "w" will be either at the beginning of the file, or at the resumption point.

response.ContentLength will be the number of bytes remaining.

Types

type Cache

type Cache struct {
	// contains filtered or unexported fields
}

Cache manages the Hermit cache.

func Open

func Open(root string, ghClient *github.Client, client *http.Client, fastFailClient *http.Client) (*Cache, error)

Open or create a Cache at the given directory, using the given http client.

"fastFailClient" is a HTTP client configured to fail quickly if a remote server is unavailable, for use in optional checks.

func (*Cache) Clean

func (c *Cache) Clean() error

Clean the cache.

func (*Cache) Create

func (c *Cache) Create(checksum, uri string) (*os.File, error)

Create a new, empty, cache entry.

func (*Cache) Download

func (c *Cache) Download(b *ui.Task, checksum, uri string, mirrors ...string) (path string, etag string, err error)

Download a local or remote artifact, transparently caching it.

If checksum is present it must be the SHA256 hash of the downloaded artifact.

func (*Cache) ETag

func (c *Cache) ETag(b *ui.Task, uri string, mirrors ...string) (etag string, err error)

ETag fetches the etag from given URI if available. Otherwise an empty string is returned

func (*Cache) Evict

func (c *Cache) Evict(b *ui.Task, checksum, uri string) error

Evict a file from the cache.

func (*Cache) IsCached

func (c *Cache) IsCached(checksum, uri string) bool

IsCached returns true if the URI is cached.

func (*Cache) Mkdir

func (c *Cache) Mkdir(uri string) (string, error)

Mkdir makes a directory for the given URI.

func (*Cache) Open

func (c *Cache) Open(b *ui.Task, checksum, uri string, mirrors ...string) (*os.File, error)

Open a local or remote artifact, transparently caching it. Subsequent accesses will use the cached copy.

If checksum is present it must be the SHA256 hash of the downloaded artifact.

func (*Cache) OpenLocal

func (c *Cache) OpenLocal(checksum, uri string) (*os.File, error)

OpenLocal opens a local cached copy of "uri", or errors.

func (*Cache) Path

func (c *Cache) Path(checksum, uri string) string

Path to cached object.

func (*Cache) Root

func (c *Cache) Root() string

Root directory of the cache.

type PackageSource

type PackageSource interface {
	OpenLocal(cache *Cache, checksum string) (*os.File, error)
	Download(b *ui.Task, cache *Cache, checksum string) (path string, etag string, err error)
	ETag(b *ui.Task, cache *Cache) (etag string, err error)
	Validate(httpClient *http.Client) error
}

PackageSource for a specific version / system of a package

func GetSource

func GetSource(uri string) (PackageSource, error)

GetSource for the given uri, or an error if the uri can not be parsed as a source