uri

Documentation

Index

• Constants
• func Filename(uri string, suffix string) string
• func IsValid(source string) (valid bool, err error)
• func Split(uri string) (transport string, ref string)

Constants

const (
	// Library is the keyword for a library ref
	Library = "library"
	// Shub is the keyword for a shub ref
	Shub = "shub"
	// HTTP is the keyword for http ref
	HTTP = "http"
	// HTTPS is the keyword for https ref
	HTTPS = "https"
	// Oras is the keyword for an oras ref
	Oras = "oras"
)

Functions

func Filename

func Filename(uri string, suffix string) string

Filename turns a transport:ref URI into a filename containing the top-level identifier of the image. For example, docker://sylabsio/lolcow:latest returns lolcow_latest.<suffix>

Returns "" when not in transport:ref format

func IsValid

func IsValid(source string) (valid bool, err error)

IsValid returns whether or not the given source is valid

func Split

func Split(uri string) (transport string, ref string)

Split splits a URI into it's components which can be used directly through containers/image

This can be tricky if there is no type but a file name contains a colon.

Examples:

docker://ubuntu -> docker, //ubuntu
docker://ubuntu:18.04 -> docker, //ubuntu:18.04
oci-archive:path/to/archive -> oci-archive, path/to/archive
ubuntu -> "", ubuntu
ubuntu:18.04.img -> "", ubuntu:18.04.img