Function Parse

pkg/referenceutil/referenceutil.go:96–146

(rawRef string)

}

func Parse(rawRef string) (*ImageReference, error) {
	ir := &ImageReference{}

	if strings.HasPrefix(rawRef, "ipfs://") {
		ir.Protocol = IPFSProtocol
		rawRef = rawRef[7:]
	} else if strings.HasPrefix(rawRef, "ipns://") {
		ir.Protocol = IPNSProtocol
		rawRef = rawRef[7:]
	} else if strings.HasPrefix(rawRef, "oci-archive://") {
		// The image must be loaded from the specified archive path first
		// before parsing the image reference specified in its OCI image manifest.
		return nil, ErrLoadOCIArchiveRequired
	}
	if decodedCID, err := decodeCid(rawRef); err == nil {
		ir.Protocol = IPFSProtocol
		rawRef = decodedCID
		ir.Path = rawRef
		return ir, nil
	}

	if dgst, err := digest.Parse(rawRef); err == nil {
		ir.Digest = dgst
		return ir, nil
	} else if dgst, err := digest.Parse("sha256:" + rawRef); err == nil {
		ir.Digest = dgst
		return ir, nil
	}

	var err error
	ir.nn, err = reference.ParseNormalizedNamed(rawRef)
	if err != nil {
		return ir, err
	}
	if tg, ok := ir.nn.(reference.Tagged); ok {
		ir.ExplicitTag = tg.Tag()
	}
	if tg, ok := ir.nn.(reference.Named); ok {
		ir.nn = reference.TagNameOnly(tg)
		ir.Domain = reference.Domain(tg)
		ir.Path = reference.Path(tg)
	}
	if tg, ok := ir.nn.(reference.Tagged); ok {
		ir.Tag = tg.Tag()
	}
	if tg, ok := ir.nn.(reference.Digested); ok {
		ir.Digest = tg.Digest()
	}

	return ir, nil
}